Перейти к содержанию

Реестр пакетов Helm

Подготовка

Для аутентификаци в реестре вам потребуется создать транспортный токен в вашем профиле GitFlic, сохраните его для дальнейшей работы.

В документации ниже встречается атрибут <домен_gitflic>. На его место необходимо указать домен, в зависимости от версии:

  • для SaaS версии registry.gitflic.ru

  • для Self-Hosted localhost:8080

Домен и порт для self-hosted версии может отличаться.

Атрибут Описание
домен_gitflic registry.gitflic.ru или ваш, в случае Self-Hosted версии
username Логин/алиас пользователя
token Транспортный токен
ownerAlias Псевдоним владельца проекта
projectAlias Псевдоним проекта
companyAlias Псевдоним компании
my_chart Псевдоним чарта

Установка пакетного менеджера

Для работы с Helm пакетами потребуется утилита Helm — это пакетный менеджер, который позволяет управлять чартами и упрощает развертывание приложений в кластере Kubernetes.

1. Воспользуйтесь одной из следующих команд для установки на вашу ОС

  • Linux
curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
  • MacOS (через Homebrew)
brew install helm
  • Windows (через Chocolatey)
choco install kubernetes-helm

2. Убедитесь в успешной установке:

helm version

Создание Helm чарта

1. Для создания нового чарта воспользуйтесь командой:

helm create <my_chart>

Данная команда создаст каталог <my_chart> с базовой структурой Helm чарта.

2. Сохраните чарт в архив .tgz

helm package <my_chart>

После выполнения данной команды ваш чарт будет сохранен в архив <your_chart>-0.1.0.tgz.

Изменить версию пакета вы можете в файле Chart.yaml в каталоге вашего чарта.

Аутентификация в реестре

Перед загрузкой чарта выполните авторизацию в GitFlic:

helm registry login <домен_gitflic> --username <username> --password <token>

В случае успешной авторизации вы должны получить сообщение Login Succeeded

Публикация Helm чарта

GitFlic поддерживает хранение Helm чартов в OCI-репозитории.

Чтобы сохранить чарт в GitFlic, используйте следующие команды:

  • Публикация в реестр репозитория
helm push <my_chart>-0.1.0.tgz oci://<домен_gitflic>/helm/project/<ownerAlias>/<projectAlias>
  • Публикация в реестр компании
helm push <my_chart>-0.1.0.tgz oci://<домен_gitflic>/helm/company/<companyAlias>
  • Публикация в реестр инстанса
helm push <my_chart>-0.1.0.tgz oci://<домен_gitflic>/helm/

Загрузка Helm чарта

Чтобы загрузить чарт из GitFlic, используйте следующие команды:

  • Загрузка из реестра репозитория
helm pull oci://<домен_gitflic>/helm/project/<ownerAlias>/<projectAlias>/<my_chart>
  • Загрузка из реестра компании
helm pull oci://<домен_gitflic>/helm/company/<companyAlias>/<my_chart>
  • Загрузка из реестра инстанса
helm pull oci://<домен_gitflic>/helm/<my_chart>

Управление Helm чартами

Для управления чартами используйте следующие команды:

  • Развернуть чарт в кластере
helm install <my_chart> --generate-name
  • Посмотреть список установленных чартов
helm list
  • Удалить установленный чарт
helm uninstall <my_chart>