InfoGrab Docs

튜토리얼: 분석 기반 웹사이트 프로젝트 설정

요약

복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협업하여 구축하고 유지 관리할 가능성이 높습니다. 예제 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자들과 협업하고, 프로젝트 수준 분석 보고서를 사용하여 프로젝트 개발을 평가하는 방법을 알아봅니다.

복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협업하여 구축하고 유지 관리할 가능성이 높습니다. 팀에서 협업하고 소통하는 방식은 프로젝트의 성패를 좌우할 수 있으므로, 팀원들이 공통 목표를 따르고 달성하는 데 도움이 되는 프로세스가 필요합니다. 분석 지표는 팀이 어떻게 하고 있는지 이해하고, 더 잘 협력할 수 있도록 프로세스를 조정해야 하는지 파악하는 데 도움이 됩니다. GitLab은 인스턴스, 그룹 및 프로젝트 수준에서 다양한 유형의 분석 인사이트를 제공합니다. 이 목록이 길게 느껴지고 어디서 시작해야 할지 모른다면 이 튜토리얼이 도움이 됩니다.

예제 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자들과 협업하고, 프로젝트 수준 분석 보고서를 사용하여 프로젝트 개발을 평가하는 방법을 알아봅니다.

진행할 작업의 개요입니다:

  1. 템플릿에서 프로젝트 만들기.
  2. 프로젝트에 사용자 초대.
  3. 프로젝트 레이블 만들기.
  4. 사용자 정의 단계를 포함한 가치 흐름 만들기.
  5. Insights 보고서 만들기.
  6. 머지 리퀘스트 및 이슈 분석 보기.

시작하기 전에#

  • 프로젝트를 만드는 그룹에 대해 Owner 역할이 있어야 합니다.

템플릿에서 프로젝트 만들기#

먼저 그룹에 프로젝트를 만들어야 합니다.

GitLab은 다양한 사용 사례에 필요한 모든 파일로 프로젝트를 쉽게 설정할 수 있는 프로젝트 템플릿을 제공합니다. 여기에서는 Hugo 웹사이트를 위한 프로젝트를 만듭니다.

프로젝트를 만들려면:

  1. 오른쪽 상단에서 Create new(+)와 New project/repository를 선택합니다.
  2. Create from template을 선택합니다.
  3. Pages/Hugo 템플릿을 선택합니다.
  4. Project name 텍스트 상자에 이름을 입력합니다(예: My website).
  5. Project URL 드롭다운 목록에서 프로젝트를 만들 그룹을 선택합니다.
  6. Project slug 텍스트 상자에 프로젝트 슬러그를 입력합니다(예: my-website).
  7. 선택 사항. Project description 텍스트 상자에 프로젝트 설명을 입력합니다. 예: "Hugo로 구축된 웹사이트를 위한 분석 기반 프로젝트". 언제든지 이 설명을 추가하거나 편집할 수 있습니다.
  8. Visibility Level 아래에서 프로젝트에 원하는 수준을 선택합니다. 그룹에서 프로젝트를 만드는 경우 프로젝트의 가시성 설정은 부모 그룹의 가시성보다 최소한 더 제한적이어야 합니다.
  9. Create project를 선택합니다.

이제 Hugo 웹사이트에 필요한 모든 파일이 있는 프로젝트가 생겼습니다.

프로젝트에 사용자 초대#

웹사이트와 같은 대규모 프로젝트를 작업할 때 개발자나 디자이너와 같은 다른 사람들과 협업해야 할 가능성이 있습니다. 모든 파일, 이슈 및 보고서에 액세스할 수 있도록 프로젝트에 초대해야 합니다.

My website 프로젝트에 사용자를 초대하려면:

  1. 프로젝트에서 Manage > Members를 선택합니다.
  2. Invite members를 선택합니다.
  3. 사용자의 username을 입력합니다.
  4. Role 드롭다운 목록에서 최소 Developer 역할을 선택합니다. 사용자가 분석을 보고 이슈와 머지 리퀘스트에 기여하려면 Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  5. 선택 사항. Access expiration date 선택기에서 날짜를 선택합니다. 초대된 구성원이 제한된 기간 동안만 프로젝트에 기여할 것으로 예상되는 경우 이 단계가 권장됩니다.
  6. Invite를 선택합니다.

초대된 사용자는 이제 프로젝트의 구성원이어야 합니다. 프로젝트의 구성원을 보고, 필터링하고, 검색할 수 있습니다.

프로젝트 레이블 만들기#

레이블은 이슈, 머지 리퀘스트 및 에픽을 구성하고 추적하는 데 도움이 됩니다. 프로젝트와 그룹에 필요한 만큼 많은 레이블을 만들 수 있습니다. 예를 들어 이러한 웹사이트 프로젝트의 경우 feature request 및 bug 레이블이 유용할 수 있습니다.

