Naar de inhoud springen
Aurabase-logo
aurabasis

Implementatie

Migraties zonder downtime, atomaire rollback, CI/CD via GitHub Actions / GitLab / CLI en databasevertakkingen: een kopie van een project om een migratie of beleid vóór productie te testen.

Uitleg8 min lezenNiveau tussenproductHerzien op 15 apr 2026

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

Drie inzetoppervlakken#

Een Aurabase-project biedt drie oppervlakken die kunnen worden geïmplementeerd: Postgres schema (SQL-migraties met versies), edge-functies (WASM + cron + jobs), beleid en geheimen (RLS, env vars, OAuth toepassingen). Elk duwt zichzelf onafhankelijk via aura CLI.

De CLI (aura) is een enkel binair bestand, ook installeerbaar met npm install -g @aurabase/cli, en ondersteunt dry-run, bevestigingsprompts en diff-preview. Linux/macOS/Windows-compatibel.

Ontwikkelaar, preview, productie#

Standaard heeft een project twee omgevingen: dev (lokaal, Kubernetes) en prod (cloud). Als u vóór de productie een wijziging op een kopie van uw gegevens wilt proberen, maakt u een databasetak.

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 met versieversie, atomaire rollback#

Migraties leven in aurabase/migrations. Eén bestand per wijziging, tijdstempel in voorvoegsel. De CLI past de ontbrekende migraties toe op het gekoppelde project; genereer uw TypeScript-typen opnieuw met npx @aurabase/gen na een wijziging.

terminalbash
# Maak een nieuwe migratie
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql

# Bekijk welke migraties zijn toegepast of in behandeling zijn en pas ze vervolgens toe op het gekoppelde project
aura db status
aura db push

# Genereer TypeScript-typen opnieuw
npx @aurabase/gen --out src/aurabase.types.ts

# Maak een lijst van toegepaste migraties
aura db migration list
Aandacht

Migraties zonder downtime. Volg de regels: voeg eerst een null-kolom toe, scheid de aanvulling en de beperking NIET NULL als laatste. De CLI controleert de achterwaartse compatibiliteit niet voor u: bekijk destructieve instructies (drop column, alter column … type) vóór aura db push.

Databasetakken#

Een branch is een nieuw project gekloond uit een bestaand PostgreSQL project: het schema, het beveiligingsbeleid op rijniveau, de functies, triggers, views en (tenzij je alleen om het schema vraagt) de rijen. Het heeft zijn eigen URL, API-sleutels en database, zodat u een migratie kunt uitvoeren, beleid kunt testen of er een preview-implementatie naar kunt richten zonder de bron aan te raken. Takken worden automatisch verwijderd wanneer hun levensduur eindigt.

clibash
# Van het gekoppelde project (auralink), standaard 72 uur
aura branch create feat/new-checkout

# Van een ander project, 7 dagen bewaard
aura branch create pr-142 --from my-app --ttl 7d

# Alleen schema: er wordt geen rij gekopieerd, reeksen beginnen opnieuw
aura branch create schema-test --no-data

aura branch list                    # de takken van het gekoppelde project
aura branch list --all              # elke tak van de organisatie
aura branch delete feat/new-checkout

aura branch create wacht tot de vertakking klaar is en drukt vervolgens de URL en de API-sleutels af, wordt slechts één keer weergegeven zoals die van aura projects create (--json drukt ze af voor scripts). Gebruik --no-wait om meteen terug te keren en volg het met aura branch list. Een branch is een project: koppel er een map aan met aura link --project-id <id> en voer daar aura db push uit om een ​​migratie uit te proberen.

Wat een tak precies is

Een branch is een -kopie gemaakt tijdens het maken van, geen live replica en geen copy-on-write-kloon: niets vloeit daarna terug naar de bron of daaruit. Het platform leest de bron in één consistente momentopname en kopieert de rijen naar de filiaaldatabase, zodat de tijd proportioneel is aan de gegevens. Op de lokale teststack werd in 14 seconden een tabel van 333 MB met 350.000 rijen gekloond. Een migratie die op de branch werkt, wordt vervolgens toegepast op productie met de gebruikelijke aura db push.

Grenzen, volledig#

