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

導入

ゼロダウンタイムの移行、アトミック ロールバック、GitHub アクション / GitLab / CLI を介した CI/CD、およびデータベース ブランチ: 運用前に移行またはポリシーをテストするためのプロジェクトのコピー。

解説8 分 読み取りレベル 中間2026/04/15 に改訂

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

3 つの展開面#

Aurabase プロジェクトは、展開する 3 つのサーフェスを公開します: Postgres スキーマ (バージョン管理された SQL 移行)、エッジ関数 (WASM + cron + ジョブ)、ポリシーとシークレット (RLS、環境変数、 OAuth アプリ)。それぞれは aura CLI を介して独立してプッシュされます。

CLI (aura) は単一のバイナリであり、 npm install -g @aurabase/cliとともにインストールすることもでき、ドライラン、確認プロンプト、および差分プレビューをサポートします。 Linux / macOS / Windows に対応。

開発、プレビュー、本番#

デフォルトでは、プロジェクトには dev (ローカル、Kubernetes) と prod (クラウド) という 2 つの環境があります。運用前にデータのコピーに変更を加えるには、 データベース ブランチを作成します。

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内に存在します。変更ごとに 1 つのファイル、プレフィックスにタイムスタンプ。 CLI は、不足している移行をリンクされたプロジェクトに適用します。変更後に npx @aurabase/gen を使用して TypeScript 型を再生成します。

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
注意

ダウンタイムゼロの移行。ルールに従ってください: 最初に NULL 許容列を追加し、個別のバックフィルを追加し、最後に NOT NULL 制約を追加します。 CLI は下位互換性をチェックしません。 aura db pushの前に、破壊的なステートメント (drop column、 alter column … type) を確認してください。

データベースブランチ#

ブランチは、既存の PostgreSQL プロジェクトから複製された 新しいプロジェクト です。これには、そのスキーマ、行レベルのセキュリティ ポリシー、関数、トリガー、ビュー、および (スキーマのみを要求しない限り) その行が含まれます。独自の URL、API キー、データベースがあるため、ソースに触れることなく、移行を実行したり、ポリシーをテストしたり、プレビュー展開を指定したりできます。ブランチは、有効期間が終了すると自動的に削除されます。

clibash
# リンクされたプロジェクト (aura リンク) からは、デフォルトで 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 と同様に を 1 回だけ表示します (--json はスクリプト用にそれらを出力します)。 --no-wait を使用してすぐに戻り、その後に aura branch listを使用します。ブランチはプロジェクトです。aura link --project-id <id> を使用してフォルダーをブランチにリンクし、そこで aura db push を実行して移行を試みます。

ブランチとは正確には何ですか

ブランチは作成時に作成されるコピーであり、ライブ レプリカやコピーオンライト クローンではありません。ソースまたはソースからその後に何もフローバックされません。プラットフォームは 1 つの一貫したスナップショットでソースを読み取り、行をブランチ データベースにコピーするため、時間はデータに比例します。ローカル テスト スタックでは、350,000 行の 333 MB テーブルが 14 秒でクローン作成されました。ブランチで機能する移行は、通常の aura db pushを使用して本番環境に適用されます。

制限、完全に#

を作成できる人アクティブで休止状態ではない PostgreSQL プロジェクトの developer 以上のロールを持つメンバー。 MongoDB プロジェクトが拒否されました。
ブランチの分岐拒否されました: 親プロジェクトからブランチを作成します。
名前文字、数字、 .、 _、 - および /、最大 63 文字、ライブ ブランチ間でプロジェクトごとに一意 (大文字と小文字は区別されません)。
生存時間デフォルトでは 72 時間、1 時間から 30 日まで (--ttl 1h から --ttl 30d)。期限切れのブランチとそのデータベースは、期限の約 1 分以内に自動的に削除されます。早めに削除することもできます。
プラン制限ブランチはプロジェクトの制限 (max_projects) にはカウントされません。組織ごとにアクティブなブランチの独自の制限 (max_branches) があります。Free では 1、Pro では 10、Team では 25 です。それを超えると、作成は BRANCH_LIMIT_REACHEDで拒否されます。失敗したブランチはカウントされません。 の制限を参照してください。
データサイズ行はメモリに保持されずストリーミングされるため、32 MiB の上限はありません。テーブルがデプロイメントの制限 (デフォルトでは 2 GiB、 Aurabaseをホストする場合は BRANCH_CLONE_MAX_BYTES) を超えると、クローン作成は数秒以内に拒否されます。メッセージにはサイズが示され、 --no-dataが提案されます。クローンも 30 分後に停止します。

