Примеры и рецепты
LegacyLegacy-рецепты SPGCLI (`spgctl`) для существующей автоматизации.
Обновлено: 5 марта 2026 г.
Ниже — несколько legacy-сценариев для существующей автоматизации на SPGCLI (spgctl). Для новых пользовательских сценариев предпочтительнее Console и API.
1. Создать tenant, базу и сразу подключиться
spgctl tenant create --name acme
spgctl db create --tenant acme --name app --size L1
psql "$(spgctl db dsn --tenant acme --db app)"
Если база была в stopped, первое подключение может занять чуть больше времени из‑за cold start.
2. Быстро проверить доступность Control Plane
spgctl ping --json
Это удобный healthcheck для локальной машины, CI runner или jump‑host.
3. Посмотреть текущее состояние перед спорной операцией
spgctl db describe --tenant acme --db app
Полезно делать перед удалением, миграцией или разбором медленного cold start.
4. Временная база для CI
Типовой сценарий такой:
- создать отдельный tenant или использовать выделенный CI‑tenant;
- создать временную БД;
- выполнить миграции и тесты;
- удалить БД по завершении пайплайна.
Пример:
spgctl db create --tenant ci --name test-$CI_PIPELINE_ID --size L1
# ... migrations / tests ...
spgctl db delete --tenant ci --db test-$CI_PIPELINE_ID --force
5. Получить DSN без ручной сборки строки подключения
spgctl db dsn --tenant acme --db app
Это безопаснее и удобнее, чем каждый раз вручную подставлять pg_user, pg_password, хост Gateway и имя базы.
