Перейти к содержимому
Логотип Аурабаза
аурабаза

Развертывание

Миграции с нулевым временем простоя, атомарный откат, CI/CD через GitHub Actions/GitLab/CLI и ветки базы данных: копия проекта для тестирования миграции или политики перед производством.

Пояснение8 мин читатьУровень среднийПересмотрено 15 апр. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Три поверхности развертывания#

Проект 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 (облако). Чтобы попробовать внести изменения в копию данных перед производством, создайте ветвь базы данных ветки базы данных.

fluxtext
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 после изменения.

terminalbash
# Создать новую миграцию
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 и база данных, поэтому вы можете запустить миграцию, протестировать политику или указать предварительную версию развертывания, не затрагивая исходный код. Ветки удаляются автоматически, когда заканчивается срок их жизни.

clibash
# Из связанного проекта (ссылка на ауру), по умолчанию 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. Вот рецепты трех самых распространенных.

.github/workflows/deploy.ymlyaml
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.

rollbackbash
# Отменить последнюю примененную миграцию (запускает .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; восстановление перезаписывает базу данных, поэтому сначала создайте новую резервную копию.

Чтобы пойти дальше#