Savienojums ar GitHub (priekšskatījums)

[Šis raksts ir pirmsizlaides dokumentācija, kas var mainīties.]

Lai savienotu Dataverse vidi vai risinājumu ar GitHub, izveido GitHub lietotni, glabā lietotnes privāto atslēgu Azure Key Vault, izveido Power Platform GitHub savienojumu un pēc tam pieslēdzies no avota kontroles pieredzes savā risinājumā.

Jūs varat piekļūt risinājumiem no Power Apps, Power Automate, Power Pages un Copilot Studio.

Svarīgi!

• Šis ir priekšskatījuma līdzeklis.
• Priekšskatījuma funkcijas nav paredzētas lietošanai ražošanā, un to funkcionalitāte var būt ierobežota. Šie līdzekļi ir pieejami pirms oficiālā laidiena, lai klienti varētu priekšlaikus piekļūt līdzeklim un sniegt atsauksmes.

Priekšnoteikumi

• Dataverse Git integrācija ir pārvaldīto vides līdzeklis. Izstrādes un mērķa vides ir jāiespējo kā pārvaldītas vides.
• GitHub konts ar organizācijas administratora piekļuvi.
• Azure abonements ar atļauju veidot Key Vault resursus. Key Vault jābūt tajā pašā Microsoft Entra nomniekā kā Dataverse videi.
• Tev vajag Dataverse vidi, kur ir sistēmas administratora drošības loma.
• Pielāgots, nepārvaldīts risinājums, ko vēlaties savienot ar avota kontroli. Izveido tādu, ja tev vēl nav.

Izveido GitHub lietotni

1. Atveriet GitHub savā pārlūkprogrammā. Izvēlieties savu profila attēlu augšējā labajā stūrī un pēc tam dodieties uz Iestatījumu>izstrādātāja iestatījumiem.

2. Izvēlieties jaunu GitHub lietotni.

   Jūs varat arī doties tieši uz GitHub lietotnes reģistrācijas lapu, lai izveidotu jaunu GitHub lietotni.

3. Create GitHub App lapā ievadiet unikālu nosaukumu savai GitHub lietotnei GitHub lietotnes nosaukuma laukā. Piemēram, ievadiet MyOrgGitHubIntegrationApp.

4. Aizpildiet sākumlapas URL lauku. Jūs varat izmantot savas organizācijas mājaslapu vai GitHub repozitorija URL.

5. Ja jums nav nepieciešami webhook paziņojumi, notīriet Active izvēles rūtiņu Webhook sadaļā.

   

Konfigurācijas repozitoriju atļaujas

1. Ritiniet uz leju līdz Atļauju sadaļai.

2. Paplašiniet repozitorija atļaujas un iestatiet saturulasīšanai un rakstīšanai. Šī atļauja ļauj lietotnei lasīt un rakstīt repozitorija saturu avota kontroles integrācijai.

   

3. Ritiniet uz leju un izvēlieties Izveidot GitHub lietotni.

4. GitHub lietotnes iestatījumu lapā nokopē klienta ID. Šī vērtība ir nepieciešama, reģistrējot lietotnes konfigurāciju Dataverse. Klienta ID izmanto formātu, piemēram, Iv23liBWoH6sf7xGrRe9.

5. Ģenerējiet un lejupielādējiet privāto atslēgu no GitHub lietotnes iestatījumu lapas. Glabājiet privāto atslēgu Azure Key Vault vēlākā posmā.

   

Instalējiet GitHub lietotni mērķa repozitorijā

1. No GitHub lietotnes iestatījumu lapas kreisajā panelī izvēlieties Instalēt lietotni.

2. Izvēlieties Instalēt blakus kontam vai organizācijai, kas pieder mērķa repozitorijam.

   Ja mērķa repozitorijs pieder GitHub organizācijai, organizācijas administratoram var būt jāapstiprina lietotnes instalācija. Administrators saņem paziņojumu, lai pārskatītu un apstiprinātu pieprasījumu.

   

3. Izvēlies, vai piešķirt lietotnei piekļuvi visiem repozitorijiem vai tikai atlasīt repozitorijus. Drošības labākajai praksei izvēlieties tikai tos konkrētos repozitorijus, kas nepieciešami avota kontroles integrācijai.

4. Izvēlieties Instalēt, lai pabeigtu instalāciju.

   

Azure Key Vault konfigurēšana

1. Atver Azure portālu un dodies uz savu atslēgu glabātuvi. Ja tev tāda nav, vispirms izveido jaunu atslēgu glabātuvi.

2. Key Vault panelī kreisajā navigācijā izvēlieties Atslēgas.

   

3. Atlasiet Ģenerēt/Importēt.

4. Opciju nolaižamajā izvēlnē izvēlieties Importēt.

5. Ievadiet atslēgas nosaukumu, piemēramdemoGitHubKey, , un pēc tam augšupielādējiet failu, .pem ko lejupielādējāt no GitHub.

6. Izvēlies Radīt, lai importētu atslēgu.

   

Izveido GitHub savienojumu

