- 시작하기 전에
- 템플릿에서 프로젝트 생성
- 프로젝트에 사용자 초대하기
- 프로젝트 라벨 생성
- 사용자 정의 단계를 포함한 가치 스트림 생성
- 인사이트 보고서 생성
- 병합 요청 및 이슈 분석 보기
튜토리얼: 분석 기반 웹사이트 프로젝트 설정
복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협력하여 구축하고 유지하는 경우가 많습니다. 팀 내에서의 협력과 의사 소통 방식이 프로젝트의 성패를 좌우할 수 있으므로 팀원이 공통 목표를 따르고 달성하는 데 도움이 되는 프로세스가 필요합니다. 분석 지표는 팀의 수행 상황을 이해하는 데 도움이 되며, 효과적인 협업을 위해 프로세스를 조정해야 할 필요성을 파악할 수 있습니다. GitLab은 인스턴스, 그룹 및 프로젝트 수준에서 다양한 유형의 분석 인사이트를 제공합니다. 이 목록이 길고 어디서부터 시작해야 할지 모르겠다면, 이 튜토리얼이 도움이 될 것입니다.
이어서, 예제 웹사이트 프로젝트를 설정하고 다른 GitLab 사용자들과 협력하여 프로젝트 수준의 분석 보고서를 사용하여 프로젝트의 개발을 평가하는 방법을 배워보세요.
다음은 할 일에 대한 개요입니다:
- 템플릿에서 프로젝트 생성
- 프로젝트에 사용자 초대하기
- 프로젝트 라벨 생성
- 사용자 정의 단계를 포함한 가치 스트림 생성
- 인사이트 보고서 생성
- 병합 요청 및 이슈 분석 보기
시작하기 전에
- 프로젝트를 생성할 그룹에서 소유자 역할을 가져야 합니다.
템플릿에서 프로젝트 생성
우선, 그룹 내에서 프로젝트를 생성해야 합니다.
GitLab은 다양한 사용 사례를 위한 필요한 모든 파일로 프로젝트를 설정하는 데 도움이 되는 프로젝트 템플릿을 제공합니다. 여기서 Hugo 웹사이트를 위한 프로젝트를 만들 것입니다.
프로젝트를 생성하려면:
- 왼쪽 사이드바 상단에서 새로 만들기 () 및 새 프로젝트/저장소 만들기를 선택합니다.
- 템플릿에서 만들기를 선택합니다.
- 페이지/Hugo 템플릿을 선택합니다.
-
프로젝트 이름 텍스트 상자에 이름을 입력합니다 (예:
내 웹사이트). - 프로젝트 URL 드롭다운 목록에서 프로젝트를 생성하려는 그룹을 선택합니다.
-
프로젝트 슬러그 텍스트 상자에 프로젝트의 슬러그를 입력합니다 (예:
my-website). - 선택 사항. 프로젝트 설명 텍스트 상자에 프로젝트에 대한 설명을 입력합니다. 예: “Hugo로 제작된 웹사이트를 위한 분석 기반 프로젝트”. 이 설명은 언제든지 추가하거나 편집할 수 있습니다.
- 가시성 레벨에서 프로젝트의 원하는 레벨을 선택합니다. 그룹에서 프로젝트를 생성하는 경우 프로젝트의 가시성 설정은 부모 그룹의 가시성 설정보다 적어도 제한적이어야 합니다.
- 프로젝트 생성을 선택합니다.
이제 Hugo 웹사이트를 위한 모든 파일이 있는 프로젝트가 준비되었습니다.
프로젝트에 사용자 초대하기
웹사이트와 같은 대규모 프로젝트를 작업할 때, 개발자나 디자이너와 같은 다른 사람들과 협업해야 할 가능성이 높습니다. 그들을 프로젝트에 초대하여 파일, 이슈 및 보고서에 액세스할 수 있도록 설정해야 합니다.
내 웹사이트 프로젝트에 사용자를 초대하려면:
- 프로젝트에서 관리 > 구성원을 선택합니다.
- 구성원 초대를 선택합니다.
- 사용자의 사용자 이름을 입력합니다.
- 역할 드롭다운 목록에서 개발자 역할 이상을 선택합니다. 사용자는 분석을 보고 이슈 및 병합 요청에 기여하려면 적어도 개발자 역할이어야 합니다.
- 선택 사항. 액세스 만료 날짜 선택기에서 날짜를 선택합니다. 이 단계는 초대된 구성원이 프로젝트에 제한된 기간 동안만 기여할 것으로 예상될 때 권장됩니다.
- 초대를 선택합니다.
초대된 사용자는 이제 프로젝트의 구성원이어야 합니다. 프로젝트의 구성원을 보기, 필터링 및 검색할 수 있습니다.
프로젝트 라벨 생성
라벨을 사용하여 이슈, 병합 요청 및 에픽을 조직화하고 추적할 수 있습니다.
프로젝트 및 그룹에 필요한 만큼 많은 라벨을 만들 수 있습니다.
예를 들어, 이런 웹사이트 프로젝트를 위해 기능 요청 및 버그 라벨이 유용할 수 있습니다.
내 웹사이트 프로젝트에서 프로젝트 라벨을 만들려면:
- 관리 > 라벨을 선택합니다.
- 새 라벨을 선택합니다.
-
제목 필드에
feature request를 입력합니다. - 선택 사항. 설명 필드에 이 라벨을 어떻게 사용하고 언제 사용해야 하는지에 대한 추가 정보를 입력합니다.
- 선택 사항. 사용 가능한 색상 중에서 선택하거나 특정 색상을 위한 16진수 색상 값을 배경 색상 필드에 입력하여 색상을 선택합니다.
- 라벨 만들기를 선택합니다.
라벨은 이제 라벨 목록에 나타나며 사용자 정의 단계를 포함한 가치 스트림을 만들 때 사용할 수 있습니다.
사용자 정의 단계를 포함한 가치 스트림 생성
이제 협력자가 있는 프로젝트가 있으므로 활동을 추적하고 시각화할 수 있습니다. 가치 스트림 분석을 사용하여 아이디어부터 제품으로 가는 데 걸리는 시간을 측정하고 개발 프로세스의 비효율성을 식별할 수 있습니다. 분석 기능에 대한 시연을 원하시면, 가치 스트림 관리 제품 투어를 참조하세요.
내 웹사이트 프로젝트에서 가치 스트림을 만들기 위해:
- 분석 > 가치 스트림 분석을 선택합니다.
- 새 가치 스트림을 선택합니다.
- 가치 스트림 이름을 입력합니다. 예:
내 웹사이트 가치 스트림. - 기본 템플릿에서 생성을 선택합니다.
- 사용자 정의 단계를 추가하려면 다른 단계 추가를 선택합니다.
- 단계에 이름을 입력합니다. 예:
라벨이 추가된 MR 병합됨. -
시작 이벤트 드롭다운 목록에서 병합 요청 라벨이 추가됨을 선택하고
feature request라벨을 선택합니다. - 중지 이벤트 드롭다운 목록에서 병합 요청이 병합됨을 선택합니다.
- 단계에 이름을 입력합니다. 예:
- 가치 스트림 생성을 선택합니다.
가치 스트림을 만든 후 데이터가 수집되고 로딩됩니다. 이 작업에는 시간이 걸릴 수 있습니다. 준비되면 대시보드는 분석 > 가치 스트림 분석에 표시됩니다.
그동안 프로젝트에 대한 인사이트 보고서를 만드는 것을 시작할 수 있습니다.
인사이트 보고서 생성
Value Stream Analytics는 전체 개발 프로세스의 개요를 제공하는 반면, Insights는 프로젝트의 생성 및 완료된 이슈, 그리고 병합 요청의 평균 병합 시간과 같은 보다 상세한 보기를 제공합니다. 이 데이터 시각화는 한눈에 문제를 식별하는 데 도움이 될 수 있습니다.
필요한 만큼 다양한 차트로 여러 개의 Insights 보고서를 생성할 수 있습니다. 예를 들어, 심각도에 따른 쌓인 막대 차트나 월별 생성된 이슈에 대한 라인 차트 등이 있습니다.
Insights 보고서를 생성하려면, My website 프로젝트에서 다음을 수행하세요:
- 파일 목록 위에서 플러스 아이콘을 선택한 후 새 파일을 선택합니다.
-
파일 이름 텍스트 상자에
.gitlab/insights.yml을 입력합니다. -
큰 텍스트 상자에 다음 코드를 입력합니다:
bugsCharts: title: "Bugs 차트" 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 막대 차트가 생겼습니다. 적어도 Developer 역할을 가진 프로젝트 구성원과 함께 분석 > Insights에서 Insights 보고서를 볼 수 있습니다.
병합 요청 및 이슈 분석 보기
Insights 보고서 외에도 프로젝트의 병합 요청 및 이슈에 대한 자세한 분석 데이터를 얻을 수 있습니다. 병합 요청 분석 및 이슈 분석은 담당자, 병합 요청 처리량, 이슈 상태 등과 같은 메트릭을 보여주는 차트 및 테이블을 표시합니다.
병합 요청 및 이슈 분석을 보려면, My website 프로젝트에서 분석 > 병합 요청 분석 또는 분석 > 이슈 분석을 선택하세요.
요령이었습니다! 이제 팀과 효율적으로 협업할 수 있는 분석 기능이 탑재된 웹사이트 프로젝트가 준비되었습니다.
도움말