Microsoft Power Platform -i arenduse jaoks saadaolevad GitHubi Toimingud

GitHubi toiminguid Microsoft Power Platform on kirjeldatud järgmistes jaotistes. Lisaks kuvatakse ka GitHubi näidistöövood. Lisateavet GitHub Actions ja nende allalaadimise kohta leiate GitHub Actions for Microsoft Power Platform.

Konfigureerige GitHub`i toimingutega koos Microsoft Power Platform rakendusega kasutatavad mandaadid

Paljud toimingud nõuavad ühenduse loomist Microsoft Dataverse'i keskkonnaga. GitHub'i hoidlasse saate lisada teenuse subjekti- või kasutajamandaadid ja seejärel kasutada neid oma töövoogudes.

• Lisateavet GitHub`is saladuste häälestamise kohta leiate Krüptitud saladused

• Lisateavet teenuse subjekti autentimise häälestamise kohta leiate Microsoft Power Platform teemast DevOps Build tööriistad

Pärast konfigureerimist saate oma toiminguskriptide kaudu helistada teenindussubjektile.

Parameetrid, mida saate GitHub tegevusskriptis määratleda kui keskkonna muutujad:

• Rakenduse ID kui: WF_APPLICATION_ID:<your application id>
• Üürniku ID kui: WF_TENANT_ID:<your tenant id>

Kliendi saladus tuleb lisada ja salvestada GitHub saladusena ning sellele viidatakse töövoos, kasutades parameetreid nagu: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Abilise tööülesanded

Allpool on kirjeldatud saadaolevat spikrit.

toimingud-installimine

Kui GitHubi toimingute töövoog sunnib jooksja kontekstis CLI installima Power Platform ja ilmneb ajalõpu tõrge, peate kasutama versiooni 1 (@v1) koos täiendava toiminguga (actions-install), nagu allpool.

Oluline

• Versiooni 1 (@v1) kasutamine võib viia olemasolevate GitHubi toimingute värskendamiseni, mille tulemuseks võib olla praeguste töövoogude värskendamine.
• Peate lisama tööriistatööriistade Power Platform installimise ülesande töövoos esimese ülesandena enne mis tahes muid GitHubi toiminguid 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'

GitHubi toimingute täiendavad näidised leiate jaotisest Power Platform Toimingud.

whoAmI

Kontrollib teenuseühendust, luues teenusega ühenduse ja saates WhoAmI [SDK/veebi API] taotluse. See ülesanne võib kasulik olla GitHub töövoogu varakult kaasamiseks, et kontrollida ühenduvust enne töötlemise algust.

Parameeter	Kirjeldus
keskkonna URL	Selle keskkonna URL, millega ühenduse loote.
kasutajanimi	Konto kasutajanimi, millega soovite ühenduse luua.
salajane parool	Kasutaja user-name parool. GitHubi paroolid määratletakse jaotise Saladusedsätetes. Saladust ei saa pärast selle määratlemist ja salvestamist taastada.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.

Lahenduse ülesanded

Need toimingud sooritavad lahendusi lahenduste vastu ja sisaldavad järgmist.

Impordi-lahendus

Impordib lahenduse sihtkeskkonda.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL lõpp-punkt, kuhu soovite lahendust importida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
lahenduse fail	(Nõutav) Selle lahendusefaili tee ja nimi, mida soovite importida.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.

ekspordi-lahendus

Ekspordib lahenduse lähtekeskkonnast.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL lõpp-punkt, kust soovite lahendust eksportida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutajanime parool. GitHubi paroolid määratletakse jaotise Saladusedsätetes. Saladust ei saa pärast selle määratlemist ja salvestamist taastada.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
lahenduse nimi	(Nõutav) Eksporditava lahenduse nimi. Kasutage alati lahenduse nime, mitte selle kuvatavat nime.
lahenduse väljundfail	(Nõutav) Faili solution.zip tee ja failinimi, kuhu sihtkeskkond tuleb eksportida.
hallatud	(Nõutav) Hallatava lahenduse eksportimiseks määrake väärtuseks true. Vaikelahendus (false) tuleb eksportida mittehallatava lahendusena.

