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

GitHub darbības Microsoft Power Platform ir aprakstītas nākamajās sadaļās. Turklāt tiek parādīti arī GitHub darbplūsmu paraugi. Lai iegūtu papildinformāciju par GitHub darbībām un to lejupielādi, ejiet uz GitHub darbībām 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. Varat pievienot servisa vadītāja vai lietotāja akreditācijas datus kā slepenu informāciju savā GitHub krātuvē un pēc tam izmantot tos darbplūsmās.

Papildinformāciju par to, kā iestatīt slepeno informāciju GitHub, skatiet sadaļā Šifrēta slepenā informācija
Papildinformāciju par servisa galvenā autentifikācijas iestatīšanas veidu Microsoft Power Platform skatiet DevOps būvēšanas rīkos

Pēc konfigurēšanas servisa vadītāju varat izsaukt no darbību skriptiem.

Parametri, kas jādefinē gitHub darbības skriptā kā vides mainīgie:

Programmas ID, piemēram: WF_APPLICATION_ID:<your application id>
Nomnieka ID, piemēram: WF_TENANT_ID:<your tenant id>

Klienta slepenie dati ir jāpievieno un jāsaglabā kā GitHub Secret, un uz tiem ir jānorāda darbplūsmā, izmantojot šādu parametru: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Palīga uzdevumi

Pieejamais palīga uzdevums ir aprakstīts tālāk.

Darbības-instalēšana

Kad GitHub darbību darbplūsma liek instalēt Power Platform CLI skrējēja kontekstā un rodas taimauta kļūda, jums jāizmanto versija 1 (@v1) ar papildu darbību (actions-install), kā norādīts zemāk.

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.
Uzdevums Instalēšanas Power Platform rīki ir jāpievieno kā pirmais uzdevums darbplūsmā pirms jebkuru citu GitHub darbību veikšanas Power Platform.

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'

Papildu GitHub darbību paraugus varat atrast sadaļā Power Platform Darbības.

WhoAmI

Pārbauda servisa savienojumu, izveidojot savienojumu ar servisu un nosūtot WhoAmI [SDK/Tīmekļa API] pieprasījumu. Šis uzdevums var būt noderīgs, lai to iekļautu GitHub darbplūsmas sākumā, lai pirms apstrādes sākuma apstiprinātu savienojamību.

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. GitHub paroles tiek definētas Iestatījumi sadaļā Noslēpumi. Pēc slepenās darbības definēšanas un saglabāšanas to vairs nevar izgū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 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. GitHub paroles tiek definētas Iestatījumi sadaļā Noslēpumi. Pēc slepenās darbības definēšanas un saglabāšanas to vairs nevar izgū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) 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

Sadala saspiestu risinājuma failu vairākos XML failos tā, lai avota vadīklas sistēma šos failus varētu viegli pārvaldīt.

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 atpakot 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 avota vadīklā esošu risinājumu solution.zip failā, ko var importēt citā vidē.

Parametrs	Apraksts
risinājuma fails	(Obligāts) Risinājums.zip faila ceļa un faila nosaukums, lai pakotu 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

Nodrošina iespēju jaunināt 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 izpilda darbības attiecībā pret pakotnēm un iekļauj tālāk norādīto.

izvietojuma pakotne

Nodrošina iespēju izvietot dll pakotnes vai zip failu ar pakotni.

Note

Šī darbība tiek atbalstīta tikai operētājsistēmā 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 izmantos standarta (`1`) vai uzlaboto(-o) 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 un ietver tālāk norādīto.

Note

Pašlaik kataloga uzdevumi Power Platform ir priekšskatījums laidiens .

instalēt

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

Parametrs	Apraksts
catalog-item-id	(Obligāti) Kataloga vienums, kas jāinstalē mērķa vidē.
target-url	(Obligāti) Mērķa vides vietrādis URL kataloga vienuma instalēšanai (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 tas tiek atstāts tukšs, tiek atlasī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ūstiet kataloga instalēšanas/iesniegšanas pieprasījuma statusu.

Parametrs	Apraksts
Izsekošanas ID	(Obligāti) Pieprasīt izsekošanas ID.
type	(Obligāti) Pieprasījuma tips (vērtības: instalēt, iesniegt)

GitHub darbplūsmas autorēšana

Lai uzzinātu vairāk par GitHub darbplūsmu komplektēšanu, izmantojot GitHub darbības, izpildiet GitHub darbības attiecībā uz Microsoft Power Platform laboratorijām.

Papildinformācija: par GitHub darbībām

Skatiet arī

GitHub darbības Microsoft Power Platform

Atsauksmes

Vai šī lapa palīdzēja?

Last updated on 2024-03-29