Предварительный просмотр баз данных для каждого запроса на извлечение
Ветка — это копия проекта со своим URL и ключами API. Создайте по одному запросу на включение в CI, наведите на него предварительный просмотр и дайте ему истечь или удалите его при слиянии.
Один запрос на вытягивание = одна база данных#
aura branch create клонирует проект PostgreSQL (схему, политики безопасности на уровне строк, функции, триггеры, представления и строки) в новый проект с собственным URL-адресом и ключами API. Запрос на включение может выполнить миграцию там, и рецензенты смогут опробовать результат без каких-либо разногласий в отношении исходного проекта. Полный список того, что клонируется, а что нет, а также ограничения находятся в ветках базы данных.
Ветка — это копия, созданная при ее создании, за время, пропорциональное данным (14 секунд для 333 МБ в локальном тестовом стеке). Это не клон копирования при записи и впоследствии он не следует за источником.
В КИ#
Для установки не требуется действия GitHub: всю работу выполняет интерфейс командной строки. Выполните аутентификацию с помощью токена личного доступа (aura login --token), затем создайте ветку из проекта, который вы тестируете, и сохраните то, что необходимо для предварительной версии. Сохраните каждый фрагмент как скрипт вашего конвейера:
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# Branch.json: идентификатор, пуля, URL, anon_key, service_role_key, expires_at
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force
Ключи печатаются только один раз, при создании ветки: сразу же сохраните их в задании (или как секреты развертывания предварительного просмотра). Чтобы запустить миграцию запроса на ветку, свяжите с ней папку и нажмите: aura link --project-id <branch id>, затем aura db push.
Команды aura branch выполнялись в локальном стеке; aura login --token — это логин для рецептов CI в развертывании развёртывание. Рабочий процесс GitHub или GitLab, связанный с ними, можете написать вы.
Что содержит ветка#
В ветке есть строки источника (добавьте --no-data только для схемы), включая любые хранящиеся в них личные данные: анонимизация отсутствует. Создайте ветку из промежуточного проекта, а не из производственного, если предварительный просмотр не должен видеть реальные данные. Пользователи аутентификации, объекты хранения, пограничные функции и секреты не клонируются; разместите их в настройках предварительного просмотра.
TTL и квоты#
По умолчанию ветка живет 72 часа, до 30 дней (--ttl). Ветки с истекшим сроком действия удаляются автоматически, как и ветка, создание которой не удалось. Ветка не учитывается в лимите вашего проекта; он учитывается в лимите активных ветвей вашего плана (1 в бесплатном режиме, 10 в Pro, 25 в Team), см. ограничения лимиты. При превышении лимита aura branch create завершается с ошибкой BRANCH_LIMIT_REACHED: удалите ветку или дождитесь ее TTL.