Prisijungimas prie GitHub (peržiūra)

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Norėdami prijungti "Dataverse" aplinką arba GitHub sprendimą, sukurkite GitHub programėlę, laikykite programos privatųjį raktą Azure Key Vault, sukurkite "Power Platform" GitHub ryšį, tada prisijunkite naudodami savo sprendimo šaltinio valdymo funkcijas.

Sprendimus galite pasiekti iš Power Apps, Power Automate, Power Pages ir Copilot Studio.

Svarbu

  • Ši funkcija yra peržiūros versijoje.
  • Peržiūros funkcijos nėra skirtos gamybiniam naudojimui ir gali būti apribotos. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.

Būtinosios sąlygos

  • "Dataverse Git" integracija yra valdomų aplinkų funkcija. Kūrimo ir tikslinės aplinkos turi būti įgalintos kaip valdomos aplinkos.
  • GitHub paskyrą su organizacijos administratoriaus prieiga.
  • Azure prenumerata su teise kurti Key Vault išteklius. Key Vault turi būti to paties Microsoft Entra nuomotojo kaip "Dataverse" aplinka.
  • Jums reikia "Dataverse" aplinkos, kurioje yra sistemos administratoriaus saugos vaidmuo.
  • Pasirinktinis nevaldomasis sprendimas, kurį norite prijungti prie šaltinio valdiklio. Sukurkite, jei jos dar neturite.

GitHub programos kūrimas

  1. Atidarykite GitHub naršyklėje. Pasirinkite savo profilio paveikslėlį viršutiniame dešiniajame kampe, tada eikite į Parametrai>Programų kūrėjas parametrai.

  2. Pasirinkite Nauja GitHub programa.

    Taip pat galite eiti tiesiai į GitHub taikomosios programos registracijos puslapį, kad sukurtumėte naują GitHub programą.

  3. Puslapyje Kurti GitHub programą įveskite unikalų GitHub taikomosios programos pavadinimą lauke GitHub Taikomosios programos pavadinimas. Pavyzdžiui, įveskite MyOrgGitHubIntegrationApp.

  4. Užpildykite lauką Pagrindinio puslapio URL . Galite naudoti savo organizacijos žiniatinklio svetainę arba GitHub saugyklos URL.

  5. Jei jums nereikia "webhook" pranešimų, sekcijoje "Webhook" išvalykite žymės langelį Aktyvus.

    GitHub taikomosios programos kūrimo puslapio su GitHub taikomosios programos pavadinimo lauku ekrano nuotrauka.

Konfigūruoti saugyklos teises

  1. Slinkite žemyn iki dalies Teisės .

  2. Išplėskite Saugyklos teisės, tada nustatykite Turinioskaitymas ir rašymas. Šis leidimas leidžia programėlei skaityti ir rašyti saugyklos turinį, kad būtų galima integruoti šaltinio kontrolę.

    GitHub programos saugyklos teisių ekrano nuotrauka.

  3. Slinkite žemyn ir pasirinkite Kurti GitHub programą.

  4. Puslapyje GitHub Taikomosios programos parametrai nukopijuokite kliento ID. Šios reikšmės reikia registruojant taikomosios programos konfigūraciją "Dataverse". Kliento ID naudoja formatą, pvz., Iv23liBWoH6sf7xGrRe9.

  5. Sugeneruokite ir atsisiųskite privatųjį raktą iš GitHub programėlės parametrų puslapio. Išsaugokite privatųjį raktą Azure Key Vault atlikdami vėlesnį veiksmą.

    GitHub programėlės parametrų puslapio su privačiojo rakto generavimo parinktimi ekrano nuotrauka.

GitHub taikomosios programos diegimas paskirties saugykloje

  1. GitHub programėlės parametrų puslapyje kairiojoje srityje pasirinkite Diegti programėlę.

  2. Šalia paskyros arba organizacijos, kuriai priklauso paskirties saugykla, pasirinkite Diegti .

    Jei paskirties saugykla priklauso GitHub organizacijai, organizacijos administratoriui gali tekti patvirtinti taikomosios programos diegimą. Administratorius gauna pranešimą peržiūrėti ir patvirtinti užklausą.

    GitHub taikomosios programos diegimo puslapio ekrano nuotrauka.

  3. Pasirinkite, ar suteikti programėlei prieigą prie visų saugyklų , ar tik pasirinkti saugyklas. Jei reikia geriausios saugos praktikos, pasirinkite tik konkrečias saugyklas, reikalingas šaltinio kontrolės integracijai.

  4. Pasirinkite Diegti , kad užbaigtumėte diegimą.

    GitHub taikomosios programos prieigos saugyklų pasirinkimo ekrano nuotrauka.

„Azure Key Vault“ konfigūravimas

  1. Atidarykite Azure portalą ir eikite į rakto saugyklos išteklių. Jei jo neturite, pirmiausia sukurkite naują rakto seifą.

  2. Srityje Key Vault kairiojoje naršymo srityje pasirinkite Klavišai.

    Naršymo elemento Azure Key Vault klavišai ekrano nuotrauka.

  3. Pasirinkite Generuoti / importuoti.

  4. Išplečiamajame sąraše Parinktys pasirinkite Importuoti.

  5. Įveskite rakto pavadinimą, pvzdemoGitHubKey., , ir nusiųskite iš GitHub atsisiųstą .pem failą.

  6. Pasirinkite Kurti , kad importuotumėte raktą.

    Rakto importavimo į Azure Key Vault ekrano nuotrauka.

GitHub ryšio kūrimas

