프로젝트를 클러스터의 관리 프로젝트로 지정할 수 있습니다.

관리 프로젝트를 사용하여 Kubernetes cluster-admin 권한으로 배포 잡을 실행할 수 있습니다.

이는 다음과 같은 경우에 유용할 수 있습니다:

• 클러스터에 클러스터 전체 애플리케이션을 설치하는 파이프라인 생성. 자세한 내용은 관리 프로젝트 템플릿을 참조하세요.
• cluster-admin 권한이 필요한 모든 잡.

권한#

관리 프로젝트만 cluster-admin 권한을 받습니다. 다른 모든 프로젝트는 계속 네임스페이스 범위의 edit 수준 권한을 받습니다.

관리 프로젝트는 다음으로 제한됩니다:

• 프로젝트 수준 클러스터의 경우, 관리 프로젝트는 클러스터 프로젝트와 동일한 네임스페이스(또는 하위 항목)에 있어야 합니다.
• 그룹 수준 클러스터의 경우, 관리 프로젝트는 클러스터 그룹과 동일한 그룹(또는 하위 항목)에 있어야 합니다.
• 인스턴스 수준 클러스터의 경우, 이러한 제한이 없습니다.

클러스터 관리 프로젝트 생성 및 구성 방법#

클러스터 관리 프로젝트를 사용하여 클러스터를 관리하려면:

1. 클러스터의 클러스터 관리 프로젝트로 사용할 새 프로젝트를 생성합니다.
2. 클러스터를 관리 프로젝트와 연결합니다.
3. 클러스터의 파이프라인을 구성합니다.
4. 환경 범위를 설정합니다.

클러스터 관리 프로젝트를 클러스터와 연결#

사전 요구 사항:

• 인스턴스 클러스터를 연결하려면 관리자 접근 권한이 필요합니다.

클러스터 관리 프로젝트를 클러스터와 연결하려면:

1. 적절한 구성 페이지로 이동합니다. 다음에 해당하는 경우:
   • 프로젝트 수준 클러스터의 경우, 프로젝트의 Operate > Kubernetes clusters 페이지로 이동합니다.
   • 그룹 수준 클러스터의 경우, 그룹의 Kubernetes 페이지로 이동합니다.
   • 인스턴스 수준 클러스터의 경우:
     1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
     2. Kubernetes를 선택합니다.
2. Advanced settings를 펼칩니다.
3. Cluster management project 드롭다운 목록에서 이전 단계에서 생성한 클러스터 관리 프로젝트를 선택합니다.

파이프라인 구성#

프로젝트를 클러스터의 관리 프로젝트로 지정한 후, 해당 프로젝트에 .gitlab-ci.yml 파일을 추가합니다. 예를 들어:

configure cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: production

환경 범위 설정#

환경 범위는 여러 클러스터를 동일한 관리 프로젝트에 연결할 때 사용할 수 있습니다.

각 범위는 관리 프로젝트에 대해 단일 클러스터에서만 사용할 수 있습니다.

예를 들어, 다음 Kubernetes 클러스터는 관리 프로젝트와 연결되어 있습니다:

.gitlab-ci.yml 파일에 설정된 환경은 Development, Staging, Production 클러스터에 배포됩니다.

stages:
  - deploy

configure development cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: development

configure staging cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: staging

configure production cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: production