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

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

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

note
Google Kubernetes Engine에서 프로덕션에 준비된 GitLab을 배포하려면 Google Cloud Platform의 Click to Deploy 단계를 따를 수 있습니다. 이것은 GCP VM을 사용하는 대안이며 Cloud native GitLab Helm chart를 사용합니다.

Prerequisites

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

  1. 구글 계정이 있어야 합니다.
  2. GCP 프로그램에 가입해야 합니다. 처음이라면 Google은 60일 동안 사용할 수 있는 $300 크레딧을 무료로 제공합니다.(여기에서 확인하세요)

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

VM 생성

GCP에서 GitLab을 배포하려면 가상 머신을 만들어야 합니다.

  1. https://console.cloud.google.com/compute/instances로 이동하고 구글 자격 증명으로 로그인합니다.
  2. 만들기를 선택합니다.

    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를 도메인 이름으로 사용하는 것이 강력하게 권장됩니다.

구글의 문서인 일시적 IP 주소 확보를 읽어보세요.

도메인 이름 사용

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

  1. VM에 SSH. Google 콘솔에서 SSH를 선택하면 새 창이 나타납니다.

    SSH 버튼

    나중에 SSH 키로 연결을 설정하는 것이 좋습니다.

  2. 좋아하는 텍스트 편집기로 Linux 패키지의 구성 파일을 편집하세요:

    sudo vim /etc/gitlab/gitlab.rb
    
  3. external_url 값을 https 없이 GitLab이 가질 도메인 이름으로 설정하세요:

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

    우리는 다음에 HTTPS를 설정할 것이므로 지금은 이 작업을 할 필요가 없습니다.

  4. 변경 사항이 적용되도록 GitLab을 다시 구성하세요:

    sudo gitlab-ctl reconfigure
    
  5. 이제 도메인 이름을 사용하여 GitLab에 방문할 수 있습니다.

도메인 이름으로 HTTPS 구성

GitLab을 안전하게 보호하기 위해 TLS 인증서를 설정하는 것이 필수는 아니지만 강력히 권장됩니다.

이메일 SMTP 설정 구성

이메일 SMTP 설정을 올바르게 구성해야만 GitLab이 댓글 및 비밀번호 변경과 같은 알림 이메일을 보낼 수 있습니다. 이를 위한 방법은 리눅스 패키지 문서를 확인하세요.

추가 자료

GitLab은 LDAP, SAML 및 Kerberos와 같은 다른 OAuth 제공업체로 인증을 구성할 수 있습니다. 다음은 읽어볼만한 몇 가지 문서입니다: