Platforma
Gałęzie baz (branching)
Osobne środowiska bazy do testów i preview — schemat lub schemat z danymi, migracje z powrotem do produkcji.
Gałąź to pełny, odizolowany klon projektu — własny Postgres, Auth, Storage, Realtime i Edge Functions, z własnymi kluczami API — utworzony z projektu produkcyjnego. Używasz jej do testowania migracji, preview deploymentów i eksperymentów bez ryzyka dla produkcji. Gałęzie znajdziesz w przełączniku środowiska w górnym pasku (main PRODUKCJA) i na stronie Gałęzie.
Tryby tworzenia
| Tryb | Co jest kopiowane | Kiedy używać |
|---|---|---|
schema | Struktura bazy: tabele, funkcje, triggery, polityki RLS, rozszerzenia — bez danych | Testy migracji, środowiska CI, preview |
data | Schemat i dane, w tym użytkownicy Auth i metadane Storage | Debugowanie na realnych danych, analizy |
Gałąź działa w tym samym regionie i na tym samym serwerze co projekt nadrzędny, ma własny ref, adres https://<branch-ref>.host.ulewicz.space i własne hasło bazy. To osobny stos, więc zużywa własne zasoby (RAM, dysk, połączenia) — usuwaj nieużywane gałęzie. Usunięcie projektu głównego usuwa też wszystkie jego gałęzie.
| Plan | Gałęzie na projekt |
|---|---|
| Free | 0 |
| Pro | 3 |
| Team | 20 |
| Enterprise | 100 |
Gałęzie nie liczą się do limitu projektów planu — mają własny limit powyżej.
Scalanie
Zmiany schematu przenosisz z gałęzi do produkcji przez migracje: panel porównuje tabele supabase_migrations.schema_migrations obu środowisk i pokazuje migracje obecne tylko na gałęzi (plan scalenia). Scal odtwarza je na produkcji w tej samej kolejności, w jednej transakcji — błąd którejkolwiek cofa całość, a panel pokazuje, która migracja się nie powiodła. Format jest zgodny z supabase db push / supabase migration list.
- Konflikty: jeśli produkcja ma migracje, których nie ma na gałęzi (gałąź jest nieaktualna), plan scalenia je wskazuje — zresetuj gałąź albo przenieś te migracje.
- Reset: odtwarza gałąź z aktualnego stanu produkcji (ten sam
ref, klucze i adres). - Dane nie są scalane — tylko schemat zapisany w migracjach.
API
| Metoda i ścieżka | Opis |
|---|---|
GET /api/v1/projects/{ref}/branches | Lista gałęzi projektu. |
POST /api/v1/projects/{ref}/branches | {"name", "mode": "schema" | "data"} — tworzy gałąź. |
DELETE /api/v1/projects/{ref}/branches/{branch} | Usuwa gałąź i jej stos. |
GET /api/v1/projects/{ref}/branches/{branch}/merge | Plan scalenia „na sucho” — migracje do zastosowania i ewentualne konflikty. |
POST /api/v1/projects/{ref}/branches/{branch}/merge | Scala gałąź (jedna transakcja). |
# nowa gałąź (tylko schemat)
curl -X POST -H "Authorization: Bearer hb_pat_..." -H "content-type: application/json" \
-d '{"name":"feature-login","mode":"schema"}' https://host.ulewicz.space/api/v1/projects/<ref>/branches
# plan scalenia, potem scalenie
curl -H "Authorization: Bearer hb_pat_..." https://host.ulewicz.space/api/v1/projects/<ref>/branches/feature-login/merge
curl -X POST -H "Authorization: Bearer hb_pat_..." https://host.ulewicz.space/api/v1/projects/<ref>/branches/feature-login/mergeMCP
Narzędzia list_branches, create_branch, delete_branch i merge_branch (z dry_run zwracającym sam plan) — agent AI może utworzyć gałąź, przetestować na niej migrację, pokazać plan i scalić ją po Twojej akceptacji.