クローン化されないもの#

  • クローンされた: テーブルとその行、列タイプ、デフォルト、アイデンティティ列、シーケンスとその現在値、制約、インデックス、行レベルのセキュリティ (有効、強制、ポリシー)、SQL 関数とプロシージャ、トリガー、ビューとマテリアライズド ビュー、列挙型、およびそれらすべてに対する権限。
  • クローン化されていません: ユーザー、セッション、および認証設定を認証します。ストレージバケットとオブジェクト。エッジ関数、シークレット、環境変数、および cron ジョブ。リアルタイム テーブル設定 (ブランチ上で再度有効にします); @graphql ディレクティブを含むテーブルと列のコメント。列レベルの権限。 pg_graphql のアクティブ化 (ブランチ上のaura projects graphql-enable)。オブジェクトはブランチの管理者ロールによって所有されます。
  • 拒否された (ブランチは不完全になります): パーティション化および継承されたテーブル、外部テーブル、ドメイン、複合型および範囲型、集計関数、書き換えルール、別のスキーマを指す外部キー、およびプラットフォームがすべてのプロジェクトにインストールするもの以外の拡張機能。

コピーの直前に読み取られるスキーマからブランチが作成されます。ブランチの作成中にソースのスキーマ (aura db push、DDL) を変更しないでください。

作成に失敗した場合#

何も残らないのです。コピーはブランチ データベース上の単一トランザクションで実行されます。失敗するとロールバックされ、ブランチ プロジェクトが削除され、aura branch create によって理由 (クローンを作成できないオブジェクトなど) が出力されます。失敗したブランチは、そのメッセージとともに aura branch list に 24 時間表示され、その名前は再び解放されます。データベース サービスがコピーの途中で再起動されると、ブランチは失敗したと宣言され、45 分後に削除されます。

3 つの統合が準備完了#

CLI はあらゆる CI で動作します。最も一般的な 3 つのレシピを次に示します。

.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

環境ごとに 1 つのプロジェクト (ステージング プロジェクトと運用プロジェクト) をリンクし、それぞれに対して同じパイプラインを実行します。 --env フラグはありません。ターゲットはフォルダーがリンクされているプロジェクトです。

アトミック、ダウンマイグレーション経由#

各 20260415_xxx.sql 移行の隣に 20260415_xxx.down.sql ファイルを含めることができます。 aura db migration down [n] は、最後に適用された n 移行の .down.sql を最新のものから順に実行し、履歴から削除します。コマンドはサーバーの応答をチェックし、何も戻されなかった場合は失敗します。 .down.sql のない移行は履歴から削除されるだけであり、CLI にはその旨が表示されます。

rollbackbash
# 最後に適用された移行を元に戻します (.down.sql を実行します)。
aura db migration down

# 最後の 3 つを元に戻す
aura db migration down 3

# スキーマを変更せずに履歴を修正します (手動で適用された移行、失敗した移行)
aura db migration repair 20260415120000_add_devices_table.sql --applied

# 失敗した移行はそれ自体のトランザクションでキャンセルされ、元に戻すものはありません。
# データベース全体のポイントインタイムリカバリはバックアップを介して行われます (aura db back upstore <id> --yes)
注意

ポイントインタイム リカバリ にはまだセルフサービス コマンドがありません。自分で復元する場合は、 aura db backup create / aura db backup restore <id> --yesのスナップショットを使用します。復元ではデータベースが上書きされるため、最初に新しいバックアップを作成してください。

さらに進むには#