튜토리얼: 분석 기반 웹사이트 프로젝트 설정
복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협력하여 구축하고 유지보수하는 경우가 많습니다. 팀 내 협력과 커뮤니케이션 방식이 프로젝트의 성패를 좌우할 수 있기 때문에, 팀원들이 공통 목표를 이해하고 달성할 수 있도록 도와주는 프로세스가 필요합니다. 분석 지표는 팀의 상황을 파악하고 작업 방식을 조정해 더 나은 협업을 이룰 수 있도록 도와줍니다. GitLab은 인스턴스, 그룹 및 프로젝트 수준에서 다양한 유형의 분석 인사이트를 제공합니다. 만약 이 목록이 길어 보여 어디서부터 시작해야 할지 모르는 경우, 본 튜토리얼을 참고하세요.
이 튜토리얼을 따라하여 예시 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자와 협력하며 프로젝트 수준의 분석 보고서를 활용하여 프로젝트의 개발을 평가하는 방법에 대해 배워봅니다.
다음은 우리가 진행할 작업의 개요입니다:
- 템플릿에서 프로젝트 생성
- 프로젝트에 사용자 초대
- 프로젝트 라벨 생성
- 사용자 정의 단계로 가치 스트림 만들기
- 인사이트 보고서 만들기
- 병합 요청 및 이슈 분석 보기
시작하기 전에
- 프로젝트를 생성하는 그룹에서 소유자 역할을 가져야 합니다.
템플릿에서 프로젝트 생성
우선, 그룹 내에서 프로젝트를 생성해야 합니다.
GitLab은 다양한 사용 사례에 필요한 모든 파일을 가진 프로젝트를 설정하는 데 도움이 되는 프로젝트 템플릿을 제공합니다. 여기서는 Hugo 웹사이트를 위한 프로젝트를 생성합니다.
프로젝트를 생성하려면:
- 왼쪽 사이드바에서 맨 위에 있는 Create new () 및 New project/repository를 선택합니다.
- 템플릿에서 생성을 선택합니다.
- 페이지/Hugo 템플릿을 선택합니다.
-
프로젝트 이름 텍스트 상자에 이름을 입력합니다(예:
내 웹사이트). - 프로젝트 URL 드롭다운 목록에서 프로젝트를 생성할 그룹을 선택합니다.
-
프로젝트 슬러그 텍스트 상자에 프로젝트의 슬러그를 입력합니다(예:
my-website). - 예비. 프로젝트 설명 텍스트 상자에 프로젝트에 대한 설명을 입력합니다. 예를 들어 “Hugo로 제작된 웹사이트를 위한 분석 기반 프로젝트”와 같이 입력합니다. 추후 언제든지 이 설명을 추가하거나 편집할 수 있습니다.
- 가시성 레벨 아래에서 프로젝트의 원하는 레벨을 선택합니다. 프로젝트를 그룹에서 생성하는 경우, 프로젝트의 가시성 설정은 상위 그룹의 가시성보다 적어도 제한적이어야 합니다.
- 프로젝트 생성을 선택합니다.
이제 Hugo 웹사이트에 필요한 모든 파일이 포함된 프로젝트가 생성되었습니다.
프로젝트에 사용자 초대
웹사이트와 같은 대규모 프로젝트를 처리할 때, 개발자 및 디자이너와 같은 다른 사람들과 협업해야 할 가능성이 높습니다. 그들을 초대하여 파일, 이슈 및 보고서에 액세스할 수 있도록 프로젝트에 초대해야 합니다.
내 웹사이트 프로젝트에 사용자를 초대하려면:
- 프로젝트에서 관리 > 구성원을 선택합니다.
- 구성원 초대를 선택합니다.
- 사용자의 사용자 이름을 입력합니다.
- 역할 드롭다운 목록에서 개발자 역할 이상을 선택합니다. 사용자는 분석 보기 및 이슈 및 병합 요청에 기여하기 위해서는 적어도 개발자 역할이 있어야 합니다.
- 예비. 액세스 만료 날짜 선택기에서 날짜를 선택합니다. 초대된 구성원이 프로젝트에 기여하는 것을 기대하는 경우 추천되는 단계입니다.
- 초대를 선택합니다.
초대된 사용자는 이제 프로젝트의 구성원입니다. 프로젝트의 구성원을 보기, 필터링, 검색할 수 있습니다.
프로젝트 라벨 생성
라벨은 이슈, 병합 요청 및 에픽을 조직화하고 추적하는 데 도움이 됩니다.
프로젝트 및 그룹에 필요한 만큼 많은 라벨을 만들 수 있습니다.
예를 들어, 이 프로젝트와 같이 웹사이트 프로젝트를 위해 기능 요청 및 버그 라벨이 유용할 수 있습니다.
내 웹사이트 프로젝트에서 프로젝트 라벨을 만들려면:
- 관리 > 라벨을 선택합니다.
- 새 라벨을 선택합니다.
-
이름 필드에
기능 요청을 입력합니다. - 예비. 설명 필드에 이 라벨을 사용하는 방법 및 시기에 대한 추가 정보를 입력합니다.
- 예비. 사용 가능한 색상 중에서 선택하거나 배경 색상 필드에 특정 색상의 HEX 색상 값을 입력하여 색상을 선택합니다.
- 라벨 생성을 선택합니다.
라벨은 이제 라벨 목록에 표시되며, 사용자 정의 단계로 가치 스트림을 만들 때 사용할 수 있습니다.
사용자 지정 단계로 가치 스트림 생성
이제 공동 작업자가 있는 프로젝트가 있으므로 활동을 추적하고 시각화할 수 있습니다. 가치 스트림 분석을 사용하여 아이디어에서 제품으로 가는 데 걸리는 시간을 측정하고 개발 프로세스의 비효율성을 식별할 수 있습니다.
시작하려면 내 웹사이트 프로젝트에 가치 스트림을 만듭니다.
- 분석 > 가치 스트림 분석을 선택합니다.
- 새 가치 스트림을 선택합니다.
- 가치 스트림에 이름을 입력하십시오. 예:
내 웹사이트 가치 스트림. - 기본 템플릿에서 생성을 선택합니다.
- 사용자 정의 단계를 추가하려면 다른 단계 추가를 선택합니다.
- 단계에 이름을 입력하십시오. 예:
레이블이 지정된 MR 병합. -
시작 이벤트 드롭다운 목록에서 병합 요청 레이블이 추가되었습니다를 선택한 다음
기능 요청레이블을 선택합니다. - 중지 이벤트 드롭다운 목록에서 병합 요청이 병합되었습니다를 선택합니다.
- 단계에 이름을 입력하십시오. 예:
- 가치 스트림 생성을 선택합니다.
가치 스트림을 만든 후 데이터 수집 및 로딩이 시작됩니다. 이 과정은 시간이 걸릴 수 있습니다. 준비되면 대시보드가 분석 > 가치 스트림 분석에 표시됩니다.
그 동안 프로젝트에 대한 인사이트 보고서를 만들기 시작할 수 있습니다.
인사이트 보고서 생성
가치 스트림 분석은 전체 개발 프로세스의 개요를 제공하는 반면, 인사이트(Insights)는 프로젝트의 이슈 생성 및 해결, 그리고 병합 요청의 평균 병합 시간을 보다 구체적으로 보여줍니다. 이 데이터 시각화는 한눈에 이슈를 분류하는 데 도움이 될 수 있습니다.
필요한 만큼 다양한 차트로 여러 인사이트 보고서를 만들 수 있습니다. 예를 들어 심각도에 따른 버그를 보여주는 쌓인 막대 차트 또는 해당 달에 개설된 이슈를 보여주는 라인 차트 등이 있습니다.
인사이트 보고서를 만들려면 내 웹사이트 프로젝트에서 다음을 수행합니다.
- 파일 목록 위에서 더하기 아이콘을 선택한 다음 새 파일을 선택합니다.
-
파일 이름 텍스트 상자에
.gitlab/insights.yml을 입력합니다. -
큰 텍스트 상자에 다음 코드를 입력합니다.
bugsCharts: title: "버그에 대한 차트" charts: - title: "월별 생성된 버그" description: "월별 생성된 오픈 버그" type: bar query: data_source: issuables params: issuable_type: issue issuable_state: opened filter_labels: - bug group_by: month period_limit: 12 - 변경 사항 커밋을 선택합니다.
이제 지난 12개월간 ~bug 레이블이 지정된 이슈의 수를 나타내는 인사이트 막대 차트가 생겼습니다.
최소한 Developer 역할을 가진 프로젝트 구성원은 분석 > 인사이트에서 인사이트 보고서를 볼 수 있습니다.
병합 요청 및 이슈 분석 보기
인사이트 보고서 외에도 프로젝트의 병합 요청 및 이슈에 대한 자세한 분석을 얻을 수 있습니다. 병합 요청 분석 및 이슈 분석에서 담당자, 병합 요청 처리량, 이슈 상태 등과 같은 지표가 포함된 차트 및 테이블을 확인할 수 있습니다.
병합 요청 및 이슈 분석을 보려면 내 웹사이트 프로젝트에서 분석 > 병합 요청 분석 또는 분석 > 이슈 분석을 선택합니다.
여기까지입니다! 이제 팀과 효율적으로 협업할 수 있는 분석 기능을 갖춘 웹사이트 프로젝트가 완성되었습니다.
도움말