Opret forbindelse til GitHub (prøveversion)

[Denne artikel er foreløbig dokumentation og kan ændres.]

Hvis du vil oprette forbindelse til et Dataverse-miljø eller en dataløsning for at GitHub, skal du oprette en GitHub app, gemme den private nøgle for appen i Azure Key Vault, oprette en Power Platform GitHub forbindelse og derefter oprette forbindelse fra versionsstyringsoplevelsen i din løsning.

Du kan få adgang til løsninger fra Power Apps, Power Automate, Power Pages og Copilot Studio.

Vigtigt!

  • Dette er en prøveversionsfunktion.
  • Prøveversionsfunktioner er ikke beregnet til produktionsbrug og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Forudsætninger

  • Integration af Dataverse Git er en funktion i administrerede miljøer. Udviklings- og målmiljøer skal aktiveres som administrerede miljøer.
  • En GitHub konto med organisationsadministratoradgang.
  • Et Azure abonnement med tilladelse til at oprette Key Vault ressourcer. Key Vault skal være i den samme Microsoft Entra-tenant som Dataverse-miljøet.
  • Du skal bruge et Dataverse-miljø, hvor du har sikkerhedsrollen Systemadministrator.
  • En brugerdefineret uadministreret løsning, som du vil knytte til versionsstyring. Opret en, hvis du ikke har en endnu.

Opret en GitHub app

  1. Åbn GitHub i browseren. Vælg dit profilbillede i øverste højre hjørne, og gå derefter til Indstillinger Udviklerindstillinger>.

  2. Vælg Ny GitHub App.

    Du kan også gå direkte til siden GitHub appregistrering for at oprette en ny GitHub app.

  3. På siden Opret GitHub app skal du angive et entydigt navn til din GitHub app i feltet GitHub Appnavn. Angiv for eksempel MyOrgGitHubIntegrationApp.

  4. Udfyld feltet URL-adresse til startsiden . Du kan bruge organisationens websted eller URL-adressen til GitHub lager.

  5. Hvis du ikke har brug for webhookmeddelelser, skal du fjerne markeringen i afkrydsningsfeltet Aktiv i afsnittet Webhook .

    Skærmbillede af GitHub oprette en appside med feltet GitHub appnavn.

Konfigurer lagertilladelser

  1. Rul ned til afsnittet Tilladelser .

  2. Udvid Lagertilladelser, og angiv derefter Indhold til Læs og skriv. Denne tilladelse gør det muligt for appen at læse og skrive lagerindhold til integration af kildestyring.

    Skærmbillede af lagertilladelser til en GitHub app.

  3. Rul ned, og vælg Opret GitHub app.

  4. Kopiér klient-id'et på siden GitHub appindstillinger. Du skal bruge denne værdi, når du registrerer appkonfigurationen i Dataverse. Klient-id'et bruger et format, f.eksIv23liBWoH6sf7xGrRe9. .

  5. Opret og download en privat nøgle fra siden med GitHub appindstillinger. Gem den private nøgle i Azure Key Vault på et senere trin.

    Skærmbillede af siden med GitHub appindstillinger med indstillingen Opret privat nøgle.

Installér GitHub-appen på destinationslageret

  1. Vælg Installér app i venstre rude på siden GitHub appindstillinger.

  2. Vælg Installér ud for den konto eller organisation, der ejer mållageret.

    Hvis mållageret tilhører en GitHub organisation, skal organisationsadministratoren muligvis godkende appinstallationen. Administratoren modtager en meddelelse om at gennemse og godkende anmodningen.

    Skærmbillede af siden GitHub appinstallation.

  3. Vælg, om appen skal have adgang til alle lagre , eller vælg kun lagre. I forbindelse med bedste praksis for sikkerhed skal du kun vælge de specifikke lagre, der er nødvendige for integration af versionsstyring.

  4. Vælg Installér for at fuldføre installationen.

    Skærmbillede af valg af lagre til GitHub appadgang.

Konfigurer Azure Key Vault

  1. Åbn Azure-portalen, og gå til din key vault-ressource. Hvis du ikke har en, skal du først oprette en ny key vault.

  2. Vælg Nøgler i venstre navigationsrude i ruden Key Vault.

    Skærmbillede af navigationselementet Azure Key Vault taster.

  3. Vælg Generer/importer.

  4. Vælg Importér på rullelisten Indstillinger.

  5. Angiv et navn til nøglen, f.eksdemoGitHubKey. , og upload derefter den .pem fil, du har downloadet fra GitHub.

  6. Vælg Opret for at importere nøglen.

    Skærmbillede af import af en nøgle til Azure Key Vault.

Opret en GitHub forbindelse

Opret en OAuth-forbindelse ved hjælp af din personlige GitHub-konto. Denne forbindelse kontrollerer, at du har administratoradgang til destinationslageret under konfigurationen. På kørselstidspunktet håndterer GitHub-appen kommunikation med GitHub, så individuelle brugere ikke behøver at oprette GitHub forbindelser.

Bemærkning

