Konektatu GitHub-era (aurrebista)

[Aurre-argitaratutako dokumentazioaren parte da artikulu hau, eta baliteke aldaketak jasatea.]

Dataverse ingurune edo soluzio bat GitHub-era konektatzeko, sortu GitHub aplikazio bat, gorde aplikazioaren giltza pribatua Azure Key Vault-en, sortu Power Platform GitHub konexioa, eta gero konektatu zure soluzioko iturburu-kontrol esperientziatik.

Power Apps, Power Automate, Power Pages eta Copilot Studio bezalako soluzioetara iritsi zaitezke.

Garrantzitsua

  • Hau aurreikuspen-eginbidea da.
  • Aurrebista-eginbideak ez daude ekoizpenerako diseinatuta, eta funtzionalitate murriztua izan dezakete. Eginbide horiek kaleratze ofiziala baino lehen dauden erabilgarri, bezeroek atzitu eta beren oharrak eman ditzaten.

Aurrebaldintzak

  • Dataverse Git integrazioa kudeatutako inguruneen ezaugarri bat da. Garapena eta helburu inguruneak kudeatutako ingurune gisa gaitu behar dira.
  • GitHub kontu bat, erakundearen administratzaile sarbidearekin.
  • Azure harpidetza bat, Key Vault baliabideak sortzeko baimenarekin. Key Vault Dataverse ingurunearekin Microsoft Entra tenant berean egon behar da.
  • Dataverse ingurune bat behar duzu, non Sistemaren Administratzaile segurtasun rola duzun.
  • Kudeatu gabeko soluzio pertsonalizatu bat, iturburu-kontrolarekin konektatu nahi duzuna. Sortu bat oraindik ez baduzu.

Sortu GitHub aplikazio bat

  1. Ireki GitHub zure nabigatzailean. Hautatu zure profilaren argazkia goiko eskuineko izkinan, eta gero joan Ezarpenen>Garatzailearen ezarpenetara.

  2. Hautatu GitHub aplikazio berria.

    Era berean, zuzenean joan zaitezke GitHub aplikazioaren erregistro orrira GitHub aplikazio berri bat sortzeko.

  3. Create GitHub App orrian, sartu zure GitHub aplikazioaren izen bakarra GitHub App izen eremuan. Adibidez, sartu MyOrgGitHubIntegrationApp.

  4. Bete Hasierako Orriaren URL eremua. Zure erakundearen webgunea edo GitHub biltegiaren URLa erabil dezakezu.

  5. Webhook jakinarazpenik behar ez baduzu, kendu Aktibo laukia Webhook atalean.

    GitHub aplikazio sortzeko orriaren pantaila-argazkia, GitHub aplikazioaren izen eremuarekin.

Biltegiaren baimenak konfiguratu

  1. Jaitsi Baimen atalera.

  2. Zabaldu Biltegiaren baimenak, eta ondoren ezarriEdukia Irakurri eta Idaztean. Baimen honek aplikazioari aukera ematen dio biltegiko edukia irakurri eta idazteko iturburu-kontrolaren integraziorako.

    GitHub aplikazio baten biltegi baimenen pantaila-argazkia.

  3. Jaitsi behera eta hautatu GitHub App Sortu.

  4. GitHub App ezarpenen orrian, kopiatu Bezeroaren IDa. Balio hori behar duzu aplikazioaren konfigurazioa Dataverse-n erregistratzean. Bezero IDak formatu bat erabiltzen du, adibidez Iv23liBWoH6sf7xGrRe9.

  5. Sortu eta deskargatu gako pribatu bat GitHub aplikazioaren ezarpen orritik. Gorde gako pribatua Azure Key Vault-en urrats bat geroago.

    GitHub aplikazioaren ezarpen orriaren pantaila-argazkia, gako pribatua sortu aukerarekin.

Instalatu GitHub aplikazioa helburu biltegian

  1. GitHub aplikazioaren ezarpen orrian, hautatu Instalatu Aplikazioa ezkerreko panelean.

  2. Aukeratu Instalatu helburuko biltegiaren jabe den kontu edo erakundearen ondoan.

    Helburu biltegia GitHub erakunde bati dagokio, erakundearen administratzaileak aplikazioaren instalazioa onartu beharko du. Administratzaileak jakinarazpen bat jasotzen du eskaera berrikusteko eta onartzeko.

    GitHub aplikazioaren instalazio orriaren pantaila-argazkia.

  3. Aukeratu aplikazioari biltegi guztietara sarbidea ematea edo biltegi hautatuak bakarrik. Segurtasun praktika onenak lortzeko, aukeratu iturburu-kontrolaren integraziorako beharrezko biltegi zehatzak soilik.

  4. Instalazioa hautatu instalazioa osatzeko.

    GitHub aplikazio sarbiderako biltegiak hautatzeko pantaila-argazkia.

Konfiguratu Azure Key Vault

  1. Ireki Azure ataria eta joan zure gako biltegiko baliabidera. Ez baduzu, sortu giltza-biltegi berri bat lehenik.

  2. Key Vault panelean, aukeratu Keys ezkerreko nabigazioan.

    Azure Key Vault gakoen nabigazio elementuaren pantaila-argazkia.

  3. Hautatu Sortu/Inportatu.

  4. Aukeren beheko goitiboan, hautatu Inportatu.

  5. Sartu giltzarako izen bat, adibidez demoGitHubKey, eta igo .pem GitHub-etik deskargatutako fitxategia.

  6. Sortu hautatu gakoa inportatzeko.

    Giltza bat Azure Key Vault-era inportatzearen pantaila-argazkia.

Sortu GitHub konexio bat

