Naar de inhoud springen
Aurabase-logo
aurabasis

Preview-databases per pull-aanvraag

Een branch is een kopie van een project met een eigen URL en API-sleutels. Maak er één per pull-aanvraag in CI, richt de preview erop en laat deze verlopen of verwijder deze bij het samenvoegen.

Handleiding5 min lezenNiveau tussenproductHerzien op 12 nov 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Eén pull-aanvraag = één database#

aura branch create kloont een PostgreSQL-project (schema, beveiligingsbeleid op rijniveau, functies, triggers, weergaven en rijen) naar een nieuw project met zijn eigen URL en API-sleutels. Een pull-request kan de migratie daar uitvoeren, en reviewers kunnen het resultaat uitproberen, zonder enige discussie over het bronproject. De volledige lijst van wat wel en niet wordt gekloond, en de limieten, bevinden zich in databasevertakkingen.

Info

Een vertakking is een kopie die wordt gemaakt wanneer u deze maakt, in tijd evenredig aan de gegevens (14 seconden voor 333 MB op de lokale teststapel). Het is geen copy-on-write-kloon en volgt de bron achteraf niet.

In CI#

Er hoeft geen GitHub actie te worden geïnstalleerd: de CLI doet het werk. Authenticeer met een persoonlijk toegangstoken (aura login --token), maak vervolgens de vertakking van het project waarmee u test en bewaar wat de preview nodig heeft. Sla elk fragment op als een script van uw pijplijn:

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, vervalt_at
close-preview.shbash
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force

De sleutels worden slechts één keer afgedrukt, wanneer de vertakking wordt gemaakt: sla ze op dat moment op in de taak (of als geheimen van de preview-implementatie). Om de migraties van het pull-verzoek op de branch uit te voeren, koppelt u de map eraan en drukt u op: aura link --project-id <branch id> en vervolgens aura db push.

De aura branch-opdrachten werden uitgevoerd tegen een lokale stapel; aura login --token is de login van de CI-recepten in -implementatie. De GitHub- of GitLab-workflow eromheen is aan jou om te schrijven.

Wat de branche inhoudt#

De vertakking heeft de rijen van de bron (voeg alleen --no-data toe voor het schema), inclusief eventuele persoonlijke gegevens die deze bevatten: er is geen anonimisering. Maak de vertakking vanuit een faseringsproject, niet vanuit productie, als de preview geen echte gegevens mag zien. Auth-gebruikers, opslagobjecten, edge-functies en geheimen worden niet gekloond; plaats ze in uw voorbeeldinstellingen.

TTL en quota#

Een filiaal heeft standaard een levensduur van 72 uur, maximaal 30 dagen (--ttl). Verlopen vertakkingen worden automatisch verwijderd, en dat geldt ook voor een vertakking waarvan het maken mislukt. Een vestiging telt niet mee voor uw projectlimiet; het telt mee voor de limiet van actieve vertakkingen van uw plan (1 op Free, 10 op Pro, 25 op Team), zie limieten. Voorbij de limiet mislukt aura branch create met BRANCH_LIMIT_REACHED: verwijder een vertakking of wacht op zijn TTL.

Om verder te gaan#