패키지 레지스트리의 Helm 차트

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated Status: Beta
caution
GitLab의 Helm 차트 레지스트리는 제한된 기능으로 인해 프로덕션 환경에서 사용할 준비가 되지 않았습니다. 이 에픽에서는 남은 작업 및 프로덕션 환경에 사용할 수 있도록 만드는 일정에 대해 자세히 설명하고 있습니다.

프로젝트의 패키지 레지스트리에 Helm 패키지를 게시하고 필요할 때마다 이를 의존성으로 사용하여 패키지를 설치합니다.

Helm 패키지 관리자 클라이언트가 사용하는 특정 API 엔드포인트에 대한 설명은 Helm API 문서를 참조하십시오.

Helm 패키지 빌드

다음과 같은 주제에 대해 Helm 문서에서 더 많이 알아보세요:

Helm 리포지터리에 인증

Helm 리포지터리에 인증하려면 다음 중 하나가 필요합니다:

패키지 게시

note
Helm 차트의 중복된 이름 또는 버전으로 게시할 수 있습니다. 중복이 있으면 GitLab은 항상 최신 버전의 차트를 반환합니다.

빌드가 완료되면 curl 또는 helm cm-push를 사용하여 원하는 채널로 차트를 업로드할 수 있습니다:

  • curl을 사용하는 경우: 

    curl --request POST \
     --form 'chart=@mychart-0.1.0.tgz' \
     --user <username>:<access_token> \
     https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/api/<channel>/charts
    • <username>: GitLab 사용자명 또는 배포 토큰 사용자명.
    • <access_token>: 개인 액세스 토큰 또는 배포 토큰.
    • <project_id>: 프로젝트 ID (예: 42) 또는 프로젝트의 URL 인코딩 경로(예: group%2Fproject).
    • <channel>: 채널 이름 (예: stable).

  • helm cm-push 플러그인을 사용하는 경우: 

    helm repo add --username <username> --password <access_token> project-1 https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/<channel>
helm cm-push mychart-0.1.0.tgz project-1
    • <username>: GitLab 사용자명 또는 배포 토큰 사용자명.
    • <access_token>: 개인 액세스 토큰 또는 배포 토큰.
    • <project_id>: 프로젝트 ID (예: 42).
    • <channel>: 채널 이름 (예: stable).

릴리스 채널

GitLab의 채널에 Helm 차트를 게시할 수 있습니다. 채널은 Helm 차트 리포지터리를 구분하는 데 사용할 수 있는 방법입니다. 예를 들어 stable 리포지터리를 추가할 수 있고 devel 차트는 격리될 수 있습니다.

CI/CD를 사용하여 Helm 패키지 게시

GitLab CI/CD를 통해 자동으로 Helm 패키지를 게시하려면 명령어에서 개인 액세스 토큰 대신 CI_JOB_TOKEN을 사용할 수 있습니다.

예를 들면: 

image: curlimages/curl:latest

stages:
  - upload

upload:
  stage: upload
  script:
    - 'curl --request POST --user gitlab-ci-token:$CI_JOB_TOKEN --form "chart=@mychart-0.1.0.tgz" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/helm/api/<channel>/charts"'
  • <username>: GitLab 사용자명 또는 배포 토큰 사용자명.
  • <access_token>: 개인 액세스 토큰 또는 배포 토큰.
  • <channel>: 채널 이름 (예: stable).

패키지 설치

note
패키지를 요청할 때 GitLab은 최근 1000개의 패키지만을 고려합니다. 각 패키지에 대해 최신 패키지 파일만 반환됩니다.

차트의 최신 버전을 설치하려면 다음 명령어를 사용하세요: 

helm repo add --username <username> --password <access_token> project-1 https://gitlab.example.com/api/v4/projects/<project_id>/packages/helm/<channel>
helm install my-release project-1/mychart
  • <username>: GitLab 사용자명 또는 배포 토큰 사용자명.
  • <access_token>: 개인 액세스 토큰 또는 배포 토큰.
  • <project_id>: 프로젝트 ID (예: 42).
  • <channel>: 채널 이름 (예: stable).

리포지터리가 이전에 추가되었으면 다음을 실행해야 할 수 있습니다: 

helm repo update

가장 최신으로 사용 가능한 차트로 Helm 클라이언트를 업데이트합니다.

자세한 정보는 Helm 사용을 참조하십시오.

문제 해결

패키지 레지스트리에 업로드한 후 차트가 보이지 않음

관련 오류를 확인하려면 Sidekiq 로그를 확인하십시오. Validation failed: Version is invalid이 표시되면 Chart.yaml 파일의 버전이 Helm 차트 버전 지정 사양을 따르지 않는다는 것을 의미합니다. 오류를 수정하려면 올바른 버전 구문을 사용하고 차트를 다시 업로드하십시오.

UI에서 패키지 처리 오류에 대한 더 나은 오류 메시지를 제공하는 지원은 이슈 330515에서 제안되었습니다.

helm push로 인해 오류 발생

Helm 3.7에서 helm-push 플러그인에 대한 호환성을 변경하는 중요 변경 사항이 소개되었습니다. Chart Museum 플러그인을 업데이트하여 helm cm-push를 사용할 수 있습니다.