Spravovanie vetiev v pracovných priestoroch služby Microsoft Fabric
Cieľom tohto článku je poskytnúť vývojárom služby Fabric rôzne možnosti na vytváranie procesov CI/CD v službe Fabric na základe bežných scenárov pre zákazníkov. Tento článok sa viac zameriava na spojitú integráciu (CI) v procese CI/CD. Informácie o časti o nepretržitom doručovaní (CD) nájdete v téme Spravovanie kanálov nasadenia.
V tomto článku je prehľad niekoľkých rôznych možností integrácie, ale mnohé organizácie používajú ich kombináciu.
Požiadavky
Ak chcete integrovať systém Git s pracovným priestorom služby Microsoft Fabric, musíte nastaviť nasledujúce predpoklady pre službu Fabric aj systém Git.
Predpoklady tkaniny
Ak chcete získať prístup k funkcii integrácie systému Git, budete potrebovať kapacitu služby Fabric. Na používanie všetkých podporovaných položiek služby Fabric sa vyžaduje kapacita služby Fabric. Ak ho ešte nemáte, zaregistrujte si bezplatnú skúšobnú verziu. Zákazníci, ktorí už majú kapacitu Power BI Premium, môžu túto kapacitu používať, ale majte na pamäti, že určité skladové jednotky SKU služby Power BI podporujú iba položky služby Power BI,.
Okrem toho musia byť na portáli na správu povolené nasledujúce prepínače nájomníka:
- Používatelia môžu vytvárať položky služby Fabric
- Používatelia môžu synchronizovať položky pracovného priestoru so svojimi odkladacími priestormi Git
- Len pre používateľov služby GitHub: Používatelia môžu synchronizovať položky pracovného priestoru s odkladacími priestormi GitHub
Tieto prepínače môže povoliť správca nájomníka, správca kapacity alebo správca pracovného priestoru v závislosti od nastavení vašej organizácie.
Požiadavky Gitu
Integrácia systému Git je v súčasnosti podporovaná pre služby Azure DevOps a GitHub. Ak chcete používať integráciu systému Git s pracovným priestorom služby Fabric, budete potrebovať nasledujúce informácie v službách Azure DevOps alebo GitHub:
- Aktívne konto Azure zaregistrované u toho istého používateľa, ktorý používa pracovný priestor služby Fabric. Vytvorte si bezplatné konto.
- Prístup k existujúcemu odkladaciemu priestoru.
Proces vývoja
Pracovný priestor služby Fabric je zdieľané prostredie, ktoré pristupuje k živým položkách. Všetky zmeny vykonané priamo v pracovnom priestore sa prepíšu a ovplyvnia všetkých ostatných používateľov pracovného priestoru. Preto je najlepším postupom systému Git, aby vývojári pracovali oddelene mimo zdieľaných pracovných priestorov. Existujú dva spôsoby, ako môže vývojár pracovať vo vlastnom chránenom pracovnom priestore.
- Vyvíjajte pomocou klientskych nástrojov, ako je napríklad Power BI Desktop pre zostavy a sémantické modely alebo VS Code pre poznámkové bloky.
- Vyvíjajte v samostatnom pracovnom priestore služby Fabric. Každý vývojár má svoj vlastný pracovný priestor, v ktorom pripojí svoju vlastnú samostatnú vetvu, synchronizuje obsah do tohto pracovného priestoru a potom sa vráti do vetvy.
Ak chcete pracovať s vetvami pomocou integrácie Git, najprv pripojte pracovný priestor zdieľaného vývojového tímu k jednej zdieľanej vetve. Ak napríklad váš tím používa jeden zdieľaný pracovný priestor, pripojte ho k hlavnej vetve v odkladacom priestore vášho tímu a synchronizujte medzi pracovným priestorom a odkladacím priestorom. Ak pracovný postup vášho tímu obsahuje viacero zdieľaných vetiev, ako napríklad vetvy Dev/Test/Prod , každá vetva môže byť pripojená k inmu pracovnému priestoru.
Potom si každý vývojár môže vybrať izolované prostredie, v ktorom má pracovať.
Scenár 1 – Vývoj pomocou klientskych nástrojov
Ak sú položky, ktoré vyvíjate, k dispozícii v iných nástrojoch, môžete na týchto položkách pracovať priamo v klientskom nástroji. Nie všetky položky sú k dispozícii v každom nástroji. Položky, ktoré sú k dispozícii len v službe Fabric, je potrebné vyvíjať v službe Fabric.
Pracovný postup pre vývojárov, ktorý používa klientsky nástroj, ako napríklad Power BI Desktop, by mal vyzerať približne takto:
Clone odkladací priestor do lokálneho počítača. (Tento krok stačí urobiť iba raz.)
Otvorte projekt v aplikácii Power BI Desktop pomocou lokálnej kópie súboru PBIProj.
Vykonajte zmeny a uložte aktualizované súbory lokálne. Potvrdenie lokálneho odkladacieho priestoru.
Keď budete pripravení, zatlačte vetvu a odošlite sa do vzdialeného odkladacieho priestoru.
Testovanie zmien v iných položkách alebo oproti viacerým údajom. Ak chcete otestovať zmeny, pripojte novú vetvu k samostatnému pracovnému priestoru a nahrajte sémantický model a zostavy pomocou tlačidla aktualizovať všetko na paneli ovládacieho prvku Zdroj. Pred zlúčením do hlavnej vetvy vykonajte všetky testy alebo zmeny konfigurácie.
Ak sa v pracovnom priestore nevyžadujú žiadne testy, vývojár môže zlúčiť zmeny priamo do hlavnej vetvy bez nutnosti ďalšieho pracovného priestoru.
Po zlúčení zmien sa pracovný priestor zdieľaného tímu zobrazí výzva na prijatie nového potvrdenia. Zmeny sa aktualizujú do zdieľaného pracovného priestoru a zmeny v týchto sémantických modeloch a zostavách si môže zobraziť každý.
Špecifické pokyny na používanie nového formátu súboru aplikácie Power BI Desktop v službe git nájdete v téme Formát zdrojového kódu.
Scenár 2 – Vývoj pomocou iného pracovného priestoru
V prípade vývojára, ktorý pracuje na webe, by postup bol takýto:
Na karte Vetvy v ponuke ovládacieho prvku Source vyberte položky Vetviť do iného pracovného priestoru.
Zadajte, či chcete vytvoriť nový pracovný priestor alebo prepnúť na existujúci. Zadajte názvy novej vetvy a pracovného priestoru alebo z rozbaľovacieho zoznamu vyberte existujúci pracovný priestor. Keď odbočíte do pracovného priestoru, položky, ktoré nie sú uložené v Git, sa môžu stratiť. Odporúča sa potvrdiť všetky položky, ktoré chcete zachovať pred vetvením.
Vyberte položku Vetva von.
Fabric vytvorí nový pracovný priestor a vetvu. Automaticky sa vrátite do nového pracovného priestoru.
Pracovný priestor sa synchronizuje s vetvou funkcie a stane sa izolovaným prostredím, v akom je znázornené. Teraz môžete pracovať v tomto novom izolovanom prostredí. Synchronizácia môže trvať niekoľko minút. Ďalšie informácie o vetvení sa nachádzajú v téme tipov na riešenie problémov.
Uložte zmeny a potvrďte ich do vetvy funkcií.
Keď budete pripravení, vytvorte PR do hlavnej vetvy. Procesy revízie a zlúčenia sa vykonávajú prostredníctvom odkladacích priestorov Azure Na základe konfigurácie, ktorú váš tím definoval pre tento odkladací priestor.
Po dokončení kontroly a zlúčenia sa vytvorí nové potvrdenie pre hlavnú vetvu. Týmto potvrdením sa používateľovi zobrazí výzva na aktualizáciu obsahu v pracovnom priestore tímu dev so zlúčenými zmenami.
Ďalšie informácie nájdete obmedzenia týkajúce sa vetvenia.
Proces vydania
Proces vydania sa spustí, keď nové aktualizácie dokončia proces žiadosti o prijatie zmien a zlúčia sa do zdieľanej vetvy tímu (napríklad hlavného, Devatď.). Od tohto bodu existujú rôzne možnosti vytvorenia procesu vydania v službe Fabric. Ďalšie možnosti, ktoré je potrebné zvážiť pri navrhovaní pracovného postupu, nájdete v téme proces vydania.
Prepínanie vetiev
Ak je váš pracovný priestor pripojený k vetve Git a chcete prepnúť na inú vetvu, môžete to urobiť rýchlo z tably Ovládací prvok Zdroj bez odpojenia a opätovného pripojenia.
Po prepnutí vetiev sa pracovný priestor synchronizuje s novou vetvou a všetky položky v pracovnom priestore sa prepíšu. Ak v každej vetve existujú rôzne verzie tej istej položky, položka sa nahradí. Ak sa položka nachádza v starej vetve, ale nie v novej, odstráni sa.
Ak chcete prepínať medzi vetvami, postupujte podľa týchto krokov:
Na karte Vetvy v ponuke ovládacieho prvkuZdroj vyberte položku Prepnúť vetvu.
Zadajte vetvu, ku ktorému sa chcete pripojiť, alebo vytvorte novú vetvu. Táto vetva musí obsahovať rovnaký adresár ako aktuálna vetva.
Vyberte položku Prepnúť vetvu.
Vetvy nie je možné prepínať, ak máte v pracovnom priestore akékoľvek nevydané zmeny. Výberom položky Zrušiť sa vráťte a potvrďte zmeny pred prepnutím vetiev.
Ak chcete pripojiť aktuálny pracovný priestor k novej vetve a zachovať si stav existujúceho pracovného priestoru, vyberte možnosť Pokladňa nová vetva. Ďalšie informácie o kontrole novej vetvy v téme Riešenie konfliktov v Git.