Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Acțiunile GitHub pentru Microsoft Power Platform sunt descrise în secțiunile următoare. În plus, sunt afișate și exemple de fluxuri de lucru GitHub. Pentru mai multe informații despre Acțiunile GitHub și despre cum să le descărcați, accesați Acțiuni GitHub 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. Puteți adăuga principalele de servicii sau acreditările de utilizator ca secrete în depozitul dvs. GitHub și apoi să le utilizați în fluxurile de lucru.
Pentru detalii despre cum să configurați secretele în GitHub, consultați Secretele criptate
Pentru detalii despre cum să configurați autentificarea principală a serviciului pentru Microsoft Power Platform, consultați Unelte DevOps Build
Odată configurat, puteți apela principalul de serviciu din scripturile de acțiune.
Parametrii de definit în scriptul de acțiune GitHub ca variabile de mediu:
- ID-ul aplicației, cum ar fi:
WF_APPLICATION_ID:<your application id> - ID-ul de entitate găzduită, cum ar fi:
WF_TENANT_ID:<your tenant id>
Secretul clientului trebuie adăugat și stocat ca secret GitHub și va fi menționat din fluxul de lucru folosind un parametru precum: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Sarcini asistent
Sarcina de ajutor disponibilă este descrisă mai jos.
acțiuni-instalare
Când un flux de lucru GitHub Actions forțează instalarea Power Platform CLI în contextul unui runner și apare o eroare de timeout, atunci trebuie să utilizați versiunea 1 (@v1) cu o acțiune suplimentară (actions-install) ca mai jos.
Important
- Utilizarea versiunii 1 (@v1) poate duce la actualizări ale acțiunilor GitHub existente, care pot duce la actualizarea fluxurilor de lucru curente.
- Trebuie să adăugați sarcina Instalare Power Platform Tools ca primă sarcină în fluxul dvs. de lucru înainte de orice alte acțiuni GitHub 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 mostre suplimentare de acțiuni GitHub la Power Platform Acțiuni.
whoAmI
Verifică conexiunea la serviciu prin conectarea la serviciu și trimiterea unei cereri WhoAmI [SDK/API Web]. Această sarcină poate fi utilă pentru a o include devreme în fluxul de lucru GitHub, pentru a verifica conectivitatea înainte de începerea procesării.
| 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. Parolele GitHub sunt definite în Setări sub Secrete. Nu puteți recupera un secret după ce a fost definit și salvat. |
| 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. Parolele GitHub sunt definite în Setări sub Secrete. Nu puteți recupera un secret după ce a fost definit și salvat. |
| 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 o soluție comprimată și o descompune în mai multe fișiere XML, astfel încât aceste fișiere să poată fi citite și gestionate mai ușor de un sistem de control sursă.
| Parametru | Descriere |
|---|---|
| solution-file | (Necesar) Calea și numele fișierului pentru fișierul solution.zip de despachetat. |
| solution-folder | (Necesar) 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 sursei într-un fișier solution.zip care poate fi importat într-un alt mediu.
| Parametru | Descriere |
|---|---|
| solution-file | (Obligatoriu) Calea și numele fișierului solution.zip în care să condenseze 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
Oferă posibilitatea de a actualiza soluția.
| 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 sarcini efectuează acțiuni împotriva pachetelor și includ următoarele.
deploy-package
Oferă posibilitatea de a implementa un pachet dll sau un fișier zip cu un pachet.
Notă
Această acțiune este acceptată numai pe un 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 pachetul dll sau fișierul zip 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 urmează să fie încărcate vor folosi standardul (1) sau modelul de date î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 sarcini efectuează acțiuni împotriva catalogului în Power Platform și includ următoarele.
Notă
În prezent, sarcinile de catalog pentru Power Platform sunt o versiune versiune preliminară .
Instalare
Instalați un element de catalog în mediul țintă.
| Parametru | Descriere |
|---|---|
| catalog-articol-id | (Obligatoriu) Element de catalog care urmează să fie instalat în mediul țintă. |
| URL țintă | (Obligatoriu) Adresa URL a mediului țintă pentru instalarea articolului de catalog în (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ă este lăsată goală, versiunea publicată este selectată. |
| 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
Obțineți starea solicitării de instalare/trimitere pentru catalog.
| Parametru | Descriere |
|---|---|
| ID-ul de urmărire | (Obligatoriu) Solicitați ID de urmărire. |
| tip | (Obligatoriu) Tip cerere (Valori: Instalare, Trimitere) |
Crearea fluxului de lucru GitHub
Pentru a afla mai multe despre compunerea fluxurilor de lucru GitHub utilizând acțiunile GitHub, completați Acțiuni GitHub pentru laboratoare Microsoft Power Platform.
Mai multe informatii: Despre Acțiunile GitHub