Zdieľať cez

Čo je integrácia Git služby Microsoft Fabric?

Tento článok vysvetľuje vývojárom, ako integrovať riadenie verzií systému Git s nástrojom na správu životného cyklu aplikácie služby Microsoft Fabric (ALM).

Poznámka

Niektoré položky integrácie Git sú vo verzii Preview. Ďalšie informácie nájdete v zozname podporovaných položiek.

Integrácia systému Git v službe Microsoft Fabric umožňuje vývojárom integrovať ich vývojové procesy, nástroje a osvedčené postupy priamo do platformy Fabric. Vývojárom, ktorí vyvíjajú služby Fabric, to umožňuje:

  • Zálohovanie a verzia ich práce
  • Podľa potreby sa vrátiť k predchádzajúcim fázam
  • Spolupráca s ostatnými alebo práca samostatne pomocou vetiev Git
  • Použitie funkcií známych nástrojov správy zdrojového kódu na spravovanie položiek tkaniny

Integrácia s ovládacím prvkom zdroja je na úrovni pracovného priestoru. Vývojári môžu verzie položiek, ktoré vyvíjajú v rámci pracovného priestoru, v rámci jedného procesu, a to s úplným prehľadom o všetkých ich položkách. Štruktúra pracovného priestoru vrátane podpriečinkovsa v odkladacom priestore Git zachová.

Pozrite si zoznam podporovaných položiek.

  • Prečítajte si základné informácie o konceptoch Git a riadenia verzií.

  • Prečítajte si viac o procese integrácie Git.

  • Prečítajte si o najlepšom spôsobe spravovania vetiev Git.

Sieťové zabezpečenie pre integráciu Git

Zabezpečenie na úrovni pracovného priestoru v službe Microsoft Fabric poskytuje podrobnú kontrolu nad prístupom k údajom a sieťovým pripojením tým, že umožňuje správcom konfigurovať prichádzajúcu aj odchádzajúcu ochranu pre jednotlivé pracovné priestory. Tieto ovládacie prvky zabezpečujú, že citlivé údaje zostanú v rámci dôveryhodných hraníc siete, a integrujú sa s nástrojmi CI/CD, ako je integrácia Git. Ďalšie informácie nájdete v téme Zabezpečenie siete pre nepretržitú integráciu/nepretržité nasadenie

Informácie o ochrane osobných údajov

Pred povolením integrácie Git si skontrolujte nasledujúce prehlásenia o ochrane osobných údajov:

Podporovaní poskytovatelia Git

Podporujú sa nasledujúcich poskytovateľov systému Git:

  • Azure DevOps v rámci rovnakého nájomníka služby Fabric (podpora medzi nájomníkmi je vo verzii Preview)
  • GitHub (iba cloudové verzie)
  • GitHub Enterprise (iba cloudové verzie)

Podporované položky

Integráciu Git aktuálne podporujú nasledujúce položky:

Ak pracovný priestor alebo adresár Git obsahuje nepodporované položky, môže byť aj naďalej pripojený, ale nepodporované položky sa ignorujú. Neuložia sa ani nesynchronizujú, ale neodstránia sa ani oni. Zobrazia sa na paneli ovládacieho prvku zdroja, ale nemôžete ich potvrdiť ani aktualizovať.

Dôležité informácie a obmedzenia

