Przejdź do treści
Logo Aurabase
aurabaza

Zastosowanie

Migracje bez przestojów, wycofanie atomowe, CI/CD poprzez GitHub Akcje / GitLab / CLI i gałęzie bazy danych: kopia projektu w celu przetestowania migracji lub polityki przed produkcją.

Objaśnienie8 min przeczytanePoziom mediatorZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Trzy powierzchnie rozmieszczenia#

Projekt Aurabase udostępnia trzy powierzchnie do wdrożenia: Postgres schemat (wersjonowane migracje SQL), funkcje brzegowe (WASM + cron + zadania), zasady i sekrety (RLS, env vars, OAuth aplikacji). Każdy z nich przesyła się niezależnie za pośrednictwem interfejsu CLI aura.

Interfejs CLI (aura) to pojedynczy plik binarny, który można również zainstalować z npm install -g @aurabase/cli i obsługuje próbę próbną, monity o potwierdzenie i podgląd różnic. Kompatybilny z Linuxem / macOS / Windowsem.

Dev, podgląd, produkcja#

Domyślnie projekt ma dwa środowiska: dev (lokalne, Kubernetes) i prod (chmura). Aby spróbować wprowadzić zmiany w kopii danych przed produkcją, utwórz gałąź bazy danych gałęzie bazy danych.

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

Wersjonowany SQL, atomowe wycofywanie#

Migracje żyją w aurabase/migrations. Jeden plik na zmianę, znacznik czasu w przedrostku. Interfejs CLI stosuje brakujące migracje do połączonego projektu; zregeneruj swoje typy TypeScript za pomocą npx @aurabase/gen po zmianie.

terminalbash
# Utwórz nową migrację
aura db migration new add_devices_table
# → aurabase/migrations/20260415120000_add_devices_table.sql

# Sprawdź, które migracje zostały zastosowane lub oczekują, a następnie zastosuj je w połączonym projekcie
aura db status
aura db push

# Wygeneruj ponownie typy TypeScript
npx @aurabase/gen --out src/aurabase.types.ts

# Lista zastosowanych migracji
aura db migration list
Uwaga

Migracje bez przestojów. Postępuj zgodnie z zasadami: najpierw dodaj kolumnę dopuszczającą wartość null, oddzielne uzupełnienie, na końcu ograniczenie NOT NULL. Interfejs CLI nie sprawdza kompatybilności wstecznej: przejrzyj instrukcje destrukcyjne (drop column, alter column … type) przed aura db push.

Gałęzie bazy danych#

Gałąź to nowy projekt sklonowany z istniejącego projektu PostgreSQL: jego schemat, zasady bezpieczeństwa na poziomie wierszy, funkcje, wyzwalacze, widoki i (chyba że poprosisz tylko o schemat) jego wiersze. Ma własny adres URL, klucze API i bazę danych, dzięki czemu możesz przeprowadzić migrację, przetestować politykę lub wskazać jej wdrożenie podglądowe bez dotykania źródła. Oddziały są usuwane automatycznie po upływie ich czasu życia.

clibash
# Z połączonego projektu (link aura), domyślnie 72 godziny
aura branch create feat/new-checkout

# Z innego projektu, przechowywane 7 dni
aura branch create pr-142 --from my-app --ttl 7d

# Tylko schemat: żaden wiersz nie jest kopiowany, sekwencje zaczynają się od nowa
aura branch create schema-test --no-data

aura branch list                    # gałęzie powiązanego projektu
aura branch list --all              # każdy oddział organizacji
aura branch delete feat/new-checkout

aura branch create czeka, aż gałąź będzie gotowa, następnie wypisuje swój adres URL i klucze API, pokazywane tylko raz, tak jak te z aura projects create (--json drukuje je dla skryptów). Użyj --no-wait, aby od razu wrócić i podążaj za nim za pomocą aura branch list. Gałąź jest projektem: połącz z nią folder za pomocą aura link --project-id <id> i uruchom tam aura db push, aby spróbować migracji.

Czym właściwie jest oddział

Gałąź jest kopią utworzoną w czasie tworzenia, a nie repliką na żywo ani klonem kopiującym przy zapisie: nic nie wraca do źródła ani z niego później. Platforma odczytuje źródło w jednym spójnym snapshotie i kopiuje wiersze do bazy branżowej, dzięki czemu czas jest proporcjonalny do danych. Na lokalnym stosie testowym w 14 sekund sklonowano tabelę o rozmiarze 333 MB i zawierającą 350 000 wierszy. Migracja działająca w gałęzi jest następnie stosowana do produkcji za pomocą zwykłego aura db push.

Limity w całości#

