튜토리얼: 분석 기능을 활용한 웹사이트 프로젝트 설정

Tier: Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

복잡한 프로젝트(예: 웹사이트)를 작업할 때 다른 사람들과 협력하여 구축하고 유지하는 경우가 많습니다. 팀에서의 협력과 커뮤니케이션이 프로젝트를 만들거나 망칠 수 있으므로 팀원들이 공통 목표를 따르고 달성할 수 있도록 도와주는 프로세스가 필요합니다. 분석 지표는 팀의 수행 상황을 이해하고, 프로세스를 조정하여 더 나은 협업을 할 수 있도록 도와줍니다. GitLab은 인스턴스, 그룹 및 프로젝트 수준에서 다양한 유형의 분석 인사이트를 제공합니다. 이 디렉터리이 길고 어디서부터 시작해야 할지 모르는 경우에는 이 튜토리얼이 도움이 될 것입니다.

직접 따라와서 예시 웹사이트 프로젝트를 설정하고, 다른 GitLab 사용자들과 협력하고, 프로젝트 수준의 분석 보고서를 사용하여 프로젝트의 개발을 평가하는 방법을 배워보세요.

다음은 우리가 할 작업에 대한 개요입니다.

  1. 템플릿에서 프로젝트 생성
  2. 프로젝트에 사용자 초대
  3. 프로젝트 레이블 생성
  4. 사용자 정의 단계를 포함한 가치 스트림 생성
  5. 인사이트 보고서 생성
  6. Merge Request 및 이슈 분석 보기

시작하기 전에

  • 프로젝트를 만드는 그룹에서 소유자 역할이 있어야 합니다.

템플릿에서 프로젝트 생성

우선, 그룹 내에서 프로젝트를 생성해야 합니다.

GitLab은 프로젝트 템플릿을 제공하여 다양한 사용 사례에 필요한 모든 파일을 갖춘 프로젝트를 쉽게 설정할 수 있습니다. 여기에서는 Hugo 웹사이트를 위한 프로젝트를 생성할 것입니다.

프로젝트를 생성하려면:

  1. 왼쪽 사이드바 상단에서 생성하기 ()와 새 프로젝트/리포지터리를 선택합니다.
  2. 템플릿에서 생성을 선택합니다.
  3. Pages/Hugo 템플릿을 선택합니다.
  4. 프로젝트 이름 텍스트 상자에 이름을 입력합니다(예: My website).
  5. 프로젝트 URL 드롭다운 디렉터리에서 프로젝트를 생성할 그룹을 선택합니다.
  6. 프로젝트 슬러그 텍스트 상자에 프로젝트 슬러그를 입력합니다(예: my-website).
  7. 선택 사항. 프로젝트 설명 텍스트 상자에 프로젝트에 대한 설명을 입력합니다. 예: “Hugo로 프로덕션된 웹사이트용 분석 기능 프로젝트”. 이 설명은 필요한 경우 언제든지 추가하거나 편집할 수 있습니다.
  8. 가시성 수준 아래에서 프로젝트에 대해 원하는 가시성 수준을 선택합니다. 그룹 내에서 프로젝트를 만들 경우, 프로젝트의 가시성 설정은 부모 그룹의 가시성보다 적어도 제한적이어야 합니다.
  9. 프로젝트 생성을 선택합니다.

이제 Hugo 웹사이트에 필요한 모든 파일을 갖춘 프로젝트가 생성되었습니다.

프로젝트에 사용자 초대

웹사이트와 같이 큰 프로젝트에서는 개발자 및 디자이너와 같은 다른 사람들과 협력해야 할 가능성이 높습니다. 그들을 프로젝트에 초대하여 모든 파일, 이슈 및 보고서에 접근할 수 있도록 해야 합니다.

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

  1. 프로젝트에서 관리 > 구성원을 선택합니다.
  2. 구성원 초대를 선택합니다.
  3. 사용자의 사용자 이름을 입력합니다.
  4. 역할 드롭다운 디렉터리에서 개발자 역할 또는 그 이상을 선택합니다. 사용자는 적어도 개발자 역할을 가져야만 분석을 볼 수 있고 이슈 및 Merge Request에 기여할 수 있습니다.
  5. 선택 사항. 액세스 만료 날짜 선택기에서 날짜를 선택합니다. 초대된 구성원이 프로젝트에 기여할 것으로 예상되는 경우 이 단계가 권장됩니다.
  6. 초대를 선택합니다.

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