lahtipakkima-lahendust

Viib tihendatud lahenduse faili ja pöörab need tagasi mitmesse XML-vormingusse, et neid faile saaks lähtekeskkonna juhtimissüsteemi kaudu hõlpsamalt lugeda ja hallata.

Parameeter	Kirjeldus
lahenduse fail	(Nõutav) Lahtipakitava faili solution.zip tee ja failinimi.
lahenduse kaust	(Nõutav) Tee ja sihtkaust, kuhu soovite lahenduse lahti pakkida.
lahenduse tüüp	(Nõutav) Lahtipakitava lahenduse tüüp. Suvandite hulka kuuluvad: Mittehallatav (soovitatav), Hallatavja Mõlemad.

pakitud-lahendus

Lähtekeskkonna juhtimises esitatud lahendus pakitakse faili solution.zip, mida saab importida teise keskkonda.

Parameeter	Kirjeldus
lahenduse fail	(Nõutav) Lahenduse tee ja solution.zip faili lahenduse pakkimiseks (nt out/CI/ALMLab.zip).
lahenduse kaust	(Nõutav) Pakitava lahenduse tee ja lähtekaust.
lahenduse tüüp	(Valikuline) Lahenduse tüüp, mida soovite pakkida. Suvandite hulka kuuluvad: Mittehallatav (soovitatav), Hallatavja Mõlemad.

avaldatud-lahendus

