Galimi „GitHub“ veiksmai, skirti „Microsoft Power Platform“ plėtrai

Tolesniuose skyriuose aprašyti Microsoft Power Platform GitHub Actions. Sekcijose taip pat rodomi GitHub darbo eigų pavyzdžiai. Daugiau informacijos apie GitHub Actions ir kaip jas atsisiųsti, žr. Microsoft Power Platform GitHub Actions.

Sukonfigūruokite kredencialus, kad galėtumėte naudoti "GitHub" veiksmus su Microsoft Power Platform

Dauguma veiksmų reikalauja prisijungti prie „Microsoft Dataverse” aplinkos. Įtraukite pagrindinį tarnybos pavadinimą arba vartotojo kredencialus kaip slaptą informaciją GitHub saugykloje, tada naudokite juos savo darbo eigose.

• Išsamios informacijos, kaip nustatyti paslaptis GitHub, žr. Užšifruotos paslaptys.

• Daugiau informacijos, kaip nustatyti pagrindinį tarnybos autentifikavimą Microsoft Power Platform, žr. "DevOps" komponavimo versijos įrankiai.

Sukonfigūravę kredencialus, galite iškviesti pagrindinį tarnybos pavadinimą veiksmų scenarijuose.

Apibrėžkite šiuos parametrus GitHub veiksmų scenarijuje kaip aplinkos kintamuosius:

• Taikomosios programos ID, pvz.: WF_APPLICATION_ID:<your application id>
• Nuomotojo ID, pvz.: WF_TENANT_ID:<your tenant id>

Įtraukite kliento slaptą informaciją kaip GitHub slaptą. Nurodykite jį iš darbo eigos naudodami parametrą, pvz.: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Padedančio užduotys

Galima ši pagalbinio padėjėjo užduotis.

veiksmai-diegimas

Kai GitHub Actions darbo eiga priverstinai įdiegia "Power Platform" CLI bėgiko kontekste ir įvyksta skirtojo laiko klaida, naudokite 1 versiją (@v1) su papildomu veiksmu (actions-install), kaip parodyta toliau pateiktame pavyzdyje.

Svarbu

• Naudojant 1 versiją (@v1) gali būti atnaujinti esami "GitHub" veiksmai, dėl kurių gali būti atnaujintos dabartinės darbo eigos.
• Įtraukite užduotį Diegti "Power Platform" įrankius kaip pirmąją užduotį savo darbo eigoje prieš bet kurią kitą "Power Platform" GitHub Actions.

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'

Daugiau GitHub Actions pavyzdžių galite rasti "Power Platform" veiksmai.

whoAmI

Tikrina paslaugos ryšį prisijungdama prie paslaugos ir išsiųsdama WhoAmI [ SDK/žiniatinklio API] užklausą. Ši užduotis gali būti naudinga įtraukti į GitHub darbo eigą anksčiau, kad būtų galima patikrinti ryšį prieš pradedant apdorojimą.

Parametras	Aprašo
aplinkos-url	URL aplinkai, prie kurios jungiatės.
vartotojo-vardas	Paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	Slaptažodis vartotojo vardui. Apibrėžkite GitHub slaptažodžius dalyje Slaptiejiparametrai. Apibrėžtų ir įrašytų slaptų duomenų gauti negalėsite.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.

Sprendimo užduotys

Šios užduotys atlieka veiksmus prieš sprendimus ir gali apimti šiuos.

sprendimo importavimas

Importuoja sprendimą į pasirinktą aplinką.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL tikslinei aplinka, į kurią norite kopijuoti, kurią norite importuoti į sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
sprendimo-failas	(Būtina) Sprendimo failo, kurį norite importuoti, kelias ir pavadinimas.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.

eksportuoti sprendimą

Eksportuoja sprendimą iš šaltinio aplinkos.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL tikslinei aplinka, į kurią norite kopijuoti, kurią norite eksportuoti iš sprendimo (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, vartotojo vardas. Apibrėžkite GitHub slaptažodžius dalyje Slaptiejiparametrai. Apibrėžtų ir įrašytų slaptų duomenų gauti negalėsite.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
sprendimo-pavadinimas	(Privaloma) Eksportuojamo sprendimo pavadinimas. Visuomet naudokite sprendimo pavadinimą, o ne jo rodomą pavadinimą.
sprendimo-išvesties-failas	(Būtina) Sprendimo.zip failo, į kurį reikia eksportuoti šaltinio aplinką, kelias ir pavadinimas.
valdomasis	(Būtinas) Nustatytas į tiesa siekiant eksportuoti kaip sutvarkytą sprendimą; numatytasis (netiesa) skirtas eksportuoti kaip nesutvarkytas sprendimas.

išpakuoti sprendimą

Paima suglaudintą sprendimo failą ir sukomponuoja jį keliuose XML failuose. Galite lengviau skaityti ir valdyti šiuos failus šaltinio valdymo sistemoje.

Parametras	Aprašo
sprendimo-failas	(Privaloma) Išpakuojamo sprendimo.zip failo vardas ir kelias.
sprendimo-aplankas	(Būtina) Kelias ir paskirties aplankas, kuriame norite išpakuoti sprendimą.
sprendimo-tipas	(Privaloma) Norimo išpakuoti sprendimo pavadinimas. Parinktys apima Nesutvarkyta (rekomenduojama), Tvarkyta ir Abi.

supakuoti sprendimą

Supakuoja šaltinio valdiklyje nurodytą sprendimą į solution.zip failą, kurį galite importuoti į kitą aplinką.

Parametras	Aprašo
sprendimo-failas	(Būtina) solution.zip failo, į kurį galima supakuoti sprendimą, kelias ir failo vardas (pvz., out/CI/ALMLab.zip).
sprendimo-aplankas	(Būtina) Sprendimo aplanko šaltinis ir kelias, į kurį pakuojama.
sprendimo-tipas	(Pasirenkamas) Pakuojamo sprendimo tipas. Parinktys apima Nesutvarkyta (rekomenduojama), Tvarkyta ir Abi.

publikuoti sprendimą

Publikuoja sprendimų tinkinimus.

Parametras	Aprašo
aplinkos-url	(Būtinas) Aplinkos, į kurią norite publikuoti sprendimą, URL (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
sprendimo-failas	(Būtina) Sprendimo failo, kurį norite importuoti, kelias ir pavadinimas.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.

klonuoti sprendimą

Klonuoja pateiktos aplinkos sprendimą.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL aplinkai, iš kurios norite klonuoti sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
sprendimo-failas	(Būtina) Sprendimo failo, kurį norite importuoti, kelias ir pavadinimas.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
sprendimo-pavadinimas	(Būtina) Failo solution.zip kelias ir pavadinimas reikalingas klonuoti (pvz., iš /CI/ALMLab.zip).
sprendimo versija	Klonuojamo sprendimo versija.
paskirties aplankalas	Paskirties aplankalas, kuriame reikia įdėti išskleistą sprendimą. (pvz., Git saugyklos\target-solution-folder).
Darbinis katalogas	Darbo, kurio metu vyksta artefaktų, kurių reikia norint klonuoti sprendimą, laikinas aplankas. numatytasis: root of the repository

patikrinti sprendimą

Patikrina sprendimo failą, kad būtų aptikti neatitikimai.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL aplinkai, iš kurios norite klonuoti sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
kelias	(Būtina) Sprendimo failo, kurį norite patikrinti, kelias ir pavadinimas.
geografinė sritis	Kurią „Microsoft Power Platform“ geografinės vietos Tikrintuvo paslaugą naudoti. Numatytoji reikšmė yra "JAV".
nuspręsti-sulygiuoti-perrašyti	Kelias į failą, kuriame yra taisyklių ir jų lygių JSON masyvas. Priimtinos reikšmės: Kritinė, Aukšta, Žema ir Informacinė. Pavyzdys: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"ID":"iv-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
tikrintojas-registravimas-artefaktas-pavadinimas	Artefaktų aplanko, į kurį bus įkelti Microsoft Power Platform tikrintojo žurnalai, pavadinimas. Numatytoji reikšmė yra 'CheckSolutionLogs'.

naujinimas-sprendimas

Atnaujina sprendimą.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL aplinkai, iš kurios norite klonuoti sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
sprendimo-failas	(Būtina) Sprendimo failo, kurį norite importuoti, kelias ir pavadinimas.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
sprendimo-pavadinimas	(Būtina) Atnaujinamo sprendimo pavadinimas.
asinchroninis	Asinchroniškai naujinamas sprendimas.
maksimalus-async-laukimo laikas	Maksimali asinchroninio laukimo trukmė minutėmis. Numatytoji vertė yra 60 minučių.

Paketų užduotys

Šios užduotys atlieka veiksmus su paketais.

išskleidžia paketą

Įdiegia paketo DLL arba ZIP failą su paketu.

Pastaba.

Šis veiksmas palaikomas tik Windows.

Parametras	Aprašo
aplinkos-url	(Būtinas) URL aplinkai, iš kurios norite klonuoti sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
vartotojo-vardas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros vartotojo vardas, kurį naudojate prisijungti.
slaptažodis-slaptasis raktas	(Būtinas) Jei naudojate prisijungimo vardo ar slaptažodžio autentifikavimą, paskyros slaptažodis, kurį naudojate prisijungti.
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
paketas	(Būtina) Kelias į paketo DLL arba ZIP failą su paketu.

Portalo užduotys

Šios užduotys atlieka toliau nurodytus veiksmus, atsižvelgiant į „Power Pages“.

įkėlimoportas

Nusiunčia duomenis į „Power Pages“ portalus.

Parametras	Aprašo
aplinkos-url	(Būtinas) Aplinkos URL, į kurią norite importuoti sprendimą (pavyzdžiui, https://YourOrg.crm.dynamics.com).
app-id	Programos ID, skirtas autentifikuoti su. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
kliento slaptasis raktas	Kliento slapta informacija, naudojama "GitHub" srautui autentifikuoti. Šis parametras būtinas kai autentifikuojama su Pagrindiniais tarnybos kredencialais.
nuomotojo ID	Nuomotojo ID, kai patvirtinate su app-id ir client-secret.
įkėlimo kelias	Kelias, kur bus laikomas svetainės turinys (alias: -p).
Visuotinio diegimo profilis	Įkelkite portalo duomenis su aplinkos informacija, nustatyta per, profilio kintamuosius talpinimo profiliuose / [profilio-pavadinimas].talpinimas.yaml faile.
Modelio versija	Nurodo, ar nusiunčiami svetainės duomenys naudoja standartinį (1) ar patobulintą duomenų modelį (2). Numatytoji reikšmė yra 1.

Sužinokite daugiau apie Microsoft Power Platform CLI palaikymą Power Pages.

Katalogo užduotys (peržiūros versija)

Šios užduotys atlieka veiksmus su katalogu "Power Platform".

Pastaba.

Šiuo metu "Power Platform" katalogo užduotys yra peržiūrimos.

įdiegti

Įdiekite katalogo elementą tikslinėje aplinkoje.

Parametras	Aprašo
Katalogo-elemento-ID	(Būtina) Katalogo elementas, kurį reikia įdiegti paskirties aplinkoje.
taikyti URL	(Būtina) Katalogo elemento diegimo tikslinės aplinkos URL (pvz., https://YourOrg.crm.dynamics.com).
parametrai	(Būtina) vykdymo paketas diegimo sistemos nustatymus, kuriuos reikia vykdyti. Eilutės formatas turi būti key=value|key=value.
Tikslinė versija	Tikslinė versija, kurią reikia įdiegti. Jei nenurodysite versijos, bus pasirinkta publikuota versija.
Apklausos būsena	Apklausa, kad patikrintumėte užklausos būseną.

pateikti

Išvardykite visus publikuotus katalogo elementus iš dabartinės Dataverse aplinkos (organizacijos).

Parametras	Aprašo
kelias	(Būtina) Kelias į katalogo pateikimo dokumentą.
Pakuotės užtrauktukas	Kelias į suglaudintą paketo failą.
sprendimas-zip	Kelias į suglaudintą sprendimo failą.
Apklausos būsena	Apklausa, kad patikrintumėte užklausos būseną.

būsena

Gaukite katalogo diegimo arba pateikimo užklausos būseną.

Parametras	Aprašo
Sekimo ID	(Privaloma) Pateikite užklausos sekimo ID.
tipas	(Būtina) Užklausos tipas. Galiojančios reikšmės yraInstall ir Submit

"GitHub" darbo eigos autorius

Norėdami sužinoti daugiau apie GitHub darbo eigų rašymą naudojant GitHub Actions, užbaikite Microsoft Power Platform laboratorijų GitHub Actions.

Daugiau informacijos žr. Apie GitHub Actions.

Taip pat žr.

"GitHub" veiksmai, skirti Microsoft Power Platform