Začíname s integráciou Git

Tento článok vás prevedie nasledujúcimi základnými úlohami v integračnom nástroji Fabric s Gitom:

• Pripojenie k odkladacom priestoru Git
• Potvrdiť zmeny
• Aktualizácia z Git
• Odpojenie od systému Git

Skôr než začnete, odporúčame vám prečítať si prehľad integrácie so službou Git.

Požiadavky

Na integráciu Gitu s vaším pracovným priestorom Microsoft Fabric musíte nastaviť nasledujúce predpoklady pre Fabric aj Git.

Predpoklady tkaniny

Na access integráciu Git potrebujete Fabric kapacitu. 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ú Power BI Premium kapacitu, môžu túto kapacitu využiť, ale majte na pamäti, že niektoré Power BI SKU podporujú len Power BI položky.

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ť predmety Fabric – vyžaduje artifacts použitie Fabric
• Používatelia môžu synchronizovať položky pracovného priestoru so svojimi odkladacími priestormi Git
• Vytvorenie pracovných priestorov (iba ak chcete odbočiť do nového pracovného priestoru.)
• Používatelia môžu synchronizovať položky pracovného priestoru s GitHub repozitármi: Iba pre GitHub používateľov

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 Git je momentálne podporovaná pre Azure DevOps a GitHub. Na použitie integrácie Git s vaším pracovným priestorom Fabric potrebujete v Azure DevOps alebo GitHub nasledovné:

Azure DevOps

• Aktívny účet Azure DevOps registrovaný na toho istého používateľa Fabric (podporovaný aj v prípade, že Azure DevOps organizácia sídli v inom tenante ako Fabric tenant). Vytvor si bezplatný účet.
• Access k existujúcemu repozitáru.

GitHub

• Aktívny účet na GitHub. Vytvoriť GitHub účet.

• Jeden z nasledujúcich osobných access žetónov:

  • jemnozrnný token (odporúčané) s povolením na čítanie a zápis Contents pod oprávneniami repozitára:

    

    Ak chcete tento token použiť s GitHub Enterprise, postupujte podľa týchto pokynov.

  • Vytvoriť GitHub klasický token s povolenými repozitárnymi rozsahmi:

    

Pripojenie pracovného priestoru k odkladacom priestoru Git

Pripojenie k odkladacom priestoru Git

Len správca pracovného priestoru môže pripojiť pracovný priestor k odkladaciemu priestoru, ale po pripojení môže pracovný priestor pracovať ktokoľvek s povolením . Ak nie ste správcom, požiadajte správcu o pomoc s pripojením. Ak chcete pripojiť pracovný priestor k Azure alebo GitHub repozitáru, postupujte podľa týchto krokov:

1. Prihláste sa do služby Fabric a prejdite do pracovného priestoru, ku ktorému sa chcete pripojiť.

2. Prejsť do časti Nastavenia pracovného priestoru

   

3. Vyberte položku Integrácia Git.

4. Vyberte poskytovateľa systému Git. V súčasnosti sú podporované Azure DevOps a GitHub.

Azure DevOps Connect

Ak vyberiete Azure DevOps, vyberte Connect aby ste sa automaticky prihlásili do Azure Repos účtu registrovaného na používateľovi Microsoft Entra prihlásenom v Fabric.

Ak ste sa už prihlásili do Azure cez Fabric pomocou iného účtu, vyberte si svoj účet zo zoznamu a vyberte Connect.

Ak sa prihlasujete zo služby Fabric prvýkrát alebo chcete pridať nové konto, vyberte položku Pridať konto.

Ak sa pripájate prvýkrát, musíte autorizovať používateľa. Zadajte nasledujúce informácie:

• Zobrazované meno – musí byť jedinečné pre každého používateľa
• Azure DevOps URL - URL repozitára Azure DevOps. URL musí byť vo formáte https://dev.azure.com/{organization}/{project}/_git/{repository} alebo https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Overovanie – overenie môžete overiť pomocou OAuth2 alebo objektu služby. Pre viac informácií pozri Azure DevOps - Git Integration with service principal

Po prihlásení vyberte Connect aby Fabric mohol access váš účet

GitHub Pripoj

Ak vyberiete GitHub, musíte sa prihlásiť do svojho GitHub účtu. Ak ste sa už prihlásili do GitHub, vyberte si svoj účet zo zoznamu a vyberte Connect.

Ak sa prihlasujete zo služby Fabric prvýkrát alebo chcete pridať nové konto, vyberte položku Pridať konto.

Ak sa pripájate prvýkrát, musíte Authorize svojho GitHub používateľa. Zadajte nasledujúce informácie:

• Zobrazované meno - musí byť jedinečný pre každého GitHub používateľa
• Osobný access token - váš klasický alebo jemnozrnný osobný access token
• Repository URL (voliteľné pre github.com, povinné pre ghe.com) - Ak URL nezadáte, môžete sa pripojiť na akýkoľvek github.com repozitár, ku ktorému access. Ak zadáte URL adresu, môžete sa pripojiť len k tomuto odkladaciemu priestoru.

Po prihlásení vyberte Connect aby Fabric mohol access váš GitHub účet.

Pripojenie k pracovnému priestoru

Ak je pracovný priestor už pripojený k Azure DevOps/GitHub, postupujte podľa pokynov pre Pripojenie k zdieľanému pracovnému priestoru.

Azure DevOps branch connect

1. V rozbaľovacej ponuke zadajte nasledujúce podrobnosti o vetve, ku ktorému sa chcete pripojiť:

   • Organizácia
   • Project
   • Git repozitár.
   • Vetva (Vyberte existujúcu vetvu pomocou rozbaľovacej ponuky alebo vyberte položku + Nová vetva a vytvorte novú vetvu. Súčasne sa môžete pripojiť len k jednej vetve.)
   • Priečinok (zadajte názov existujúceho priečinka alebo zadajte názov na vytvorenie nového priečinka. Ak názov priečinka ponecháte prázdny, obsah sa vytvorí v koreňovom priečinku. Naraz sa môžete pripojiť len k jednému priečinku.)

GitHub branch connect

1. V rozbaľovacej ponuke zadajte nasledujúce podrobnosti o vetve, ku ktorému sa chcete pripojiť:

   • URL repozitára. Ak ste sa pripojili na GitHub pomocou scoped tokenu, URL sa automaticky vyplní a môžete sa pripojiť len k tomuto repozitáru.
   • Vetva (Vyberte existujúcu vetvu pomocou rozbaľovacej ponuky alebo vyberte položku + Nová vetva a vytvorte novú vetvu. Súčasne sa môžete pripojiť len k jednej vetve.)
   • Priečinok (zadajte názov existujúceho priečinka alebo zadajte názov na vytvorenie nového priečinka. Ak názov priečinka ponecháte prázdny, obsah sa vytvorí v koreňovom priečinku. Naraz sa môžete pripojiť len k jednému priečinku.)

Vyberte položku Pripojiť a synchronizovať.

Ak je v počiatočnej synchronizácii pracovný priestor alebo vetva systému Git prázdna, obsah sa skopíruje z umiestnenia nonempty do prázdneho. Ak majú obsah v pracovnom priestore aj v Git vetve, pýtajú sa vás, ktorým smerom by sa mala synchronizácia uberať. Ďalšie informácie o tejto počiatočnej synchronizácii nájdete v téme Pripojenie a synchronizácia.

Po pripojení pracovný priestor zobrazí informácie o riadení zdrojového kódu, ktoré môžete použiť na zobrazenie pripojenej vetvy, stavu každej položky v vetve a času poslednej synchronizácie.

Ak chcete zachovať synchronizáciu pracovného priestoru s vetvou Git, potvrďte všetky zmeny vykonané v pracovnom priestore vo vetve Git a aktualizujte pracovný priestor vždy, keď niekto vytvorí nové záväzky do vetvy Git.

Umožniť prispievateľom a členom meniť pobočky

