Pripojenie k GitHub (Preview)

[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]

Ak chcete pripojiť prostredie Alebo riešenie Dataverse na GitHub, vytvorte aplikáciu GitHub, uložte súkromný kľúč aplikácie do Azure Key Vault, vytvorte pripojenie GitHub Power Platformy a potom sa pripojte zo zdroja ovládacieho prvku vo vašom riešení.

Môžete sa pripojiť k GitHub ukážke integrácie z prostredia riešení v https://make.preview.powerapps.com, , https://make.preview.powerautomate.comhttps://copilotstudio.preview.microsoft.comalebo https://make.preview.powerpages.microsoft.com.

Dôležité

  • Toto je funkcia vo verzii Preview.
  • Funkcie verzie Preview nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Predpoklady

  • Integrácia do Dataverse Git je vlastnosťou spravovaných prostredí. Vývojové a cieľové prostredia musia byť povolené ako spravované prostredia.
  • Konto GitHub s prístupom správcu organizácie.
  • Prihlásenie na odber Azure s povolením na vytváranie zdrojov Key Vault. Key Vault sa musí nachádzať v rovnakej Microsoft Entra nájomníkovi ako prostredie Dataverse.
  • Potrebujete prostredie Dataverse, v ktorom máte rolu zabezpečenia Správca systému.
  • Vlastné nespravované riešenie, ktoré sa chcete pripojiť k ovládaciemu prvku zdroja. Ak ho ešte nemáte, vytvorte si ho.

Vytvorenie aplikácie GitHub

  1. Otvorte GitHub v prehliadači. Vyberte svoj profilový obrázok v pravom hornom rohu a potom prejdite do časti Nastavenia>Nastavenia pre vývojára.

  2. Vyberte položku Nová GitHub aplikáciu.

    Môžete tiež prejsť priamo na registračnú stránku aplikácie GitHub a vytvoriť tak novú aplikáciu GitHub.

  3. Na stránke Vytvoriť aplikáciu GitHub zadajte jedinečný názov svojej aplikácie GitHub do poľa názov aplikácie GitHub. Zadajte MyOrgGitHubIntegrationAppnapríklad:

  4. Vyplňte pole URL adresa domovskej stránky . Môžete použiť webovú lokalitu svojej organizácie alebo URL adresu odkladacieho priestoru GitHub.

  5. Ak nepotrebujete oznámenia webhooku, zrušte začiarknutie políčka Aktívne v časti Webhook .

    Snímka obrazovky GitHub vytvorenie stránky aplikácie s poľom GitHub názvom aplikácie.

Konfigurácia povolení pre odkladací priestor

  1. Posuňte sa nadol do časti Povolenia .

  2. Rozbaľte povolenia odkladacieho priestoru a potom nastavte obsah na Čítanie a zapisovaie. Toto povolenie umožňuje aplikácii čítať a zapisovať obsah odkladacieho priestoru na integráciu riadenia zdrojov.

    Snímka obrazovky zobrazujúca povolenia odkladacieho priestoru pre aplikáciu GitHub.

  3. Posuňte sa nadol a vyberte položku Vytvoriť GitHub aplikáciu.

  4. Na stránke nastavení aplikácie GitHub skopírujte ID klienta. Túto hodnotu potrebujete, ak registrujete konfiguráciu aplikácie v časti Dataverse. ID klienta používa formát ako .Iv23liBWoH6sf7xGrRe9

  5. Vygenerujte a stiahnite súkromný kľúč zo stránky nastavení GitHub aplikácie. Uložte súkromný kľúč do Azure Key Vault v neskoršom kroku.

    Snímka obrazovky so stránkou nastavenia GitHub aplikácií s možnosťou generovať súkromný kľúč.

