튜토리얼: 분석을 기반으로 한 웹사이트 프로젝트 설정
복잡한 프로젝트(예: 웹사이트)에서 작업할 때, 다른 사람들과 협력하여 이를 구축하고 유지 관리할 가능성이 높습니다.
팀 내에서 협력하고 소통하는 방식은 프로젝트의 성패를 좌우할 수 있으므로, 팀원이 공통 목표를 따르고 달성할 수 있도록 돕는 프로세스를 마련하는 것이 중요합니다.
분석 메트릭은 팀이 어떻게 진행되고 있는지 이해하는 데 도움을 주며, 더 나은 협업을 위해 프로세스를 조정해야 할 필요가 있는지 여부를 알려줍니다.
GitLab은 인스턴스, 그룹, 프로젝트 수준에서 다양한 유형의 분석 통찰력을 제공합니다.
이 리스트가 길어 보이고 어디서 시작해야 할지 잘 모르겠다면, 이 튜토리얼이 도움이 될 것입니다.
예제 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자와 협업하며, 프로젝트 수준의 분석 보고서를 사용하여 프로젝트의 진행 상황을 평가하는 방법을 배워보세요.
우리가 진행할 내용은 다음과 같습니다:
- 템플릿에서 프로젝트 생성
- 프로젝트에 사용자 초대
- 프로젝트 레이블 생성
- 사용자 정의 단계로 가치 흐름 생성
- 인사이트 보고서 생성
- 병합 요청 및 이슈 분석 보기
시작하기 전에
- 프로젝트를 생성할 그룹의 소유자 역할이 있어야 합니다.
템플릿에서 프로젝트 생성
우선, 그룹에서 프로젝트를 생성해야 합니다.
GitLab은 다양한 사용 사례에 필요한 모든 파일로 프로젝트를 쉽게 설정할 수 있는 프로젝트 템플릿을 제공합니다.
여기에서는 Hugo 웹사이트용 프로젝트를 생성합니다.
프로젝트를 생성하려면:
- 왼쪽 사이드바 상단에서 Create new ()와 New project/repository를 선택합니다.
- Create from template을 선택합니다.
- Pages/Hugo 템플릿을 선택합니다.
-
Project name 텍스트 상자에 이름을 입력합니다(예:
My website). - Project URL 드롭다운 목록에서 프로젝트를 생성할 그룹을 선택합니다.
-
Project slug 텍스트 상자에 프로젝트의 슬러그를 입력합니다(예:
my-website). - 선택 사항. Project description 텍스트 상자에 프로젝트 설명을 입력합니다. 예를 들어, “Hugo로 구축된 웹사이트를 위한 분석 기반 프로젝트”. 이 설명은 언제든지 추가하거나 수정할 수 있습니다.
- Visibility Level에서 프로젝트에 대한 원하는 수준을 선택합니다. 그룹에서 프로젝트를 생성할 경우, 프로젝트의 가시성 설정은 부모 그룹의 가시성과 최소한 동일하게 제한되어야 합니다.
- Create project를 선택합니다.
이제 Hugo 웹사이트에 필요한 모든 파일이 있는 프로젝트가 생성되었습니다.
프로젝트에 사용자 초대
웹사이트와 같은 대규모 프로젝트에서 작업할 때, 개발자 및 디자이너와 같은 다른 사람들과 협력해야 할 가능성이 높습니다.
이들에게 프로젝트에 초대하여 모든 파일, 이슈 및 보고서에 접근할 수 있도록 해야 합니다.
My website 프로젝트에 사용자 초대하려면:
- 프로젝트에서 Manage > Members를 선택합니다.
- Invite members를 선택합니다.
- 사용자의 username을 입력합니다.
- Role 드롭다운 목록에서 Developer 역할 또는 더 높은 역할을 선택합니다. 사용자는 분석을 보고 이슈 및 병합 요청에 기여하기 위해 최소한 Developer 역할 이상을 가져야 합니다.
- 선택 사항. Access expiration date 선택기에서 날짜를 선택합니다. 초대된 멤버가 제한된 시간 동안만 프로젝트에 기여할 것으로 예상된다면 이 단계가 권장됩니다.
- Invite를 선택합니다.
초대된 사용자는 이제 프로젝트의 멤버가 되어야 합니다.
프로젝트의 멤버 보기, 필터링 및 검색하기 기능을 사용할 수 있습니다.
프로젝트 레이블 만들기
레이블은 이슈, 병합 요청, 그리고 에픽을 조직하고 추적하는 데 도움이 됩니다.
프로젝트와 그룹에 필요한 만큼의 레이블을 만들 수 있습니다.
예를 들어, 이 웹사이트 프로젝트의 경우 feature request와 bug 레이블이 유용할 수 있습니다.
My website 프로젝트에서 프로젝트 레이블을 만들려면:
-
관리 > 레이블을 선택합니다.
-
새 레이블을 선택합니다.
-
제목 필드에
feature request를 입력합니다. -
선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
-
선택 사항. 사용 가능한 색상 중에서 선택하거나 특정 색상의 16진수 색상 값을 배경색 필드에 입력하여 색상을 선택합니다.
-
레이블 만들기를 선택합니다.
이제 레이블이 레이블 목록에 나타나야 하며,
사용해 커스텀 단계로 값 흐름을 생성할 수 있습니다.
커스텀 단계로 값 흐름 만들기
이제 협업자가 있는 프로젝트가 생겼으니 활동을 추적하고 시각화할 수 있습니다.
Value Stream Analytics는 아이디어에서 프로덕션으로 가는 데 걸리는 시간을 측정하고
개발 프로세스의 비효율성을 식별하는 데 도움이 됩니다.
분석 기능에 대한 시연 데모는 Value Stream Management 제품 투어를 참조하세요.
시작하려면 My website 프로젝트에서 값 흐름을 생성합니다:
-
분석 > 값 흐름 분석을 선택합니다.
-
새 값 흐름을 선택합니다.
-
값 흐름의 이름을 입력합니다. 예:
My website value stream. -
기본 템플릿에서 생성을 선택합니다.
- 커스텀 단계를 추가하려면 다른 단계 추가를 선택합니다.
- 단계의 이름을 입력합니다. 예:
레이블이 붙은 MRs 병합. -
시작 이벤트 드롭다운 목록에서 병합 요청 레이블이 추가됨을 선택한 다음
feature request레이블을 선택합니다. - 중지 이벤트 드롭다운 목록에서 병합 요청 병합됨을 선택합니다.
- 단계의 이름을 입력합니다. 예:
- 값 흐름 만들기를 선택합니다.
값 흐름을 생성한 후, 데이터 수집 및 로딩이 시작됩니다.
이 과정은 시간이 걸릴 수 있습니다. 준비되면 대시보드가 분석 > 값 흐름 분석에 표시됩니다.
그동안 프로젝트에 대한 인사이트 보고서를 만들기 시작할 수 있습니다.
인사이트 보고서 만들기
Value Stream Analytics는 전체 개발 프로세스에 대한 개요를 제공하는 반면,
Insights는 프로젝트의 생성 및 종료된 이슈와 평균 병합 시간을 보다 세부적으로 보여줍니다.
이 데이터 시각화는 이슈를 한눈에 분류하는 데 도움을 줄 수 있습니다.
서로 다른 차트로 인사이트 보고서를 여러 개 만들 수 있습니다.
예를 들어, 심각도에 따른 버그를 위한 스택형 막대 차트 또는 한 달 동안 열린 이슈를 위한 선 차트가 있습니다.
My website 프로젝트에서 인사이트 보고서를 만들려면:
-
파일 목록 위에 있는 더하기 아이콘을 선택한 다음 새 파일을 선택합니다.
-
파일 이름 텍스트 상자에
.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 레이블이 붙은 이슈 수를 보여줍니다.
최소한 개발자 역할을 가진 프로젝트 구성원은 분석 > 인사이트에서 인사이트 보고서를 볼 수 있습니다.
병합 요청 및 이슈 분석 보기
Insights 보고서 외에도, 프로젝트의 병합 요청 및 이슈에 대한 상세한 분석을 얻을 수 있습니다.
병합 요청 분석 및 이슈 분석은 담당자, 병합 요청 처리량, 이슈 상태와 같은 지표가 포함된 차트와 표를 표시합니다.
병합 요청 및 이슈 분석을 보려면 My website 프로젝트에서 분석 > 병합 요청 분석 또는 분석 > 이슈 분석을 선택하세요.
그게 전부입니다! 이제 팀과 효율적으로 협업할 수 있는 분석 기능이 있는 웹사이트 프로젝트가 준비되었습니다.
도움말