Deli putem


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

Takođe pogledajte

GitHub Actions for Microsoft Power Platform