Inštalácia aplikácie GitHub do cieľového odkladacieho priestoru

  1. Na stránke nastavení GitHub aplikácie vyberte na ľavej table položku Inštalovať aplikáciu.

  2. Vyberte položku Inštalovať vedľa konta alebo organizácie, ktorá vlastní cieľový odkladací priestor.

    Ak cieľový odkladací priestor patrí organizácii GitHub, správca organizácie možno bude musieť schváliť inštaláciu aplikácie. Správca dostane oznámenie s cieľom skontrolovať a schváliť žiadosť.

    Snímka obrazovky inštalačnej stránky aplikácie GitHub.

  3. Vyberte, či chcete dať aplikácii prístup do všetkých odkladacích priestorov alebo Vybrať iba odkladacie priestory. V prípade najvhodnejších postupov zabezpečenia vyberte iba konkrétne odkladacie priestory potrebné na integráciu riadenia zdrojov.

  4. Vyberte položku Inštalovať a dokončite inštaláciu.

    Snímka obrazovky znázorňujúca výber odkladacích priestorov na prístup GitHub aplikácií.

Konfigurácia služby Azure Key Vault

  1. Otvorte portál Azure a prejdite do svojho zdroja služby Key Vault. Ak ho nemáte, najskôr vytvorte nový trezor kľúčov.

  2. Na table Key Vault vyberte v ľavom navigačnom paneli položku Kľúče.

    Snímka obrazovky položky navigácie pomocou kľúčov Azure Key Vault.

  3. Vyberte Generovať/Import.

  4. V rozbaľovacej ponuke Možnosti vyberte položku Importovať.

  5. Zadajte názov kľúča, ako demoGitHubKeyje napríklad , a potom nahrajte .pem súbor, ktorý ste stiahli z GitHub.

  6. Kľúč importujete výberom položky Vytvoriť .

    Snímka obrazovky znázorňujúca import kľúča do Azure Key Vault.

Poznámka

Keď k GitHub pripojíte nasledujúce prostredia Dataverse, nemusíte opakovať predchádzajúce GitHub aplikácie a Azure Key Vault kroky nastavenia. Rovnakú GitHub aplikáciu môžete opakovane použiť na viacerých odkladacích priestoroch a rovnakú konfiguráciu Azure Key Vault vo viacerých prostrediach.

Vytvorenie GitHub pripojenia

Vytvorte pripojenie OAuth pomocou svojho osobného konta GitHub. Toto pripojenie overí, či máte počas nastavovania správcovský prístup do cieľového odkladacieho priestoru. V režime runtime aplikácia GitHub spracováva komunikáciu s GitHub, takže jednotliví používatelia nemusia vytvárať GitHub pripojenia.

Poznámka

Prípadne môžete namiesto GitHub pripojenia použiť GitHub osobný prístupový token (PAT). Ak je pre prostredie Dataverse povolená podpora virtuálnej siete (VNET) alebo keď GitHub nie je možné vytvoriť pripojenia, použite pat.

  1. Prejdite na Power Apps Ukážka a potom vyberte pripojenia.

  2. Vyberte možnosť Nové pripojenie.

  3. Vyhľadajte a vyberte GitHub štandardný konektor.

    Snímka obrazovky vytvorenia nového pripojenia GitHub v službe Power Apps.

  4. Prihláste sa pomocou svojho GitHub konta a udeľte požadovaný prístup.

    Snímka obrazovky výzvy na prihlásenie GitHub na vytvorenie Power Apps pripojenia.

Konto GitHub, s ktorým sa prihlasujete, musí mať prístup správcu do cieľového odkladacieho priestoru. Pripojenie OAuth overí vaše povolenia.

Po vytvorení pripojenia ho otvorte. Všimnite si ID pripojenia z URL adresy na paneli s adresou prehliadača. Túto hodnotu potrebujete pri konfigurácii pripojenia Git.

ID pripojenia sa zobrazí v URL adrese pri zobrazení podrobností pripojenia, ako je to znázornené v nasledujúcom príklade:

https://make.preview.powerapps.com/.../connections/shared_github/{connectionId}/details

Snímka obrazovky Power Apps GitHub stránky s podrobnosťami o pripojení zobrazujúca ID pripojenia v URL adrese.

Schválenie prístupu aplikácie OAuth pre vašu organizáciu