Izveidojiet OAuth savienojumu, izmantojot savu personīgo GitHub kontu. Šis savienojums apliecina, ka iestatīšanas laikā jums ir administratora piekļuve mērķa repozitorijam. Izpildes laikā GitHub lietotne apstrādā komunikāciju ar GitHub, tāpēc atsevišķiem lietotājiem nav jāveido GitHub savienojumi.

Piezīme

Tu nevari izmantot GitHub savienojumus, ja Dataverse vidē ir ieslēgts virtuālā tīkla (VNET) atbalsts. Tā vietā izmantojiet GitHub personīgās piekļuves tokenu (PAT).

1. Dodieties uz Power Apps maker portālu un tad izvēlieties Savienojumus.

2. Atlasiet Jauns savienojums.

3. Meklējiet un izvēlieties GitHub standarta savienotāju.

   

4. Piesakieties, izmantojot savu GitHub kontu, un piešķiriet pieprasīto piekļuvi.

   

GitHub kontam, ar kuru piesakāties, jābūt administratora piekļuvei mērķa repozitorijam. OAuth savienojums pārbauda jūsu atļaujas.

Kad esi izveidojis savienojumu, atver to. Pievērs uzmanību savienojuma ID no URL savā pārlūkprogrammas adreses joslā. Šī vērtība ir nepieciešama, konfigurējot Git savienojumu.

Savienojuma ID parādās URL, kad apskatāt savienojuma detaļas, kā redzams šajā piemērā:

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

Apstipriniet OAuth lietotnes piekļuvi jūsu organizācijai

Ja jūsu GitHub organizācijai ir ieslēgti piekļuves ierobežojumi bez Microsoft lietojumprogrammām, organizācijas administratoram jāapstiprina OAuth lietotne, ko izmanto Power Apps GitHub savienotājs. Pārbaudiet savas organizācijas iestatījumus sadaļā Organization Settings>Third-party access.

Papildu informācijai skatiet sadaļu Iespējot OAuth lietotņu piekļuves ierobežojumus un Apstiprināt OAuth lietotnes jūsu organizācijai.

Savienojies ar GitHub no risinājuma

1. Izveidojiet jaunu nevadītu risinājumu vai izvēlieties esošu pielāgotu nevadītu risinājumu.

2. Avota kontroles lapā izvēlieties Connect.

3. Connect to Git panelī izvēlieties GitHub.

   

4. Ievadiet GitHub organizāciju, repozitoriju, zaru, Git mapi un savienojuma informāciju no iepriekšējiem iestatīšanas soļiem.

   

5. Izveidojiet GitHub lietotnes konfigurāciju un ievadiet GitHub lietotnes klienta ID, Key Vault URI un atslēgas nosaukumu no iepriekšējiem iestatīšanas soļiem.

   

Konfigurējiet Key Vault lomu balstītu piekļuves kontroli (RBAC)

1. Azure portālā dodies uz savu Key Vault resursu.

2. Izvēlieties piekļuves kontroli (IAM), izvēlieties Pievienot un pēc tam izvēlieties Pievienot lomas piešķiršanu.

3. Meklējiet un izvēlieties Key Vault Crypto User lomu.

   

4. Izvēlieties Select dalībniekus un pēc tam meklējiet Dataverse pārvaldīto identitāti, kas saistīta ar jūsu GitHub lietotnes konfigurāciju. Pārvaldītās identitātes nosaukums tiek izmantots šādā formātā:

   PPMI-githubappconfigmanagedidentity-{GUID}
   

5. Izvēlieties pārvaldīto identitāti un pēc tam izvēlieties Pārskatīt + piešķirt.

   

Ja pārvaldītā identitāte neparādās, dodieties uz Dataverse vides iestatījumiem>System Jobs un pārbaudiet kļūdas, kas saistītas ar GitHub lietotnes konfigurācijas izveidi. Reģistrācija tiek izveidota asinhroni un var aizņemt brīdi, lai parādītos.

Pēc lomas piešķiršanas pabeigšanas Dataverse pārvaldītajai identitātei ir atļauja izmantot GitHub atslēgu šajā Key Vault.

Pārbaudiet savienojumu un pārbaudiet apstiprinājumu

Atver nevadītu risinājumu no Risinājumu sadaļas. Ja tev vēl nav risinājuma, vispirms izveido jaunu risinājumu. Avota kontroles integrācija darbojas tikai ar nepārvaldītiem risinājumiem.

Dodieties uz Source Control lapu un izvēlieties Git savienojumu. Pārbaudiet, vai savienojums rāda GitHub kā pakalpojumu sniedzēju un ka organizācijas, repozitorijas, zara un mapes dati ir pareizi.

Lai pārbaudītu gala līdz gala plūsmu, izvēlieties Commit, lai nosūtītu savu risinājumu uz pievienoto GitHub repozitoriju.

Ja apņemšanās izdodas, integrācija ir operacionāla.

Savienojieties, izmantojot kodu

Tu vari izmantot Dataverse Web API vai PowerShell, lai programmatiski pieslēgtos GitHub, nevis izmantojot lietotāja saskarni. Papildu informācijai skatiet sadaļu Savienojums ar GitHub repozitoriju.