Dostupne GitHub radnje za Microsoft Power Platform razvoj
GitHub radnje za Microsoft Power Platform opisane su u sledećim odeljcima. Pored toga, prikazani su i uzorci GitHub tokova posla. Za više informacija o GitHub radnjama i načinu njihovog preuzimanja, idite na GitHub radnje za Microsoft Power Platform.
Konfigurisanje akreditiva za korišćenje sa GitHub radnjama sa platformom Microsoft Power Platform
Mnoge radnje zahtevaju da se povežete sa Microsoft Dataverse okruženjem. Možete dodati akreditive korisnika ili principala usluge kao tajne u GitHub spremištu, a zatim ih koristiti u tokovima posla.
Za detalje o podešavanju tajni u GitHubu, pogledajte Šifrovane tajne
Za detalje o tome kako da podesite potvrdu identiteta principala usluge za Microsoft Power Platform, pogledajte DevOps Build Tools
Kada je konfigurišete, možete pozvati principala usluge iz svojih skripti radnje.
Parametri koje treba definisati u okviru skripte GitHub radnje kao Promenljive okruženja:
- ID aplikacije kao što je
WF_APPLICATION_ID:<your application id>
- ID zakupca kao što je
WF_TENANT_ID:<your tenant id>
Tajna klijenta se mora dodati i skladištiti kao GitHub tajna i na nju će se upućivati iz toka posla pomoću parametra poput: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Zadaci pomagača
Dostupni zadatak pomoćnika opisan je u nastavku.
radnje-instalacija
Kada tok posla GitHub radnji primora Power Platform instalaciju CLI u kontekstu trkača, a dođe do greške u vremenskom periodu, morate da koristite verziju 1 (@v1) sa dodatnom radnjom (actions-install
) kao ispod.
Važno
- Korišćenje verzije 1 (@v1) može dovesti do ažuriranja postojećih GitHub radnji koje mogu da dovedu do ažuriranja trenutnih tokova posla.
- Zadatak "Instaliranje alatki " Power Platform morate dodati kao prvi zadatak u toku posla pre bilo koje druge GitHub radnje 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 uzorke GitHub radnji možete pronaći u radnjama Power Platform .
whoAmI
Verifikuje vezu sa uslugom povezujući se sa uslugom i šaljući WhoAmI
[SDK/Web API] zahtev. Ovaj zadatak može biti koristan za rano uključivanje u vaš GitHub tok posla, da biste verifikovali povezanost pre početka obrade.
Parametar | Opis |
---|---|
environment-url | URL adresa za okruženje na koje se povezujete. |
user-name | Korisničko ime naloga koji koristite da se povežete. |
password-secret | Lozinka za user-name. GitHub lozinke su definisane u odeljku Postavke pod Tajne. Ne možete da preuzmete tajnu kada je definišete i sačuvate. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
Zadaci rešenja
Ovi zadaci izvršavaju radnje protiv rešenja i uključuju sledeće.
import-solution
Uvozi rešenje u ciljno okruženje.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za ciljno okruženje u koje želite da uvezete rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
solution-file | (Obavezno) Putanja i ime datoteke rešenja koju želite da uvezete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
export-solution
Izvozi rešenje iz izvornog okruženja.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje iz kojeg želite da izvezete rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za user-name. GitHub lozinke su definisane u odeljku Postavke pod Tajne. Ne možete da preuzmete tajnu kada je definišete i sačuvate. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
solution-name | (Obavezno) Naziv rešenja koje se izvozi. Uvek koristite naziv rešenja, ne njegovo ime za prikaz. |
solution-output-file | (Obavezno) Naziv putanje i datoteke rešenje.zip za izvoz izvornog okruženja. |
managed | (Obavezno) Podesite na tačno da biste izvezli kompletno rešenje; podrazumevano (netačno) je za izvoz kao nekompletno rešenje. |
unpack-solution
Uzima komprimovanu datoteku rešenja i dekomponuje je u više XML datoteka kako bi sistem kontrole izvora mogao lakše da učita ove datoteke i njima upravlja.
Parametar | Opis |
---|---|
solution-file | (Obavezno) Putanja i naziv .zip datoteke rešenja za raspakivanje. |
solution-folder | (Obavezno) Putanja i ciljna fascikla u koju želite da raspakujete rešenje. |
solution-type | (Obavezno) Tip rešenja koje želite da raspakujete. Opcije uključuju Nekompletno (preporučuje se), Kompletno i Oba. |
pack-solution
Pakuje rešenje predstavljeno u kontroli izvora u .zip datoteku rešenja koja se može uvesti u drugo okruženje.
Parametar | Opis |
---|---|
solution-file | (Obavezno) Putanja i ime datoteke solution.zip u koju se pakuje rešenje (na primer, out/CI/ALMLab.zip). |
solution-folder | (Obavezno) Putanja i izvorna fascikla rešenja za pakovanje. |
solution-type | (Opcionalno) Tip rešenja za pakovanje. Opcije uključuju Nekompletno (preporučuje se), Kompletno i Oba. |
publish-solution
Objavljuje prilagođavanja rešenja.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za ciljno okruženje u koje želite da objavite rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
solution-file | (Obavezno) Putanja i ime datoteke rešenja koju želite da uvezete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
clone-solution
Klonira rešenje za dato okruženje.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje iz kojeg želite da klonirate rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
solution-file | (Obavezno) Putanja i ime datoteke rešenja koju želite da uvezete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
solution-name | (Obavezno) Putanja i ime datoteke solution.zip potrebne za kloniranje (na primer, out/CI/ALMLab.zip). |
solution-version | Verzija rešenja za kloniranje. |
target-folder | Ciljna fascikla u koju ćete smestiti raspakovano rešenje. (npr. Git spremište\target-solution-folder). |
Working-directory | Privremena fascikla za artefakte rada u toku koji su potrebni za kloniranje rešenja. podrazumevano: root of the repository |
check-solution
Proverava datoteku rešenja radi otkrivanja nedoslednosti.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje iz kojeg želite da klonirate rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
path | (Obavezno) Putanja i ime datoteke rešenja koju želite da proverite. |
geo | Koju geografsku lokaciju usluge Microsoft Power Platform provere treba koristiti. Podrazumevana vrednost je 'united states'. |
rule-level-override | Putanja do datoteke koja sadrži JSON niz pravila i njihove nivoe. Prihvaćene vrednosti su: Kritično, Visoko, Nisko i Informativno. Primer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
checker-logs-artifact-name | Ime fascikle za artefakte za koju će Microsoft Power Platform evidencija provere biti otpremljena. Podrazumevana vrednost je 'CheckSolutionLogs'. |
upgrade-solution
Pruža mogućnost nadogradnje rešenja.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje iz kojeg želite da klonirate rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
solution-file | (Obavezno) Putanja i ime datoteke rešenja koju želite da uvezete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
solution-name | (Obavezno) Naziv rešenja koje treba nadograditi. |
async | Asinhrono nadograđuje rešenje. |
max-async-wait-time | Maksimalno vreme asinhronog čekanja u minutima. Podrazumevana vrednost je 60 minuta. |
Paketni zadaci
Ovi zadaci izvode radnje u odnosu na pakete i uključuju sledeće.
deploy-package
Pruža mogućnost primene dll paketa ili zip datoteke sa paketom.
Belešku
Ova radnja je podržana samo na operativnom sistemu Windows.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje iz kojeg želite da klonirate rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
user-name | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, korisničko ime naloga sa kojim se povezujete. |
password-secret | (Obavezno) Ako koristite potvrdu identiteta pomoću korisničkog imena / lozinke, lozinka za nalog sa kojim se povezujete. |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
package | (Obavezno) Putanja do dll datoteke paketa ili zip datoteke sa paketom. |
Zadaci portala
Ovi zadaci izvršavaju sledeće radnje u usluzi Power Pages.
upload-paportal
Otprema podatke u Power Pages.
Parametar | Opis |
---|---|
environment-url | (Obavezno) URL adresa za okruženje u koje želite da uvezete rešenje (na primer, https://YourOrg.crm.dynamics.com ). |
app-id | ID aplikacije za potvrdu identiteta. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
client-secret | Klijentska tajna koja se koristi za autentifikaciju GitHub kanala. Ovaj parametar je obavezan prilikom potvrde identiteta pomoću akreditiva principala usluge. |
tenant-id | ID zakupca prilikom potvrde identiteta pomoću parametara app-id i client-secret . |
upload-path | Putanja na kojoj je uskladišten sadržaj veb-lokacije (pseudonim: -p). |
deployment-profile | Otpremajte podatke o portalu sa detaljima o okruženju definisanim putem promenljivih profila u datoteci deployment-profiles/[profile-name].deployment.yaml. |
model-verzija | Označava da li će podaci lokacije koji će biti otpremljeni koristiti standardni (1 ) ili poboljšani model podataka (2 ). Podrazumevana vrednost je "1". |
Saznajte više o Microsoft Power Platform CLI podršci za Power Pages.
Kataloški zadaci (pregled)
Ovi zadaci izvršavaju radnje u odnosu na katalog i Power Platform uključuju sledeće radnje.
Belešku
Trenutno su kataloški zadaci Power Platform izdanje za pregled.
instaliraj
Instalirajte stavku kataloga u ciljno okruženje.
Parametar | Opis |
---|---|
katalog-id artikla | (Obavezno) Stavka kataloga koja će biti instalirana na ciljnom okruženju. |
target-url | (Obavezno) Url adresa ciljnog okruženja za instalaciju stavke kataloga u (na primer, "https://YourOrg.crm.dynamics.com"). |
podešavanja | (Obavezno) Postavke paketa izvršavanja za izvršavanje instalacionog okvira. Format niske mora biti key=value|key=value . |
ciljna-verzija | Ciljna verzija za instalaciju. Ako ostane prazna, izabrana je objavljena verzija. |
anketa-status | Anketa za proveru statusa vašeg zahteva. |
prosledi
Navedite sve objavljene stavke kataloga iz trenutnog Dataverse okruženja (organizacije).
Parametar | Opis |
---|---|
path | (Obavezno) Putanja do dokumenta prosleđivanja kataloga. |
paket-zip | Putanja do datoteke paketa u zip formatu. |
resenje-zip | Putanja do datoteke rešenja u zip formatu. |
anketa-status | Anketa za proveru statusa vašeg zahteva. |
status
Dobijte status zahteva za instalaciju/prosleđivanje kataloga.
Parametar | Opis |
---|---|
Id praćenja | (Obavezno) ID praćenja zahteva. |
tip | (Obavezno) Tip zahteva (Vrednosti: Instaliranje, prosleđivanje) |
Kreiranje GitHub toka posla
Da biste saznali više o sastavljanju GitHub tokova posla pomoću GitHub radnji, dovršite GitHub radnje za Microsoft Power Platform laboratorije.
Još informacija: O GitHub radnjama