Ak má vaša GitHub organizácia povolené obmedzenia prístupu k aplikáciám bez Microsoft, správca organizácie musí schváliť aplikáciu OAuth, ktorú používa konektor Power Apps GitHub. Pozrite si nastavenia organizácie v nastaveniach> organizáciePrístup tretích strán.

Snímka obrazovky zobrazujúca nastavenia prístupu k aplikácii tretej strany v organizácii GitHub.

Ďalšie informácie nájdete v téme Povolenie obmedzení prístupu k aplikácii OAuth a Schválenie aplikácií OAuth pre vašu organizáciu.

Pripojenie k GitHub z riešenia

  1. Prejdite do Power Apps ukážky a vytvorte nové nespravované riešenie alebo vyberte existujúce vlastné nespravované riešenie.

  2. Na stránke Ovládací prvok Zdroj vyberte položku Pripojiť.

  3. Na table Pripojiť k systému Git vyberte položku GitHub.

    Snímka obrazovky znázorňujúca tablu Pripojenie k systému Git s možnosťami Azure DevOps a poskytovateľa GitHub.

  4. Zadajte GitHub organizáciu, odkladací priestor, vetvu, priečinok Git a informácie o pripojení z predchádzajúcich krokov inštalácie.

    Snímka obrazovky GitHub podrobnosti o pripojení na table Pripojiť k systému Git.

  5. Vytvorte konfiguráciu aplikácie GitHub a zadajte ID klienta aplikácie GitHub, identifikátor URI Key Vault a názov kľúča z predchádzajúcich krokov nastavenia.

    Snímka obrazovky GitHub podrobnosti o konfigurácii aplikácie na table Pripojiť k systému Git.

Konfigurácia Key Vault riadenia prístupu na základe rolí (RBAC)

  1. Na portáli Azure prejdite na Key Vault prostriedok.

  2. Vyberte položku Riadenie prístupu (IAM), vyberte položku Pridať a potom vyberte položku Pridať priradenie roly.

  3. Vyhľadajte a vyberte rolu Key Vault Crypto User.

    Snímka obrazovky znázorňujúca výber roly Key Vault Crypto v priradení roly Azure.

  4. Vyberte položku Select members (Vybrať členov) a potom vyhľadajte spravovanú identitu Dataverse priradenú k konfigurácii aplikácie GitHub. Spravovaný názov identity má nasledujúci formát:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Vyberte spravované identity a potom vyberte položku Skontrolovať a priradiť.

    Snímka obrazovky znázorňujúca výber identity spravovanej identity Dataverse pre priradenie roly Key Vault.

Ak sa spravovaná identita nezobrazuje, prejdite do časti Nastavenia>systému úloh prostredia Dataverse a skontrolujte chyby súvisiace s GitHub vytváraním konfigurácie aplikácie. Registrácia je vytvorená asynchrónne a môže chvíľu trvať, kým sa zobrazí.

Po dokončení priradenia roly má spravovaná identita Dataverse povolenie používať kľúč GitHub v tomto Key Vault.

Overenie pripojenia a testovanie potvrdenia

Otvorte nespravované riešenie z oblasti Riešenia . Ak ho ešte nemáte, najskôr vytvorte nové riešenie. Integrácia riadenia zdrojového kódu funguje len s nespravovanými riešeniami.

Prejdite na stránku Ovládací prvok Zdroj a vyberte pripojenie Git. Overte, či sa v pripojení zobrazujú GitHub ako poskytovateľ a či sú podrobnosti organizácie, odkladacieho priestoru, vetvy a priečinka správne.

Ak chcete overiť koncový postup, vyberte položku Potvrdiť a presunutie riešenia do pripojeného odkladacieho priestoru GitHub.

Ak je potvrdenie úspešné, integrácia bude funkčná.

Pripojenie pomocou kódu

Namiesto používania používateľského rozhrania môžete na pripojenie k GitHub pomocou programovania použiť rozhranie Dataverse Web API alebo PowerShell. Ďalšie informácie nájdete v téme Pripojenie k odkladaciemu priestoru GitHub.

  • Naposledy aktualizované: