О Shepherd CLI
Shepherd CLI — инструмент для управления жизненным циклом окружения VK Dev Platform. Он заменяет запуск Ansible напрямую и упрощает работу с инсталлятором.
Все операции с окружением VK Dev Platform выполняются с помощью Shepherd CLI внутри образа инсталлятора. Не используйте команды запуска Ansible из руководств предыдущих релизов (26.2.0 и более ранних).
Docker и файловые команды в руководстве нужны только для запуска контейнера с образом Shepherd и подготовки входных файлов — файла ответов, kubeconfig, SSH-ключей и сертификатов. Все остальные операции выполняются внутри контейнера командами Shepherd CLI.
Подробную инструкцию по Shepherd CLI можно посмотреть в /shepherd/tools/shepherd-cli/README.md после распаковки архива (подробнее — в разделе Распаковка архива).
Справка по командам:
$ shepherd --help
Другие справочные файлы внутри образа:
/shepherd/playbooks/preparation/README.md— заполнение файла ответовanswers.yaml;/shepherd/roles/<РОЛЬ>/README.md— параметры компонентов.
Shepherd CLI предоставляет четыре команды: init, deploy, secrets, certs.
Команда deploy запускает только плейбук playbooks/data-plane.yaml. Выбор другого плейбука недоступен.
Отдельные процедуры обслуживания недоступны через CLI, в их числе:
- обязательная миграция GitLab MinIO → S3;
- standalone preflight-проверки.
Для переноса Vault-секретов используется отдельная Python-утилита tools/migrate_legacy_secrets/migrate_legacy_secrets.py.