My website 프로젝트에서 프로젝트 레이블을 만들려면:

  1. Manage > Labels를 선택합니다.
  2. New label을 선택합니다.
  3. Title 필드에 feature request를 입력합니다.
  4. 선택 사항. Description 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  5. 선택 사항. 사용 가능한 색상에서 선택하거나 Background color 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  6. Create label을 선택합니다.

이제 레이블이 레이블 목록에 표시되며 사용자 정의 단계가 있는 가치 흐름을 만드는 데 사용할 수 있습니다.

사용자 정의 단계를 포함한 가치 흐름 만들기#

이제 협력자와 함께 프로젝트가 생겼으므로 활동 추적 및 시각화를 시작할 수 있습니다. Value Stream Analytics는 아이디어에서 프로덕션까지 걸리는 시간을 측정하고 개발 프로세스의 비효율성을 파악하는 데 도움이 됩니다. 분석 기능의 클릭 스루 데모는 Value Stream Management 제품 투어를 참조하세요.

시작하려면 My website 프로젝트에서 가치 흐름을 만듭니다:

  1. Analyze > Value Stream Analytics를 선택합니다.
  2. New Value Stream을 선택합니다.
  3. 가치 흐름의 이름을 입력합니다(예: My website value stream).
  4. Create from default template을 선택합니다.
  5. 사용자 정의 단계를 추가하려면 Add a stage를 선택합니다.
    • 단계 이름을 입력합니다(예: Labeled MRs merged).
    • Start event 드롭다운 목록에서 Merge request label added를 선택한 다음 feature request 레이블을 선택합니다.
    • Stop event 드롭다운 목록에서 Merge request merged를 선택합니다.
  6. Create value stream을 선택합니다.

가치 흐름을 만들면 데이터가 수집되고 로드되기 시작합니다. 이 프로세스는 다소 시간이 걸릴 수 있습니다. 준비가 되면 Analyze > Value Stream Analytics에 대시보드가 표시됩니다.

그 동안 프로젝트의 Insights 보고서 만들기를 시작할 수 있습니다.

Insights 보고서 만들기#

Value Stream Analytics는 전체 개발 프로세스에 대한 개요를 제공하는 반면, Insights는 프로젝트의 생성 및 종료된 이슈, 머지 리퀘스트의 평균 머지 시간에 대한 더 세분화된 보기를 제공합니다. 이 데이터 시각화는 이슈를 한눈에 분류하는 데 도움이 됩니다.

다양한 차트가 있는 Insights 보고서를 필요한 만큼 많이 만들 수 있습니다. 예를 들어 심각도별 버그의 스택 막대형 차트 또는 한 달에 걸쳐 열린 이슈의 선 차트가 있습니다.

My website 프로젝트에서 Insights 보고서를 만들려면:

  1. 파일 목록 위에서 더하기 아이콘을 선택한 다음 New file을 선택합니다.

  2. File name 텍스트 상자에 .gitlab/insights.yml을 입력합니다.

  3. 큰 텍스트 상자에 다음 코드를 입력합니다:

    bugsCharts:
   title: "Charts for bugs"
   charts:
      - title: "Monthly bugs created"
         description: "Open bugs created per month"
         type: bar
         query:
         data_source: issuables
         params:
            issuable_type: issue
            issuable_state: opened
            filter_labels:
               - bug
            group_by: month
            period_limit: 12

  4. Commit changes를 선택합니다.

이제 지난 12개월 동안 매월 생성된 ~bug 레이블이 있는 이슈 수를 표시하는 Insights 막대 차트가 생겼습니다. Developer, Maintainer 또는 Owner 역할을 가진 사용자와 프로젝트 구성원은 Analyze > Insights에서 Insights 보고서를 볼 수 있습니다.

머지 리퀘스트 및 이슈 분석 보기#

Insights 보고서 외에도 프로젝트의 머지 리퀘스트 및 이슈에 대한 상세한 분석을 얻을 수 있습니다. 머지 리퀘스트 분석 및 이슈 분석은 담당자, 머지 리퀘스트 처리량 및 이슈 상태와 같은 지표가 있는 차트와 표를 표시합니다.

머지 리퀘스트 및 이슈 분석을 보려면 My website 프로젝트에서 Analyze > Merge request analytics 또는 Analyze > Issue analytics를 선택합니다.

끝입니다! 이제 팀과 효율적으로 협업할 수 있는 분석 기반 웹사이트 프로젝트가 생겼습니다.

튜토리얼: 분석 기반 웹사이트 프로젝트 설정

