Acțiuni GitHub disponibile pentru dezvoltarea Microsoft Power Platform

Secțiunile următoare descriu GitHub Actions pentru Microsoft Power Platform. Secțiunile afișează, de asemenea, eșantioane de fluxuri de lucru GitHub. Pentru mai multe informații despre GitHub Actions și cum să le descărcați, consultați GitHub Actions pentru Microsoft Power Platform.

Configurați acreditările pentru a le utiliza cu GitHub Actions cu Microsoft Power Platform

Multe dintre acțiuni necesită conectarea la un mediu Microsoft Dataverse. Adăugați acreditările principale de serviciu sau de utilizator ca secrete în depozitul GitHub, apoi utilizați-le în fluxurile de lucru.

  • Pentru detalii despre cum să configurați secrete în GitHub, consultați Secrete criptate.

  • Pentru detalii despre cum să configurați autentificarea principală a serviciului pentru Microsoft Power Platform, consultați Instrumente de compilare DevOps.

După ce configurați acreditările, puteți apela entitatea principală de serviciu din scripturile de acțiune.

Definiți următorii parametri din scriptul de acțiune GitHub ca variabile de mediu:

  • ID aplicație, cum ar fi: WF_APPLICATION_ID:<your application id>
  • ID entitate găzduită, cum ar fi: WF_TENANT_ID:<your tenant id>

Adăugați secretul clientului ca secret GitHub. Faceți referire la el din fluxul de lucru utilizând un parametru, cum ar fi: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Sarcini asistent

Următoarea activitate de ajutor este disponibilă.

acțiuni-instalare

Atunci când un flux de lucru GitHub Actions impune o instalare a CLI-ului Power Platform în contextul unui runner și are loc o eroare de expirare, utilizați versiunea 1 (@v1) cu o acțiune suplimentară (actions-install) așa cum se arată în exemplul următor.

Important

  • Utilizarea versiunii 1 (@v1) poate duce la actualizări ale acțiunilor GitHub existente, care pot duce la actualizarea fluxurilor de lucru curente.
  • Adăugați activitatea Instalați instrumente Power Platform ca prima activitate din fluxul de lucru înainte de orice altă GitHub Actions pentru 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'

Puteți găsi mai multe exemple de GitHub Actions în Acțiuni Power Platform.

whoAmI

Verifică conexiunea la serviciu prin conectarea la serviciu și trimiterea unei cereri WhoAmI [SDK/API Web]. Această activitate poate fi utilă pentru a include mai devreme în fluxul de lucru GitHub pentru a verifica conectivitatea înainte de a începe procesarea.

Parametru Descriere
environment-url Adresa URL a mediului la care vă conectați.
user-name Numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret Parola pentru nume-utilizator. Definiți GitHub parole în Setări sub Secrete. Nu puteți regăsi un secret după ce îl definiți și îl salvați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.

Sarcini soluție

Aceste sarcini efectuează acțiuni împotriva soluțiilor și includ următoarele.

import-solution

Importă o soluție într-un mediu țintă.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul țintă în care doriți să importați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
solution-file (Obligatoriu) Calea și numele fișierului soluție pe care doriți să îl importați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.

export-solution

Exportă o soluție dintr-un mediu sursă.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul de unde doriți să importați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificare nume de utilizator/parolă, parola pentru nume de utilizator. Definiți GitHub parole în Setări sub Secrete. Nu puteți regăsi un secret după ce îl definiți și îl salvați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
solution-name (Necesar) Denumirea soluției de exportat. Folosiți întotdeauna Numele soluției, nu Numele afișat al acesteia.
solution-output-file (Necesar) Calea și numele pentru fișierul solution.zip de exportat din mediul sursă.
managed (Obligatoriu) Setați pe Adevărat pentru a exporta ca soluție gestionată; setarea implicită (fals) este pentru a exporta ca o soluție neadministrată.

unpack-solution

Preia un fișier soluție comprimat și îl decomposează în mai multe fișiere XML. Puteți să citiți și să gestionați mai ușor aceste fișiere într-un sistem de control sursă.

Parametru Descriere
solution-file (Necesar) Calea și numele fișierului pentru fișierul solution.zip de despachetat.
solution-folder (Obligatoriu) Calea și folderul țintă în care doriți să despachetați soluția.
solution-type (Necesar) Tipul de soluție pe care doriți să o despachetați. Opțiunile includ Negestionat (recomandat), Gestionat și Ambele.

pack-solution

Împachetează o soluție reprezentată în controlul sursă într-un fișier solution.zip pe care îl puteți importa în alt mediu.

Parametru Descriere
solution-file (Obligatoriu) Calea și numele de fișier al fișierului solution.zip în care se împachetează soluția (de exemplu, out/CI/ALMLab.zip).
solution-folder (Necesar) Calea și folderul sursă al soluției de împachetat.
solution-type (Opțional) Tipul de soluție de condensat. Opțiunile includ Negestionat (recomandat), Gestionat și Ambele.

publish-solution

Publică personalizarea soluției.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul în care doriți să publicați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
solution-file (Obligatoriu) Calea și numele fișierului soluție pe care doriți să îl importați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.

clone-solution