Du kan ikke bruge GitHub forbindelser, når du aktiverer understøttelse af virtuelle netværk (VNET) for Dataverse-miljøet. Brug i stedet et GitHub personligt adgangstoken (PAT).

  1. Gå til Power Apps-udviklerportalen, og vælg derefter Forbindelser.

  2. Vælg Ny forbindelse.

  3. Søg efter og vælg GitHub-standardforbindelsen.

    Skærmbillede af oprettelse af en ny GitHub forbindelse i Power Apps.

  4. Log på ved hjælp af din GitHub konto, og tildel den ønskede adgang.

    Skærmbillede af GitHub logonprompt for en Power Apps forbindelse.

Den GitHub konto, du logger på med, skal have administratoradgang til destinationslageret. OAuth-forbindelsen kontrollerer dine tilladelser.

Når du har oprettet forbindelsen, skal du åbne den. Bemærk forbindelses-id'et fra URL-adressen på browserens adresselinje. Du skal bruge denne værdi, når du konfigurerer Git-forbindelsen.

Forbindelses-id'et vises i URL-adressen, når du får vist forbindelsesoplysningerne, som vist i følgende eksempel:

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

Skærmbillede af en side med Power Apps GitHub forbindelsesoplysninger, der viser forbindelses-id'et i URL-adressen.

Godkend OAuth-appadgang for din organisation

Hvis din GitHub organisation har ikke-Microsoft programadgangsbegrænsninger aktiveret, skal en organisationsadministrator godkende den OAuth-app, der bruges af Power Apps GitHub-connectoren. Kontrollér organisationens indstillinger under Organisationsindstillinger>Tredjepartsadgang.

Skærmbillede af GitHub indstillinger for tredjepartsprogramadgang til organisationen.

Du kan få flere oplysninger under Aktivering af adgangsbegrænsninger for OAuth-apps og Godkendelse af OAuth-apps for din organisation.

Opret forbindelse til GitHub fra en løsning

  1. Opret en ny ikke-administreret løsning, eller vælg en eksisterende brugerdefineret ikke-administreret løsning.

  2. Vælg Opret forbindelse på siden Kildekontrolelement.

  3. Vælg GitHub i ruden Opret forbindelse til Git.

    Skærmbillede af ruden Opret forbindelse til Git med indstillinger for Azure DevOps og GitHub udbyder.

  4. Angiv oplysninger om GitHub organisation, lager, forgrening, Git-mappe og forbindelse fra de forrige konfigurationstrin.

    Skærmbillede af GitHub forbindelsesoplysninger i ruden Opret forbindelse til Git.

  5. Opret en GitHub appkonfiguration, og angiv GitHub appklient-id, Key Vault URI og nøglenavn fra de forrige konfigurationstrin.

    Skærmbillede af GitHub oplysninger om appkonfiguration i ruden Opret forbindelse til Git.

Konfigurer Key Vault rollebaseret adgangskontrol (RBAC)

  1. Gå til din Key Vault-ressource på Azure-portalen.

  2. Vælg Adgangskontrol (IAM), vælg Tilføj, og vælg derefter Tilføj rolletildeling.

  3. Søg efter og vælg rollen Key Vault Kryptografibruger.

    Skærmbillede af valg af rollen Key Vault Kryptografibruger i Azure rolletildeling.

  4. Vælg Vælg medlemmer, og søg derefter efter den Dataverse-administrerede identitet, der er knyttet til din GitHub appkonfiguration. Navnet på den administrerede identitet bruger følgende format:

    PPMI-githubappconfigmanagedidentity-{GUID}

  5. Vælg den administrerede identitet, og vælg derefter Gennemse + tildel.

    Skærmbillede af valg af den dataverseadministrerede identitet for en Key Vault rolletildeling.

Hvis den administrerede identitet ikke vises, skal du gå til Indstillinger for> dataverse-miljøetSystemjob og kontrollere, om der er fejl i forbindelse med oprettelse af GitHub appkonfiguration. Registreringen oprettes asynkront og kan tage et øjeblik at blive vist.

Når rolletildelingen er fuldført, har dataverse-den administrerede identitet tilladelse til at bruge nøglen GitHub i denne Key Vault.

Kontrollér forbindelsen, og test en bekræftelse

Åbn en ikke-administreret løsning fra området Løsninger . Hvis du ikke har en endnu, skal du først oprette en ny løsning. Integration af versionsstyring fungerer kun sammen med ikke-administrerede løsninger.

Gå til siden Kildekontrolelement , og vælg Git-forbindelse. Kontrollér, at forbindelsen viser GitHub som udbyder, og at oplysningerne om organisationen, lageret, forgreningen og mappen er korrekte.

Hvis du vil bekræfte flowet fra slutpunkt til slutpunkt, skal du vælge Bekræft for at overføre din løsning til det forbundne GitHub lager.

Hvis bekræftelsen lykkes, fungerer integrationen.

Opret forbindelse ved hjælp af kode

Du kan bruge Dataverse Web API eller PowerShell til at oprette forbindelse til GitHub programmatisk i stedet for at bruge brugergrænsefladen. Du kan få flere oplysninger under Opret forbindelse til et GitHub lager.

  • Last updated on