GitLab을 통해 Google Kubernetes Engine(GKE)에서 호스팅되는 클러스터를 새로 만들거나 기존 클러스터를 연결할 수 있습니다.

기존 GKE 클러스터 연결#

이미 GKE 클러스터가 있고 이를 GitLab에 연결하려면 Kubernetes용 GitLab 에이전트를 사용합니다.

GitLab에서 새 GKE 클러스터 만들기#

GitLab이 프로비저닝하는 모든 GKE 클러스터는 VPC 네이티브입니다.

GitLab에서 새 GKE 클러스터를 만들려면 OpenTofu와 GitLab을 사용한 Infrastructure as Code를 사용합니다.

클러스터 인증서를 통해 GKE에서 새 클러스터 만들기#

사전 요구사항:

• 접근 권한이 설정된 Google Cloud 결제 계정이 필요합니다.
• Kubernetes Engine API 및 관련 서비스가 활성화되어 있어야 합니다. 일반적으로 즉시 동작하지만 프로젝트를 만든 후 최대 10분이 걸릴 수 있습니다. 자세한 내용은 Kubernetes Engine 문서의 "시작하기 전에" 섹션을 참고합니다.

다음 사항에 유의합니다:

• GitLab 인스턴스 수준에서 Google 인증 통합이 활성화되어 있어야 합니다. 활성화되어 있지 않다면 GitLab 관리자에게 활성화를 요청합니다. GitLab.com에서는 이미 활성화되어 있습니다.
• GitLab이 만든 모든 GKE 클러스터는 RBAC이 활성화되어 있습니다. 자세한 내용은 RBAC 섹션을 참고합니다.
• 클러스터의 Pod 주소 IP 범위는 일반적인 /14가 아닌 /16으로 설정됩니다. /16은 CIDR 표기법입니다.
• GitLab이 초기 서비스 계정을 설정하려면 클러스터에 기본 인증이 활성화되어 있고 클라이언트 인증서가 발급되어 있어야 합니다. GitLab 11.10 이상에서는 클러스터 생성 과정에서 기본 인증이 활성화되고 클라이언트 인증서가 발급된 클러스터를 만들도록 GKE에 명시적으로 요청합니다.

클러스터 인증서를 통해 프로젝트, 그룹, 인스턴스에 새 Kubernetes 클러스터를 만들려면 다음 단계를 수행합니다:

1. 다음 위치로 이동합니다:
   • 프로젝트 수준 클러스터는 프로젝트의 [cloud-gear] Operate > Kubernetes clusters 페이지.
   • 그룹 수준 클러스터는 그룹의 [cloud-gear] Kubernetes 페이지.
   • 인스턴스 수준 클러스터는 Admin 영역의 Kubernetes 페이지.
2. Integrate with a cluster certificate를 선택합니다.
3. Create new cluster 탭에서 Google GKE를 선택합니다.
4. 아직 Google 계정을 연결하지 않았다면 Sign in with Google 버튼을 선택하여 연결합니다.
5. 클러스터 설정을 선택합니다:
   • Kubernetes cluster name - 클러스터에 지정할 이름.
   • Environment scope - 이 클러스터에 연결된 환경.
   • Google Cloud Platform project - Kubernetes 클러스터를 호스팅하기 위해 GCP 콘솔에서 만든 프로젝트를 선택합니다. 자세한 내용은 프로젝트 만들기 및 관리를 참고합니다.
   • Zone - 클러스터를 만들 리전 영역을 선택합니다.
   • Number of nodes - 클러스터에 둘 노드 수를 입력합니다.
   • Machine type - 클러스터의 기반이 될 가상 머신 인스턴스의 머신 유형.
   • Enable Cloud Run for Anthos - 이 클러스터에 Anthos용 Cloud Run을 사용하려면 선택합니다. 자세한 내용은 Anthos용 Cloud Run 섹션을 참고합니다.
   • GitLab-managed cluster - GitLab이 이 클러스터의 네임스페이스와 서비스 계정을 관리하도록 하려면 선택한 상태로 둡니다. 자세한 내용은 관리형 클러스터 섹션을 참고합니다.
6. 마지막으로 Create Kubernetes cluster 버튼을 선택합니다.

몇 분이 지나면 클러스터가 준비됩니다.

Anthos용 Cloud Run#

클러스터를 만든 후 Knative와 Istio를 따로 설치하는 대신 Anthos용 Cloud Run을 사용하도록 선택할 수 있습니다. 이 경우 Cloud Run(Knative), Istio, HTTP 부하 분산이 처음부터 클러스터에 활성화되며, 이후 설치하거나 제거할 수 없습니다.