Microsoft Azure 비즈니스 클라우드 사용자를 위해, GitLab은 Azure Marketplace에 사전 구성된 오퍼링을 제공합니다. 이 튜토리얼은 단일 가상 머신(VM)에 GitLab Enterprise Edition을 설치하는 방법을 설명합니다.

사전 요구 사항#

• Azure 계정. 다음 방법 중 하나를 사용하세요:
  • 본인 또는 회사에 구독이 있는 계정이 있다면 해당 계정을 사용하세요.
  • 무료 계정 만들기: 30일간 Azure를 탐색할 수 있는 $200 크레딧이 제공됩니다. 자세한 내용은 Azure 무료 계정을 참조하세요.
  • MSDN 구독이 있다면 Azure 구독자 혜택을 활성화하세요. MSDN 구독을 통해 매월 반복 Azure 크레딧을 받을 수 있습니다.
• GitLab 인스턴스를 유지 관리하기 위한 관리자 액세스 권한.

GitLab 배포 및 구성#

GitLab이 이미 사전 구성된 이미지에 설치되어 있으므로, 새 VM을 생성하기만 하면 됩니다:

1. 마켓플레이스에서 GitLab 오퍼링 방문
2. Get it now를 선택하면 Create this app in Azure 창이 열립니다. Continue를 선택합니다.
3. Azure 포털에서 다음 옵션 중 하나를 선택합니다:
   • Create를 선택하여 처음부터 VM을 생성합니다.
   • Start with a pre-set configuration을 선택하여 사전 구성된 옵션으로 시작합니다. 이 구성은 언제든지 수정할 수 있습니다.

이 가이드에서는 처음부터 VM을 생성하므로 Create를 선택합니다.

가상 머신을 생성한 후, 다음 섹션의 정보를 사용하여 구성하세요.

Basics 탭 구성#

먼저 기본 가상 머신의 기본 설정을 구성해야 합니다:

1. 구독 모델과 리소스 그룹을 선택합니다(없으면 새로 만들기).
2. VM의 이름을 입력합니다(예: GitLab).
3. 지역을 선택합니다.
4. Availability options에서 Availability zone을 선택하고 1로 설정합니다. 가용성 영역에 대해 자세히 알아보세요.
5. 선택한 이미지가 GitLab - Gen1으로 설정되어 있는지 확인합니다.
6. 하드웨어 요구 사항에 따라 VM 크기를 선택합니다. 최대 500명의 사용자를 위한 GitLab 환경을 실행하기 위한 최소 시스템 요구 사항은 D4s_v3 크기로 충족되므로 해당 옵션을 선택합니다.
7. 인증 유형을 SSH public key로 설정합니다.
8. 사용자 이름을 입력하거나 자동으로 생성된 이름을 그대로 사용합니다. 이는 Azure가 SSH를 통해 VM에 연결하는 데 사용하는 사용자입니다. 기본적으로 사용자에게는 루트 액세스 권한이 있습니다.
9. 자체 SSH 키를 제공할지 또는 Azure가 키를 생성하도록 할지 결정합니다. SSH 공개 키 설정 방법에 대한 자세한 내용은 SSH를 참조하세요.

입력한 설정을 검토한 후 Disks 탭으로 진행합니다.

Disks 탭 구성#

디스크 설정:

1. OS 디스크 유형으로 Premium SSD를 선택합니다.
2. 기본 암호화를 선택합니다.

Azure가 제공하는 디스크 유형에 대해 자세히 알아보세요.

설정을 검토한 후 Networking 탭으로 진행합니다.

Networking 탭 구성#

이 탭을 사용하여 네트워크 인터페이스 카드(NIC) 설정을 구성하여 가상 머신의 네트워크 연결을 정의합니다. 기본 설정을 그대로 유지할 수 있습니다.

Azure는 기본적으로 보안 그룹을 생성하며 VM이 여기에 할당됩니다. 마켓플레이스의 GitLab 이미지는 기본적으로 다음 포트가 열려 있습니다:

포트를 변경하거나 규칙을 추가하려면 VM 대시보드에서 왼쪽 사이드바의 Networking settings를 선택하여 VM 생성 후에 변경할 수 있습니다.

Management 탭 구성#

이 탭을 사용하여 VM의 모니터링 및 관리 옵션을 구성합니다. 기본 설정을 변경할 필요가 없습니다.

