Kurz: Pracovní postup vývoje založený na větvích

Důležité

Automatické škálování LakeBase je v beta verzích v následujících oblastech: eastus2, westeurope, westus.

Automatické škálování LakeBase je nejnovější verze LakeBase s automatickým škálováním výpočetních prostředků, škálováním na nulu, větvení a okamžitým obnovením. Porovnání funkcí se službou Lakebase Provisioned najdete v tématu Volba mezi verzemi.

Zjistěte, jak používat větve, jako jsou větve Gitu, a dát každému vývojáři izolovanou větev pro nezávislou práci a pak resetovat synchronizaci.

Požadavky

• Projekt Lakebase s production větví (výchozí)
• Větev development, vytvořená ze production pro sdílenou vývojovou práci
• Základní znalost SQL a Postgres

Nastavení spouštěcího schématu

Před vytvořením větve pro vývojáře nastavte jednoduché schéma ve vývojové větvi. To slouží jako sdílený výchozí bod, ze kterého budou všichni vývojáři forkovat. Když vytvoříte svou osobní větev, toto schéma okamžitě dědí prostřednictvím kopírování při zápisu (copy-on-write).

1. Přejděte do vývojové větve v uživatelském rozhraní Lakebase.
2. Otevřete editor SQL.
3. Vytvořte základní tabulku uživatelů s ukázkovými daty:

CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    email TEXT NOT NULL UNIQUE,
    created_at TIMESTAMP DEFAULT NOW()
);

INSERT INTO users (email) VALUES
    ('alice@example.com'),
    ('bob@example.com'),
    ('charlie@example.com');

Vytvořte větev pro vývojáře

Každý vývojář ve vašem týmu může mít dlouhodobou větev pro průběžnou práci. Pravidelně ho resetujte, abyste zůstali synchronizovaní s nadřazeným.

V seznamu větví projektu vyberte větev pro vývoj a potom klikněte na Vytvořit podřízenou větev. Zadejte název větve (povinné), například dev/alex (podle vzoru dev/<your-name>) a klikněte na Vytvořit.

Větev je vytvořena okamžitě a zahrnuje všechna schémata a data z vývojového prostředí pomocí techniky copy-on-write.

Vaše hierarchie větví:

production (root)
  └── development (has users table + data)
        └── dev/alex (instantly inherits users table + data)

Vývoj funkce

Nasměrujte aplikaci na vývojovou větev aktualizací připojovacího řetězce v .env souboru a pak pomocí normálního pracovního postupu vytvořte funkci.

Přidání sledování předvoleb uživatele do aplikace by například zahrnovalo aktualizaci uživatelského modelu, vygenerování migrace pomocí vaší architektury (Prisma, Alembic, Django atd.) a jeho spuštění ve vaší dev/alex větvi. Soubor migrace může obsahovat:

ALTER TABLE users ADD COLUMN preferences JSONB DEFAULT '{}';
CREATE INDEX idx_users_preferences ON users USING GIN (preferences);

Po spuštění migrace vyvíjejte funkci předvoleb v kódu aplikace a otestujte celý tok místně. Vaše větev je zcela izolovaná – změny nemají vliv na produkční ani jiné vývojáře.

Kontrola změn

Před nasazením do jiných prostředí ověřte pomocí funkce porovnání schémat, co se změnilo. Přejděte na přehled vaší větve dev/alex, klikněte na Rozdíl schématu a porovnejte ho proti development.

Porovnání vedle sebe ukazuje, že váš nový preferences sloupec a index jsou zvýrazněny zeleně:

Tento krok ověření pomáhá zachytit nezamýšlené změny, než se dostanou do produkčního prostředí. Kompletní dokumentaci k rozdílům schémat viz Porovnání schémat větví.

Podpořte své změny

Pokud si jste jisti svými změnami, nasměrujte je do vyšších větví. Použijte stejné změny schématu, které jste ověřili na dev/alex, ve vaší větvi development, a potom nasaďte kód aplikace. Tento pracovní postup zajišťuje, že se změny schématu testují izolovaně před dosažením sdíleného prostředí.

Obnovit a začít znovu

Až budete připraveni začít novou práci, resetujte svou osobní větev, aby zůstala synchronizovaná s development, která mohla být změněna jinými vývojáři. Tím získáte čistý start od aktuální sdílené referenční úrovně.

Přejděte do větve dev/alex a klikněte na Obnovit z nadřazeného objektu. Modální resetování potvrzuje, že všechny databáze a role budou nahrazeny nejnovějšími daty z development. Tato akce není nevratná, proto se před potvrzením ujistěte, že jste upřednostnili všechny změny, které chcete zachovat.

Vaše větev nyní přesně odpovídá development a je připravena na váš další úkol.

Osvědčené postupy

• Používejte konzistentní pojmenování:dev/<name> Postupujte podle modelu pro vývojářské větve.
• Pravidelně resetovat: Udržujte větev synchronizovanou, development abyste se vyhnuli posunu.
• Ochrana produkčního prostředí: Použití chráněných větví k zabránění náhodným změnám