Dostupne GitHub radnje za razvoj platforme Microsoft Power Platform

U sljedećim je odjeljcima GitHub Actions za Microsoft Power Platform. U odjeljcima se prikazuju i ogledni GitHub tijekovi rada. Dodatne informacije o GitHub Actions kako ih preuzeti potražite u odjeljku GitHub Actions za Microsoft Power Platform.

Konfiguriranje vjerodajnica za upotrebu s GitHub radnjama s Microsoft Power Platform

Mnogo radnji zahtijeva povezivanje s okruženjem Microsoft Dataverse. Dodajte upravitelja servisa ili korisničke vjerodajnice kao tajne u spremište GitHub a zatim ih koristite u tijekovima rada.

Kada konfigurirate vjerodajnice, možete pozvati upravitelja servisa iz akcijskih skripti.

Definirajte sljedeće parametre u skripti GitHub kao varijable okruženja:

  • ID aplikacije, kao što su: WF_APPLICATION_ID:<your application id>
  • ID klijenta, kao što su: WF_TENANT_ID:<your tenant id>

Dodajte tajnu klijenta kao GitHub tajnu. Referencira ga iz tijeka rada pomoću parametra kao što je: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Zadaci pomagača

Dostupan je sljedeći zadatak pomoći.

akcije-instalacija

Kada tijek rada sustava GitHub Actions prisiljava instalaciju dodatka Power Platform CLI u kontekstu izvođenja i dođe do pogreške isteka vremena, upotrijebite verziju 1 (@v1) s dodatnom akciji () kaoactions-install što je prikazano u sljedećem primjeru.

Važno

  • Korištenje verzije 1 (@v1) može dovesti do ažuriranja postojećih GitHub akcija koje mogu rezultirati ažuriranjem trenutnih tijekova rada.
  • Dodajte zadatak Instaliraj alate dodatka Power Platform kao prvi zadatak u tijeku rada prije drugih GitHub Actions 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'

Više uzoraka uzoraka možete pronaći GitHub Actions na web-mjestu Akcije platforme Power Platform.

whoAmI

Provjerava vezu usluge povezivanjem na uslugu i slanjem zahtjeva WhoAmI [SDK/Web API]. Ovaj zadatak može biti koristan za uključivanje ranog u tijek rada GitHub biste potvrdili vezu prije početka obrade.

Parametar Opis
url-okruženja URL za okruženje na koje se povezujete.
korisničko-ime Korisničko ime računa s kojim se povezujete.
tajna-lozinke Lozinka za korisničko-ime. Definirajte GitHub u Postavkama u odjeljkuTajne. Ne možete dohvatiti tajnu nakon što je definirate i spremite.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.

Zadaci rješenja

Ti zadaci izvode radnje u odnosu na rješenja i uključuju sljedeće.

import-solution

Uvozi rješenje u ciljno okruženje.

Parametar Opis
url-okruženja (Obavezno) URL za ciljno okruženje u koje želite uvesti rješenje (na primjer, https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
datoteka-rješenja (Obavezno) Putanja i naziv datoteke rješenja koje želite uvesti.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.

export-solution

Izvozi rješenje iz izvornog okruženja.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje iz kojeg želite izvesti rješenje (na primjer, https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za korisničko-ime. Definirajte GitHub u Postavkama u odjeljkuTajne. Ne možete dohvatiti tajnu nakon što je definirate i spremite.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
naziv-rješenja (Obvezno) Naziv rješenja koje treba izvesti. Uvijek koristite naziv rješenja, a ne njegov zaslonski naziv.
datoteka-izlaza-rješenja (Obvezno) Putanja i naziv datoteke rješenje.zip u koju treba izvesti u ciljno okruženje.
upravljano (Obavezno) Postavite na true da biste izvezli kao upravljano rješenje; zadano (false) služi za izvoz kao neupravljano rješenje.

unpack-solution

Uzima komprimiranu datoteku rješenja i dekomponira je u više XML datoteka. Te datoteke lakše ćete čitati i upravljati njima u izvorišnom sustavu kontrole.

Parametar Opis
datoteka-rješenja (Obvezno) Navedite putanju i ime datoteke rješenje.zip koje treba raspakirati.
mapa-rješenja (Obavezno) Put i ciljna mapa u koju želite raspakirati rješenje.
vrsta-rješenja (Obvezno) Vrsta rješenja koje želite raspakirati. Mogućnosti uključuju Neupravljano (preporučeno), Upravljano i Oboje.

pack-solution

Paket rješenja predstavljenog u izvornoj kontroli u solution.zip koju možete uvesti u drugo okruženje.

Parametar Opis
datoteka-rješenja (Obavezno) Put i naziv datoteke datoteke solution.zip u koju će se rješenje pakirati (na primjer, out/CI/ALMLab.zip).
mapa-rješenja (Obvezno) Putanja i izvorna mapa rješenja koje treba zapakirati.
vrsta-rješenja (Neobavezno) Vrsta rješenja za pakiranje. Mogućnosti uključuju Neupravljano (preporučeno), Upravljano i Oboje.

publish-solution

Objavljuje prilagodbe rješenja.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje na koje želite objaviti rješenje (na primjer https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
datoteka-rješenja (Obavezno) Putanja i naziv datoteke rješenja koje želite uvesti.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.

clone-solution

Klonira rješenje za dano okruženje.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje iz kojeg želite klonirati rješenje (na primjer https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
datoteka-rješenja (Obavezno) Putanja i naziv datoteke rješenja koje želite uvesti.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
naziv-rješenja (Obavezno) Putanja i naziv datoteke solution.zip potrebne za kloniranje (na primjer, out/CI/ALMLab.zip).
solution-version Verzija rješenja za kloniranje.
target-folder Ciljna mapa u koju se smješta izdvojeno rješenje. (na primjer Git repository\target-solution-folder).
Working-directory Privremena mapa za artefakte na kojima se radi, a koji su potrebni za kloniranje rješenja.
zadano: root of the repository

check-solution

Provjerava datoteku rješenja kako bi otkrila nedosljednosti.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje iz kojeg želite klonirati rješenje (na primjer https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
put (Obavezno) Putanja i naziv datoteke rješenja koje želite provjeriti.
geo Koju zemljopisnu lokaciju usluge Microsoft Power Platform Checker treba upotrijebiti. Zadana vrijednost je 'united states'.
rule-level-override Putanja do datoteke koja sadrži JSON niz pravila i njihove razine. Prihvaćene vrijednosti su: Critical, High, Low i Informational. Primjer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name Naziv mape artefakata za koju će se prenijeti Microsoft Power Platform zapisnici provjera. Zadana je vrijednost 'CheckSolutionLogs'.

upgrade-solution

Nadograđuje rješenje.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje iz kojeg želite klonirati rješenje (na primjer https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
datoteka-rješenja (Obavezno) Putanja i naziv datoteke rješenja koje želite uvesti.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
naziv-rješenja (Obvezno) Naziv rješenja za nadogradnju.
asinkron Asinkrono nadograđuje rješenje.
max-async-wait-time Maksimalno vrijeme asinkronog čekanja u minutama. Zadana vrijednost je 60 minuta.

Zadaci paketa

Ti zadaci izvode akcije u odnosu na pakete.

deploy-package

Implementira DLL paket ili ZIP datoteku s paketom.

Napomena

Ta je akcija podržana samo na Windows.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje iz kojeg želite klonirati rješenje (na primjer https://YourOrg.crm.dynamics.com).
korisničko-ime (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, korisničko ime računa s kojim se povezujete.
tajna-lozinke (Obavezno) Ako koristite provjeru autentičnosti korisničkog imena/lozinke, lozinka za račun s kojim se povezujete.
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
paket (Obavezno) Put do DLL ili ZIP datoteke paketa.

Zadaci portala

Ovi zadaci izvode sljedeće radnje na Power Pages portalima.

upload-paportal

Prenosi podatke na Power Pages.

Parametar Opis
url-okruženja (Obavezno) URL za okruženje u koje želite uvesti rješenje (na primjer https://YourOrg.crm.dynamics.com).
app-id ID aplikacije za provjeru autentičnosti. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
client-secret Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obvezan prilikom autentifikacije s vjerodajnicama upravitelja usluge.
tenant-id ID klijenta prilikom autentifikacije sa app-id i client-secret.
upload-path Put na kojem se sadržaj web-mjesta sprema (alias: -p).
deployment-profile Prenosi podatke profila s pojedinostima okruženja definiranima putem varijabli profila iz datoteke deployment-profiles/[profile-name].deployment.yaml.
model-verzija Označava koriste li podaci web-mjesta koji će se prenijeti standardni (1) ili poboljšani podatkovni model (2). Zadana vrijednost je 1.

Saznajte više o Microsoft Power Platform podršci za CLI za Power Pages.

Zadaci kataloga (pretpregled)

Ti zadaci izvode akcije u katalogu na platformi Power Platform.

Napomena

Zadaci kataloga za Power Platform trenutno su u pretpregledu.

instalirati

Instalirajte stavku za katalog u ciljno okruženje.

Parametar Opis
katalog-stavka-id (Obavezno) Stavka kataloga za instalaciju u ciljnom okruženju.
target-url (Obavezno) URL ciljnog okruženja za instalaciju stavke kataloga (na primjer, https://YourOrg.crm.dynamics.com).
postavke (Obavezno) Postavke paket za izvođenje za instalacijski okvir za izvršavanje. Format niza mora biti key=value|key=value.
Ciljana verzija Ciljna verzija za instalaciju. Ako ne navedete verziju, odabrana je objavljena verzija.
Status ankete Anketa za provjeru statusa vašeg zahtjeva.

pošalji

Navedite sve objavljene stavke kataloga iz trenutnog Dataverse okruženja (organizacije).

Parametar Opis
put (Obavezno) Put do dokumenta za slanje kataloga.
paket-zip Putanja do ZIP datoteke paketa.
rješenje-zip Putanja do zip datoteke s rješenjem.
Status ankete Anketa za provjeru statusa vašeg zahtjeva.

status

Dohvatite status zahtjeva za instalaciju ili slanje kataloga.

Parametar Opis
ID praćenja (Obavezno) Zatražite ID za praćenje.
vrsta (Obavezno) Vrsta zahtjeva. Valjane su vrijednosti Install i Submit.

Izrada GitHub tijekova rada

Da biste saznali više o sastavljanju GitHub tijekova rada pomoću GitHub Actions, dovršite GitHub Actions za Microsoft Power Platform laboratorije.

Dodatne informacije potražite u članku Informacije o GitHub Actions.

Pogledajte također

GitHub akcije za Microsoft Power Platform