Примеры и рецепты

Legacy

Legacy-рецепты 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

Типовой сценарий такой:

  1. создать отдельный tenant или использовать выделенный CI‑tenant;
  2. создать временную БД;
  3. выполнить миграции и тесты;
  4. удалить БД по завершении пайплайна.

Пример:

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 и имя базы.