Развертывание
Миграции с нулевым временем простоя, атомарный откат, CI/CD через GitHub Actions/GitLab/CLI и ветки базы данных: копия проекта для тестирования миграции или политики перед производством.
Три поверхности развертывания#
Проект Aurabase предоставляет три поверхности для развертывания: Postgres схема (версионная миграция SQL), Edge функции (WASM + cron + задания), политики и секреты (RLS, env vars, OAuth приложения). Каждый из них загружается независимо через aura CLI.
CLI (aura) представляет собой один двоичный файл, который также можно установить с помощью npm install -g @aurabase/cli и поддерживает пробный запуск, запросы подтверждения и предварительный просмотр различий. Совместимость с Linux/macOS/Windows.
Разработка, предварительный просмотр, производство#
По умолчанию в проекте есть две среды: dev (локальная, Kubernetes) и prod (облако). Чтобы попробовать внести изменения в копию данных перед производством, создайте ветвь базы данных ветки базы данных.
LOCAL DEV
$ ./start.sh → full local stack (k3d)
$ aura dev → watch mode + types gen
BRANCH (copy of a project, deleted by its TTL)
$ aura branch create pr-142 --from my-app --ttl 3d
$ aura db push → on the branch project, to try the migration
$ aura branch delete pr-142
PRODUCTION
merge to main → CI run: aura db push
→ aura deploy functions
Версионный SQL, атомарный откат#
Миграции живут в aurabase/migrations. Один файл на каждое изменение, временная метка в префиксе. CLI применяет недостающие миграции к связанному проекту; восстановите типы TypeScript с помощью npx @aurabase/gen после изменения.
# Создать новую миграцию
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql
# Посмотрите, какие миграции применяются или ожидаются, а затем примените их к связанному проекту.
aura db status
aura db push
# Восстановить типы TypeScript
npx @aurabase/gen --out src/aurabase.types.ts
# Получение списка примененных миграций
aura db migration list
Миграция без простоев. Следуйте правилам: сначала добавьте столбец с нулевым значением, отдельное заполнение, а затем ограничение NOT NULL. CLI не проверяет обратную совместимость за вас: просмотрите деструктивные операторы (drop column, alter column … type) перед aura db push.
Ветви базы данных#
Ветка — это новый проект , клонированный из существующего проекта PostgreSQL: его схема, политики безопасности на уровне строк, функции, триггеры, представления и (если вы не запрашиваете только схему) его строки. У него есть собственный URL-адрес, ключи API и база данных, поэтому вы можете запустить миграцию, протестировать политику или указать предварительную версию развертывания, не затрагивая исходный код. Ветки удаляются автоматически, когда заканчивается срок их жизни.
# Из связанного проекта (ссылка на ауру), по умолчанию 72 часа.
aura branch create feat/new-checkout
# Из другого проекта, хранилось 7 дней
aura branch create pr-142 --from my-app --ttl 7d
# Только схема: ни одна строка не копируется, последовательность начинается заново.
aura branch create schema-test --no-data
aura branch list # ветки связанного проекта
aura branch list --all # каждое отделение организации
aura branch delete feat/new-checkout
aura branch create ждет, пока ветка будет готова, затем печатает ее URL-адрес и ключи API, отображается только один раз, аналогично aura projects create (--json печатает их для сценариев). Используйте --no-wait для немедленного возврата и следуйте за ним с помощью aura branch list. Ветка — это проект: свяжите с ней папку с помощью aura link --project-id <id> и запустите там aura db push, чтобы попробовать миграцию.
Ветка — это копия , созданная во время создания, а не живая реплика и не клон копирования при записи: ничего не возвращается обратно к источнику или из него впоследствии. Платформа считывает источник в одном согласованном снимке и копирует строки в базу данных филиала, поэтому время пропорционально данным. В локальном тестовом стеке таблица размером 333 МБ с 350 000 строк была клонирована за 14 секунд. Миграция, которая работает в ветке, затем применяется к рабочей среде с помощью обычного aura db push.
Ограничения в полном объеме#
| Кто может создать | Участники с ролью developer или более из проекта PostgreSQL, который активен и не находится в спящем режиме. Проект MongoDB отклонен. |
| Разветвление ветки | Отказано: создайте ветку из родительского проекта. |
| Имя | Буквы, цифры, ., _, - и /, до 63 символов, уникальные для каждого проекта среди действующих ветвей (без учета регистра). |
| Время жить | По умолчанию 72 часа, от 1 часа до 30 дней (от --ttl 1h до --ttl 30d). Ветка с истекшим сроком действия и ее база данных удаляются автоматически, примерно через минуту после истечения срока. Вы можете удалить его раньше. |
| Ограничение плана | Ветка учитывает , а не, в рамках лимита вашего проекта (max_projects); у него есть свой лимит активных веток на организацию (max_branches): 1 в Free, 10 в Pro, 25 в Team. После этого создание отклоняется с помощью BRANCH_LIMIT_REACHED. Неудачная ветка не засчитывается. См. ограничения лимиты. |
| Размер данных | Строки передаются в потоковом режиме, а не хранятся в памяти, поэтому потолка в 32 МБ нет. В клонировании отказано через несколько секунд, если таблицы содержат больше, чем предел развертывания (2 ГиБ по умолчанию, BRANCH_CLONE_MAX_BYTES при размещении Aurabase): в сообщении указывается размер и предлагается --no-data. Клон также останавливается через 30 минут. |
Что не клонируется#
- Клонированный: таблицы и их строки, типы столбцов, значения по умолчанию, столбцы идентификаторов, последовательности и их текущие значения, ограничения, индексы, безопасность на уровне строк (включенная, принудительная, политики), функции и процедуры SQL, триггеры, представления и материализованные представления, типы перечислений и привилегии для всех из них.
- Не клонируется: пользователи аутентификации, сеансы и настройки аутентификации; ведра и предметы для хранения; пограничные функции, секреты, переменные среды и задания cron; настройки таблиц в реальном времени (перевключите их на ветке); комментарии к таблицам и столбцам, включая директивы
@graphql; привилегии уровня столбца; активация pg_graphql (aura projects graphql-enableна ветке). Объекты принадлежат администратору ветки. - Отказ от (ветвь будет неполной): секционированные и унаследованные таблицы, внешние таблицы, домены, составные и диапазонные типы, агрегатные функции, правила перезаписи, внешние ключи, указывающие на другую схему, а также расширения, отличные от тех, которые платформа устанавливает в каждом проекте.
Ветвь создается из схемы, поскольку она читается непосредственно перед копированием. Не меняйте схему источника (aura db push, DDL) во время создания ветки.
Когда создание терпит неудачу#
Ничего не осталось позади. Копия выполняется в одной транзакции в базе данных филиала; в случае любого сбоя происходит откат, проект ветки удаляется, а aura branch create печатает причину (например, объект, который невозможно клонировать). Неисправная ветвь остается видимой в aura branch list со своим сообщением в течение 24 часов, и ее имя снова становится свободным. Если служба базы данных перезапускается в середине копирования, ветвь объявляется неудавшейся и удаляется через 45 минут.
Три интеграции готовы#
CLI работает с любым CI. Вот рецепты трех самых распространенных.
name: Deploy to Aurabase
on:
push: { branches: [main] }
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g @aurabase/cli # или загрузите двоичный файл со страницы выпуска
- run: aura login --token ${{ secrets.AURA_PAT }} # Токен личного доступа aura_pat_*
- run: aura link ${{ vars.AURA_PROJECT_ID }}
- run: aura db push
- run: aura deploy functions
Свяжите один проект с каждой средой (промежуточный проект и производственный проект) и запустите для каждого из них один и тот же конвейер. Флаг --env отсутствует: целью является проект, с которым связана папка.
Атомный, посредством миграции вниз#
Рядом с каждой миграцией 20260415_xxx.sql может находиться файл 20260415_xxx.down.sql. aura db migration down [n] запускает .down.sql последней примененной миграции n, сначала самую новую, и удаляет ее из истории; команда проверяет ответ сервера и завершается ошибкой, если ничего не было возвращено. Миграция без .down.sql удаляется только из истории, и об этом сообщает CLI.
# Отменить последнюю примененную миграцию (запускает .down.sql)
aura db migration down
# Вернуть последние три
aura db migration down 3
# Исправить историю, не трогая схему (миграция, примененная вручную, неудачная)
aura db migration repair 20260415120000_add_devices_table.sql --applied
# Неудачная миграция отменяется отдельной транзакцией: возвращать нечего.
# Восстановление всей базы данных на определенный момент времени осуществляется с помощью резервных копий (aura db Backup Restore <id> --yes)
Восстановление на определенный момент времени пока не имеет команды самообслуживания. Для самостоятельного восстановления используйте снимки aura db backup create / aura db backup restore <id> --yes; восстановление перезаписывает базу данных, поэтому сначала создайте новую резервную копию.
Чтобы пойти дальше#
- Предварительный просмотр баз данных для каждого запроса на извлечение
Ветка на пул-реквест в CI и ее очистка.
- Развертывание в нескольких регионах
Репликация, аварийное переключение, резидентность данных.
- Аудит эффективности
EXPLAIN ANALYZE, индексы, медленные запросы.
- Справочник по интерфейсу командной строки
Все команды, флаги, переменные окружения.