VK Dev Platform logo
Помощь
Обновлена 6 ноября 2026 г. в 11:18

О 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

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.

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