Avaldab lahenduse kohandused.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Selle keskkonna URL, kus te soovite lahenduse avaldada (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
lahenduse fail	(Nõutav) Selle lahendusefaili tee ja nimi, mida soovite importida.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.

kloon-lahendus

Kloonib lahenduse antud keskkonda.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL keskkonna jaoks kust soovite lahendust kloonida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
lahenduse fail	(Nõutav) Selle lahendusefaili tee ja nimi, mida soovite importida.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
lahenduse nimi	(Nõutav) Kopeerimiseks vajaliku faili solution.zip tee ja nimi (nt out/CI/ALMLab.zip).
lahenduse-versioon	Kloonimise lahenduse versioon.
siht-kaust	Sihtkaust, kuhu ekstraktitud lahendus paigutatakse. (näiteks Git'i hoidla\target-lahenduse-kaust).
Töö-kataloog	Ajutine kaust pooleli töö artefaktide jaoks, mis on vajalikud lahenduse puhastamiseks. vaikesäte: root of the repository

lahenduse-kontrollija

Kontrollib lahendusefaili, et tuvastada vastuolusid.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL keskkonna jaoks kust soovite lahendust kloonida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
tee	(Nõutav) Selle lahendusefaili tee ja nimi, mida soovite kontrollida.
geotsoon	Millist Microsoft Power Platform`i kontrollteenuse geograafilist asukohta kasutada. Vaikeväärtus on "USA".
reegli-taseme-alistamine	Faili tee, mis sisaldab JSON`i reeglite ja nende tasemete massiivi. Aktsepteeritud väärtused on: kriitilised, kõrged, madal ja teabelised. Näide: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
kontoll-logid-artefakti-nimi	Artefakti kausta nimi, mille kohta Microsoft Power Platform logid üles laaditakse. Vaikeväärtus on 'CheckSolutionLogs'.

värskendatud-lahendus

Pakub võimalust lahendust täiendada.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL keskkonna jaoks kust soovite lahendust kloonida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
lahenduse fail	(Nõutav) Selle lahendusefaili tee ja nimi, mida soovite importida.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
lahenduse nimi	(Nõutav) Täiendamiseks pakutava lahenduse nimi.
asünkroonne	Täiendab lahendust asünkroonselt.
max-asünkroonimise-oote-aeg	Asünkroonse ooteaja ülemaeg minutites. Vaikeväärtus on 60 minutit.

Pakettülesanded

Need toimingud sooritavad toiminguid pakettide suhtes ja sisaldavad järgmist.

juurutus-pakett

Annab võimaluse juurutada paketti dll või Zip faili paketiga.

Märkus.

Seda toimingut toetatakse ainult Windows`is.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Sihtkeskkonna URL keskkonna jaoks kust soovite lahendust kloonida (näiteks https://YourOrg.crm.dynamics.com).
kasutajanimi	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte kasutajanimi.
salajane parool	(Nõutav) Kui kasutate kasutajanime/parooli autentimist, siis kasutatava ettevõtte parool.
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
pakett	(Nõutav) Paketi dll või zip faili tee koos paketiga.

Portaali tööülesanded

Need toimingud sooritavad Power Pages suhtes järgmisi toiminguid.

üleslaadimisportaal

Laadib andmed Power Pagesi.

Parameeter	Kirjeldus
keskkonna URL	(Nõutav) Selle keskkonna URL, kus te soovite lahenduse importida (näiteks https://YourOrg.crm.dynamics.com).
app-id	Rakenduse ID, millega autentida. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
kliendi-saladus	Kliendi saladus, mida kasutati GitHub'i konveieri autentimiseks. See parameeter on nõutav teenuse subjekti mandaadiga autentimisel.
rentniku-id	Rentniku ID, autentides rakendusega app-id ja client-secret.
üleslaadimise tee	Veebisaidi sisu hoiustamise tee (alias: -p).
juurutusprofiil	Laadige portaali andmed üles keskkonnaandmetega, mis on määratletud profiili muutujad kaudu juurutusprofiilide/[profiili-nime].depoyment.yaml fail.
Mudeli versioon	Näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). Vaikeväärtus on "1".

Lisateave CLI toe Microsoft Power Platform kohta Power Pages.

Kataloogi ülesanded (eelversioon)

Need ülesanded teevad toiminguid kataloogi Power Platform vastu ja sisaldavad järgmist.

Märkus.

Praegu on kataloogiülesanded Power Platform a eelversioon release.

installima

Saate kataloogi üksuse installida sihtkeskkonda.

Parameeter	Kirjeldus
Kataloog-üksus-id	(Nõutav) Sihtkeskkonda installitav kataloogiüksus.
siht-url	(Nõutav) Kataloogiüksuse installimise sihtkeskkonna URL (nt "https://YourOrg.crm.dynamics.com").
sätted	(Nõutav) käitusaja pakett installiraamistiku käivitamise sätted. Stringi vorming peab olema key=value|key=value.
sihtversioon	Installitav sihtversioon. Kui see jääb tühjaks, valitakse avaldatud versioon.
Küsitluse staatus	Küsitlus teie taotluse oleku kontrollimiseks.

esita

Loetlege kõik praegusest keskkonnast (organisatsioonist) avaldatud kataloogiüksused Dataverse .

Parameeter	Kirjeldus
tee	(Nõutav) Tee kataloogi esitamise dokumendini.
pakend-zip	Tee paketi ZIP-failini.
lahendus-zip	Tee lahenduse ZIP-failini.
Küsitluse staatus	Küsitlus, et kontrollida oma taotluse olekut.

olek

Kataloogi installimise/esitamise taotluse oleku toomine.

Parameeter	Kirjeldus
Jälgimise ID	(Nõutav) Taotlege jälgimis-ID-d.
tüüp	(Nõutav) Päringu tüüp (väärtused: installimine, esitamine)

GitHub töövoo loomine

Lisateavet GitHub töövoogude koostamise kohta GitHub toimingute abil, viige lõpule GitHub toimingud rakenduse jaoks Microsoft Power Platform laborid.

Lisateave: GitHub Actions kohta

Vt ka

GitHubi toimingud Microsoft Power Platform