Advanced 탭 구성#

이 탭을 사용하여 가상 머신 확장 또는 cloud-init을 통해 추가 구성, 에이전트, 스크립트 또는 애플리케이션을 추가합니다. 기본 설정을 변경할 필요가 없습니다.

Tags 탭 구성#

이 탭을 사용하여 리소스를 분류할 수 있는 이름/값 쌍을 추가합니다. 기본 설정을 변경할 필요가 없습니다.

VM 검토 및 생성#

마지막 탭에서는 선택한 모든 옵션이 표시되며, 이전 단계에서의 선택을 검토하고 수정할 수 있습니다. Azure는 백그라운드에서 유효성 검사 테스트를 실행하며, 필요한 모든 설정을 제공한 경우 VM을 생성할 수 있습니다.

Create를 선택한 후, Azure가 SSH 키 쌍을 생성하도록 선택했다면 개인 SSH 키를 다운로드하라는 프롬프트가 나타납니다. VM에 SSH 접속하는 데 필요하므로 키를 다운로드하세요.

키를 다운로드한 후 배포가 시작됩니다.

배포 완료#

이 시점에서 Azure는 새 VM 배포를 시작합니다. 배포 프로세스는 완료까지 몇 분이 걸립니다. 완료되면 새 VM과 관련 리소스가 Azure 대시보드에 표시됩니다. Go to resource를 선택하여 VM의 대시보드를 방문합니다.

GitLab이 이제 배포되어 사용할 준비가 되었습니다. 그러나 그 전에 도메인 이름을 설정하고 GitLab이 이를 사용하도록 구성해야 합니다.

도메인 이름 설정#

VM에는 공개 IP 주소(기본적으로 정적)가 있지만, Azure를 사용하면 VM에 설명적인 DNS 이름을 할당할 수 있습니다:

1. VM 대시보드에서 DNS name 아래의 Configure를 선택합니다.
2. DNS name label 필드에 인스턴스의 설명적인 DNS 이름을 입력합니다(예: gitlab-prod). 이렇게 하면 VM에 gitlab-prod.eastus.cloudapp.azure.com으로 액세스할 수 있습니다.
3. Save를 선택합니다.

결국 대부분의 사용자는 자체 도메인 이름을 사용하고 싶어합니다. 이를 위해서는 도메인 등록 기관에서 Azure VM의 공개 IP 주소를 가리키는 DNS A 레코드를 추가해야 합니다. Azure DNS 또는 다른 등록 기관을 사용할 수 있습니다.

GitLab 외부 URL 변경#

GitLab은 구성 파일의 external_url을 사용하여 도메인 이름을 설정합니다. 이를 설정하지 않으면 Azure 친화적 이름으로 방문할 때 브라우저가 공개 IP로 리디렉션됩니다.

GitLab 외부 URL을 설정하려면:

1. VM 대시보드의 Settings > Connect로 이동하여 SSH를 통해 GitLab에 연결하고 지침을 따릅니다. VM 생성 시 지정한 사용자 이름과 SSH 키로 로그인해야 합니다. Azure VM 도메인 이름은 이전에 설정한 이름입니다. VM에 도메인 이름을 설정하지 않은 경우 대신 IP 주소를 사용할 수 있습니다.

   예시의 경우:

   ssh -i <private key path> gitlab-azure@gitlab-prod.eastus.cloudapp.azure.com
   

   [!note] 자격 증명을 재설정해야 하는 경우 Azure VM의 사용자에 대한 SSH 자격 증명 재설정 방법을 읽어보세요.

2. 편집기로 /etc/gitlab/gitlab.rb를 엽니다.

3. external_url을 찾아 자체 도메인 이름으로 교체합니다. 이 예시에서는 Azure가 설정한 기본 도메인 이름을 사용합니다. URL에 https를 사용하면 Let's Encrypt가 자동으로 활성화되고 HTTPS가 기본값으로 설정됩니다:

   external_url 'https://gitlab-prod.eastus.cloudapp.azure.com'
   

4. 다음 설정을 찾아 주석 처리하여 GitLab이 잘못된 인증서를 사용하지 않도록 합니다:

   # nginx['redirect_http_to_https'] = true
   # nginx['ssl_certificate'] = "/etc/gitlab/ssl/server.crt"
   # nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/server.key"
   