Kto może utworzyćCzłonkowie z rolą developer lub większą z projektu PostgreSQL, który jest aktywny i nie jest w stanie hibernacji. Projekt MongoDB został odrzucony.
Rozgałęzianie oddziałuOdmówiono: utwórz gałąź z projektu nadrzędnego.
NazwaLitery, cyfry, ., _, - i /, do 63 znaków, unikalne dla projektu wśród aktywnych gałęzi (wielkość liter nie jest uwzględniana).
Czas życiaDomyślnie 72 godziny, od 1 godziny do 30 dni (--ttl 1h do --ttl 30d). Wygasły oddział i jego baza danych są automatycznie usuwane w ciągu około minuty od upływu terminu. Możesz go wcześniej usunąć.
Limit planuOddział wlicza , a nie do limitu projektu (max_projects); ma swój własny limit aktywnych oddziałów na organizację (max_branches): 1 w wersji bezpłatnej, 10 w wersji Pro, 25 w wersji zespołowej. Poza tym tworzenie jest odrzucane za pomocą BRANCH_LIMIT_REACHED. Nieudana gałąź nie liczy się. Zobacz limity.
Rozmiar danychWiersze są przesyłane strumieniowo, a nie przechowywane w pamięci, więc nie ma limitu 32 MiB. Klonowanie jest odrzucane po kilku sekundach, gdy tabele zawierają więcej niż limit wdrożenia (domyślnie 2 GiB, BRANCH_CLONE_MAX_BYTES, gdy hostujesz Aurabase): komunikat podaje rozmiar i sugeruje --no-data. Klon zatrzymuje się również po 30 minutach.

Co nie jest klonowane#

  • Sklonowane: tabele i ich wiersze, typy kolumn, wartości domyślne, kolumny tożsamości, sekwencje i ich bieżąca wartość, ograniczenia, indeksy, zabezpieczenia na poziomie wierszy (włączone, wymuszone, zasady), funkcje i procedury SQL, wyzwalacze, widoki i widoki zmaterializowane, typy wyliczeniowe i uprawnienia do nich wszystkich.
  • Nie sklonowano: autoryzowani użytkownicy, sesje i ustawienia autoryzacji; wiadra i przedmioty do przechowywania; funkcje brzegowe, sekrety, zmienne środowiskowe i zadania cron; ustawienia tabeli w czasie rzeczywistym (włącz je ponownie na oddziale); komentarze do tabel i kolumn, w tym dyrektywy @graphql; uprawnienia na poziomie kolumny; aktywacja pg_graphql (aura projects graphql-enable na gałęzi). Właścicielem obiektów jest rola administratora oddziału.
  • Odmówiono (gałąź byłaby niekompletna): tabele partycjonowane i dziedziczone, tabele obce, domeny, typy złożone i zakresowe, funkcje agregujące, reguły przepisywania, klucze obce wskazujące inny schemat i rozszerzenia inne niż te, które platforma instaluje w każdym projekcie.

Na podstawie schematu odczytywanego tuż przed kopią tworzona jest gałąź. Nie zmieniaj schematu źródła (aura db push, DDL) podczas tworzenia gałęzi.

Kiedy tworzenie się nie powiedzie#

Nic nie pozostaje w tyle. Kopia działa w ramach pojedynczej transakcji w bazie danych oddziału; w przypadku jakiegokolwiek niepowodzenia jest on wycofywany, projekt gałęzi jest usuwany, a aura branch create wypisuje przyczynę (na przykład obiekt, którego nie można sklonować). Oddział, który uległ awarii, pozostaje widoczny w aura branch list przez 24 godziny wraz ze swoim komunikatem, a jego nazwa jest znów wolna. Jeśli usługa bazy danych zostanie uruchomiona ponownie w trakcie kopiowania, gałąź zostanie uznana za nieudaną i usunięta po 45 minutach.

Trzy integracje gotowe#

Interfejs CLI współpracuje z dowolnym CI. Oto przepisy na trzy najpopularniejsze.

.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   # lub pobierz plik binarny ze strony wydania
      - run: aura login --token ${{ secrets.AURA_PAT }}   # Osobisty token dostępu aura_pat_*
      - run: aura link ${{ vars.AURA_PROJECT_ID }}
      - run: aura db push
      - run: aura deploy functions

Połącz jeden projekt na środowisko (projekt przejściowy i projekt produkcyjny) i uruchom dla każdego z nich ten sam potok. Nie ma flagi --env: celem jest projekt, z którym powiązany jest folder.

Atomowy, poprzez migrację w dół#

Przy każdej migracji 20260415_xxx.sql może znajdować się plik 20260415_xxx.down.sql. aura db migration down [n] uruchamia .down.sql ostatnich n zastosowanych migracji, zaczynając od najnowszych, i usuwa je z historii; polecenie sprawdza odpowiedź serwera i kończy się niepowodzeniem, jeśli nic nie zostało przywrócone. Migracja bez .down.sql jest usuwana z historii tylko i tak mówi CLI.

rollbackbash
# Przywróć ostatnio zastosowaną migrację (uruchamia plik .down.sql)
aura db migration down

# Cofnij ostatnie trzy
aura db migration down 3

# Napraw historię bez dotykania schematu (migracja zastosowana ręcznie, nieudana)
aura db migration repair 20260415120000_add_devices_table.sql --applied

# Nieudana migracja zostaje anulowana w osobnej transakcji: nie ma już możliwości cofnięcia.
# Odzyskiwanie całej bazy danych do określonego momentu odbywa się poprzez kopie zapasowe (przywracanie kopii zapasowej aura db <id> --yes)
Uwaga

Odzyskiwanie do określonego momentu nie ma jeszcze polecenia samoobsługi. Do samodzielnego przywracania użyj migawek aura db backup create / aura db backup restore <id> --yes; przywracanie nadpisuje bazę danych, więc najpierw wykonaj nową kopię zapasową.

Aby pójść dalej#