Yhteyden muodostaminen GitHub (esikatselu)

[Tämä artikkeli on esijulkaisuasiakirja, ja se voi muuttua.]

Jos haluat yhdistää Dataverse-ympäristön tai ratkaisun GitHub, luo GitHub sovellus, tallenna sovelluksen yksityinen avain Azure Key Vault, luo Power Platform -GitHub yhteys ja muodosta sitten yhteys lähteen hallintakokemuksesta ratkaisussasi.

Voit käyttää ratkaisuja Power Apps, Power Automate, Power Pages ja Copilot Studio.

Important

  • Tämä on esikatseluominaisuus.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Edellytykset

  • Dataverse Git -integrointi on hallittujen ympäristöjen ominaisuus. Kehitys- ja kohdeympäristöt on otettava käyttöön hallittuina ympäristöinä.
  • GitHub tilin, jolla on organisaation järjestelmänvalvojan käyttöoikeus.
  • Azure tilaus, jolla on Key Vault resurssien luontioikeus. Key Vault on oltava samassa Microsoft Entra vuokraajassa kuin Dataverse-ympäristön.
  • Tarvitset Dataverse-ympäristön, jossa sinulla on järjestelmänvalvojan käyttöoikeusrooli.
  • Mukautettu hallitsematon ratkaisu, jonka haluat muodostavan yhteyden lähdekoodin hallintaan. Luo sellainen, jos sinulla ei vielä ole sellaista.

GitHub sovelluksen luominen

  1. Avaa GitHub selaimessasi. Valitse profiilikuvasi oikeasta yläkulmasta ja siirry kohtaan Asetukset>Kehittäjän asetukset.

  2. Valitse Uusi GitHub -sovellus.

    Voit myös siirtyä suoraan GitHub sovelluksen rekisteröintisivulle ja luoda uuden GitHub-sovelluksen.

  3. Kirjoita Luo GitHub sovellus -sivulla GitHub sovelluksen yksilöivä nimi GitHub-sovelluksen nimi -kenttään. Syötä arvoksi esimerkiksi MyOrgGitHubIntegrationApp.

  4. Täytä Aloitussivun URL-osoite - kenttä. Voit käyttää organisaatiosi sivustoa tai GitHub säilön URL-osoitetta.

  5. Jos et tarvitse webhook-ilmoituksia, poista Webhook-osan Active-valintaruudun valinta.

    Näyttökuva sovelluksen luomisen GitHub sivusta, jossa on GitHub sovelluksen nimikenttä.

Säilön käyttöoikeuksien määrittäminen

  1. Vieritä alaspäin Käyttöoikeudet-osaan .

  2. Laajenna Säilön käyttöoikeudet ja määritä sen sisällön arvoksi Luku ja kirjoitus. Tämän oikeuden avulla sovellus voi lukea ja kirjoittaa säilön sisältöä lähteen hallinnan integrointia varten.

    Näyttökuva säilön käyttöoikeuksista GitHub sovellukselle.

  3. Vieritä alaspäin ja valitse Luo GitHub sovellus.

  4. Kopioi Sovelluksen GitHub -asetussivultaAsiakastunnus. Tarvitset tätä arvoa, kun rekisteröit sovelluksen määritykset Dataversessa. Asiakastunnus käyttää muotoa, kuten Iv23liBWoH6sf7xGrRe9.

  5. Luo ja lataa yksityinen avain GitHub sovelluksen asetussivulta. Tallenna yksityinen avain Azure Key Vault myöhemmässä vaiheessa.

    Näyttökuva GitHub sovelluksen asetussivulta yksityisen avaimen luomisen vaihtoehdolla.

Asenna GitHub-sovellus kohdesäilöön

  1. Valitse GitHub sovelluksen asetussivulla Asenna sovellus vasemmassa ruudussa.

  2. Valitse Asenna sen tilin tai organisaation vieressä, joka omistaa kohdesäilön.

    Jos kohdesäilö kuuluu GitHub organisaatiolle, organisaation järjestelmänvalvojan täytyy ehkä hyväksyä sovelluksen asennus. Järjestelmänvalvoja saa ilmoituksen pyynnön tarkistamisesta ja hyväksymisestä.

    Näyttökuva sovelluksen GitHub asennussivusta.

  3. Valitse, annetaanko sovellukselle käyttöoikeus kaikkiin säilöihin vai Vain tietyt säilöt. Suojauksen parhaat käytännöt saat valitsemalla vain ne säilöt, joita tarvitaan lähteen hallinnan integroinnissa.

  4. Viimeistele asennus valitsemalla Asenna .

    Näyttökuva säilöjen valitsemisesta GitHub käyttöä varten.

Azure Key Vaultin määrittäminen

  1. Avaa Azure portaali ja siirry Key Vault -resurssiin. Jos sinulla ei ole sellaista, luo ensin uusi Key Vault.

  2. Valitse Key Vault ruudun vasemmasta siirtymisruudusta Avaimet.

    Näyttökuvassa on Azure Key Vault näppäimien siirtymiskohde.

  3. Valitse Luo tai tuo.

  4. Valitse avattavasta Asetukset-valikostaTuo.

  5. Anna avaimelle nimi, kuten demoGitHubKey, ja lataa .pem sitten GitHub lataamasi tiedosto.

  6. Tuo avain valitsemalla Luo .

    Näyttökuva avaimen tuomisesta Azure Key Vault.

GitHub yhteyden luominen

Luo OAuth-yhteys käyttämällä henkilökohtaista GitHub tiliäsi. Tämä yhteys tarkistaa, että sinulla on järjestelmänvalvojan käyttöoikeus kohdesäilöön määrityksen aikana. GitHub sovellus käsittelee suorituksen aikana viestintää GitHub kanssa, joten yksittäisten käyttäjien ei tarvitse luoda GitHub yhteyksiä.

