コンテンツへスキップ
オーラベースのロゴ
オーラベース

プル リクエストごとにデータベースをプレビューする

ブランチは、独自の URL と API キーを持つプロジェクトのコピーです。 CI でプル リクエストごとに 1 つ作成し、プレビューをポイントして、期限切れにするか、マージ時に削除します。

ハウツーガイド5 分 読み取りレベル 中間2026/11/12 に改訂

このページは自動翻訳されました。英語版が正式です。

1 つのプル リクエスト = 1 つのデータベース#

aura branch create は、PostgreSQL プロジェクト (スキーマ、行レベルのセキュリティ ポリシー、関数、トリガー、ビュー、行) を、独自の URL と API キーを使用して 新しいプロジェクト に複製します。プル リクエストはそこで移行を実行でき、レビュー担当者はソース プロジェクトで競合することなく結果を試すことができます。クローンの対象と対象外の完全なリストと制限は、 データベース ブランチにあります。

情報

ブランチは、作成時にデータに比例した時間で作成されるコピーです (ローカル テスト スタック上の 333 MB で 14 秒)。これはコピーオンライトのクローンではなく、その後ソースを追跡しません。

CIで#

インストールする GitHub アクションはありません。CLI が機能します。パーソナル アクセス トークン (aura login --token) で認証し、テスト対象のプロジェクトからブランチを作成し、プレビューに必要なものを保持します。各スニペットをパイプラインのスクリプトとして保存します。

open-preview.shbash
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# Branch.json: ID、スラッグ、URL、anon_key、service_role_key、expires_at
close-preview.shbash
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force

キーはブランチの作成時に 1 回だけ出力されます。その時点でキーをジョブ (またはプレビュー展開のシークレットとして) に保存します。プル リクエストの移行をブランチで実行するには、フォルダーをブランチにリンクし、 aura link --project-id <branch id> 、次に aura db pushをプッシュします。

aura branch コマンドはローカル スタックに対して実行されました。 aura login --token は、 デプロイメントの CI レシピのログインです。 GitHub または GitLab ワークフローを作成するのはあなた自身です。

ブランチに含まれるもの#

ブランチにはソースの行があり (スキーマのみ --no-data を追加)、ブランチが保持する個人データも含まれます。匿名化はありません。プレビューに実際のデータが表示されないようにするには、本番環境ではなくステージング プロジェクトからブランチを作成します。認証ユーザー、ストレージ オブジェクト、エッジ機能、およびシークレットは複製されません。それらをプレビュー設定にシードします。

TTL とクォータ#

ブランチの存続期間はデフォルトで 72 時間、最大 30 日間 (--ttl) です。期限切れのブランチは自動的に削除され、作成に失敗したブランチも同様に削除されます。ブランチはプロジェクトの制限にはカウントされません。これは、プランのアクティブなブランチの制限 (Free で 1、Pro で 10、Team で 25) に対してカウントされます。 の制限を参照してください。制限を超えると、 aura branch create は BRANCH_LIMIT_REACHEDで失敗します: ブランチを削除するか、その TTL を待機します。

さらに進むには#