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 포털에서 다음 옵션 중 하나를 선택합니다.
   • 처음부터 VM을 생성하려면 Create를 선택합니다.
   • 사전 구성된 옵션으로 시작하려면 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에 연결할 때 사용하는 사용자이며, 기본적으로 root 액세스 권한을 가집니다.
9. 직접 SSH 키를 제공할지 Azure가 생성하도록 할지 결정합니다. SSH 공개 키 설정 방법에 대한 자세한 내용은 SSH를 참고합니다.

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

Disks 탭 구성#

디스크의 경우:

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

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

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

Networking 탭 구성#

이 탭을 사용해 네트워크 인터페이스 카드(NIC) 설정을 구성함으로써 가상 머신의 네트워크 연결을 정의합니다. 기본 설정을 그대로 두어도 됩니다.

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

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

Management 탭 구성#

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

Advanced 탭 구성#

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

Tags 탭 구성#

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

VM 검토 및 생성#

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

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

키를 다운로드하면 배포가 시작됩니다.

배포 완료#

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

이제 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을 업데이트 할 수 있습니다. 자세한 내용은 패키지 서명을 참고합니다.