Muistio

Et voi käyttää GitHub yhteyksiä, kun otat käyttöön näennäisverkon (VNET) tuen Dataverse-ympäristölle. Käytä sen sijaan GitHub henkilökohtaista käyttöoikeustietuetta (PAT).

  1. Siirry tekijäportaaliin Power Apps ja valitse sitten Yhteydet.

  2. Valitse Uusi yhteys.

  3. Etsi ja valitse vakioliittimen GitHub.

    Näyttökuva uuden GitHub yhteyden luomisesta Power Apps.

  4. Kirjaudu sisään käyttämällä GitHub-tiliäsi ja myönnä pyydetty käyttöoikeus.

    Näyttökuva kirjautumiskehotteen GitHub Power Apps yhteyden muodostamiseksi.

Kirjautumistilillä GitHub on oltava kohdesäilön järjestelmänvalvojan käyttöoikeus. OAuth-yhteys tarkistaa käyttöoikeutesi.

Kun olet luonut yhteyden, avaa se. Huomaa yhteystunnus selaimen osoiterivin URL-osoitteesta. Tarvitset tätä arvoa, kun määrität Git-yhteyttä.

Yhteystunnus näkyy URL-osoitteessa, kun tarkastelet yhteyden tietoja seuraavassa esimerkissä esitetyllä tavalla:

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

Näyttökuva yhteyden Power Apps GitHub tietosivusta, jossa yhteystunnus näkyy URL-osoitteessa.

Hyväksy OAuth-sovelluksen käyttöoikeus organisaatiossasi

Jos GitHub organisaatiossasi on käytössä ei-Microsoft sovelluksen käyttöoikeusrajoituksia, organisaation järjestelmänvalvojan on hyväksyttävä Power Apps GitHub liittimen käyttämä OAuth-sovellus. Tarkista organisaatiosi asetukset kohdassa Organisaation asetukset>Kolmannen osapuolen käyttöoikeus.

Näyttökuva organisaation kolmannen osapuolen sovelluksen käyttöoikeusasetusten GitHub.

Lisätietoja on kohdassa OAuth-sovelluksen käyttöoikeusrajoitusten käyttöönotto ja OAuth-sovellusten hyväksyminen organisaatiollesi.

Yhdistä GitHubiin ratkaisusta

  1. Luo uusi hallitsematon ratkaisu tai valitse aiemmin luotu mukautettu hallitsematon ratkaisu.

  2. Valitse Lähde-ohjausobjektisivullaYhdistä.

  3. Valitse Yhdistä Gitiin -ruudussa GitHub.

    Näyttökuva Yhdistä Gitiin -ruudusta, jossa on Azure DevOps- ja GitHub palveluvaihtoehdot.

  4. Anna organisaation, säilön, haaran, Git-kansion ja yhteystietojen GitHub edellisistä asennusvaiheista.

    Näyttökuva yhteyden GitHub Git-ruudussa.

  5. Luo GitHub sovellusmääritys ja anna GitHub sovelluksen asiakastunnus, Key Vault URI ja avaimen nimi edellisistä asennusvaiheista.

    Näyttökuva sovelluksen GitHub määritystiedoista Gitiin yhdistämisen ruudussa.

Key Vault roolipohjaisen käytön hallinnan määrittäminen

  1. Siirry Azure-portaalissa Key Vault resurssiin.

  2. Valitse Käyttöoikeuksien valvonta (IAM), valitse Lisää ja valitse sitten Lisää roolimääritys.

  3. Etsi ja valitse Key Vault Salauskäyttäjä -rooli.

    Näyttökuva Key Vault Salauskäyttäjä -roolin valitsemisesta roolimäärityksessä Azure.

  4. Valitse Valitse jäsenet ja etsi sitten GitHub sovellusmääritykseesi liittyvät Dataversen hallitut käyttäjätiedot. Hallitun käyttäjätiedon nimi käyttää seuraavaa muotoa:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Valitse hallitut käyttäjätiedot ja valitse sitten Tarkista + määritä.

    Näyttökuva Dataversen hallittujen käyttäjätietojen valitsemisesta Key Vault roolimääritystä varten.

Jos hallittuja käyttäjätietoja ei näy, siirry Dataverse-ympäristön asetukset>järjestelmätöihin ja tarkista GitHub sovellusten kokoonpanon luomiseen liittyvät virheet. Rekisteröinti luodaan asynkronisesti, ja sen ilmestyminen voi kestää hetken.

Kun roolimääritys on valmis, Dataversen hallituilla käyttäjätiedoilla on oikeus käyttää GitHub-avainta tässä Key Vault.

Yhteyden tarkistaminen ja vahvistustestin testaaminen

Avaa hallitsematon ratkaisu Ratkaisut-alueelta . Jos sinulla ei vielä ole ratkaisua, luo uusi ratkaisu. Lähteen hallinnan integrointi toimii vain hallitsemattomien ratkaisujen kanssa.

Siirry Lähde-ohjausobjektisivulle ja valitse Git-yhteys. Varmista, että yhteys näyttää palveluna GitHub ja että organisaation, säilön, haaran ja kansion tiedot ovat oikein.

Jos haluat varmistaa päästä päähän -työnkulun, valitse Vahvista, jos haluat työntää ratkaisusi yhdistettyyn GitHub säilöön.

Jos vahvistus onnistuu, integrointi on toiminnassa.

Yhdistä koodin avulla

Dataverse Web API:n tai PowerShellin avulla voit muodostaa yhteyden GitHub ohjelmallisesti käyttöliittymän käyttämisen sijaan. Lisätietoja on artikkelissa GitHub säilöön yhdistäminen.

  • Last updated on