Pieejamās GitHub darbības Microsoft Power Platform izstrādei

Turpmākajās sadaļās aprakstītas GitHub Actions for Microsoft Power Platform. Sadaļās ir arī parādīti GitHub darba plūsmas paraugi. Lai iegūtu vairāk informācijas par GitHub Actions un to lejupielādi, skatiet GitHub Actions for Microsoft Power Platform.

Konfigurēt akreditācijas datus izmantošanai ar GitHub darbībām ar Microsoft Power Platform

Daudzām darbībām ir nepieciešams savienojums ar Microsoft Dataverse vidi. Pievienojiet pakalpojuma galveno vai lietotāja akreditācijas datus kā noslēpumus savā GitHub repozitorijā un pēc tam izmantojiet tos savās darba plūsmās.

Pēc akreditācijas konfigurēšanas varat izsaukt pakalpojuma galveno no saviem darbību skriptiem.

Definējiet šādus parametrus savā GitHub Action Script kā vides mainīgos:

  • Lietojumprogrammas ID, piemēram: WF_APPLICATION_ID:<your application id>
  • Īrnieka ID, piemēram: WF_TENANT_ID:<your tenant id>

Pievieno klienta noslēpumu kā GitHub noslēpumu. Atsaucies uz to no darba plūsmas iekšienes, izmantojot parametru, piemēram: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Palīga uzdevumi

Pieejams šāds palīga uzdevums.

Darbības-instalēšana

Kad GitHub Actions darba plūsma piespiež instalēt Power Platform CLI skrējēja kontekstā un rodas laika limita kļūda, izmantojiet versiju 1 (@v1) ar papildu darbību (actions-install), kā parādīts nākamajā piemērā.

Svarīgi

  • Izmantojot 1. (@v1) versiju, var tikt atjauninātas esošās GitHub darbības, kā rezultātā pašreizējās darbplūsmas var tikt atjauninātas.
  • Pievienojiet uzdevumu Install Power Platform Tools kā pirmo uzdevumu savā darba plūsmā pirms jebkura cita GitHub Actions for Power Platform veikšanas.
jobs:
    builds:
        runs-on: windows-latest   # alternate runner OS is: ubuntu-latest

    steps:
    - name: Install Power Platform Tools
        uses: microsoft/powerplatform-actions/actions-install@v1

    - name: Export Solution
         uses: microsoft/powerplatform-actions/export-solution@v1
      with:
         environment-url: 'https://myenv.crm.dynamics.com'
         user-name: 'me@myenv.onmicrosoft.com'
         password-secret: ${{ secrets.MYPASSWORD }}
         solution-name: aSolution
         solution-output-file: 'aSolution.zip'
         working-directory: 'out'

Vairāk GitHub Actions piemēru varat atrast Power Platform Actions vietnē.

WhoAmI

Pārbauda servisa savienojumu, izveidojot savienojumu ar servisu un nosūtot WhoAmI [SDK/Tīmekļa API] pieprasījumu. Šo uzdevumu var būt noderīgi iekļaut agrīnā GitHub darba plūsmā, lai pārbaudītu savienojamību pirms apstrādes sākuma.

Parametrs Apraksts
vides URL Tās vides URL, ar kuru veidojat savienojumu.
lietotājvārds Tā uzņēmuma lietotājvārds, ko izmantojat, lai izveidotu savienojumu.
parole-noslēpums Parole lietotājvārdam. Definējiet GitHub paroles iestatījumos sadaļā Secrets. Tu nevari atgūt noslēpumu pēc tam, kad esi to definējis un saglabājis.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.

Risinājuma uzdevumi

Šie uzdevumi veic darbības ar risinājumiem un ietver tālāk norādītās darbības.

import-solution

Importējot risinājumu mērķa vidē.