Tier: Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협업하여 구축하고 유지 관리할 가능성이 높습니다. 예제 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자들과 협업하고, 프로젝트 수준 분석 보고서를 사용하여 프로젝트 개발을 평가하는 방법을 알아봅니다.

복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협업하여 구축하고 유지 관리할 가능성이 높습니다. 팀에서 협업하고 소통하는 방식은 프로젝트의 성패를 좌우할 수 있으므로, 팀원들이 공통 목표를 따르고 달성하는 데 도움이 되는 프로세스가 필요합니다. 분석 지표는 팀이 어떻게 하고 있는지 이해하고, 더 잘 협력할 수 있도록 프로세스를 조정해야 하는지 파악하는 데 도움이 됩니다. GitLab은 인스턴스, 그룹 및 프로젝트 수준에서 다양한 유형의 분석 인사이트를 제공합니다. 이 목록이 길게 느껴지고 어디서 시작해야 할지 모른다면 이 튜토리얼이 도움이 됩니다.

예제 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자들과 협업하고, 프로젝트 수준 분석 보고서를 사용하여 프로젝트 개발을 평가하는 방법을 알아봅니다.

진행할 작업의 개요입니다:

  1. 템플릿에서 프로젝트 만들기.
  2. 프로젝트에 사용자 초대.
  3. 프로젝트 레이블 만들기.
  4. 사용자 정의 단계를 포함한 가치 흐름 만들기.
  5. Insights 보고서 만들기.
  6. 머지 리퀘스트 및 이슈 분석 보기.

시작하기 전에#

  • 프로젝트를 만드는 그룹에 대해 Owner 역할이 있어야 합니다.

템플릿에서 프로젝트 만들기#

먼저 그룹에 프로젝트를 만들어야 합니다.

GitLab은 다양한 사용 사례에 필요한 모든 파일로 프로젝트를 쉽게 설정할 수 있는 프로젝트 템플릿을 제공합니다. 여기에서는 Hugo 웹사이트를 위한 프로젝트를 만듭니다.

프로젝트를 만들려면:

  1. 오른쪽 상단에서 Create new(+)와 New project/repository를 선택합니다.
  2. Create from template을 선택합니다.
  3. Pages/Hugo 템플릿을 선택합니다.
  4. Project name 텍스트 상자에 이름을 입력합니다(예: My website).
  5. Project URL 드롭다운 목록에서 프로젝트를 만들 그룹을 선택합니다.
  6. Project slug 텍스트 상자에 프로젝트 슬러그를 입력합니다(예: my-website).
  7. 선택 사항. Project description 텍스트 상자에 프로젝트 설명을 입력합니다. 예: "Hugo로 구축된 웹사이트를 위한 분석 기반 프로젝트". 언제든지 이 설명을 추가하거나 편집할 수 있습니다.
  8. Visibility Level 아래에서 프로젝트에 원하는 수준을 선택합니다. 그룹에서 프로젝트를 만드는 경우 프로젝트의 가시성 설정은 부모 그룹의 가시성보다 최소한 더 제한적이어야 합니다.
  9. Create project를 선택합니다.

이제 Hugo 웹사이트에 필요한 모든 파일이 있는 프로젝트가 생겼습니다.

프로젝트에 사용자 초대#

웹사이트와 같은 대규모 프로젝트를 작업할 때 개발자나 디자이너와 같은 다른 사람들과 협업해야 할 가능성이 있습니다. 모든 파일, 이슈 및 보고서에 액세스할 수 있도록 프로젝트에 초대해야 합니다.

My website 프로젝트에 사용자를 초대하려면:

  1. 프로젝트에서 Manage > Members를 선택합니다.
  2. Invite members를 선택합니다.
  3. 사용자의 username을 입력합니다.
  4. Role 드롭다운 목록에서 최소 Developer 역할을 선택합니다. 사용자가 분석을 보고 이슈와 머지 리퀘스트에 기여하려면 Developer, Maintainer 또는 Owner 역할이 있어야 합니다.
  5. 선택 사항. Access expiration date 선택기에서 날짜를 선택합니다. 초대된 구성원이 제한된 기간 동안만 프로젝트에 기여할 것으로 예상되는 경우 이 단계가 권장됩니다.
  6. Invite를 선택합니다.

초대된 사용자는 이제 프로젝트의 구성원이어야 합니다. 프로젝트의 구성원을 보고, 필터링하고, 검색할 수 있습니다.

프로젝트 레이블 만들기#

레이블은 이슈, 머지 리퀘스트 및 에픽을 구성하고 추적하는 데 도움이 됩니다. 프로젝트와 그룹에 필요한 만큼 많은 레이블을 만들 수 있습니다. 예를 들어 이러한 웹사이트 프로젝트의 경우 feature request 및 bug 레이블이 유용할 수 있습니다.

