Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
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.
Detalje o postavljanju tajni u aplikaciji GitHub članku Šifrirane tajne.
Pojedinosti o postavljanju provjere autentičnosti upravitelja servisa za provjeru autentičnosti za Microsoft Power Platform međuverzije devOps potražite u članku Alati za međuverzije DevOps.
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.