Управление шаблонами
В VK Dev Platform для создания репозиториев и хранилищ артефактов можно использовать шаблоны.
Шаблоны реализованы как специальные ресурсы Kubernetes (подробнее — в официальной документации). Управление шаблонами выполняется с помощью CLI-утилиты kubectl (подробнее — в официальной документации).
На основе шаблона реализована ролевая модель управления доступом (подробнее — в разделе Права и учетные записи пользователей).
Каждый шаблон соответствует своей спецификации CRD (подробнее — в официальной документации). Спецификация определяет возможную конфигурацию шаблона.
Чтобы просмотреть список спецификаций шаблонов, выполните команду:
$ kubectl get crd | grep dev-platform.vk.team
Чтобы просмотреть спецификацию шаблона, выполните команду:
$ kubectl describe crd/<ИМЯ_СПЕЦИФИКАЦИИ>.templates.dev-platform.vk.team
Здесь <ИМЯ_СПЕЦИФИКАЦИИ> — имя спецификации шаблона (пример: nexusyumrepositorytemplates).
-
В YAML-файле опишите шаблон репозитория в соответствии со спецификацией (подробнее — в разделе Спецификация шаблонов).
-
Загрузите шаблон в VK Dev Platform:
$ kubectl apply -f <ПУТЬ_ШАБЛОНА>Здесь
<ПУТЬ_ШАБЛОНА>— путь до файла с шаблоном.
Перед добавлением шаблона убедитесь, что в используемом хранилище артефактов (VK Registry или Sonatype Nexus Repository Manager CE):
- Созданы все политики очистки, которые будут указаны в поле
cleanup: policyNames: []шаблона. - Создано blob-хранилище, которое будет указано в поле
storage: blobStoreNameшаблона. Если VK Registry развернут в HA-конфигурации, blob-хранилище должно быть типаS3.
Подробнее — в официальной документации:
- политики очистки в VK Registry;
- blob-хранилища в VK Registry;
- политики очистки в Sonatype Nexus Repository Manager CE;
- blob-хранилища в Sonatype Nexus Repository Manager CE.
Чтобы добавить шаблон хранилища артефактов:
-
В YAML-файле опишите шаблон хранилища артефактов в соответствии со спецификацией (подробнее — в разделе Спецификация шаблонов).
-
Загрузите шаблон в VK Dev Platform:
$ kubectl apply -f <ПУТЬ_ШАБЛОНА>Здесь
<ПУТЬ_ШАБЛОНА>— путь до файла с шаблоном.
Чтобы удалить шаблон репозитория или хранилища артефактов из VK Dev Platform, выполните команду:
$ kubectl delete -f <ПУТЬ_ШАБЛОНА>
Здесь <ПУТЬ_ШАБЛОНА> — путь до файла с шаблоном.