Bereitstellung
Migrationen ohne Ausfallzeiten, atomares Rollback, CI/CD über GitHub-Aktionen/GitLab/CLI und Datenbankzweige: eine Kopie eines Projekts zum Testen einer Migration oder einer Richtlinie vor der Produktion.
Drei Einsatzflächen#
Ein Aurabase-Projekt stellt drei Oberflächen zur Bereitstellung bereit: Postgres Schema (versionierte SQL-Migrationen), Edge-Funktionen (WASM + Cron + Jobs), Richtlinien und Geheimnisse (RLS, Umgebungsvariablen, OAuth Apps). Jeder pusht sich unabhängig über die aura-CLI.
Die CLI (aura) ist eine einzelne Binärdatei, die auch mit npm install -g @aurabase/cli installiert werden kann und unterstützt Probelauf, Bestätigungsaufforderungen und Diff-Vorschau. Linux/MacOS/Windows-kompatibel.
Entwicklung, Vorschau, Produktion#
Standardmäßig verfügt ein Projekt über zwei Umgebungen: dev (lokal, Kubernetes) und prod (Cloud). Um vor der Produktion eine Änderung an einer Kopie Ihrer Daten zu versuchen, erstellen Sie einen Datenbankzweig Datenbank-Branches.
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
Versioniertes SQL, atomares Rollback#
Migrationen leben in aurabase/migrations. Eine Datei pro Änderung, Zeitstempel im Präfix. Die CLI wendet die fehlenden Migrationen auf das verknüpfte Projekt an; Generieren Sie Ihre TypeScript-Typen nach einer Änderung mit npx @aurabase/gen neu.
# Erstellen Sie eine neue Migration
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql
# Sehen Sie, welche Migrationen angewendet werden oder ausstehen, und wenden Sie sie dann auf das verknüpfte Projekt an
aura db status
aura db push
# Generieren Sie TypeScript-Typen neu
npx @aurabase/gen --out src/aurabase.types.ts
# Angewandte Migrationen auflisten
aura db migration list
Migrationen ohne Ausfallzeiten. Befolgen Sie die Regeln: Fügen Sie zuerst eine nullbare Spalte hinzu, trennen Sie die Auffüllung, beschränken Sie sich zuletzt auf NOT NULL. Die CLI prüft die Abwärtskompatibilität nicht für Sie: Überprüfen Sie destruktive Anweisungen (drop column, alter column … type) vor aura db push.
Datenbankzweige#
Ein Zweig ist ein neues Projekt, das aus einem vorhandenen PostgreSQL-Projekt geklont wurde: sein Schema, Sicherheitsrichtlinien auf Zeilenebene, Funktionen, Trigger, Ansichten und (sofern Sie nicht nur nach dem Schema fragen) seine Zeilen. Es verfügt über eine eigene URL, API-Schlüssel und Datenbank, sodass Sie eine Migration durchführen, eine Richtlinie testen oder eine Vorschaubereitstellung darauf verweisen können, ohne die Quelle zu berühren. Zweige werden automatisch gelöscht, wenn ihre Gültigkeitsdauer abläuft.
# Aus dem verknüpften Projekt (Aura-Link), standardmäßig 72 Stunden
aura branch create feat/new-checkout
# Aus einem anderen Projekt, 7 Tage aufbewahrt
aura branch create pr-142 --from my-app --ttl 7d
# Nur Schema: Es wird keine Zeile kopiert, die Sequenzen beginnen von vorne
aura branch create schema-test --no-data
aura branch list # die Zweige des verknüpften Projekts
aura branch list --all # jeder Zweig der Organisation
aura branch delete feat/new-checkout
aura branch create wartet, bis der Zweig bereit ist, und druckt dann seine URL und seine API-Schlüssel aus. wird nur einmal angezeigt. wie die von aura projects create (--json druckt sie für Skripte). Verwenden Sie --no-wait, um sofort zurückzukehren, und folgen Sie ihm mit aura branch list. Ein Zweig ist ein Projekt: Verknüpfen Sie einen Ordner mit aura link --project-id <id> und führen Sie dort aura db push aus, um eine Migration zu versuchen.
Ein Zweig ist eine Kopie, die zum Zeitpunkt der Erstellung erstellt wurde, keine Live-Replik und kein Copy-on-Write-Klon: Es fließt nichts zurück zur Quelle oder von ihr danach. Die Plattform liest die Quelle in einem konsistenten Snapshot und kopiert die Zeilen in die Zweigdatenbank, sodass die Zeit proportional zu den Daten ist. Auf dem lokalen Teststack wurde eine 333 MB große Tabelle mit 350.000 Zeilen in 14 Sekunden geklont. Eine Migration, die in der Verzweigung funktioniert, wird dann mit dem üblichen aura db push auf die Produktion angewendet.
Grenzen, vollständig#
| Wer kann erstellen? | Mitglieder mit der Rolle developer oder höher aus einem PostgreSQL-Projekt, das aktiv und nicht im Ruhezustand ist. Ein MongoDB-Projekt wird abgelehnt. |
| Einen Zweig verzweigen | Abgelehnt: Erstellen Sie den Zweig aus seinem übergeordneten Projekt. |
| Name | Buchstaben, Ziffern, ., _, - und /, bis zu 63 Zeichen, eindeutig pro Projekt unter den Live-Zweigen (Groß- und Kleinschreibung wird nicht beachtet). |
| Zeit zu leben | Standardmäßig 72 Stunden, von 1 Stunde bis 30 Tage (--ttl 1h bis --ttl 30d). Der abgelaufene Zweig und seine Datenbank werden automatisch gelöscht, etwa eine Minute nach Ablauf der Frist. Sie können es früher löschen. |
| Planlimit | Ein Zweig zählt nicht auf Ihr Projektlimit (max_projects); Es gibt ein eigenes Limit an aktiven Zweigen pro Organisation (max_branches): 1 bei Free, 10 bei Pro, 25 bei Team. Danach wird die Erstellung mit BRANCH_LIMIT_REACHED abgelehnt. Ein fehlgeschlagener Zweig zählt nicht. Siehe -Grenzwerte. |
| Datengröße | Die Zeilen werden gestreamt und nicht im Speicher gehalten, daher gibt es keine Obergrenze von 32 MiB. Das Klonen wird innerhalb weniger Sekunden abgelehnt, wenn die Tabellen mehr als das Limit der Bereitstellung enthalten (standardmäßig 2 GiB, BRANCH_CLONE_MAX_BYTES, wenn Sie Aurabase hosten): Die Meldung gibt die Größe an und schlägt --no-data vor. Ein Klon stoppt auch nach 30 Minuten. |
Was wird nicht geklont?#
- Geklont: Tabellen und ihre Zeilen, Spaltentypen, Standardwerte, Identitätsspalten, Sequenzen und ihr aktueller Wert, Einschränkungen, Indizes, Sicherheit auf Zeilenebene (aktiviert, erzwungen, Richtlinien), SQL-Funktionen und -Prozeduren, Trigger, Ansichten und materialisierte Ansichten, Aufzählungstypen und die Berechtigungen für alle.
- Nicht geklont: Benutzer, Sitzungen und Authentifizierungseinstellungen authentifizieren; Aufbewahrungseimer und -gegenstände; Edge-Funktionen, Geheimnisse, Umgebungsvariablen und Cron-Jobs; Echtzeit-Tabelleneinstellungen (reaktivieren Sie sie in der Verzweigung); Tabellen- und Spaltenkommentare, einschließlich
@graphql-Direktiven; Berechtigungen auf Spaltenebene; die pg_graphql-Aktivierung (aura projects graphql-enableauf dem Zweig). Objekte gehören der Administratorrolle der Zweigstelle. - Abgelehnt (der Zweig wäre unvollständig): partitionierte und geerbte Tabellen, Fremdtabellen, Domänen, zusammengesetzte und Bereichstypen, Aggregatfunktionen, Umschreiberegeln, Fremdschlüssel, die auf ein anderes Schema verweisen, und andere Erweiterungen als die, die die Plattform in jedem Projekt installiert.
Beim Lesen unmittelbar vor dem Kopieren wird aus dem Schema ein Zweig erstellt. Ändern Sie nicht das Schema der Quelle (aura db push, DDL), während ein Zweig erstellt wird.
Wenn die Schöpfung scheitert#
Nichts bleibt zurück. Die Kopie wird in einer einzigen Transaktion in der Filialdatenbank ausgeführt. Bei jedem Fehler wird ein Rollback durchgeführt, das Zweigprojekt gelöscht und aura branch create gibt den Grund aus (z. B. das Objekt, das nicht geklont werden kann). Der ausgefallene Zweig bleibt mit seiner Meldung 24 Stunden lang in aura branch list sichtbar und sein Name ist wieder frei. Wenn der Datenbankdienst mitten im Kopiervorgang neu startet, wird der Zweig als fehlgeschlagen erklärt und nach 45 Minuten gelöscht.
Drei Integrationen bereit#
Die CLI funktioniert mit jedem CI. Hier sind die Rezepte für die drei häufigsten.
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 # oder laden Sie die Binärdatei von der Release-Seite herunter
- run: aura login --token ${{ secrets.AURA_PAT }} # Persönliches Zugriffstoken aura_pat_*
- run: aura link ${{ vars.AURA_PROJECT_ID }}
- run: aura db push
- run: aura deploy functions
Verknüpfen Sie ein Projekt pro Umgebung (ein Staging-Projekt und ein Produktionsprojekt) und führen Sie für beide dieselbe Pipeline aus. Es gibt kein --env-Flag: Das Ziel ist das Projekt, mit dem der Ordner verknüpft ist.
Atomar, durch Abwärtsmigration#
Neben jeder 20260415_xxx.sql-Migration kann eine 20260415_xxx.down.sql-Datei vorhanden sein. aura db migration down [n] führt den .down.sql der letzten n angewendeten Migrationen aus, die neuesten zuerst, und entfernt sie aus dem Verlauf; Der Befehl prüft die Antwort des Servers und schlägt fehl, wenn nichts zurückgesetzt wurde. Eine Migration ohne .down.sql wird nur aus dem Verlauf entfernt, und die CLI gibt dies an.
# Machen Sie die zuletzt angewendete Migration rückgängig (führt deren .down.sql aus)
aura db migration down
# Setzen Sie die letzten drei zurück
aura db migration down 3
# Korrigieren Sie den Verlauf, ohne das Schema zu berühren (eine von Hand durchgeführte Migration, eine fehlgeschlagene)
aura db migration repair 20260415120000_add_devices_table.sql --applied
# Eine fehlgeschlagene Migration wird in ihrer eigenen Transaktion abgebrochen: Es gibt nichts, was rückgängig gemacht werden könnte.
# Die Point-in-Time-Wiederherstellung einer gesamten Datenbank erfolgt über Backups (aura db Backup Restore <id> --yes)
Point-in-Time-Wiederherstellung hat noch keinen Self-Service-Befehl. Für eine selbst durchgeführte Wiederherstellung verwenden Sie die Snapshots von aura db backup create / aura db backup restore <id> --yes; Durch die Wiederherstellung wird die Datenbank überschrieben. Erstellen Sie daher zunächst ein neues Backup.