Zum Inhalt springen
Aurabase-Logo
Aurabasis

Vorschau der Datenbanken pro Pull-Anfrage

Ein Zweig ist eine Kopie eines Projekts mit eigener URL und eigenen API-Schlüsseln. Erstellen Sie eine pro Pull-Anfrage in CI, richten Sie die Vorschau darauf und lassen Sie sie ablaufen oder löschen Sie sie beim Zusammenführen.

Anleitung5 Min. gelesenEbene MittelstufeÜberarbeitet am 12.11.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Eine Pull-Anfrage = eine Datenbank#

aura branch create klont ein PostgreSQL-Projekt (Schema, Sicherheitsrichtlinien auf Zeilenebene, Funktionen, Trigger, Ansichten und Zeilen) in ein neues Projekt mit eigener URL und eigenen API-Schlüsseln. Dort kann eine Pull-Anfrage ihre Migration ausführen und Prüfer können das Ergebnis ausprobieren, ohne dass es zu Konflikten mit dem Quellprojekt kommt. Die vollständige Liste dessen, was geklont wird und was nicht, sowie die Grenzwerte finden Sie in den Datenbankzweigen Datenbank-Branches.

Infos

Bei einem Zweig handelt es sich um eine Kopie, die bei der Erstellung erstellt wird und deren Zeit proportional zu den Daten ist (14 Sekunden für 333 MB auf dem lokalen Teststapel). Es handelt sich nicht um einen Copy-on-Write-Klon, und er folgt der Quelle anschließend nicht.

Im CI#

Es muss keine GitHub-Aktion installiert werden: Die CLI erledigt die Arbeit. Authentifizieren Sie sich mit einem persönlichen Zugriffstoken (aura login --token), erstellen Sie dann den Zweig aus dem Projekt, gegen das Sie testen, und behalten Sie bei, was die Vorschau benötigt. Speichern Sie jedes Snippet als Skript Ihrer Pipeline:

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, Slug, 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

Die Schlüssel werden nur einmal gedruckt, wenn der Zweig erstellt wird: Speichern Sie sie zu diesem Zeitpunkt im Job (oder als Geheimnisse der Vorschaubereitstellung). Um die Migrationen der Pull-Anfrage auf dem Zweig auszuführen, verknüpfen Sie den Ordner damit und drücken Sie Folgendes: aura link --project-id <branch id> und dann aura db push.

Die aura branch-Befehle wurden auf einem lokalen Stack ausgeführt; aura login --token ist der Login der CI-Rezepte in der -Bereitstellung. Der GitHub- oder GitLab-Workflow um sie herum liegt bei Ihnen.

Was der Zweig enthält#

Der Zweig verfügt über die -Zeilen der Quelle (fügen Sie --no-data nur für das Schema hinzu), einschließlich aller darin enthaltenen persönlichen Daten: Es erfolgt keine Anonymisierung. Erstellen Sie den Zweig aus einem Staging-Projekt und nicht aus der Produktion, wenn in der Vorschau keine echten Daten angezeigt werden sollen. Authentifizierungsbenutzer, Speicherobjekte, Edge-Funktionen und Geheimnisse werden nicht geklont; Setzen Sie sie in Ihr Vorschau-Setup ein.

TTL und Quoten#

Ein Zweig lebt standardmäßig 72 Stunden, bis zu 30 Tage (--ttl). Abgelaufene Zweige werden automatisch gelöscht, ebenso wie Zweige, deren Erstellung fehlschlägt. Eine Verzweigung wird nicht auf Ihr Projektlimit angerechnet; es wird auf das Limit der aktiven Zweige Ihres Plans angerechnet (1 bei Free, 10 bei Pro, 25 bei Team), siehe Limits. Nach Erreichen des Grenzwerts schlägt aura branch create mit BRANCH_LIMIT_REACHED fehl: Löschen Sie einen Zweig oder warten Sie auf seine TTL.

Um weiter zu gehen#