다중 Kubernetes 클러스터를 위한 Auto DevOps

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

Auto DevOps를 사용할 때 여러 Kubernetes 클러스터에 서로 다른 환경을 배포할 수 있습니다.

Auto DevOps에서 사용하는 Deploy Job template은 세 가지 환경 이름을 정의합니다:

  • review/ (각 환경은 review/로 시작합니다)
  • staging
  • production

이러한 환경은 Auto Deploy를 사용하여 작업에 연결되므로 각각 다른 배포 도메인을 가져야 합니다. 세 환경마다 별도의 KUBE_CONTEXT 및 KUBE_INGRESS_BASE_DOMAIN 변수를 정의해야 합니다.

다른 클러스터에 배포하기

여러 Kubernetes 클러스터에 환경을 배포하려면:

  1. Kubernetes 클러스터를 생성합니다.
  2. 프로젝트에 클러스터를 연결합니다:
    1. 각 클러스터에 GitLab 에이전트를 설치합니다.
    2. 각 에이전트를 프로젝트에 액세스하도록 구성합니다.
  3. 각 클러스터에 NGINX Ingress Controller를 설치합니다. 다음 단계에 대비하여 IP 주소와 Kubernetes 네임스페이스를 저장합니다.
  4. Auto DevOps CI/CD 파이프라인 변수를 구성합니다.
    • 각 환경에 대한 KUBE_CONTEXT 변수를 설정합니다. 값은 관련 클러스터의 에이전트를 가리켜야 합니다.
    • KUBE_INGRESS_BASE_DOMAIN을 설정합니다. 각 환경에 대해 베이스 도메인을 해당 클러스터의 Ingress로 지정해야 합니다.
    • 값을 Kubernetes 네임스페이스에 맞추어 KUBE_NAMESPACE 변수를 추가합니다. 이 변수를 여러 환경에 범위 지정할 수 있습니다.

서비스 중단 예정인 인증서 기반 클러스터의 경우:

  1. 왼쪽 사이드바에서 프로젝트를 선택하고 운영 > Kubernetes 클러스터를 선택합니다.
  2. 각 클러스터의 환경 범위를 설정합니다.
  3. 각 클러스터에 대해 Ingress IP 주소를 기반으로 도메인 추가합니다.
note
활성 Kubernetes 클러스터 확인 시 클러스터 환경 범위가 적용되지 않음 (영어). Auto DevOps에서 다중 클러스터 설정이 작동하려면 클러스터 환경 범위를 *로 설정한 폴백 클러스터를 생성해야 합니다. 이미 추가한 클러스터 중 하나를 폴백 클러스터로 설정할 수 있습니다.

예시 설정

클러스터 이름 클러스터 환경 범위 KUBE_INGRESS_BASE_DOMAIN 값 KUBE CONTEXT 값 변수 환경 범위 설명
review review/* review.example.com path/to/project:review-agent review/* 모든 리뷰 앱을 실행하는 리뷰 클러스터입니다.
staging staging staging.example.com path/to/project:staging-agent staging 선택 사항입니다. 스테이징 환경의 배포를 실행하는 스테이징 클러스터입니다. 먼저 활성화해야 합니다.
production production example.com path/to/project:production-agent production 프로덕션 환경의 배포를 실행하는 프로덕션 클러스터입니다. 점진적 배포를 사용할 수 있습니다.

설정 테스트

구성을 완료한 후에는 Merge Request을 생성하여 설정을 테스트합니다. Kubernetes 클러스터의 review/* 환경 범위에 애플리케이션이 Review App으로 배포되었는지 확인하세요. 마찬가지로 다른 환경도 확인합니다.