Všeobecné obmedzenia integrácie systému Git

  • Metóda overovania v službe Fabric musí byť aspoň rovnako silná ako metóda overovania pre Git. Ak napríklad Git vyžaduje viacfaktorové overenie, fabric musí vyžadovať aj viacfaktorové overovanie.
  • Množiny údajov služby Power BI pripojené k službe Analysis Services sa momentálne nepodporujú.
  • Ak použijete identitu pracovného priestoru v jednom artefakte a potvrdíte ju v službe Git, možno ju aktualizovať (späť do pracovného priestoru štruktúry) iba v pracovnom priestore pripojenom k rovnakej identite. Buďte opatrní, pretože to ovplyvňuje aj funkcie, ako je vetvenie.
  • Submoduly nie sú podporované.
  • Suverénne cloudy nie sú podporované.
  • Služba Azure DevOps nie je podporovaná, ak povoliť overenie politiky podmieneného prístupu IP.
  • Ak sa pracovný priestor a odkladací priestor Git nachádzajú v dvoch rôznych geografických oblastiach, správca nájomníka musí povoliť exporty medzi geografickými oblasťami.
  • Ak vaša organizácia nakonfigurovala podmieneného prístupu, uistite sa, že služba Power BI má rovnaké podmienky nastavené na overovanie tak, ako očakávate.
  • Pri použití konektora Azure DevOps je veľkosť potvrdenia obmedzená na 25 MB. Pre predvolené konto Microsoft Entra ID jediného prihlásenia (SSO) je limit 125 MB.

Obmedzenia služby GitHub Enterprise

Niektoré verzie a nastavenia služby GitHub Enterprise nie sú podporované. Napríklad:

  • GitHub Enterprise Cloud s pobytom údajov (ghe.com)
  • GitHub Enterprise Server s vlastnou doménou nie je podporovaný, a to ani v prípade, že inštancia je verejne prístupná
  • Podnikový server Github hosťovaný v súkromnej sieti
  • zoznam povolených IP adries

Obmedzenia pracovného priestoru

  • Pripojenia k odkladaciemu priestoru Git môže spravovať len správca pracovného priestoru, ako je napríklad pripojenie, odpojenie alebo pridanie vetvy.
    Po pripojení môže v pracovnom priestore pracovať ktokoľvek s povolením .
  • Pracovné priestory s nainštalovanými aplikáciami šablón nie je možné pripojiť k systému Git.
  • položky Môj Pracovný priestor sa nemôže pripojiť k poskytovateľovi Git.

Obmedzenia vetiev a priečinkov

  • Maximálna dĺžka názvu vetvy je 244 znakov.
  • Maximálna dĺžka úplnej cesty k názvom súborov je 250 znakov. Dlhšie názvy zlyhajú.
  • Maximálna veľkosť súboru je 25 MB.
  • Štruktúra priečinkov je udržiavaná až do 10 úrovní v hĺbke.
  • Stiahnutie zostavy/množiny údajov ako súboru .pbix zo služby po ich nasadení s integráciou s Git sa neodporúča, pretože výsledky sú nespoľahlivé. Na stiahnutie zostáv alebo množín údajov vo formáte .pbix odporúčame použiť aplikáciu PowerBI Desktop.
  • Ak má zobrazovaný názov položky niektorú z týchto vlastností, priečinok Git sa premenuje na logické ID (Guid) a zadajte:
    • Má viac ako 256 znakov
    • Končí . alebo medzerou
    • Obsahuje všetky zakázané znaky, ako je popísané v téme Obmedzenia názvov adresárov
  • Keď pripojíte pracovný priestor s priečinkami k systému Git, musíte potvrdiť zmeny v odkladacom priestore Git, ak je táto štruktúra priečinkov odlišná.

Obmedzenia názvu adresára

  • Názov adresára, ktorý sa pripája k odkladaciemu priestoru Git, má nasledujúce obmedzenia pomenovania:

    • Názov adresára nemôže začínať ani končiť medzerou alebo kartou.
    • Názov adresára nemôže obsahovať žiadne z nasledujúcich znakov: "/:<>\*?|

  • Priečinok položiek (priečinok obsahujúci súbory položiek) nemôže obsahovať žiadne z nasledujúcich znakov: ":<>\*?|. Ak priečinok premenujete na niečo, čo obsahuje jeden z týchto znakov, Git sa nemôže pripojiť alebo synchronizovať s pracovným priestorom a dôjde k chybe.