5. 변경 사항을 적용하기 위해 GitLab을 재구성합니다. /etc/gitlab/gitlab.rb를 변경할 때마다 다음 명령을 실행합니다:

   sudo gitlab-ctl reconfigure
   

6. 재부팅 후 도메인 이름이 재설정되지 않도록 Bitnami가 사용하는 유틸리티를 이름 변경합니다:

   sudo mv /opt/bitnami/apps/gitlab/bnconfig /opt/bitnami/apps/gitlab/bnconfig.bak
   

이제 새 외부 URL로 브라우저에서 GitLab을 방문할 수 있습니다.

처음으로 GitLab 방문#

앞서 설정한 도메인 이름을 사용하여 브라우저에서 새 GitLab 인스턴스를 방문합니다. 이 예시에서는 https://gitlab-prod.eastus.cloudapp.azure.com입니다.

처음 나타나는 것은 로그인 페이지입니다. GitLab은 기본적으로 관리자 사용자를 생성합니다. 자격 증명은:

• 사용자 이름: root
• 비밀번호: 비밀번호는 자동으로 생성되며, 찾는 방법이 두 가지입니다.

로그인 후 즉시 비밀번호를 변경하세요.

GitLab 인스턴스 유지 관리#

GitLab 환경을 최신 상태로 유지하는 것이 중요합니다. GitLab 팀은 지속적으로 개선을 하며 보안상의 이유로 업데이트가 필요할 수 있습니다. GitLab을 업데이트해야 할 때마다 이 섹션의 정보를 사용하세요.

현재 버전 확인#

현재 실행 중인 GitLab 버전을 확인하려면:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 Overview > Dashboard를 선택합니다.
3. Components 표에서 버전을 확인합니다.

하나 이상의 보안 수정이 포함된 최신 GitLab 버전이 있는 경우, GitLab에서 업데이트를 권장하는 Update asap 알림 메시지가 표시됩니다.

GitLab 업데이트#

GitLab을 최신 버전으로 업데이트하려면:

1. SSH를 통해 VM에 연결합니다.

2. GitLab을 업데이트합니다:

   sudo apt update
   sudo apt install gitlab-ee
   

   이 명령은 GitLab 및 관련 구성 요소를 최신 버전으로 업데이트하며 완료까지 시간이 걸릴 수 있습니다. 이 과정에서 터미널에 다양한 업데이트 작업이 완료되는 내용이 표시됩니다.

   [!note] E: The repository 'https://packages.gitlab.com/gitlab/gitlab-ee/debian buster InRelease' is not signed.와 같은 오류가 발생하면 문제 해결 섹션을 참조하세요.

3. 업데이트 프로세스가 완료되면 다음과 같은 메시지가 나타납니다:

   Upgrade complete! If your GitLab server is misbehaving try running
   
      sudo gitlab-ctl restart
   
   before anything else.
   

브라우저에서 GitLab 인스턴스를 새로 고침하고 Admin 영역으로 이동합니다. 이제 GitLab 인스턴스가 최신 상태여야 합니다.

다음 단계 및 추가 구성#

기능적인 GitLab 인스턴스가 준비되었으므로 다음 단계를 따라 새 설치로 무엇을 더 할 수 있는지 알아보세요.

문제 해결#

이 섹션에서는 발생할 수 있는 일반적인 오류를 설명합니다.

GitLab 리포지터리의 GPG 키 업데이트#

Azure의 사전 구성된 GitLab 이미지(Bitnami 제공)는 2020년 4월에 지원 중단된 GPG 키를 사용합니다.

리포지터리를 업데이트하려고 하면 시스템이 다음 오류를 반환합니다:

[   21.023494] apt-setup[1198]: W: GPG error: https://packages.gitlab.com/gitlab/gitlab-ee/debian buster InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 3F01618A51312F3F
[   21.024033] apt-setup[1198]: E: The repository 'https://packages.gitlab.com/gitlab/gitlab-ee/debian buster InRelease' is not signed.

이를 수정하려면 새 GPG 키를 가져옵니다:

sudo apt install gpg-agent
sudo curl --fail --silent --show-error \
     --output /etc/apt/trusted.gpg.d/gitlab.asc \
     --url "https://gitlab-org.gitlab.io/omnibus-gitlab/gitlab_new_gpg.key"

이제 GitLab을 업데이트할 수 있습니다. 자세한 내용은 패키지 서명에 대해 읽어보세요.