Parametrs Apraksts
vides URL (Obligāts) Vietrādis URL mērķa videi, kurā vēlaties importēt risinājumu. (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
risinājuma fails (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.

export-solution

Eksportē risinājumu no avota vides.

Parametrs Apraksts
vides URL (Obligāts) Vietrādis URL mērķa videi, no kuras vēlaties eksportēt risinājumu. (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums (Obligāts) Ja izmantojat lietotājvārdu/paroles autentifikāciju, parole lietotājvārdam. Definējiet GitHub paroles iestatījumos sadaļā Secrets. Tu nevari atgūt noslēpumu pēc tam, kad esi to definējis un saglabājis.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
risinājuma nosaukums (Nepieciešams) Eksportējamā risinājuma nosaukums. Vienmēr izmantojiet risinājuma nosaukumu, nevis tā parādāmo nosaukumu.
risinājuma izvades fails (Nepieciešams) Risinājuma .zip faila ceļš un faila nosaukums, uz kuru eksportēt avota vidi.
pārvaldītie Nepieciešams iestatiet vērtību patiess, lai eksportētu kā pārvaldītu risinājumu; noklusējuma (nepatiess) iestatījums ir eksportēt kā nepārvaldītu risinājumu.

unpack-solution

Ņem saspiestu risinājuma failu un sadala to vairākos XML failos. Šos failus ir vieglāk lasīt un pārvaldīt avota kontroles sistēmā.

Parametrs Apraksts
risinājuma fails (Nepieciešams) solution.zip faila ceļš un faila nosaukums, kas jāatpako.
risinājuma mape (Nepieciešams) Ceļš un mērķa mape, kur vēlaties izpakot risinājumu.
risinājuma tips (Nepieciešams) Izpakojamā risinājuma veida izvēle. Ir šādas opcijas: Nepārvaldīts (ieteicams), Pārvaldīts un Abi.

pack-solution

Iepako risinājumu, kas attēlots avota kontrolē, solution.zip failā, ko var importēt citā vidē.

Parametrs Apraksts
risinājuma fails (Nepieciešams) Ceļš un faila nosaukums solution.zip failam, kurā iepakot risinājumu (piemēram, out/CI/ALMLab.zip).
risinājuma mape (Nepieciešams) Risinājumu pakošanas ceļš un avota mape.
risinājuma tips (Neobligāts) Risinājuma tips pakotnei. Ir šādas opcijas: Nepārvaldīts (ieteicams), Pārvaldīts un Abi.

publish-solution

Publicē risinājumu pielāgojumus.

Parametrs Apraksts
vides URL (Obligāts) URL videi, kurā vēlaties publicét risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
risinājuma fails (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.

clone-solution

Tiek klonēts konkrētās vides risinājums.

Parametrs Apraksts
vides URL (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
risinājuma fails (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
risinājuma nosaukums (Obligāti) Klonēt nepieciešamā solution.zip faila ceļu un nosaukumu (piemēram, out/CI/ALMZol.zip).
solution-version Klonējamā risinājuma versija.
target-folder Mērķa mape, kurā ievietot izvilkto risinājumu. (piemēram, Git krātuve\target-solution-folder).
Working-directory Pagaidu mape darbam artefaktiem, kas nepieciešami risinājuma klonēšanai.
noklusējums: root of the repository

check-solution

Pārbauda risinājuma failu, lai noteiktu neatbilstības.

Parametrs Apraksts
vides URL (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
ceļš (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties pārbaudīt.
ģeogrāfisks apgabals Kura Microsoft Power Platform pārbaudītāja pakalpojuma ģeogrāfiskā instance jāizmanto. Noklusējuma vērtība ir "ASV".
rule-level-override Ceļš uz failu, kurā iekļauts JSON kārtulu masīvs un to līmeņi. Pieņemtās vērtības ir: Kritisks, Augsts, Zems un Informācijas. Piemērs: [{"Id":"metadati-remove-dup-re","OverrideLevel":"Vidējs"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Vidējs"}]
checker-logs-artifact-name Tās artefaktētās mapes nosaukums, kurai Microsoft Power Platform tiks augšupielādēti pārbaudes lietojumprogrammas žurnāli. Noklusējuma vērtība ir 'CheckSolutionLogs'.

upgrade-solution

Uzlabo risinājumu.

Parametrs Apraksts
vides URL (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
risinājuma fails (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
risinājuma nosaukums (Nepieciešams) Jaunināmā risinājuma nosaukums.
asinhrons Asinhroni jaunina risinājumu.
Maksimālais asinhronais gaidīšanas laiks Maksimālais asinhronais gaidīšanas laiks minūtēs. Noklusējuma vērtība ir 60 minūtes.

Pakotnes uzdevumi

Šie uzdevumi veic darbības pret pakotnēm.

izvietojuma pakotne

Izvieto pakotnes DLL vai ZIP failu kopā ar pakotni.

Note

Šī darbība ir atbalstīta tikai uz Windows.

Parametrs Apraksts
vides URL (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
lietotājvārds Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu.
parole-noslēpums Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu.
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
Pakotne (Nepieciešams) Ceļš uz pakotnes DLL vai ZIP failu ar pakotni.

Portāla uzdevumi

Šie uzdevumi izpilda sekojośas darbíbas attiecībā uz Power Pages.

upload-paportal

Augšupielādē datus uz Power Pages.

Parametrs Apraksts
vides URL (Obligāts) URL videi, kurā vēlaties importēt risinājumu (piemēram, https://YourOrg.crm.dynamics.com).
app-id Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
client-secret Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati.
tenant-id Nomnieka ID, veicot autentificēšanu ar app-id un client-secret.
upload-path Ceļš, kurā tiks lejupielādēts tīmekļa vietnes saturs (aizstājvārds: -p).
deployment-profile Augšupielādējiet portāla datus ar vides detaļām, kuras definēti ar profila mainīgajiem izvietojuma profilos/[profile-name].deployment.yaml file.
Modeļa versija Norāda, vai augšupielādējamie vietnes dati izmanto standarta (1) vai uzlaboto datu modeli (2). Noklusējuma vērtība ir 1.

Uzziniet vairāk par Microsoft Power Platform CLI atbalstu Power Pages.

Kataloga uzdevumi (priekšskatījums)

Šie uzdevumi veic darbības pret katalogu Power Platform vidē.

Note

Pašlaik Power Platform kataloga uzdevumi ir priekšskatījumā.

instalēt

Instalējiet kataloga vienumu mērķa vidē.

Parametrs Apraksts
catalog-item-id (Nepieciešams) Kataloga vienums, kas jāinstalē mērķa vidē.
target-url (Nepieciešams) Kataloga vienuma instalācijas mērķa vides URL (piemēram, https://YourOrg.crm.dynamics.com).
iestatījumi (Obligāti) izpildlaika pakotne instalācijas struktūras iestatījumi, kas jāizpilda. Virknes formātam jābūt key=value|key=value.
Mērķa versija Instalējamā mērķa versija. Ja nenorādāt versiju, tiek izvēlēta publicētā versija.
Aptaujas statuss Aptauja, lai pārbaudītu pieprasījuma statusu.

iesniegt

Uzskaitiet visus publicētos kataloga vienumus no pašreizējās Dataverse vides (organizācijas).

Parametrs Apraksts
ceļš (Obligāti) Ceļš uz kataloga iesniegšanas dokumentu.
iepakojums-zip Ceļš uz pakotnes zip failu.
risinājums-zip Ceļš uz risinājuma zip failu.
Aptaujas statuss Aptauja, lai pārbaudītu pieprasījuma statusu.

statuss

Iegūsti kataloga instalācijas statusu vai iesniedz pieprasījumu.

Parametrs Apraksts
Izsekošanas ID (Obligāti) Pieprasīt izsekošanas ID.
type (Nepieciešams) Pieprasījuma veids. Derīgās vērtības ir Install un Submit.

GitHub darbplūsmas autorēšana

Lai uzzinātu vairāk par GitHub darba plūsmu veidošanu, izmantojot GitHub Actions, aizpildiet GitHub Actions Microsoft Power Platform laboratorijām.

Papildu informācijai skatiet sadaļu Par GitHub Actions.

Skatiet arī

GitHub darbības Microsoft Power Platform