Google Cloud Platform(GCP)에 GitLab 설치하기

Tier: Free, Premium, Ultimate Offering: Self-Managed

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

note
프로덕션 환경에 적합한 GitLab을 Google Kubernetes Engine에 배포하려면, Google Cloud Platform의 Click to Deploy 단계를 따를 수 있습니다. 이것은 GCP VM을 사용하는 대안이며 Cloud 원생적 GitLab Helm 차트를 사용합니다.

전제조건

GCP에 GitLab을 설치하려면 두 가지 전제조건이 있습니다:

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

위 두 단계를 완료한 후, 가상 머신을 생성할 수 있습니다.

가상 머신 생성

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

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

    Search GitLab을 클릭해

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

    Compute Engine에서 시작

  4. 크기, 유형, 원하는 운영 체제의 선택을 위해 부트 디스크 아래의 변경을 선택하세요. 작업을 마치면 선택을 선택하세요.

  5. 마지막 단계로 HTTP 및 HTTPS 트래픽을 허용하고 생성을 선택하세요. 프로세스는 몇 초 안에 완료됩니다.

GitLab 설치

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

배포 설정

  1. 나중에 필요하게 될 외부 IP 주소를 메모해 두세요.
  2. 연결 열 아래에서 SSH를 선택하여 인스턴스에 연결하세요.
  3. 새 창이 열리면 인스턴스에 로그인한 것입니다.

    GitLab 처음 로그인

  4. 다음으로, 선택한 운영 체제에 따라 GitLab 설치 지침을 따르세요. 호스트 이름으로 메모한 외부 IP 주소를 사용할 수 있습니다.

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

    GitLab 처음 로그인

다음 단계

첫 번째로 GitLab을 설치한 후 수행해야 할 가장 중요한 단계입니다.

정적 IP 할당

기본적으로 Google은 인스턴스에 임시 IP를 할당합니다. 프로덕션 환경에서 GitLab을 사용하는 경우 정적 IP를 할당하고 이전 단계에서 구성한 정적 IP를 가리키는 DNS를 올바르게 설정하는 것이 강력히 권장됩니다.

Google의 문서가 어떻게 임시 IP 주소를 변환하는지 보세요.

도메인 이름 사용

보유한 도메인 이름이 있고 이전 단계에서 구성한 정적 IP를 가리키도록 DNS를 올바르게 설정한 경우, 다음과 같이 GitLab을 변경할 수 있습니다:

  1. VM에 SSH합니다. Google 콘솔에서 SSH를 선택하여 새 창이 열립니다.

    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 구성

필요는 없지만 GitLab을 TLS 인증서로 보안하는 것이 강력히 권장됩니다.

이메일 SMTP 설정 구성

이메일 SMTP 설정을 올바르게 구성하지 않으면 GitLab이 알림 이메일(댓글, 암호 변경 등)을 보낼 수 없습니다. Linux 패키지 문서에서 구성하는 방법을 확인하세요.

추가 자료

GitLab은 LDAP, SAML, Kerberos와 같은 다른 OAuth 공급자로 인증을 구성할 수 있습니다. 다음 자료를 확인할 수도 있습니다: