Razpoložljiva dejanja GitHub Actions za razvoj storitve Microsoft Power Platform
Dejanja GitHub Actions za Microsoft Power Platform so opisana v naslednjih razdelkih. Poleg tega so prikazani tudi vzorčni poteki dela GitHub. Za več informacij o dejanjih GitHub in kako jih prenesti, pojdite na Dejanja GitHub za Microsoft Power Platform.
Konfigurirajte poverilnice za uporabo z dejanji GitHub Actions s storitvijo Microsoft Power Platform
Številna dejanja zahtevajo vzpostavljeno povezavo z okoljem Microsoft Dataverse. Glavno ime storitve ali uporabniške poverilnice lahko dodate kot skrivnosti v svojo shrambo GitHub in jih nato uporabite v svojih potekih dela.
Za podrobnosti o nastavitvi skrivnosti v storitvi GitHub glejte razdelek Šifrirane skrivnosti
Za podrobnosti o nastavitvi preverjanja pristnosti glavnega imena storitve za Microsoft Power Platform glejte DevOps Build Tools
Ko je konfiguriran, lahko pokličete glavno ime storitve znotraj skriptov dejanj.
Parametri, ki jih v skriptih GitHub Action definirate kot spremenljivke okolja:
- ID aplikacije, npr.
WF_APPLICATION_ID:<your application id> - ID najemnika, npr.
WF_TENANT_ID:<your tenant id>
Odjemalsko skrivnost je treba dodati in shraniti kot skrivnost GitHub, nanjo pa se bo sklicevalo znotraj poteka dela s pomočjo parametra, kot je: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Opravila pomočnika
Razpoložljiva pomožna naloga je opisana spodaj.
dejanja-namestitev
Ko potek dela GitHub Actions prisili namestitev Power Platform CLI v kontekstu izvajalnika in pride do napake časovne omejitve, morate uporabiti različico 1 (@v1) z dodatnim dejanjem (actions-install) kot spodaj.
Pomembno
- Uporaba različice 1 (@v1) lahko vodi do posodobitev obstoječih dejanj GitHub, kar lahko povzroči posodobitev trenutnih delovnih tokov.
- Nalogo Namesti Power Platform Orodja morate dodati kot prvo nalogo v svojem delovnem toku pred vsemi drugimi dejanji GitHub za 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'
Dodatne vzorce dejanj GitHub najdete na Power Platform Dejanja.
whoAmI
Preveri povezavo storitve tako, da se vzpostavi povezavo s storitvijo in pošlje zahtevo WhoAmI [SDK/Web API]. To nalogo je lahko koristno vključiti zgodaj v potek dela GitHub, da preverite povezanost pred začetkom obdelave.
| Parameter | Opis |
|---|---|
| URL okolja | URL za okolje, v katerega se povezujete. |
| Uporabniško ime | Uporabniško ime kupca, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | Geslo za user-name. Gesla za GitHub so določena v razdelku Skrivnosti pod možnostjo Nastavitve. Po opredelitvi in shranjevanju skrivnosti ne morete več pridobiti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
Opravila rešitve
Ta opravila izvedejo dejanja glede na rešitve in vključujejo naslednje.
import-solution
Uvozi rešitev v ciljno okolje.
| Parameter | Opis |
|---|---|
| URL okolja | (Obvezno) URL za ciljno okolje, v katerega želite uvoziti rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| Datoteka rešitve | (obvezno) Pot in ime datoteke rešitve, ki jo želite uvoziti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
export-solution
Izvozi rešitev iz izvornega okolja.
| Parameter | Opis |
|---|---|
| URL okolja | (Obvezno) URL za okolje, iz katerega želite izvoziti rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo za user-name. Gesla za GitHub so določena v razdelku Skrivnosti pod možnostjo Nastavitve. Po opredelitvi in shranjevanju skrivnosti ne morete več pridobiti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| Ime rešitve | (Obvezno) Ime rešitve za izvoz. Vedno uporabite Ime rešitve in ne Prikazno ime. |
| Izhodna datoteka rešitve | (obvezno) Pot in ime datoteke za datoteko solution.zip, ki jo izvozite v izvorno okolje. |
| upravljano | (Obvezno) Nastavljeno na true za izvoz kot upravljana rešitev; privzeto (false) je izvoz kot neupravljana rešitev. |
unpack-solution
Datoteko s stisnjeno rešitvijo vzame in jo razstavi na več datotek XML, da lahko sistem za upravljanje izvorne kode lažje bere te datoteke in jih upravlja.
| Parameter | Opis |
|---|---|
| Datoteka rešitve | (Obvezno) Pot in ime datoteke za datoteko solution.zip za razpakiranje. |
| Mapa z rešitvijo | (Obvezno) Pot in ciljna mapa, v katero želite razpakirati rešitev. |
| Vrsta rešitve | (Obvezno) Vrsta rešitve, ki jo želite razpakirati. Možnosti vključujejo Neupravljano (priporočljivo), Upravljano in Oboje. |
pack-solution
Zapakira rešitev, ki je prikazana v upravljanju izvorne kode, v datoteko solution.zip, ki jo je mogoče uvoziti v drugo okolje.
| Parameter | Opis |
|---|---|
| Datoteka rešitve | (Obvezno) Pot in ime datoteke za datoteko solution.zip, v katero se zapakira rešitev (na primer, out/CI/ALMLab.zip). |
| Mapa z rešitvijo | (Obvezno) Pot in izvorna mapa rešitve za pakiranje. |
| Vrsta rešitve | (Izbirno) Vrsta rešitve, ki se zapakira. Možnosti vključujejo Neupravljano (priporočljivo), Upravljano in Oboje. |
publish-solution
Objavlja prilagoditve rešitve.
| Parameter | Opis |
|---|---|
| URL okolja | (obvezno) URL za okolje, v katerega želite objaviti rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| Datoteka rešitve | (obvezno) Pot in ime datoteke rešitve, ki jo želite uvoziti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
clone-solution
Klonira rešitev za dano okolje.
| Parameter | Opis |
|---|---|
| URL okolja | (Obvezno) URL za okolje, iz katerega želite klonirati rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| Datoteka rešitve | (obvezno) Pot in ime datoteke rešitve, ki jo želite uvoziti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| Ime rešitve | (Obvezno) Pot in ime datoteke solution.zip, ki je potrebna za kloniranje (na primer out/CI/ALMLab.zip). |
| solution-version | Različica rešitve za kloniranje. |
| target-folder | Ciljna mapa, v katero želite umestiti izvlečeno raztopino. (na primer shrambo GIT repository\target-solution-folder). |
| Working-directory | Začasna mapa za nedokončane artefakte, potrebne za kloniranje rešitve. privzeto: root of the repository |
check-solution
Preveri datoteko rešitve, da zazna neskladja.
| Parameter | Opis |
|---|---|
| URL okolja | (Obvezno) URL za okolje, iz katerega želite klonirati rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| path | (obvezno) Pot in ime datoteke rešitve, ki jo želite preveriti. |
| geo | Katera geografska lokacija storitve pregledovalnika za Microsoft Power Platform naj bo uporabljen. Privzeta vrednost je 'united states'. |
| rule-level-override | Pot do datoteke, ki vsebuje vrsto pravil JSON in njihove ravni. Sprejete vrednosti so: kritično, visoko, nizko in informativno. Primer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Ime mape z artefakti, za katero bodo naloženi dnevnik pregledovalnika Microsoft Power Platform. Privzeta vrednost je 'CheckSolutionLogs'. |
upgrade-solution
Omogoča nadgradnjo rešitve.
| Parameter | Opis |
|---|---|
| URL okolja | (Obvezno) URL za okolje, iz katerega želite klonirati rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| Datoteka rešitve | (obvezno) Pot in ime datoteke rešitve, ki jo želite uvoziti. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| Ime rešitve | (obvezno) Ime rešitve za nadgradnjo. |
| async | Asinhrono nadgradi rešitev. |
| max-async-wait-time | Najdaljši asinhroni čakalni čas v minutah. Privzeta vrednost je 60 minut. |
Opravila glede paketov
Ta opravila izvajajo dejanja glede paketov in vključujejo naslednje.
deploy-package
Ponuja možnost uvedbe paketa dll ali datoteke zip s paketom.
opomba,
To dejanje je podprto samo v sistemu Windows.
| Parameter | Description |
|---|---|
| URL okolja | (Obvezno) URL za okolje, iz katerega želite klonirati rešitev (na primer, https://YourOrg.crm.dynamics.com). |
| Uporabniško ime | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, uporabniško ime, ki ga uporabljate za povezavo. |
| Geslo – skrivnost | (Obvezno) Če uporabljate preverjanje pristnosti uporabniškega imena/gesla, geslo, ki ga uporabljate za povezavo. |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| package | (obvezno) Pot do datoteke dll ali zip s paketom. |
Opravila portala
Opravila na platformi Power Pages izvajajo naslednja dejanja.
upload-paportal
Podatke naloži na platformo Power Pages.
| Parameter | Description |
|---|---|
| URL okolja | (obvezno) URL za okolje, v katerega želite uvoziti rešitev (na primer https://YourOrg.crm.dynamics.com). |
| app-id | ID aplikacije za preverjanje pristnosti. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| client-secret | Skrivnost odjemalca, ki se uporablja za overjanje prodajnega lijaka GitHub. Ta parameter je zahtevan pri preverjanju pristnosti s poverilnicami glavnega imena storitve. |
| tenant-id | ID najemnika pri preverjanju pristnosti z app-id in client-secret. |
| upload-path | Pot, kamor bo shranjena vsebina spletnega mesta (vzdevek: -p). |
| deployment-profile | Podatke portala naložite s podrobnostmi o okolju, ki jih določajo spremenljivke profila v datoteki profili-uvajanja/[ime-profila].deployment.yaml. |
| model-različica | Označuje, ali bodo podatki mesta, ki bodo naloženi, uporabljali standardni (1) ali izboljšan podatkovni model (2). Privzeta vrednost je '1'. |
Več o Microsoft Power Platform podpori za CLI za Power Pages.
Naloge kataloga (predogled)
Te naloge izvajajo dejanja proti katalogu v Power Platform in vključujejo naslednje.
opomba,
Trenutno so naloge kataloga za Power Platform predogled izdaja.
Namesti
Namestite element kataloga v ciljno okolje.
| Parameter | Description |
|---|---|
| kataloški-item-id | (Obvezno) Element kataloga, ki bo nameščen v ciljnem okolju. |
| target-url | (Obvezno) Url ciljnega okolja za namestitev elementa kataloga v (na primer, "https://YourOrg.crm.dynamics.com"). |
| nastavitve | (Obvezno) Nastavitve paketa izvajalnega okolja za izvedbo namestitvenega ogrodja. Format niza mora biti key=value|key=value. |
| Ciljna različica | Ciljna različica za namestitev. Če je polje prazno, je izbrana objavljena različica. |
| Stanje ankete | Anketa za preverjanje statusa vaše zahteve. |
pošlji
Navedite vse objavljene kataloške postavke iz trenutnega Dataverse okolja (organizacije).
| Parameter | Description |
|---|---|
| path | (Obvezno) Pot do dokumenta za predložitev kataloga. |
| paket-zip | Pot do datoteke zip paketa |
| rešitev-zip | Pot do datoteke zip rešitve. |
| Stanje ankete | Anketa za preverjanje statusa vaše zahteve. |
stanje
Pridobite stanje zahteve za namestitev/oddajo kataloga.
| Parameter | Description |
|---|---|
| tracking-id | (Obvezno) ID za sledenje zahteve. |
| vrsta | (Obvezno) Vrsta zahteve (vrednosti: namestitev, oddaja) |
Avtorstvo poteka dela GitHub
Če želite izvedeti več o ustvarjanju potekov dela GitHub z uporabo dejanj GitHub, opravite dejanja GitHub za Microsoft Power Platform.
Več informacij: O dejanjih GitHub
Glejte tudi
Povratne informacije
Kmalu na voljo: V letu 2024 bomo ukinili storitev Težave v storitvi GitHub kot mehanizem za povratne informacije za vsebino in jo zamenjali z novim sistemom za povratne informacije. Za več informacij si oglejte: https://aka.ms/ContentUserFeedback.
Pošlji in prikaži povratne informacije za