Obmedzenia vetvenia

  • Vetvenie vyžaduje povolenia uvedené v tabuľke povolení.
  • Pre túto akciu musí byť dostupná kapacita.
  • Obmedzenia pomenovania všetkých pracovných priestorov a vetiev platia pri vetvení do nového pracovného priestoru.
  • V novom pracovnom priestore sú k dispozícii iba položky podporované v službe Git.
  • Zoznam súvisiacich vetiev zobrazuje iba vetvy a pracovné priestory, na ktoré máte povolenie na zobrazenie.
  • Integrácia systému Git musí byť povolená.
  • Pri vetvení sa vytvorí nová vetva a nastavenia z pôvodnej vetvy sa neskopírujú. Upravte nastavenia alebo definície a ubezpečte sa, že nový spĺňa politiky vašej organizácie.
  • Pri vetvení do existujúceho pracovného priestoru:
    • Cieľový pracovný priestor musí podporovať pripojenie Git.
    • Používateľ musí byť správcom cieľového pracovného priestoru.
    • Cieľový pracovný priestor musí mať kapacitu.
    • Pracovný priestor nemôže mať aplikácie šablón.
  • Všimnite si, že keď odbočíte do pracovného priestoru, všetky položky, ktoré nie sú uložené v Git, sa môžu stratiť. Odporúča sa potvrdiť všetky položky, ktoré chcete mať pred vetvením.

Obmedzenia synchronizácie a potvrdenia

  • Synchronizovať môžete iba v jednom smere. Nemôžete potvrdiť a aktualizovať naraz.
  • Označenia citlivosti nie sú podporované a exportovanie položiek s označeniami citlivosti môže byť zakázané. Ak chcete potvrdiť položky, ktoré majú označenia citlivosti bez označenia citlivosti, požiadajte o pomoc svojho správcu .
  • Funguje s obmedzenými položkami. Nepodporované položky v priečinku sa ignorujú.
  • Duplikovanie názvov nie je povolené. Dokonca aj vtedy, ak služba Power BI umožňuje duplicitu názvov, akcia aktualizácie, potvrdenia alebo vrátenia zmeny zlyhá.
  • B2B nie je podporovaná.
  • Riešenie konfliktu sa čiastočne vykonáva v službe Git.
  • Počas procesu Potvrdiť v Git služba Fabric odstráni súbory vo vnútri priečinka položky, ktoré nie sú súčasťou definície položky. Nesúvisiace súbory, ktoré nie sú v priečinku položiek, sa neodstránia.
  • Po potvrdení zmien si môžete všimnúť neočakávané zmeny položky, ktoré ste nevytvorili. Tieto zmeny sú sémanticky nevýznamné a môžu sa vyskytnúť z viacerých dôvodov. Napríklad:
    • Manuálna zmena súboru definície položky. Tieto zmeny sú platné, ale môžu sa líšiť od toho, ak sa vykonali prostredníctvom editorov. Ak napríklad premenujete stĺpec sémantického modelu v službe Git a importujete túto zmenu do pracovného priestoru, pri ďalšom potvrdení zmien do sémantického modelu sa súbor BIM zaregistruje ako zmenený a upravený stĺpec sa presunie do zadnej časti columns poľa. Dôvodom je, že nástroj AS, ktorý generuje súbory BIM odosiela premenované stĺpce na koniec poľa. Táto zmena nemá vplyv na spôsob, akým položka funguje.
    • Spáchanie súboru, ktorý používa zlomy riadkov CRLF . Služba používa zlomy riadkov LF (posun riadka). Ak ste v odkladacom priestore Git mali súbory položiek s zlomami riadkov CRLF , pri potvrdení zo služby sa tieto súbory zmenia na LF. Ak napríklad otvoríte zostavu v počítači, uložte súbor projektu (.pbip) a nahrajte ho do Git pomocou CRLF.
  • Obnovenie sémantického modelu pomocou rozšíreného rozhrania API obnovenia spôsobí po každom obnovení rozdiel Git.

Súvisiaci obsah

  • Last updated on