프로젝트 레이블 생성

레이블은 이슈, Merge Request 및 에픽을 조직화하고 추적하는 데 도움이 됩니다. 여러분은 프로젝트 및 그룹에 필요한 만큼 레이블을 만들 수 있습니다. 예를 들어, 이 웹사이트 프로젝트에서 기능 요청버그 레이블이 유용할 것입니다.

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

  1. 관리 > 레이블을 선택합니다.
  2. 새 레이블을 선택합니다.
  3. 제목 필드에 기능 요청을 입력합니다.
  4. 선택 사항. 설명 필드에 이 레이블을 사용하는 방법과 시기에 대한 추가 정보를 입력합니다.
  5. 선택 사항. 사용 가능한 색상 중에서 색상을 선택하거나 배경 색상 필드에 특정 색상의 hex 색상 값을 입력합니다.
  6. 레이블 생성을 선택합니다.

이 레이블은 이제 레이블 디렉터리에 나타날 것이며, 사용자 지정 스테이지를 포함한 가치 스트림 만들기에 사용할 수 있습니다.

사용자 지정 단계를 포함한 가치 스트림 생성

이제 협력자가 있는 프로젝트를 가지고 있으므로 활동을 추적하고 시각화하는 것을 시작할 수 있습니다. 가치 스트림 분석은 아이디어에서 제품으로 가는 데 걸리는 시간을 메트릭하고 개발 프로세스의 비효율성을 식별하는 데 도움이 됩니다.

My website 프로젝트에 가치 스트림을 만들려면:

  1. 분석 > 가치 스트림 분석을 선택합니다.
  2. 새 가치 스트림을 선택합니다.
  3. 가치 스트림에 이름을 입력합니다. 예: My website value stream.
  4. 기본 템플릿에서 만들기를 선택합니다.
  5. 사용자 정의 단계를 추가하려면 다른 스테이지 추가를 선택합니다.
    • 스테이지에 이름을 입력합니다. 예: 레이블이 추가된 MR Merge.
    • 시작 이벤트 드롭다운 디렉터리에서 Merge Request 레이블이 추가됨, 그런 다음 기능 요청 레이블을 선택합니다.
    • 중지 이벤트 드롭다운 디렉터리에서 Merge Request이 Merge됨을 선택합니다.
  6. 가치 스트림 생성을 선택합니다.

가치 스트림을 만들면 데이터 수집 및 로딩이 시작됩니다. 이 프로세스는 시간이 걸릴 수 있습니다. 준비가 되면 대시보드가 분석 > 가치 스트림 분석에 표시됩니다.

그 사이에 프로젝트에 대한 인사이트 보고서를 작성할 수 있습니다.

인사이트 보고서 생성

가치 스트림 분석은 전체 개발 프로세스 개요를 제공하는 반면, 인사이트는 프로젝트의 이슈 생성 및 완료, Merge Request의 평균 Merge 시간과 같은 더 세부적인 보기를 제공합니다. 이 데이터 시각화를 통해 한눈에 이슈를 선택적으로 처리할 수 있습니다.

다양한 차트를 사용하여 다른 인사이트 보고서를 원하는만큼 만들 수 있습니다. 예: 심각도에 따른 버그의 쌓인 막대 차트 또는 한 달 동안 개설된 이슈에 대한 라인 차트.

My website 프로젝트에서 인사이트 보고서를 작성하려면:

  1. 파일 디렉터리 위에서 플러스 아이콘을 선택한 다음 새 파일을 선택합니다.
  2. 파일 이름 텍스트 상자에 .gitlab/insights.yml을 입력합니다.
  3. 큰 텍스트 상자에 다음 코드를 입력합니다:

    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
    
  4. 변경 사항 커밋을 선택합니다.

이제 지난 12개월 동안 ~bug 레이블이 달린 이슈의 수를 보여주는 인사이트 막대 차트가 생겼습니다. 최소한 개발자 역할을 갖춘 여러분과 프로젝트 구성원은 분석 > 인사이트에서 인사이트 보고서를 볼 수 있습니다.

Merge Request 및 이슈 분석 보기

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

Merge Request 및 이슈 분석을 보려면 내 웹사이트 프로젝트에서 분석 > Merge Request 분석 또는 분석 > 이슈 분석을 선택합니다.

여기까지입니다! 이제 팀과 효율적으로 협업할 수 있는 분석을 활용한 웹사이트 프로젝트가 준비되었습니다.