GitLab 상태 페이지를 사용하면 인시던트 중에 사용자에게 효율적으로 커뮤니케이션하기 위한 정적 웹사이트를 생성하고 배포할 수 있습니다. 상태 페이지 랜딩 페이지에는 최근 인시던트의 개요가 표시됩니다:

인시던트를 선택하면 특정 인시던트에 대한 자세한 정보가 있는 세부 정보 페이지가 표시됩니다:

• 인시던트가 마지막으로 업데이트된 시점을 포함한 인시던트 상태.
• 이모지를 포함한 인시던트 제목.
• 이모지를 포함한 인시던트 설명.
• 인시던트 설명에 제공된 파일 첨부 파일 또는 유효한 이미지 확장자가 있는 코멘트.
• 인시던트 업데이트의 시간순 정렬 목록.

상태 페이지 설정#

GitLab 상태 페이지를 구성하려면:

1. 클라우드 제공자 정보로 GitLab 구성.
2. AWS 계정 구성.
3. GitLab에서 상태 페이지 프로젝트 생성.
4. 인시던트를 상태 페이지에 동기화.

클라우드 제공자 정보로 GitLab 구성#

배포 대상으로는 AWS S3만 지원됩니다.

사전 요구사항:

• 유지 관리자 또는 소유자 역할이 있어야 합니다.

상태 페이지에 콘텐츠를 푸시하는 데 필요한 AWS 계정 정보를 GitLab에 제공하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 모니터를 선택합니다.
3. 상태 페이지를 확장합니다.
4. 활성 체크박스를 선택합니다.
5. 상태 페이지 URL 상자에 외부 상태 페이지의 URL을 제공합니다.
6. S3 버킷 이름 상자에 S3 버킷의 이름을 입력합니다. 자세한 내용은 버킷 구성 문서를 참조하십시오.
7. AWS 리전 상자에 버킷의 리전을 입력합니다. 자세한 내용은 AWS 문서를 참조하십시오.
8. AWS 액세스 키 ID 및 AWS 비밀 액세스 키를 입력합니다.
9. 변경 사항 저장을 선택합니다.

AWS 계정 구성#

1. AWS 계정 내에서 다음 파일을 예시로 사용하여 두 개의 새 IAM 정책을 생성합니다:
   • 버킷 생성.
   • 버킷 콘텐츠 업데이트 (S3_BUCKET_NAME을 버킷 이름으로 교체해야 함).
2. 첫 번째 단계에서 생성한 권한 정책으로 새 AWS 액세스 키를 생성합니다.

상태 페이지 프로젝트 생성#

AWS 계정을 구성한 후 상태 페이지 프로젝트를 추가하고 상태 페이지를 AWS S3에 배포하는 데 필요한 CI/CD 변수를 구성해야 합니다:

1. 상태 페이지 프로젝트를 포크합니다. 최신 상태 페이지 기능을 가져올 수 있도록 저장소 미러링을 통해 이 작업을 수행할 수 있습니다.
2. 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
3. 변수를 확장합니다.
4. Amazon 콘솔에서 다음 변수를 추가합니다:

   • S3_BUCKET_NAME - Amazon S3 버킷의 이름. 제공된 이름의 버킷이 없는 경우 첫 번째 파이프라인 실행 시 버킷을 생성하고 정적 웹사이트 호스팅을 위해 구성합니다.

   • AWS_DEFAULT_REGION - AWS 리전.

   • AWS_ACCESS_KEY_ID - AWS 액세스 키 ID.

   • AWS_SECRET_ACCESS_KEY - AWS 비밀.

5. 왼쪽 사이드바에서 빌드 > 파이프라인을 선택합니다.
6. 상태 페이지를 S3에 배포하려면 새 파이프라인을 선택합니다.

인시던트를 상태 페이지에 동기화#

CI/CD 변수를 생성한 후 인시던트에 사용할 프로젝트를 구성합니다:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 모니터를 선택합니다.
3. 상태 페이지를 확장합니다.
4. 클라우드 제공자의 자격 증명을 입력하고 활성 체크박스를 선택해야 합니다.
5. 변경 사항 저장을 선택합니다.

GitLab 상태 페이지 사용 방법#

GitLab 인스턴스를 구성한 후 관련 업데이트가 인시던트에 대한 JSON 형식 데이터를 외부 클라우드 제공자에게 푸시하는 백그라운드 작업을 트리거합니다. 상태 페이지 웹사이트는 이 JSON 형식 데이터를 주기적으로 가져옵니다. 팀의 추가 노력 없이 사용자에게 진행 중인 인시던트에 대한 정보를 형식화하고 표시합니다:

%%{init: { "fontFamily": "GitLab Sans" }}%%
graph TB
    accTitle: Understand your status page
    accDescr: How GitLab fetches, formats, and displays incident data
subgraph GitLab Instance
issues(issue updates) -- trigger --> middleware(Background job: JSON generation)
end
subgraph Cloud Provider
middleware --saves data --> c1(Cloud Bucket stores JSON file)
end
subgraph Status Page
d(Static Site on CDN) -- fetches data --> c1
end</code></pre></details></div>

인시던트 게시#
인시던트를 게시하려면:

GitLab 상태 페이지 설정을 활성화한 프로젝트에 인시던트를 생성합니다.
프로젝트 또는 그룹 소유자가 /publish 빠른 액션을 사용하여 GitLab 상태 페이지에 인시던트를 게시해야 합니다. 기밀 인시던트는 게시할 수 없습니다.

백그라운드 작업자가 설정 중에 제공한 자격 증명을 사용하여 상태 페이지에 인시던트를 게시합니다. 게시의 일부로 GitLab은:

사용자 및 그룹 멘션을 Incident Responder로 익명화합니다.
비공개 GitLab 참조의 제목을 제거합니다.
인시던트 설명에 첨부된 파일을 최대 인시던트당 5000개까지 게시합니다.

게시 후 인시던트 제목 아래에 표시되는 상태 페이지에 게시됨 버튼을 선택하여 인시던트의 세부 정보 페이지에 액세스할 수 있습니다.

인시던트 업데이트#
인시던트에 대한 업데이트를 게시하려면 인시던트의 설명을 업데이트합니다.
Warning
참조된 인시던트가 변경(제목 또는 기밀성 등)되어도 참조가 있는 인시던트는 업데이트되지 않습니다.

인시던트에 코멘트 게시#
상태 페이지 인시던트에 코멘트를 게시하려면:

인시던트에 코멘트를 생성합니다.
코멘트를 게시할 준비가 되면 코멘트에 마이크 이모지 반응 (:microphone: 🎤)을 추가하여 코멘트를 게시로 표시합니다.
코멘트에 첨부된 파일(인시던트당 최대 5000개)도 게시됩니다.

Warning
인시던트를 볼 수 있는 액세스 권한이 있는 사람이라면 코멘트에 이모지 반응을 추가할 수 있으므로 이슈에 대한 액세스를 팀원에게만 제한하는 것을 고려하십시오.

인시던트 상태 업데이트#
인시던트 상태를 open에서 closed로 변경하려면 GitLab 내에서 인시던트를 닫습니다. 인시던트를 닫으면 백그라운드 작업자가 GitLab 상태 페이지 웹사이트를 업데이트하도록 트리거됩니다.
게시된 인시던트를 기밀로 설정하면 GitLab이 GitLab 상태 페이지 웹사이트에서 해당 인시던트를 게시 취소합니다.