Google Cloud Platform에 GitLab 설치하기
Google Cloud Platform (GCP)에서 공식 Linux 패키지를 사용하여 GitLab을 설치할 수 있습니다. 필요에 맞게 사용자 정의해야 합니다.
Click to Deploy 단계를 따를 수 있습니다. 이는 GCP VM을 사용하는 대안이며 클라우드 네이티브 GitLab Helm 차트를 사용합니다.전제 조건
GCP에 GitLab을 설치하려면 두 가지 전제 조건이 있습니다.
- Google 계정이 있어야 합니다.
- GCP 프로그램에 가입해야 합니다. 처음이라면 Google에서 60일 동안 무료로 $300 크레딧을 제공합니다.
이 두 단계를 수행한 후에 가상 머신을 생성할 수 있습니다.
가상 머신 생성
GCP에서 GitLab을 배포하려면 가상 머신을 생성해야 합니다.
- https://console.cloud.google.com/compute/instances로 이동하고 Google 자격 증명으로 로그인합니다.
-
만들기를 선택합니다.
-
다음 페이지에서 VM 유형과 예상 비용을 선택할 수 있습니다. 인스턴스 이름, 원하는 데이터 센터, 및 머신 유형을 제공합니다. 다양한 사용자 기반 크기에 대한 하드웨어 요구 사항을 참고하세요.
-
운영 체제를 선택하려면
부트 디스크에서 변경을 선택합니다. 완료하면 선택을 선택합니다. -
크기, 유형, 및 원하는 운영 체제를 선택하기 위해 부트 디스크 아래의 변경을 선택합니다.
- 마지막 단계로 HTTP 및 HTTPS 트래픽을 허용한 다음 만들기를 선택합니다. 과정은 몇 초 안에 완료됩니다.
GitLab 설치
몇 초 후에 인스턴스가 생성되어 로그인할 수 있는 상태가 됩니다. 다음 단계는 인스턴스에 GitLab을 설치하는 것입니다.
- 인스턴스의 외부 IP 주소를 적어두십시오. 이 주소는 나중의 단계에서 필요합니다.
- 연결 열 아래의 SSH를 선택하여 인스턴스에 연결합니다.
-
새 창이 열리면 해당 인스턴스에 로그인합니다.
-
다음으로 선택한 운영 체제에 따라 GitLab을 설치하는 지침을 따라야 합니다. 이때 앞에서 적어둔 외부 IP 주소를 호스트 이름으로 사용할 수 있습니다.
-
축하합니다! GitLab을 설치했고 이제 브라우저를 통해 액세스할 수 있습니다. 설치를 마무리하려면 URL을 열고 초기 관리자 암호를 제공하세요. 이 계정의 사용자 이름은
root입니다.
다음 단계
첫 번째로 GitLab을 설치한 후에 수행해야 할 가장 중요한 다음 단계입니다.
정적 IP 할당
기본적으로 Google은 인스턴스에 일회용 IP를 할당합니다. GitLab을 프로덕션 환경에서 사용하는 경우 정적 IP를 할당하고 이전 단계에서 구성한 정적 IP를 가리키도록 DNS를 올바르게 설정하는 것이 강력히 권장됩니다.
Google의 문서에서 일회용 IP 주소가 영구적인 IP 주소로 할당되도록 설정하는 방법을 읽어보세요.
도메인 이름 사용
도메인 이름이 있고 이전 단계에서 구성한 정적 IP를 가리키도록 DNS를 올바르게 설정한 경우, GitLab이 이러한 변경 사항을 인식하도록 구성하는 방법은 다음과 같습니다.
-
VM에 SSH로 연결합니다. Google 콘솔에서 SSH를 선택하면 새 창이 열립니다.
나중에 SSH 키로 연결하는 설정을 하려는 경우를 위해 이후에 셋업하고 싶을 것입니다.
-
좋아하는 텍스트 편집기를 사용하여 Linux 패키지의 구성 파일을 편집합니다.
sudo vim /etc/gitlab/gitlab.rb -
external_url값을https없이 GitLab이 가져야 하는 도메인 이름으로 설정합니다.external_url 'http://gitlab.example.com'HTTPS를 설정할 예정이기 때문에 지금은 이 작업을 할 필요가 없습니다.
-
변경 사항이 적용되도록 GitLab을 다시 구성합니다.
sudo gitlab-ctl reconfigure -
이제 도메인 이름을 사용하여 GitLab에 액세스할 수 있습니다.
도메인 이름으로 HTTPS 구성
필수는 아니지만 GitLab을 TLS 인증서로 안전하게 보호하는 것이 강력히 권장됩니다.
이메일 SMTP 설정 구성
이메일 SMTP 설정을 올바르게 구성하지 않으면 GitLab이 알림 이메일(댓글, 암호 변경 등)을 보낼 수 없습니다. Linux 패키지 문서를 확인하여 설정하는 방법을 알아보세요.
추가 자료
GitLab을 다른 OAuth 제공자(LDAP, SAML, Kerberos 등)와 인증하도록 구성할 수 있습니다. 다음 문서들을 읽어보세요:
도움말