Wie kan aanmakenLeden met de rol developer of hoger, van een PostgreSQL-project dat actief is en niet in de slaapstand staat. Een MongoDB-project wordt geweigerd.
Een tak vertakkenGeweigerd: maak de branch van het bovenliggende project.
NaamLetters, cijfers, ., _, - en /, maximaal 63 tekens, uniek per project onder de live vertakkingen (niet hoofdlettergevoelig).
Tijd om te levenStandaard 72 uur, van 1 uur tot 30 dagen (--ttl 1h tot --ttl 30d). De verlopen tak en de bijbehorende database worden automatisch verwijderd, binnen ongeveer een minuut na de deadline. Je kunt het eerder verwijderen.
PlanlimietEen vertakking telt niet mee voor uw projectlimiet (max_projects); het heeft zijn eigen limiet van actieve vestigingen per organisatie (max_branches): 1 op Free, 10 op Pro, 25 op Team. Als dit voorbij is, wordt de creatie geweigerd met BRANCH_LIMIT_REACHED. Een mislukte vertakking telt niet mee. Zie limieten.
GegevensgrootteDe rijen worden gestreamd en niet in het geheugen bewaard, dus er is geen plafond van 32 MiB. Klonen wordt binnen een paar seconden geweigerd als de tabellen meer dan de limiet van de implementatie bevatten (standaard 2 GiB, BRANCH_CLONE_MAX_BYTES als u Aurabase host): het bericht geeft de grootte aan en suggereert --no-data. Een kloon stopt ook na 30 minuten.

Wat is niet gekloond#

  • Gekloond: tabellen en hun rijen, kolomtypen, standaardwaarden, identiteitskolommen, reeksen en hun huidige waarde, beperkingen, indexen, beveiliging op rijniveau (ingeschakeld, geforceerd, beleid), SQL-functies en -procedures, triggers, weergaven en gerealiseerde weergaven, opsommingstypen en de rechten voor al deze.
  • Niet gekloond: auth gebruikers, sessies en auth instellingen; opslagemmers en voorwerpen; edge-functies, geheimen, omgevingsvariabelen en cron-jobs; realtime tabelinstellingen (schakel ze opnieuw in op de vertakking); tabel- en kolomcommentaar, inclusief @graphql-richtlijnen; rechten op kolomniveau; de pg_graphql-activering (aura projects graphql-enable op de tak). Objecten zijn eigendom van de beheerdersrol van de vertakking.
  • Geweigerd (de vertakking zou onvolledig zijn): gepartitioneerde en overgenomen tabellen, buitenlandse tabellen, domeinen, samengestelde en bereiktypen, aggregatiefuncties, herschrijfregels, externe sleutels die naar een ander schema verwijzen en andere extensies dan die het platform in elk project installeert.

Er wordt een vertakking gemaakt op basis van het schema zoals het net vóór de kopie wordt gelezen. Wijzig het schema van de bron (aura db push, DDL) niet terwijl er een vertakking wordt gemaakt.

Als de schepping mislukt#

Er wordt niets achtergelaten. De kopie wordt in één transactie uitgevoerd op de filiaaldatabase; bij elke fout wordt het teruggedraaid, het vertakkingsproject wordt verwijderd en aura branch create drukt de reden af ​​(bijvoorbeeld het object dat niet kan worden gekloond). De mislukte branch blijft 24 uur zichtbaar in aura branch list met zijn bericht, en de naam is weer vrij. Als de databaseservice midden in een kopie opnieuw opstart, wordt de vertakking mislukt verklaard en na 45 minuten verwijderd.

Drie integraties klaar#

De CLI werkt met elk CI. Hier zijn de recepten voor de drie meest voorkomende.

.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   # of download het binaire bestand van de releasepagina
      - run: aura login --token ${{ secrets.AURA_PAT }}   # Persoonlijk toegangstoken aura_pat_*
      - run: aura link ${{ vars.AURA_PROJECT_ID }}
      - run: aura db push
      - run: aura deploy functions

Koppel één project per omgeving (een faseringsproject en een productieproject) en voer voor elke omgeving dezelfde pijplijn uit. Er is geen --env-vlag: het doel is het project waaraan de map is gekoppeld.

Atomair, via neerwaartse migratie#

Elke 20260415_xxx.sql-migratie kan een 20260415_xxx.down.sql-bestand ernaast hebben. aura db migration down [n] voert de .down.sql uit van de laatste n toegepaste migraties, de nieuwste eerst, en verwijdert deze uit de geschiedenis; de opdracht controleert het antwoord van de server en mislukt als er niets is teruggedraaid. Een migratie zonder .down.sql wordt alleen uit de geschiedenis verwijderd, en dat zegt de CLI ook.

rollbackbash
# De laatst toegepaste migratie terugdraaien (voert zijn .down.sql uit)
aura db migration down

# Zet de laatste drie terug
aura db migration down 3

# Herstel de geschiedenis zonder het schema aan te raken (een handmatig toegepaste migratie, een mislukte)
aura db migration repair 20260415120000_add_devices_table.sql --applied

# Een mislukte migratie wordt in zijn eigen transactie geannuleerd: er valt niets terug te draaien.
# Point-in-time herstel van een hele database gaat via back-ups (aura db backup herstel <id> --yes)
Aandacht

Point-in-time herstel heeft nog geen zelfbedieningsopdracht. Voor een herstelbewerking die u zelf uitvoert, gebruikt u de snapshots van aura db backup create / aura db backup restore <id> --yes; het herstel overschrijft de database, dus maak eerst een nieuwe back-up.

Om verder te gaan#