VK Dev Platform logo
Помощь
Обновлена 30 июля 2024 г. в 16:58

Управление шаблонами

В VK Dev Platform для создания репозиториев и хранилищ артефактов можно использовать шаблоны.

Шаблоны реализованы как специальные ресурсы Kubernetes (подробнее — в официальной документации). Управление шаблонами выполняется с помощью CLI-утилиты kubectl (подробнее — в официальной документации).

На основе шаблона реализована ролевая модель управления доступом (подробнее — в разделе Права и учетные записи пользователей).

Спецификация шаблонов

Список спецификаций

Каждый шаблон соответствует своей спецификации CRD (подробнее — в официальной документации). Спецификация определяет возможную конфигурацию шаблона.

Чтобы просмотреть список спецификаций шаблонов, выполните команду:

$ kubectl get crd | grep dev-platform.vk.team

Просмотр спецификации

Чтобы просмотреть спецификацию шаблона, выполните команду:

$ kubectl describe crd/<ИМЯ_СПЕЦИФИКАЦИИ>.templates.dev-platform.vk.team

Здесь <ИМЯ_СПЕЦИФИКАЦИИ> — имя спецификации шаблона (пример: nexusyumrepositorytemplates).

Добавление шаблона репозитория

  1. В YAML-файле опишите шаблон репозитория в соответствии со спецификацией (подробнее — в разделе Спецификация шаблонов).

  2. Загрузите шаблон в VK Dev Platform:

    $ kubectl apply -f <ПУТЬ_ШАБЛОНА>

    Здесь <ПУТЬ_ШАБЛОНА> — путь до файла с шаблоном.

Добавление шаблона хранилища артефактов

Перед добавлением шаблона убедитесь, что в используемом хранилище артефактов (VK Registry или Sonatype Nexus Repository Manager CE):

  • Созданы все политики очистки, которые будут указаны в поле cleanup: policyNames: [] шаблона.
  • Создано blob-хранилище, которое будет указано в поле storage: blobStoreName шаблона. Если VK Registry развернут в HA-конфигурации, blob-хранилище должно быть типа S3.

Подробнее — в официальной документации:

Чтобы добавить шаблон хранилища артефактов:

  1. В YAML-файле опишите шаблон хранилища артефактов в соответствии со спецификацией (подробнее — в разделе Спецификация шаблонов).

  2. Загрузите шаблон в VK Dev Platform:

    $ kubectl apply -f <ПУТЬ_ШАБЛОНА>

    Здесь <ПУТЬ_ШАБЛОНА> — путь до файла с шаблоном.

Удаление шаблона репозитория или хранилища артефактов

Чтобы удалить шаблон репозитория или хранилища артефактов из VK Dev Platform, выполните команду:

$ kubectl delete -f <ПУТЬ_ШАБЛОНА>

Здесь <ПУТЬ_ШАБЛОНА> — путь до файла с шаблоном.

Была ли статья полезна?