Začněte s integrací Gitu

Tento článek vás provede následujícími základními úlohami v nástroji pro integraci Git Microsoft Fabric:

• Připojení k úložišti Git
• Potvrzení změn
• Aktualizace z Gitu
• Odpojení od Gitu

Než začnete, doporučujeme přečíst si přehled integrace Gitu .

Požadavky

Pokud chcete integrovat Git s pracovním prostorem Microsoft Fabric, musíte pro Microsoft Fabric a Git nastavit následující předpoklady.

Požadavky pro Fabric

Pokud chcete přistup k funkci integrace Gitu, potřebujete kapacitu Fabric. Pro použití všech položek podporovaných v systému Fabric je vyžadována kapacita Fabric. Pokud ho ještě nemáte, zaregistrujte si bezplatnou zkušební verzi. Zákazníci, kteří už mají kapacitu Power BI Premium, mohou tuto kapacitu používat, ale mějte na paměti, že některé SKU Power BI podporují pouze položky Power BI.

Kromě toho musí být na portálu pro správu povoleny následující přepínače tenantů :

• Uživatelé můžou vytvářet položky platformy Fabric – je to nutné v případě použití artefaktů platformy Fabric.
• Uživatelé můžou synchronizovat položky pracovního prostoru se svými úložišti Git.
• Vytvořte pracovní prostory (pouze pokud chcete rozšířit činnost do nového pracovního prostoru.)
• Uživatelé můžou synchronizovat položky pracovního prostoru s úložišti GitHub: Pouze pro uživatele GitHub

Tyto přepínače může povolit správce tenanta, správce kapacity nebo správce pracovního prostoru v závislosti na nastavení vaší organizace.

Požadavky Gitu

Integrace Gitu se v současné době podporuje pro Azure DevOps a GitHub. Pro použití integrace Gitu s pracovním prostorem Fabric potřebujete v Azure DevOps nebo GitHub:

Azure DevOps

• Aktivní účet Azure DevOps registrovaný stejnému uživateli ve Fabricu (podporováno i v případě, že se organizace Azure DevOps nachází v jiném tenantu než tenant Fabric). Vytvoření bezplatného účtu.
• Access do existujícího úložiště.

GitHub

• Aktivní účet GitHub. Vytvoření účtu GitHub

• Jeden z následujících osobních přístupových tokenů:

  • Jemnozrnný token (doporučeno) s oprávněním ke čtení a zápisu pro obsah v rámci oprávnění úložiště:

    

    Pokud chcete tento token použít s GitHub Enterprise, postupujte podle směr.

  • Vytvořte klasický token GitHub s povolenými oprávněními úložiště:

    

Připojení pracovního prostoru k úložišti Git

Připojení k úložišti Git

Pracovní prostor může připojit jenom správce pracovního prostoru k úložišti, ale po připojení může v pracovním prostoru pracovat kdokoli s oprávněním . Pokud nejste správce, požádejte správce o pomoc s připojením. Pokud chcete připojit pracovní prostor k úložišti Azure nebo GitHub, postupujte takto:

1. Přihlaste se do Fabric a přejděte na pracovní prostor, ke kterému se chcete připojit.

2. Přejít do nastavení pracovního prostoru

   

3. Vyberte integraci Gitu.

4. Vyberte svého poskytovatele Gitu. V současné době se podporují Azure DevOps a GitHub.

Azure DevOps Connect

Pokud vyberete Azure DevOps, vyberte Connect a automaticky se přihlaste k účtu Azure Repos propojenému s uživatelem Microsoft Entra přihlášeným do služby Fabric.

Pokud jste se už přihlásili k Azure z Fabric pomocí jiného účtu, vyberte účet ze seznamu a vyberte Connect.

Pokud se přihlašujete z Fabric poprvé, nebo chcete přidat nový účet, vyberte Přidat účet.

Pokud se připojujete poprvé, musíte autorizovat uživatele. Zadejte následující údaje:

• Zobrazované jméno – musí být jedinečné pro každého uživatele.
• Azure DevOps URL – adresa URL úložiště Azure DevOps. Adresa URL musí být ve formátu https://dev.azure.com/{organization}/{project}/_git/{repository} nebo https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Ověřování – Můžete ověřit pomocí OAuth2 nebo služebního hlavního jména. Další informace najdete v tématu Azure DevOps – Integrace Gitu s instančním objektem

Po přihlášení vyberte Connect a povolte službě Fabric přístup k vašemu účtu.

GitHub Connect

Pokud vyberete GitHub, musíte se přihlásit ke svému GitHub účtu. Pokud jste se už přihlásili k GitHub, vyberte ze seznamu svůj účet a vyberte Connect.

Pokud se přihlašujete z Fabric poprvé, nebo chcete přidat nový účet, vyberte Přidat účet.

