클러스터 애플리케이션 관리

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

GitLab은 클러스터 관리 프로젝트 템플릿을 제공합니다. 이 템플릿을 사용하여 프로젝트를 생성할 수 있습니다. 해당 프로젝트에는 GitLab과 통합되고 GitLab 기능을 확장하는 클러스터 애플리케이션이 포함되어 있습니다. 프로젝트 안에 표시된 패턴을 사용하여 사용자 지정 클러스터 애플리케이션을 확장할 수 있습니다.

참고: 프로젝트 템플릿은 수정 없이 GitLab.com에서 작동합니다. Self-managed 인스턴스의 경우 .gitlab-ci.yml 파일을 수정해어해 합니다.

에이전트 및 매니페스트용 하나의 프로젝트 사용

GitLab과 클러스터를 연결하기 위해 아직 에이전트를 사용하지 않았다면 다음을 수행합니다:

  1. 클러스터 관리 프로젝트 템플릿을 사용하여 프로젝트 생성.
  2. 프로젝트를 에이전트에 맞게 구성합니다.
  3. 프로젝트의 설정에서 $KUBE_CONTEXT라는 환경 변수를 만들고 값을 path/to/agent-configuration-project:your-agent-name로 설정합니다.
  4. 필요에 따라 파일을 구성합니다.

에이전트 및 매니페스트용 별도의 프로젝트 사용

이미 에이전트를 구성하고 GitLab과 클러스터를 연결했다면 다음을 수행합니다:

  1. 클러스터 관리 프로젝트 템플릿을 사용하여 프로젝트 생성.
  2. 에이전트를 구성한 프로젝트에서, 에이전트에 새 프로젝트에 대한 액세스 권한 부여합니다.
  3. 새 프로젝트에서, $KUBE_CONTEXT라는 환경 변수를 만들고 값을 path/to/agent-configuration-project:your-agent-name로 설정합니다.
  4. 새 프로젝트에서 파일을 구성합니다.

클러스터 관리 프로젝트 템플릿을 기반으로 프로젝트 생성

클러스터 관리 프로젝트 템플릿에서 프로젝트를 생성하려면:

  1. 왼쪽 사이드바에서 상단에 만들기() 및 새 프로젝트/저장소를 선택합니다.
  2. 템플릿에서 만들기를 선택합니다.
  3. 템플릿 목록에서 GitLab 클러스터 관리 옆의 템플릿 사용을 선택합니다.
  4. 프로젝트 세부 정보를 입력합니다.
  5. 프로젝트 만들기를 선택합니다.
  6. 새 프로젝트에서 파일을 구성합니다.

프로젝트 구성

클러스터 관리 템플릿을 사용하여 프로젝트를 생성한 후 다음을 구성할 수 있습니다:

  • .gitlab-ci.yml 파일.
  • 메인 helmfile.yml 파일(#the-main-helmfileyml-file).
  • 내장된 애플리케이션을 가진 디렉터리(#built-in-applications).

.gitlab-ci.yml 파일

.gitlab-ci.yml 파일은:

  • Helm 버전 3에서 실행되도록합니다.
  • 프로젝트에서 활성화된 애플리케이션을 배포합니다.

파이프라인 정의를 편집하거나 확장할 수 있습니다.

파이프라인에서 사용되는 기본 이미지는 cluster-applications 프로젝트에 의해 빌드됩니다. 이 이미지에는 Helm v3 릴리즈를 지원하기 위한 일련의 Bash 유틸리티 스크립트가 포함되어 있습니다.

Self-managed 인스턴스의 경우, .gitlab-ci.yml 파일을 수정해야합니다. 특히, include가 GitLab.com 프로젝트를 참조하기 때문에 Self-managed 인스턴스에서는 Automatic package upgrades로 시작하는 섹션이 작동하지 않습니다. 이 주석 아래의 모든 내용을 제거하면 파이프라인이 성공합니다.

메인 helmfile.yml 파일

이 템플릿에는 Helm v3로 클러스터 애플리케이션을 관리할 수 있는 Helmfile이 포함되어 있습니다.

이 파일에는 각 앱에 대한 다른 Helm 파일 경로가 포함되어 있습니다. 기본적으로 모두 주석 처리되어 있으므로, 사용하려는 앱에 대한 경로의 주석 처리를 제거해야합니다.

이러한 하위 경로의 각 helmfile.yaml는 기본적으로 installed: true 특성을 가지고 있습니다. 이는 클러스터 및 Helm 릴리스의 상태에 따라, Helmfile이 파이프라인 실행마다 앱을 설치하거나 업데이트를 시도합니다. 이 특성을 installed: false로 변경하면 Helmfile은 클러스터에서이 앱을 제거하려고 시도합니다. Helmfile이 작동하는 방법에 대해 자세히 읽으십시오.

내장된 애플리케이션

이 템플릿에는 템플릿 내 각 애플리케이션에 대한 helmfile.yaml가 구성된 applications 디렉토리가 포함되어 있습니다.

내장 지원 애플리케이션은 다음과 같습니다:

각 애플리케이션에는 applications/{app}/values.yaml 파일이 있습니다. GitLab Runner의 경우, 파일은 applications/{app}/values.yaml.gotmpl입니다.

이 파일에서 앱의 Helm 차트에 대한 기본 값을 정의할 수 있습니다. 일부 앱은 이미 기본값이 정의되어 있습니다.