Sukurkite "OAuth" ryšį naudodami asmeninę GitHub paskyrą. Šis ryšys patikrina, ar turite administratoriaus prieigą prie paskirties saugyklos sąrankos metu. Vykdymo metu GitHub programa apdoroja ryšį su GitHub, todėl atskiriems vartotojams nereikia kurti GitHub ryšių.

Pastaba

Negalite naudoti GitHub ryšių, kai įgalinate virtualaus tinklo (VNET) palaikymą "Dataverse" aplinkoje. Vietoj to naudokite GitHub asmeninę prieigos atpažinimo ženklą (PAT).

  1. Eikite į Power Apps kūrėjo portalą, tada pasirinkite Ryšiai.

  2. Pasirinkite Naujas ryšys.

  3. Ieškokite ir pasirinkite GitHub standartinę jungtį.

    Naujo GitHub ryšio kūrimo programoje

  4. Prisijunkite naudodami GitHub paskyrą ir suteikite pageidaujamą prieigą.

    GitHub prisijungimo raginimo Power Apps ryšį ekrano nuotrauka.

GitHub paskyra, prie kurios prisijungiate, privalo turėti administratoriaus prieigą prie paskirties saugyklos. "OAuth" ryšys patvirtina jūsų teises.

Sukūrę ryšį, atidarykite jį. Įsidėmėkite ryšio ID iš URL naršyklės adreso juostoje. Jums reikia šios reikšmės, kai konfigūruojate "Git" ryšį.

Peržiūrint ryšio išsamią informaciją, URL rodomas ryšio ID, kaip parodyta šiame pavyzdyje:

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

Power Apps GitHub ryšio informacijos puslapio, kuriame rodomas URL ryšio ID, ekrano nuotrauka.

Organizacijos "OAuth" taikomosios programos prieigos patvirtinimas

Jei jūsų GitHub organizacijoje įgalinti ne „Microsoft“ programų prieigos apribojimai, organizacijos administratorius turi patvirtinti Power Apps GitHub jungties naudojamą "OAuth" taikomąją programą. Patikrinkite savo organizacijos parametrus dalyje Organizacijos parametrai>Trečiųjų šalių prieiga.

GitHub organizacijos trečiosios šalies programos prieigos parametrų ekrano nuotrauka.

Daugiau informacijos žr. "OAuth" taikomosios programos prieigos apribojimų įgalinimas ir " OAuth" programų patvirtinimas organizacijoje.

Prisijungimas prie sprendimo GitHub

  1. Sukurkite naują nevaldomą sprendimą arba pasirinkite esamą pasirinktinį nevaldomą sprendimą.

  2. Šaltinio valdymo puslapyje pasirinkite Prisijungti.

  3. Srityje Prisijungti prie "Git" pasirinkite GitHub.

    Srities Prisijungti prie

  4. Atlikdami ankstesnius sąrankos veiksmus įveskite GitHub organizacijos, saugyklos, šakos, "Git" aplanko ir ryšio informaciją.

    Ekrano nuotrauka, kurioje rodoma GitHub ryšio informacija srityje Prisijungti prie

  5. Sukurkite GitHub taikomosios programos konfigūraciją ir atlikdami ankstesnius sąrankos veiksmus įveskite GitHub taikomosios programos kliento ID, Key Vault URI ir rakto pavadinimą.

    Programos konfigūracijos informacijos GitHub srityje Prisijungimas prie

Konfigūruoti Key Vault vaidmenimis pagrįstą prieigos kontrolę (RBAC)

  1. Azure portale eikite į savo Key Vault išteklių.

  2. Pasirinkite Prieigos valdymas (IAM), pasirinkite Įtraukti, tada pasirinkite Įtraukti vaidmenų priskyrimą.

  3. Ieškokite ir pasirinkite vaidmenį Key Vault Crypto User.

    Key Vault Crypto User role in Azure role assignment pasirinkimo ekrano nuotrauka.

  4. Pasirinkite Pasirinkti narius, tada ieškokite "Dataverse" valdomos tapatybės, susietos su jūsų GitHub taikomosios programos konfigūracija. Valdomas tapatybės pavadinimas naudoja šį formatą:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Pasirinkite valdomą tapatybę, tada pasirinkite Peržiūra ir priskyrimas.

    Ekrano nuotrauka, kurioje rodoma, kaip pasirinkti Key Vault vaidmens priskyrimo

Jei valdoma tapatybė nerodoma, eikite į "Dataverse" aplinkos parametrų>sistemos užduotis ir patikrinkite, ar nėra klaidų, susijusių su GitHub taikomosios programos konfigūracijos kūrimu. Registracija sukuriama asinchroniškai ir gali šiek tiek užtrukti.

Atlikus vaidmenų priskyrimą, "Dataverse" valdoma tapatybė turi teisę naudoti šio Key Vault GitHub raktą.

Patikrinkite ryšį ir patikrinkite atlikimą

Atidarykite nevaldomą sprendimą srityje Sprendimai . Jei dar neturite, pirmiausia sukurkite naują sprendimą. Šaltinio valdiklio integravimas veikia tik su nevaldomi sprendimais.

Eikite į šaltinio valdymo puslapį ir pasirinkite "Git" ryšys. Patikrinkite, ar ryšys rodomas GitHub kaip teikėjas ir ar teisinga organizacijos, saugyklos, šakos ir aplanko informacija.

Norėdami patikrinti visą srautą, pasirinkite Vykdyti, kad pereitumėte į prijungtą GitHub saugyklą.

Jei įvykdysite sėkmingai, integravimas bus baigtas.

Prisijungimas naudojant kodą

Galite naudoti "Dataverse Web API" arba "PowerShell", kad prisijungtumėte prie GitHub programiškai, o ne naudodami vartotojo sąsają. Daugiau informacijos žr. Prisijungimas prie GitHub saugyklos.

  • Last updated on