Pokud se připojujete poprvé, musíte autorizovat uživatele GitHub. Zadejte následující údaje:

• Název zobrazení – musí být jedinečný pro každého uživatele GitHubu
• Osobní přístupový token - váš klasický nebo jemně odstupňovaný osobní přístupový token
• Repository URL (volitelné pro github.com, povinné pro ghe.com) – Pokud nezadáte adresu URL, můžete se připojit k libovolnému github.com úložišti, ke kterému máte access. Pokud zadáte adresu URL, můžete se připojit pouze k tomuto úložišti.

Po přihlášení vyberte Connect a povolte Fabric přístup k vašemu účtu GitHub.

Připojení k pracovnímu prostoru

Pokud už je pracovní prostor připojený k Azure DevOps/GitHub, postupujte podle pokynů pro Pojení ke sdílenému pracovnímu prostoru.

Připojení větví Azure DevOps

1. V rozevírací nabídce zadejte následující podrobnosti o větvi, ke které se chcete připojit:

   • Organization
   • Project
   • Úložiště Git
   • Větev (Vyberte existující větev pomocí rozevírací nabídky nebo vyberte + Nová větev a vytvořte novou větev. Můžete se připojit pouze k jedné větvi najednou.)
   • Složka (Zadejte název existující složky nebo zadejte název pro vytvoření nové složky. Pokud název složky ponecháte prázdný, vytvoří se obsah v kořenové složce. Můžete se připojit pouze k jedné složce najednou.)

Připojení větev GitHub

1. V rozevírací nabídce zadejte následující podrobnosti o větvi, ke které se chcete připojit:

   • Adresa URL úložiště. Pokud jste se připojili k GitHub pomocí tokenu s vymezeným oborem, adresa URL se vyplní automaticky a můžete se připojit jenom k danému úložišti.
   • Větev (Vyberte existující větev pomocí rozevírací nabídky nebo vyberte + Nová větev a vytvořte novou větev. Můžete se připojit pouze k jedné větvi najednou.)
   • Složka (Zadejte název existující složky nebo zadejte název pro vytvoření nové složky. Pokud název složky ponecháte prázdný, vytvoří se obsah v kořenové složce. Můžete se připojit pouze k jedné složce najednou.)

Vyberte Připojit a synchronizovat.

Pokud je pracovní prostor nebo větev Gitu prázdná, během počáteční synchronizace se obsah zkopíruje z neprázdného umístění do prázdného. Pokud pracovní prostor i větev Gitu obsahují obsah, zobrazí se dotaz, ve kterém směru má synchronizace proběhnout. Další informace o této počáteční synchronizaci najdete v tématu Připojení a synchronizace.

Po připojení se v pracovním prostoru zobrazí informace o správě zdrojového kódu, které uživateli umožní zobrazit připojenou větev, stav každé položky ve větvi a čas poslední synchronizace.

Pokud chcete zachovat synchronizaci pracovního prostoru s větví Git, potvrďte všechny změny provedené v pracovním prostoru do větve Git a aktualizujte pracovní prostor pokaždé, když někdo vytvoří nová potvrzení do větve Gitu.

Potvrzení změn do Gitu

Po úspěšném připojení ke složce Git upravte pracovní prostor obvyklým způsobem. Všechny změny, které uložíte, se uloží jenom v pracovním prostoru. Až budete připravení, můžete potvrdit změny do větve Gitu nebo vrátit změny zpět a vrátit se k předchozímu stavu.

Přečtěte si další informace o commitách.

Potvrzení do Gitu

Pokud chcete potvrdit změny ve větvi Git, postupujte takto:

1. Přejděte do pracovního prostoru.

2. Vyberte ikonu správy zdrojového kódu. Tato ikona zobrazuje počet nepotvrzených změn.

3. Vyberte změny v podokně Řízení zdroje. Zobrazí se seznam se všemi položkami, které jste změnili, a ikona označující, zda je položka nová , změněna , konflikt , stejná změna nebo odstraněna .

4. Vyberte položky, které chcete potvrdit. Pokud chcete vybrat všechny položky, zaškrtněte políčko nahoře.

5. Přidejte do pole komentář. Pokud komentář nepřidáte, přidá se automaticky výchozí zpráva.

6. Vyberte Potvrdit.

   

Po potvrzení změn se ze seznamu odeberou potvrzené položky a pracovní prostor odkazuje na nové potvrzení, se kterým se synchronizoval.

Po úspěšném dokončení potvrzení se stav vybraných položek změní z Nepotvrzené na Synchronizované.

Zavázat se do samostatné větve

Úprava do nové samostatné větve je funkce integrace Gitu, která vám umožní vytvořit čerstvou větev a potvrdit vaše aktuální změny v rámci jedné akce. Jinými slovy, místo commitování do připojené větve, můžete za běhu vytvořit novou větev: systém vytvoří novou Git větev a uloží vaši práci tam, aniž byste museli opustit nebo přepnout z vaší původní větve.

1. Přejděte do pracovního prostoru.
2. Vyberte ikonu správy zdrojového kódu. Tato ikona zobrazuje počet nepotvrzených změn.
3. Vyberte změny v podokně Řízení zdroje. Zobrazí se seznam se všemi položkami, které jste změnili, a ikona označující, zda je položka nová , změněna , konflikt , stejná změna nebo odstraněna .
4. Vyberte položky, které chcete potvrdit. Pokud chcete vybrat všechny položky, zaškrtněte políčko nahoře.
5. Přidejte do pole komentář. Pokud komentář nepřidáte, přidá se automaticky výchozí zpráva.
6. Vyberte Potvrdit do nové větve.

Důležité

Uvědomte si následující skutečnosti:

• nově vytvořená větev nebude připojena k existujícímu pracovnímu prostoru.
• nově vytvořená větev bude založena na posledním stavu synchronizace aktuálního pracovního prostoru.
• tato funkce je možná, pokud existují příchozí aktualizace, i když je výchozí commit zakázaný.
• aktuální stav pracovního prostoru se kvůli tomuto potvrzení nezmění a zůstane tak, jak je.

Vrácení uložené změny zpět

Pokud se po uložení změn do pracovního prostoru rozhodnete, že tyto změny nechcete potvrdit do Gitu, můžete tyto změny vrátit zpět a vrátit tyto položky do předchozího stavu. Pokud chcete změny vrátit zpět, postupujte takto:

1. Přejděte do pracovního prostoru.

2. Vyberte tlačítko Správy zdrojového kódu . Toto tlačítko také zobrazuje počet nepotvrzených změn.

3. Vyberte Změny z panelu Správa zdrojů. Zobrazí se seznam se všemi položkami, které jste změnili, a ikona označující, jestli je změněná položka nová , změněná , konfliktní nebo odstraněná .

4. Vyberte změny, které chcete vrátit zpět.

5. Zaškrtněte políčko Rozumím, že položky pracovního prostoru mohou být smazány a nelze je obnovit a vyberte Zpět.

   

6. Znovu vyberte Zpět pro potvrzení. Zobrazené dialogové okno se může lišit v závislosti na tom, jestli se detekují položky, které budou odstraněny. První snímek obrazovky neobsahuje žádná mazání. Druhým, pokud jsou zjištěna odstranění.

   

   

Vybrané položky v pracovním prostoru se vrátí k tomu, jak byly při poslední synchronizaci pracovního prostoru.

Důležité

Pokud odstraníte položku a pak změny vrátíte zpět, vytvoří se nová položka a některá metadata můžou být ztracena. Například popisky citlivosti se neuchovávají a měly by být resetované a vlastník položky je nastavený na aktuálního uživatele.

Zrušení přidané položky ji trvale odstraní.

Aktualizace pracovního prostoru z Gitu

Pokaždé, když někdo potvrdí novou změnu do připojené větve Gitu, zobrazí se v příslušném pracovním prostoru oznámení. Pomocí panelu Správa zdrojového kódu můžete stáhnout nejnovější změny, sloučit je nebo se vrátit do pracovního prostoru a aktualizovat živé položky. Změny ve složkách se také aktualizují. Přečtěte si další informace o aktualizaci.

Pokud chcete aktualizovat pracovní prostor, postupujte takto:

1. Přejděte do pracovního prostoru.
2. Vyberte ikonu správy zdrojového kódu.
3. Ve Zdrojovém ovládacím panelu vyberte Updates. Zobrazí se seznam se všemi položkami, které byly změněny ve větvi od poslední aktualizace.
4. Vyberte Aktualizovat vše.

5. V potvrzovací dialogovém okně vyberte Aktualizovat.

Po úspěšné aktualizaci se odebere seznam položek a pracovní prostor odkazuje na nový pracovní prostor, do kterého se synchronizuje.

Po úspěšném dokončení aktualizace se stav položek změní na Synchronizované.

Odpojení pracovního prostoru od Gitu

Jenom správce pracovního prostoru může odpojit pracovní prostor od úložiště Git. Pokud nejste správce, požádejte správce o pomoc s odpojením. Pokud jste správce a chcete úložiště odpojit, postupujte takto:

1. Přejít do nastavení pracovního prostoru
2. Výběr integrace Gitu
3. Vyberte Odpojit pracovní prostor
4. Znovu zvolte Odpojit pro potvrzení.

Oprávnění

Akce, které můžete provést v pracovním prostoru, závisí na oprávněních, která máte v pracovním prostoru i v úložišti Git. Podrobnější diskuzi o oprávněních najdete v tématu Oprávnění.

Související obsah

• Vysvětlení procesu integrace Gitu
• Správa větví Git
• Osvědčené postupy integrace Gitu