Štandardne operácie vetvy, ako je Switch branch a Checkout to new branch , vyžadujú rolu administrátora pracovného priestoru. Avšak administrátor pracovného priestoru môže povoliť nastavenie na úrovni pracovného priestoru Povoliť používateľom s aspoň rolou prispievateľa zmeniť Git vetvu. Keď je toto nastavenie povolené, prispievatelia alebo členovia, ktorí majú prístup na zápis ku všetkým artefaktom v pracovnom priestore, môžu tiež prepínať medzi vetvami a vytvárať nové vetvy pod vlastnou identitou.

Toto prostredie:

• Je to nastavené pre každý pracovný priestor (neexistuje prepínač na úrovni tenanta, ktorý by to deaktivoval).
• Vyžaduje aktívne pripojenie na Git v pracovnom priestore.
• Nemení oprávnenia na pripojenie alebo odpojenie pracovného priestoru – tieto akcie zostávajú len administrátorské.

Pre podrobnú tabuľku oprávnení vrátane požiadaviek na rolu Git pozri Oprávnenia.

Potvrdiť zmeny v gitu

Po úspešnom pripojení k priečinku Git upravte pracovný priestor ako zvyčajne. Všetky zmeny, ktoré uložíte, sa uložia iba v pracovnom priestore. Keď budete pripravení, môžete svoje zmeny commitovať do Git vetvy, alebo ich môžete vrátiť späť a vrátiť sa k predchádzajúcemu stavu.

Prečítajte si viac o potvrdeniach.

Potvrdiť systému Git

Ak chcete potvrdiť zmeny vo vetve Git, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.

2. Vyberte ikonu ovládacieho prvku Zdroj. Táto ikona zobrazuje počet nekomprimovaných zmien.

3. Vyberte položku Zmeny na ovládacom paneli Zdroj. Zobrazí sa zoznam so všetkými položkami, ktoré ste zmenili, a ikona označujúca, či je položka nová , upravená , konfliktná , rovnaká zmena alebo odstránená .

4. Vyberte položky, ktoré chcete potvrdiť. Ak chcete vybrať všetky položky, začiarknite horné políčko.

5. Pridajte do poľa komentár. Ak nepridáte komentár, automaticky sa pridá predvolená správa.

6. Vyberte položku Potvrdiť.

   

Po spáchaných zmenách sa položky, ktoré sa dopustili, odstránia zo zoznamu a pracovný priestor odkazuje na nové potvrdenie, že sa synchronizovalo s.

Po úspešnom dokončení potvrdenia sa stav vybratých položiek zmení z hodnoty Uncommitted na Synchronizované.

Commit to standalone branch

Commit to standalone branch je integračná funkcia s Gitom, ktorá vám umožní vytvoriť novú vetvu a vložiť do nej aktuálne zmeny v jednej akcii. Inými slovami, namiesto záväzku na pripojenú vetvu môžete odbočiť za behu: systém spustí novú vetvu Git a uloží tam vašu prácu bez toho, aby ste museli odísť alebo prejsť z pôvodnej vetvy.

1. Prejdite do pracovného priestoru.
2. Vyberte ikonu ovládacieho prvku Zdroj. Táto ikona zobrazuje počet nekomprimovaných zmien.
3. Vyberte položku Zmeny na ovládacom paneli Zdroj. Zobrazí sa zoznam so všetkými položkami, ktoré ste zmenili, a ikona označujúca, či je položka nová , upravená , konfliktná , rovnaká zmena alebo odstránená .
4. Vyberte položky, ktoré chcete potvrdiť. Ak chcete vybrať všetky položky, začiarknite horné políčko.
5. Pridajte do poľa komentár. Ak nepridáte komentár, automaticky sa pridá predvolená správa.
6. Vyberte Commit to new branch.

Dôležité

Majte na pamäti nasledovné:

• Novo vytvorená vetva nebude pripojená k existujúcemu pracovnému priestoru.
• Novo vytvorená vetva bude založená na poslednom synchronizovanom stave aktuálneho pracovného priestoru.
• Táto funkcionalita je možná, keď prichádzajú aktualizácie – aj keď je predvolený commit vypnutý.
• Súčasný stav pracovného priestoru sa kvôli tomuto commitu nezmení a zostane taký, aký je.

