Galimi „GitHub“ veiksmai, skirti „Microsoft Power Platform“ plėtrai
"GitHub" veiksmai Microsoft Power Platformaprašyti toliau skyriuose. Be to, taip pat rodomi "GitHub" darbo eigų pavyzdžiai. Dėl daugiau informacijos apie „GitHub“ veiksmus ir kaip juos atsisiųsti, eikite į „GitHub“ veiksmai „Microsoft Power Platform“.
Sukonfigūruokite kredencialus, kad galėtumėte naudoti "GitHub" veiksmus su Microsoft Power Platform
Dauguma veiksmų reikalauja prisijungti prie „Microsoft Dataverse” aplinkos. Į savo "GitHub" saugyklą galite įtraukti pagrindinę tarnybą arba vartotojo kredencialus kaip slaptas teises ir naudoti jas savo darbo eigose.
Išsami informacija apie tai, kaip nustatyti slaptas informacijas "GitHub", žr. Užšifruota slapta informacija
Norėdami gauti daugiau informacijos, kaip nustatyti pagrindinį tarnybos Microsoft Power Platform autentifikavimą, žr. "DevOps" kūrimo įrankiai
Sukonfigūravus, galite iškviesti Pagrindinį Aptarnavimą iš savo veiksmų scenarijaus.
Parametrai, apibrėžiami jūsų "GitHub" veiksmų scenarijuje kaip Aplinkos kintamieji:
- Programos ID tokia kaip:
WF_APPLICATION_ID:<your application id> - Nuomotojo ID tokia kaip:
WF_TENANT_ID:<your tenant id>
Kliento Slaptą informaciją privaloma pridėti ir ji bus saugoma kaip "GitHub" slapta informacija, kaip aprašyta anksčiau ir bus nurodyta darbų eigoje naudojant parametrą, tokį kaip: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Padedančio užduotys
Galima pagalbos užduotis aprašyta toliau.
veiksmai-diegimas
Kai "GitHub Actions" darbo eiga priverčia įdiegti Power Platform CLI bėgiko kontekste ir įvyksta skirtojo laiko klaida, turite naudoti 1 versiją (@v1) su papildomu veiksmu (actions-install), kaip nurodyta toliau.
Svarbu
- Naudojant 1 versiją (@v1) gali būti atnaujinti esami "GitHub" veiksmai, dėl kurių gali būti atnaujintos dabartinės darbo eigos.
- Turite įtraukti užduotį Įdiegti Power Platform įrankius kaip pirmąją savo darbo eigos užduotį prieš atlikdami bet kokius kitus "GitHub" veiksmus 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'
Papildomų "GitHub" veiksmų pavyzdžių galite rasti skiltyje 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 norint anksčiau įtraukti į "GitHub" darbo eigą ir 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. „GitHub” slaptažodžiai yra nustatomi skyriuje Parametrai, esančiame dalyje Slaptieji raktai. Nustačius ir įrašius slaptą informaciją, jos atstatyti nepavyks. |
| 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. „GitHub” slaptažodžiai yra nustatomi skyriuje Parametrai, esančiame dalyje Slaptieji raktai. Nustačius ir įrašius slaptą informaciją, jos atstatyti nepavyks. |
| 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 išskaido jį į kelis XML ir kitus failus, kad juos galėtų lengviau skaityti ir valdyti šaltinio kontrolės sistema.
| Parametras | Aprašo |
|---|---|
| sprendimo-failas | (Privaloma) Išpakuojamo sprendimo.zip failo vardas ir kelias. |
| sprendimo-aplankas | (Privaloma) Galutinio aplanko, į kurį norite išpakuoti sprendimą, kelias ir pavadinimas. |
| sprendimo-tipas | (Privaloma) Norimo išpakuoti sprendimo pavadinimas. Parinktys apima Nesutvarkyta (rekomenduojama), Tvarkyta ir Abi. |
supakuoti sprendimą
Supakuoja sprendimą rodomą šaltinio valdiklyje į sprendimo.zip failą, kuris gali būti importuojamas į kitą aplinką.
| Parametras | Aprašo |
|---|---|
| sprendimo-failas | (Būtina) Kelias ir failo sprendimo.zip failo pavadinimas skirtas supakuoti sprendimą į (pavyzdžiui, 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šymas |
|---|---|
| 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šymas |
|---|---|
| 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šymas |
|---|---|
| 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. |
| path | (Būtina) Sprendimo failo, kurį norite patikrinti, kelias ir pavadinimas. |
| geograf. | 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
Suteikia galimybę atnaujinti sprendimą.
| Parametras | Aprašymas |
|---|---|
| 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. |
| async | 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 prieš paketus ir yra tokios:
išskleidžia paketą
Suteikia galimybę diegti paketą "dll" arba "zip" failą su paketu.
Pastaba.
Šis veiksmas palaikomas tik "Windows" sistemoje.
| Parametras | Aprašą |
|---|---|
| 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 į "dll" paketą 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šą |
|---|---|
| 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 svetainės duomenys, kuriuos reikia įkelti, naudos 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ūra)
Šios užduotys atlieka veiksmus su katalogu, esančiu kataloge Power Platform , ir apima toliau nurodytus dalykus.
Pastaba.
Šiuo metu katalogo Power Platform užduotys yra peržiūros leidimas.
Įdiegti
Įdiekite katalogo elementą tikslinėje aplinkoje.
| Parametras | Aprašą |
|---|---|
| Katalogo-elemento-ID | (Būtina) Katalogo elementas, kuris turi būti įdiegtas paskirties aplinkoje. |
| taikyti URL | (Būtina) Katalogo elemento diegimo į (pvz., "https://YourOrg.crm.dynamics.com"). |
| parametrai | (Būtina) Vykdymo laiko paketo nustatymai, skirti diegimo sistemai vykdyti. Eilutės formatas turi būti key=value|key=value. |
| Tikslinė versija | Tikslinė versija, kurią reikia įdiegti. Jei paliekama tuščia, pasirenkama 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šą |
|---|---|
| path | (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 / pateikimo užklausos būseną.
| Parametras | Aprašą |
|---|---|
| Sekimo ID | (Būtina) Prašyti sekimo ID. |
| tipas | (Būtina) Užklausos tipas (reikšmės: įdiegti, pateikti) |
"GitHub" darbo eigos autorius
Norėdami sužinoti daugiau apie "GitHub" darbo eigų composing naudojant "GitHub" veiksmus, atlikite "GitHub" veiksmus Microsoft Power Platform laboratorijai.
Daugiau informacijos: Apie „GitHub“ veiksmus