공식 Linux 패키지를 사용하여 Google Cloud Platform(GCP)에 GitLab을 설치할 수 있습니다. 필요에 맞게 사용자 정의해야 합니다.

사전 요구 사항#

GCP에 GitLab을 설치하기 위한 두 가지 사전 요구 사항이 있습니다:

1. Google 계정이 있어야 합니다.
2. GCP 프로그램에 가입해야 합니다. 처음이라면 Google이 60일 동안 사용할 수 있는 무료 크레딧 $300을 제공합니다.

이 두 단계를 수행한 후 VM을 생성할 수 있습니다.

VM 생성 {#creating-the-vm}#

GCP에 GitLab을 배포하려면 가상 머신을 생성해야 합니다:

1. https://console.cloud.google.com/compute/instances로 이동하여 Google 자격 증명으로 로그인합니다.

2. Create를 선택합니다.

   

3. 다음 페이지에서 VM 유형과 예상 비용을 선택할 수 있습니다. 인스턴스 이름, 원하는 데이터 센터, 머신 유형을 입력합니다. 다양한 사용자 기반 크기에 대한 하드웨어 요구 사항을 참고하세요.

   

4. 크기, 유형, 원하는 운영 체제를 선택하려면 Boot disk 아래에서 Change를 선택합니다. 완료되면 Select를 선택합니다.

5. 유료 라이선스에 필요합니다. Labels 아래에서 GitLab 라이선스를 조달한 방법에 따라 리소스 레이블을 추가합니다:

   • Google Cloud Marketplace 조달의 경우 추가:
     • Key: goog-partner-solution
     • Value: isol_plb32_0014m00001h35gdqaq_i4j66u754ivftu3n2bb3vyv7fek76fjo
   • 비마켓플레이스 조달의 경우 추가:
     • Key: goog-partner-solution
     • Value: isol_psn_0014m00001h35gdqaq_gitlab

   이 레이블은 파트너십 계약에 따라 리소스를 Google Cloud에서 GitLab 설치와 관련된 것으로 태그 지정합니다. 리소스 레이블에 대한 자세한 내용은 리소스 레이블 지정에 관한 Google Cloud 문서를 참조하세요.

   [!note] Terraform을 사용하여 적절한 레이블로 인프라 생성을 자동화할 수도 있습니다. 참조는 Google Cloud에서 GitLab 설치 Terraform 코드를 참조하세요.

6. HTTP 및 HTTPS 트래픽을 허용하고 Create를 선택합니다. 몇 초 만에 프로세스가 완료됩니다.

GitLab 설치#

몇 초 후 인스턴스가 생성되어 로그인할 수 있습니다. 다음 단계는 인스턴스에 GitLab을 설치하는 것입니다.

1. 이후 단계에서 필요하므로 인스턴스의 외부 IP 주소를 메모합니다.

2. 연결 열 아래에서 SSH를 선택하여 인스턴스에 연결합니다.

3. 새 창이 나타나며 인스턴스에 로그인됩니다.

   

4. 그런 다음 선택한 운영 체제에 대한 GitLab 설치 지침을 https://about.gitlab.com/install/에서 따르세요. 호스트명으로 이전에 메모한 외부 IP 주소를 사용할 수 있습니다.

5. 축하합니다! GitLab이 이제 설치되었으며 브라우저를 통해 액세스할 수 있습니다. 설치를 완료하려면 브라우저에서 URL을 열고 초기 관리자 비밀번호를 제공합니다. 이 계정의 사용자 이름은 root입니다.

   

다음 단계#

GitLab을 처음 설치한 후 가장 중요한 다음 단계입니다.

정적 IP 할당#

기본적으로 Google은 인스턴스에 임시 IP를 할당합니다. 도메인 이름을 사용하는 프로덕션 환경에서 GitLab을 사용한다면 정적 IP를 할당해야 합니다.

자세한 내용은 임시 외부 IP 주소 프로모션을 참조하세요.

도메인 이름 사용#

도메인 이름을 보유하고 있고 이전 단계에서 구성한 정적 IP를 가리키도록 DNS를 올바르게 설정한 경우 GitLab이 변경을 인식하도록 구성하는 방법입니다:

1. VM에 SSH 접속합니다. Google 콘솔에서 SSH를 선택하면 새 창이 팝업됩니다.

   

   나중에 SSH 키로 연결을 설정하고 싶을 수 있습니다.

2. 즐겨 쓰는 텍스트 편집기를 사용하여 Linux 패키지의 구성 파일을 편집합니다:

   sudo vim /etc/gitlab/gitlab.rb
   

3. external_url 값을 GitLab에 사용하려는 도메인 이름으로 https 없이 설정합니다:

   external_url 'http://gitlab.example.com'
   

   다음 단계에서 HTTPS를 설정할 것이므로 지금 할 필요가 없습니다.

4. 변경 사항을 적용하려면 GitLab을 재구성합니다:

   sudo gitlab-ctl reconfigure
   

5. 이제 도메인 이름을 사용하여 GitLab을 방문할 수 있습니다.

도메인 이름으로 HTTPS 구성#

필수는 아니지만 TLS 인증서로 GitLab을 보호하는 것을 강력히 권장합니다.

이메일 SMTP 설정 구성#

이메일 SMTP 설정을 올바르게 구성하지 않으면 GitLab이 댓글, 비밀번호 변경과 같은 알림 이메일을 보낼 수 없습니다. 방법은 Linux 패키지 문서를 확인하세요.

추가 자료#

GitLab은 LDAP, SAML, Kerberos와 같은 다른 OAuth 공급자로 인증하도록 구성할 수 있습니다. 읽어볼 만한 문서들입니다:

• Linux 패키지 문서
• 통합 문서
• GitLab Pages 구성
• GitLab 컨테이너 레지스트리 구성