My website 프로젝트에서 프로젝트 레이블을 만들려면:

  1. Manage > Labels를 선택합니다.
  2. New label을 선택합니다.
  3. Title 필드에 feature request를 입력합니다.
  4. 선택 사항. Description 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  5. 선택 사항. 사용 가능한 색상에서 선택하거나 Background color 필드에 특정 색상의 16진수 색상 값을 입력하여 색상을 선택합니다.
  6. Create label을 선택합니다.

이제 레이블이 레이블 목록에 표시되며 사용자 정의 단계가 있는 가치 흐름을 만드는 데 사용할 수 있습니다.

사용자 정의 단계를 포함한 가치 흐름 만들기#

이제 협력자와 함께 프로젝트가 생겼으므로 활동 추적 및 시각화를 시작할 수 있습니다. Value Stream Analytics는 아이디어에서 프로덕션까지 걸리는 시간을 측정하고 개발 프로세스의 비효율성을 파악하는 데 도움이 됩니다. 분석 기능의 클릭 스루 데모는 Value Stream Management 제품 투어를 참조하세요.

시작하려면 My website 프로젝트에서 가치 흐름을 만듭니다:

  1. Analyze > Value Stream Analytics를 선택합니다.
  2. New Value Stream을 선택합니다.
  3. 가치 흐름의 이름을 입력합니다(예: My website value stream).
  4. Create from default template을 선택합니다.
  5. 사용자 정의 단계를 추가하려면 Add a stage를 선택합니다.
    • 단계 이름을 입력합니다(예: Labeled MRs merged).
    • Start event 드롭다운 목록에서 Merge request label added를 선택한 다음 feature request 레이블을 선택합니다.
    • Stop event 드롭다운 목록에서 Merge request merged를 선택합니다.
  6. Create value stream을 선택합니다.

가치 흐름을 만들면 데이터가 수집되고 로드되기 시작합니다. 이 프로세스는 다소 시간이 걸릴 수 있습니다. 준비가 되면 Analyze > Value Stream Analytics에 대시보드가 표시됩니다.

그 동안 프로젝트의 Insights 보고서 만들기를 시작할 수 있습니다.

Insights 보고서 만들기#

Value Stream Analytics는 전체 개발 프로세스에 대한 개요를 제공하는 반면, Insights는 프로젝트의 생성 및 종료된 이슈, 머지 리퀘스트의 평균 머지 시간에 대한 더 세분화된 보기를 제공합니다. 이 데이터 시각화는 이슈를 한눈에 분류하는 데 도움이 됩니다.

다양한 차트가 있는 Insights 보고서를 필요한 만큼 많이 만들 수 있습니다. 예를 들어 심각도별 버그의 스택 막대형 차트 또는 한 달에 걸쳐 열린 이슈의 선 차트가 있습니다.

My website 프로젝트에서 Insights 보고서를 만들려면:

  1. 파일 목록 위에서 더하기 아이콘을 선택한 다음 New file을 선택합니다.

  2. File name 텍스트 상자에 .gitlab/insights.yml을 입력합니다.

  3. 큰 텍스트 상자에 다음 코드를 입력합니다:

    bugsCharts:
   title: "Charts for bugs"
   charts:
      - title: "Monthly bugs created"
         description: "Open bugs created per month"
         type: bar
         query:
         data_source: issuables
         params:
            issuable_type: issue
            issuable_state: opened
            filter_labels:
               - bug
            group_by: month
            period_limit: 12

  4. Commit changes를 선택합니다.

이제 지난 12개월 동안 매월 생성된 ~bug 레이블이 있는 이슈 수를 표시하는 Insights 막대 차트가 생겼습니다. Developer, Maintainer 또는 Owner 역할을 가진 사용자와 프로젝트 구성원은 Analyze > Insights에서 Insights 보고서를 볼 수 있습니다.

머지 리퀘스트 및 이슈 분석 보기#

Insights 보고서 외에도 프로젝트의 머지 리퀘스트 및 이슈에 대한 상세한 분석을 얻을 수 있습니다. 머지 리퀘스트 분석 및 이슈 분석은 담당자, 머지 리퀘스트 처리량 및 이슈 상태와 같은 지표가 있는 차트와 표를 표시합니다.

머지 리퀘스트 및 이슈 분석을 보려면 My website 프로젝트에서 Analyze > Merge request analytics 또는 Analyze > Issue analytics를 선택합니다.

끝입니다! 이제 팀과 효율적으로 협업할 수 있는 분석 기반 웹사이트 프로젝트가 생겼습니다.