Zrušiť zmenu uložené

Po uložení zmien v pracovnom priestore, ak sa rozhodneš, že ich nechceš commitovať do gitu, môžeš zmeny vrátiť späť a vrátiť ich do pôvodného stavu. Ak chcete zmeny vrátiť späť, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.

2. Vyberte tlačidlo Ovládací prvok Zdroj. Toto tlačidlo tiež zobrazuje počet nekomprimovaných zmien.

3. Vyberte položku Zmeny na ovládacompaneli Zdroj. Zobrazí sa zoznam so všetkými položkami, ktoré ste zmenili, a ikona označujúca, či je zmenená položka nová , upravená, konfliktná alebo odstránená .

4. Vyberte zmeny, ktoré chcete vrátiť späť.

5. Začiarknite políčko Rozumiem, že položky pracovného priestoru môžu byť odstránené a nedajú sa obnoviť a vyberte položku Späť.

   

6. Ak to chcete potvrdiť, opäť vyberte položku Zrušiť zmenu. Zobrazené dialógové okno sa môže líšiť v závislosti od toho, či sa rozpoznajú položky, ktoré sa odstránia. Prvá snímka obrazovky nezobrazuje žiadne odstránenia. Druhý, ak sa zistia odstránenia.

   

   

Vybraté položky v pracovnom priestore sa vrátia k tomu, ako boli naposledy synchronizované.

Dôležité

Ak odstránite položku a potom vrátite zmeny späť, vytvorí sa nová položka a niektoré metaúdaje sa môžu stratiť. Napríklad citlivé štítky sa nezachovajú a mali by sa resetovať, pričom vlastník položky je nastavený na aktuálneho používateľa.

Vrátením pridaných položiek sa položka natrvalo odstráni.

Aktualizácia pracovného priestoru z Git

Vždy, keď niekto potvrdí novú zmenu pripojenej vetve Git, v príslušnom pracovnom priestore sa zobrazí oznámenie. Pomocou ovládacieho panela Zdroj načítajte najnovšie zmeny, zlúčenia alebo zmeny do pracovného priestoru a aktualizáciu dynamických položiek. Zmeny priečinkov sa aktualizujú aj. Prečítajte si viac o aktualizácii.

Ak chcete aktualizovať pracovný priestor, postupujte podľa týchto krokov:

1. Prejdite do pracovného priestoru.
2. Vyberte ikonu ovládacieho prvku Zdroj.
3. Vyberte Updates zo zdrojového control panel. Zobrazí sa zoznam so všetkými položkami, ktoré boli vo vetve zmenené od poslednej aktualizácie.
4. Vyberte položku Aktualizovať všetko.

5. V potvrdzovacom dialógu vyberte Aktualizovať.

Po úspešnom aktualizácii sa zoznam položiek odstráni a pracovný priestor odkazuje na nový pracovný priestor, do ktorému je synchronizovaný.

Po úspešnom dokončení aktualizácie sa stav položiek zmení na Synchronizované.

Odpojenie pracovného priestoru od systému Git

Pracovný priestor od odkladacieho priestoru Git môže odpojiť len správca pracovného priestoru. Ak nie ste administrátor, požiadajte ho o pomoc s odpojením. Ak ste administrátor a chcete odpojiť svoj repozitár, postupujte podľa týchto krokov:

1. Prejsť do časti Nastavenia pracovného priestoru
2. Vyberte integráciu Git
3. Vyberte položku Odpojiť pracovný priestor
4. Ak to chcete potvrdiť, znova vyberte položku Odpojiť .

Povolenia

Akcie, ktoré môžete vykonať v pracovnom priestore, závisia od povolení, ktoré máte v pracovnom priestore aj v odkladacom priestore Git. Podrobnejšie informácie o povoleniach nájdete v téme Povolenia.

Súvisiaci obsah

• Vysvetlenie procesu integrácie systému Git
• Spravovanie vetiev systému Git
• Najvhodnejšie postupy integrácie so službou Git