Clonează soluția pentru un mediu dat.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul de unde doriți să clonați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
solution-file (Obligatoriu) Calea și numele fișierului soluție pe care doriți să îl importați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
solution-name (Obligatoriu) Calea și numele fișierului solution.zip necesare clonării (de exemplu, out/CI/ALMLab.zip).
solution-version Versiunea soluției de clonat.
target-folder Dosar țintă pentru a plasa soluția extrasă. (de exemplu, depozit Git\target-solution-folder).
Working-directory Dosar temporar pentru artefacte în curs de desfășurare necesare clonării soluției.
implicit: root of the repository

check-solution

Verifică fișierul soluției pentru a detecta neconcordanțe.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul de unde doriți să clonați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
path (Obligatoriu) Calea și numele fișierului soluție pe care doriți să îl verificați.
geo Locația geografică a serviciului Verificator Microsoft Power Platform care se va utiliza. Valoarea implicită este „Statele Unite”.
rule-level-override Calea către un fișier care conține o matrice JSON de reguli și nivelurile acestora. Valorile acceptate sunt: critice, ridicate, scăzute și informaționale. Exemplu: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name Numele folderului artefact pentru care jurnalele de verificare Microsoft Power Platform vor fi încărcate. Valoarea implicită este 'CheckSolutionLogs'.

upgrade-solution

Face upgrade soluției.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul de unde doriți să clonați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
solution-file (Obligatoriu) Calea și numele fișierului soluție pe care doriți să îl importați.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
solution-name (Obligatoriu) Numele soluției de actualizat.
asincron Face upgrade asincron soluției.
max-async-wait-time Timp maxim de așteptare asincron în minute. Valoarea implicită este de 60 de minute.

Sarcini de pachet

Aceste activități efectuează acțiuni în raport cu pachetele.

deploy-package

Implementează un DLL de pachet sau un fișier ZIP cu un pachet.

Notă

Această acțiune este acceptată doar pe Windows.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul de unde doriți să clonați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
user-name (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, numele de utilizator al contului pe care îl utilizați pentru a vă conecta.
password-secret (Obligatoriu) Dacă utilizați autentificarea cu nume de utilizator/parolă, parola pentru contul pe care îl utilizați pentru a vă conecta.
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
pachet (Obligatoriu) Calea către fișierul DLL sau ZIP al pachetului cu un pachet.

Activități pentru portaluri

Aceste activități efectuează următoarele acțiuni asupra Power Pages.

upload-paportal

Încărcați date în Power Pages.

Parametru Descriere
environment-url (Obligatoriu) URL-ul pentru mediul în care doriți să importați soluția (de exemplu, https://YourOrg.crm.dynamics.com).
app-id ID-ul de aplicație cu care să vă autentificați. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
client-secret Clientul secret utilizat pentru autentificarea canalului GitHub. Acest parametru este necesar la autentificarea cu acreditările Serviciului Principal.
tenant-id ID-ul de entitate găzduită la autentificarea cu app-id și client-secret.
upload-path Calea unde va fi stocat conținutul site-ului web (alias: -p).
deployment-profile Încărcați date de portal cu detalii de mediu definite prin variabile de profil în fișierul deployment-profiles/[profile-name].deployment.yaml.
versiune-model Indică dacă datele site-ului care vor fi încărcate utilizează modelul de date standard (1) sau cel îmbunătățit (2). Valoarea implicită este 1.

Aflați mai multe despre Microsoft Power Platform compatibilitatea CLI pentru Power Pages.

Sarcini de catalog (versiune preliminară)

Aceste activități efectuează acțiuni în raport cu catalogul din Power Platform.

Notă

În prezent, activitățile de catalog pentru Power Platform sunt în previzualizare.

Instalare

Instalați un element de catalog în mediul țintă.

Parametru Descriere
catalog-articol-id (Obligatoriu) Element de catalog de instalat în mediul țintă.
URL țintă (Obligatoriu) URL-ul mediului țintă pentru instalarea elementelor de catalog (de exemplu, https://YourOrg.crm.dynamics.com).
setări (Obligatoriu) Setări pachet runtime pentru ca cadrul de instalare să fie executat. Formatul șirului trebuie să fie key=value|key=value.
versiune-țintă Versiunea țintă de instalat. Dacă nu specificați o versiune, este selectată versiunea publicată.
Statutul sondajului Sondaj pentru a verifica starea cererii dvs.

trimitere

Listați toate articolele de catalog publicate din mediul Dataverse actual (organizație).

Parametru Descriere
path (Obligatoriu) Calea către documentul de trimitere a catalogului.
pachet-zip Calea către fișierul zip cu pachetul.
soluție-zip Calea către fișierul zip al soluției.
Statutul sondajului Sondaj pentru a verifica starea cererii dvs.

stare

Aflați starea instalării sau remiterii solicitării de catalog.

Parametru Descriere
ID-ul de urmărire (Obligatoriu) Solicitați ID de urmărire.
tip (Obligatoriu) Tip solicitare. Valorile valide sunt Install și Submit.

Crearea fluxului de lucru GitHub

Pentru a afla mai multe despre compunerea de fluxuri de lucru GitHub utilizând GitHub Actions, finalizați GitHub Actions pentru laboratoarele de Microsoft Power Platform.

Pentru mai multe informații, consultați Despre GitHub Actions.

Consultați și

Acțiuni GitHub pentru Microsoft Power Platform