Sortu OAuth konexio bat zure GitHub kontu pertsonala erabiliz. Konexio honek egiaztatzen du konfigurazioan zehar helburu biltegira administratzaile sarbidea duzula. Exekuzioan, GitHub aplikazioak GitHub-ekin komunikazioa kudeatzen du, beraz, erabiltzaile banakoek ez dute GitHub konexiorik sortu behar.

Oharra

Ezin duzu GitHub konexioak erabili Dataverse ingurunerako sare birtualaren (VNET) laguntza gaitzen duzunean. Erabili GitHub sarbide pertsonaleko token bat (PAT) horren ordez.

  1. Joan Power Apps maker atarira eta hautatu Konexioak.

  2. Hautatu konexio berria.

  3. Bilatu eta hautatu GitHub konektore estandarra.

    Power Apps-en GitHub konexio berri bat sortzearen pantaila-argazkia.

  4. Saioa hasi zure GitHub kontua erabiliz eta eman eskatutako sarbidea.

    Power Apps konexio baterako GitHub saio-hasierako promptaren pantaila-argazkia.

Saioa hasten duzun GitHub kontuak helburuko biltegira administratzaile sarbidea izan behar du. OAuth konexioak zure baimenak egiaztatzen ditu.

Konexioa sortu ondoren, ireki ezazu. Kontuan hartu zure nabigatzailearen helbide barran dagoen URLaren konexio IDa. Balio hori behar duzu Git konexioa konfiguratzean.

Konexio IDa URLan agertzen da konexioaren xehetasunak ikusten dituzunean, hurrengo adibidean erakusten den bezala:

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

Power Apps GitHub konexio xehetasun orri baten pantaila-argazkia, URLaren barruan dagoen konexio IDa erakusten duena.

OAuth aplikazioaren sarbidea onartu zure erakundearentzat

Zure GitHub erakundeak aplikazio sarbide mugak ez-Microsoft gaituta baditu, erakundeko administratzaileak OAuth aplikazioa onartu behar du Power Apps GitHub konektoreak erabiltzen duena. Egiaztatu zure erakundearen ezarpenak Antolakundearen>Ezarpenak Hirugarrenen Sarbidea.

GitHub antolaketa hirugarrenen aplikazio sarbide ezarpenen pantaila-argazkia.

Informazio gehiago nahi izanez gero, ikusi OAuth aplikazioen sarbide murrizketak Gaitzea eta OAuth aplikazioak onartzea zure erakundearentzat.

Konektatu GitHub-era soluzio batetik

  1. Sortu kudeatu gabeko soluzio berri bat edo hautatu dagoen kudeatu gabeko soluzio pertsonalizatu bat.

  2. Iturburu kontrol orrian, hautatu Konektatu.

  3. Git konektatzeko panelean, hautatu GitHub.

    Connect to Git panelaren pantaila-argazkia, Azure DevOps eta GitHub hornitzaile aukerekin.

  4. Sartu GitHub antolaketa, biltegia, adarra, Git karpeta eta konexio informazioa aurreko konfigurazio pausoetatik.

    GitHub konexio xehetasunaren pantaila-argazkia Connect to Git panelean.

  5. Sortu GitHub aplikazio konfigurazio bat eta sartu GitHub aplikazioaren bezeroaren IDa, Key Vault URI-a eta aurreko konfigurazio pausoetatik gako izena.

    GitHub App konfigurazio xehetasunak Connect to Git panelean pantaila-argazkia.

Konfiguratu Key Vault rolen bidezko sarbide kontrola (RBAC)

  1. Azure atarian, joan zure Key Vault baliabidera.

  2. Sarbide kontrola (IAM) hautatu, Gehitu, eta gero Gehitu rol esleipena.

  3. Bilatu eta hautatu Key Vault Crypto User rola.

    Key Vault Crypto User rola hautatzearen pantaila-argazkia, Azure rol esleipenaren barruan.

  4. Hautatu Select kideak, eta bilatu Dataverse kudeatutako identitatea zure GitHub aplikazioaren konfigurazioarekin lotuta. Kudeatutako identitate izenak honako formatua erabiltzen du:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Hautatu nortasun kudeatua, eta gero Berrikusi + esleitu hautatu.

    Dataverse kudeatutako identitatea hautatzearen pantaila-argazkia, Key Vault rol esleipenerako.

Kudeatutako identitatea ez bada agertzen, joan Dataverse ingurunearenEzarpenen> System Jobs eta begiratu GitHub aplikazioaren konfigurazio sorkuntzarekin lotutako akatsak dauden. Erregistroa asinkronoan sortzen da eta une batez agertu daiteke.

Rol esleipena amaitutakoan, Dataverse-ren kudeatutako identitateak baimena du GitHub gakoa erabiltzeko Key Vault honetan.

Konexioa egiaztatu eta commit bat probatu

Ireki soluzio kudeatu gabeko bat Solutions eremutik. Oraindik ez baduzu, lehenik irtenbide berri bat sortu. Iturburu-kontrolaren integrazioa kudeatu gabeko soluzioekin bakarrik funtzionatzen du.

Joan Iturburu kontrol orrira eta aukeratu Git konexioa. Egiaztatu konexioak GitHub hornitzaile gisa agertzen dela eta antolaketa, biltegi, adar eta karpeta xehetasunak zuzenak direla.

Amaieratik amaierara fluxua egiaztatzeko, hautatu Konprometitu zure soluzioa GitHub konektatutako biltegira bidaltzeko.

Konpromisoa arrakastatsua bada, integrazioa martxan.

Kodea erabiliz konektatu

Dataverse Web API edo PowerShell erabil dezakezu GitHub-era programatikoki konektatzeko, erabiltzaile-interfazea erabili beharrean. Informazio gehiago nahi izanez gero, ikusi Konektatu GitHub biltegira.

  • Last updated on