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.
GitHub akcije za Microsoft Power Platform opisane su u sljedećim odjeljcima. Osim toga, prikazani su i primjeri GitHub tijekova rada. Za dodatne informacije o GitHub radnjama i kako ih preuzeti idite na GitHub radnje za Microsoft Power Platform.
Konfiguriranje vjerodajnica za upotrebu s GitHub radnjama s Microsoft Power Platform
Mnogo radnji zahtijeva povezivanje s okruženjem Microsoft Dataverse. Možete dodati vjerodajnice upravitelja usluge ili korisnika kao tajne u svoje GitHub spremište, a zatim ih koristiti u svojim tijekovima rada.
Za pojedinosti o postavljanju tajni u GitHubu pogledajte Šifrirane tajne
Za pojedinosti o tome kako postaviti provjeru autentičnosti upravitelja za Microsoft Power Platform, vidite DevOps Build alati
Kad su konfigurirani, možete pozvati upravitelja usluge iz svojih skripti radnje.
Parametri koje treba definirati u GitHub skripti radnje kao varijable okruženja:
- Unesite ID aplikacije kao što je:
WF_APPLICATION_ID:<your application id> - ID klijenta kao što je:
WF_TENANT_ID:<your tenant id>
Klijentska tajna mora se dodati i pohraniti kao GitHub tajna, kao što je ranije opisano i na nju će se upućivati iz radnog tijeka pomoću parametra poput: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Zadaci pomagača
Dostupni zadatak pomoćnika opisan je u nastavku.
akcije-instalacija
Kada tijek rada GitHub Actions prisiljava instalaciju Power Platform CLI-ja u kontekstu pokretača i dođe do pogreške isteka vremenskog ograničenja, morate koristiti verziju 1 (@v1) s dodatnom akcijom (actions-install) kao u nastavku.
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.
- Morate dodati zadatak Instalacija Power Platform alata kao prvi zadatak u tijeku rada prije bilo koje druge GitHub akcije 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 primjere GitHub akcija možete pronaći na stranici Power Platform Akcije.
whoAmI
Provjerava vezu usluge povezivanjem na uslugu i slanjem zahtjeva WhoAmI [SDK/Web API]. Ovaj zadatak može biti koristan za rano uključivanje u vaš GitHub tijek rada, kako biste provjerili povezanost 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. Lozinke GitHub definirane su u Postavke pod Tajne. Ne možete dohvatiti tajnu nakon što je definirana i spremljena. |
| 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. Lozinke GitHub definirane su u Postavke pod Tajne. Ne možete dohvatiti tajnu nakon što je definirana i spremljena. |
| 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 rastavlja je u više datoteka XML tako da sustav kontrole izvora može jednostavnije čitati i upravljati tim datotekama.
| Parametar | Opis |
|---|---|
| datoteka-rješenja | (Obvezno) Navedite putanju i ime datoteke rješenje.zip koje treba raspakirati. |
| mapa-rješenja | (Obvezno) Putanja i ciljana 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
Pakira rješenje predstavljeno u kontroli izvora u datoteku rješenje.zip koja se može uvesti u drugo okruženje.
| Parametar | Opis |
|---|---|
| datoteka-rješenja | (Obavezno) Putanja i naziv datoteke solution.zip u koju se pakira rješenje (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
Pruža mogućnost nadogradnje rješenja.
| 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
Ovi zadaci izvode radnje na paketima i uključuju sljedeće.
deploy-package
Pruža mogućnost uvođenja dll-a paketa ili zip datoteke s paketom.
Napomena
Ova je radnja podržana samo u sustavu 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 | (Obvezna) Putanja do dll-a paketa ili zip datoteke s paketom. |
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 hoće li podaci web-lokacije koji se prenose upotrebljavati 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)
Ovi zadaci izvode radnje u odnosu na katalog i Power Platform uključuju sljedeće.
Napomena
Trenutno su Power Platform zadaci kataloga za pretpregled .
instalirati
Instalirajte stavku za katalog u ciljno okruženje.
| Parametar | Opis |
|---|---|
| katalog-stavka-id | (Obavezno) Stavka kataloga koja će se instalirati u ciljnom okruženju. |
| target-url | (Obavezno) URL ciljnog okruženja za instalaciju stavke kataloga u (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 ostane prazna, odabire se 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 stanje zahtjeva za instalaciju/slanje kataloga.
| Parametar | Opis |
|---|---|
| ID praćenja | (Obavezno) Zatražite ID za praćenje. |
| vrsta | (Obavezno) Vrsta zahtjeva (vrijednosti: Instaliraj, Pošalji) |
Izrada GitHub tijekova rada
Da biste saznali više o sastavljanju GitHub tijekova rada pomoću GitHub radnji, dovršite GitHub radnje za Microsoft Power Platform laboratorije.
Dodatne informacije: O GitHub radnjama