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ą.
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.
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.
# 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
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.
# 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.
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łu | Odmówiono: utwórz gałąź z projektu nadrzędnego. |
| Nazwa | Litery, cyfry, ., _, - i /, do 63 znaków, unikalne dla projektu wśród aktywnych gałęzi (wielkość liter nie jest uwzględniana). |
| Czas życia | Domyś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 planu | Oddział 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 danych | Wiersze 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-enablena 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.
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.
# 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)
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#
- Podgląd baz danych na żądanie ściągnięcia
Gałąź na żądanie ściągnięcia w CI i jej czyszczenie.
- Wdrożenie w wielu regionach
Replikacja, przełączanie awaryjne, przechowywanie danych.
- Audyt wydajności
WYJAŚNIJ ANALIZĘ, indeksy, powolne zapytania.
- Odniesienie do interfejsu wiersza polecenia
Wszystkie polecenia, flagi, env vars.