Microsoft Power Platform garapenerako GitHub Ekintzak eskuragarri
GitHub ekintzak Microsoft Power Platform hurrengo ataletan azaltzen dira. Horrez gain, GitHub lan-fluxuen laginak ere erakusten dira. GitHub ekintzei eta deskargatzeko moduari buruzko informazio gehiago lortzeko, joan hona GitHub ekintzak Microsoft Power Platform.
Konfiguratu kredentzialak GitHub ekintzekin erabiltzeko Microsoft Power Platform
Ekintza askorekin Microsoft Dataverse ingurunera konektatu behar zara. Zerbitzu nagusiaren edo erabiltzaileen kredentzialak zure GitHub biltegian sekretu gisa gehi ditzakezu eta gero zure lan-fluxuetan erabil ditzakezu.
GitHub-en sekretuak konfiguratzeko moduari buruzko xehetasunak ikusteko, ikusi Enkriptatutako sekretuak
Zerbitzuaren autentifikazio nagusia nola konfiguratu zehazteko Microsoft Power Platform, ikusi DevOps Build tresnak
Konfiguratu ondoren, Zerbitzuaren zuzendariari dei diezaiokezu zure Ekintza scriptetatik.
Zure GitHub Ekintza Scriptean definitzeko parametroak Ingurunearen Aldagaiak:
- Aplikazioaren IDa, adibidez:
WF_APPLICATION_ID:<your application id> - Maizterraren IDa, adibidez:
WF_TENANT_ID:<your tenant id>
Bezeroaren sekretua GitHub sekretu gisa gehitu eta gorde behar da, eta lan-fluxuaren barnean erreferentzia egingo zaio, honelako parametro bat erabiliz: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Laguntzailearen zereginak
Eskuragarri dagoen laguntzailearen zeregina jarraian azaltzen da.
ekintzak-instalatu
GitHub Actions lan-fluxu batek Power Platform CLI exekutatu baten testuinguruan instalatzera behartzen duenean eta denbora-muga errorea gertatzen denean, 1 bertsioa (@v1) erabili behar duzu ekintza gehigarri batekin (actions-install) behean bezala.
Garrantzitsua da
- 1 bertsioa (@v1) erabiltzeak lehendik dauden GitHub ekintzen eguneraketak ekar ditzake, eta horrek uneko lan-fluxuak eguneratzea eragin dezake.
- Instalatu Power Platform Tresnak zeregina gehitu behar duzu zure lan-fluxuan beste edozein GitHub ekintzaren aurretik 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'
GitHub ekintzen lagin osagarriak aurki ditzakezu Power Platform Ekintzak helbidean.
whoAmI
Zerbitzu konexioa egiaztatzen du zerbitzura konektatuz eta WhoAmI [SDK/Web APIa] eskaera bat bidaliz. Zeregin hau erabilgarria izan daiteke zure GitHub lan-fluxuan hasieran sartzeko, prozesatzen hasi aurretik konektibitatea egiaztatzeko.
| Parametroa | Deskribapena |
|---|---|
| ingurunearen URLa | Konektatzen ari zaren ingurunearen URLa. |
| erabiltzaile-izena | Konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | Pasahitza hurrengorako erabiltzaile-izena. GitHub pasahitzak hemen definitzen dira Ezarpenak, Sekretuak-en azpian. Ezin duzu sekretua berreskuratu definitu eta gorde ondoren. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
Soluzioaren zereginak
Zeregin horiek konponbideen aurkako ekintzak burutzen dituzte eta honako hauek biltzen dituzte.
import-solution
Irtenbidea xede ingurune batera inportatzen du.
| Parametroa | Deskribapena |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna inportatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| soluzio-fitxategia | (Beharrezkoa) Inportatu nahi duzun irtenbide fitxategiaren bidea eta izena. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
export-solution
Iturri ingurune batetik irtenbidea esportatzen du.
| Parametroa | Deskribapena |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna esportatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen ari bazara, pasahitza erabiltzaile-izena. GitHub pasahitzak hemen definitzen dira Ezarpenak, Sekretuak-en azpian. Ezin duzu sekretua berreskuratu definitu eta gorde ondoren. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| soluzioaren izena | (Beharrezkoa) Esportatuko den soluzioaren izena. Erabili beti irtenbidearen Izena, ez bere Bistaratzeko izena. |
| soluzioaren irteera-fitxategia | (Beharrezkoa) Iturburuko ingurunean esportatzeko solution.zip fitxategiaren bide-izena eta fitxategiaren izena. |
| kudeatuta | (Beharrezkoa) Ezarri gisa egia kudeatutako soluzio gisa esportatzeko; lehenetsia (faltsua) kudeatu gabeko irtenbide gisa esportatzea da. |
unpack-solution
Konprimitutako konponbide fitxategia hartzen du eta XML fitxategi askotan bereizten ditu, fitxategi horiek iturri kontrol sistema batek errazago irakurri eta kudeatu ditzan.
| Parametroa | Deskribapena |
|---|---|
| soluzio-fitxategia | (Beharrezkoa) Deskonprimatu beharreko solution.zip fitxategiaren bide-izena eta izena. |
| irtenbide-karpeta | (Beharrezkoa) Soluzioa deskonprimatu nahi duzun bide-izena eta helburuko karpeta. |
| soluzio mota | (Beharrezkoa) Aukeratu deskonprimatu nahi duzun soluzioa. Aukerak hauek dira kudeatu gabea (Gomendatua), Kudeatutako, eta Biek. |
pack-solution
Zeregin honek iturburu-kontrolean irudikatutako irtenbidea paketatzen du ingurune batera inportatu daitekeen solution.zip fitxategian.
| Parametroa | Deskribapena |
|---|---|
| soluzio-fitxategia | (Beharrezkoa) irtenbidea paketatzeko irtenbide.zip fitxategiaren bidea eta fitxategi izena (adibidez, out / CI / ALMLab.zip). |
| irtenbide-karpeta | (Beharrezkoa) Paketatu beharreko soluzioaren bide-izena eta iturburuko karpeta. |
| soluzio mota | (Aukerakoa) Ontziratu beharreko irtenbide mota. Aukerak hauek dira kudeatu gabea (Gomendatua), Kudeatutako, eta Biek. |
publish-solution
Irtenbide pertsonalizazioak argitaratzen ditu.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna argitaratzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| soluzio-fitxategia | (Beharrezkoa) Inportatu nahi duzun irtenbide fitxategiaren bidea eta izena. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
clone-solution
Ingurune jakin baterako irtenbidea klonatzen du.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna klonatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| soluzio-fitxategia | (Beharrezkoa) Inportatu nahi duzun irtenbide fitxategiaren bidea eta izena. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| soluzioaren izena | (Beharrezkoa) Klonatzeko behar den solution.zip fitxategiaren bidea eta izena (adibidez, out/CI/ALMLab.zip). |
| solution-version | Klonatuko den soluzioaren bertsioa. |
| target-folder | Ateratako soluzioa kokatzeko helburu karpeta. (adibidez, Git repository\target-solution-folder). |
| Working-directory | Soluzioa klonatzeko beharrezkoak diren artefaktuak aldi baterako karpeta. lehenetsia: root of the repository |
check-solution
Irtenbide fitxategia egiaztatzen du inkoherentziak hautemateko.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna klonatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| bide-izena | (Beharrezkoa) Egiaztatu nahi duzun irtenbide fitxategiaren bidea eta izena. |
| geo | Erabili beharreko Microsoft Power Platform egiaztatzailearen kokaleku geografikoa. Balio lehenetsia "estatu batuak" da. |
| rule-level-override | JSON arau multzoa eta horien mailak dituen fitxategirako bidea. Onartutako balioak hauek dira: kritikoak, altuak, baxuak eta informatzaileak. Adibidez: [{"Id":"meta-remove-dup-reg", "OverrideLevel":"Ertaina"},{"Id": "il-Avoid-Specialized-Update-Ops","OverrideLevel": "Ertaina"}] |
| checker-logs-artifact-name | Zein den artefaktuen karpetaren izena Microsoft Power Platform zuzentzaileen erregistroak kargatuko dira. "CheckSolutionLogs" da balio lehenetsia. |
upgrade-solution
Irtenbidea berritzeko gaitasuna eskaintzen du.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna klonatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| soluzio-fitxategia | (Beharrezkoa) Inportatu nahi duzun irtenbide fitxategiaren bidea eta izena. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| soluzioaren izena | (Beharrezkoa) Bertsio-berritu behar den soluzioaren izena. |
| async | Soluzioa asinkronikoki bertsio-berritzen. |
| max-async-wait-time | Itxarote gehieneko denbora asinkronoa minututan. Balio lehenetsia 60 minutu da. |
Pakete-zereginak
Zeregin hauek paketeen aurkako ekintzak burutzen dituzte eta honako hauek biltzen dituzte.
deploy-package
Pakete dll edo zip fitxategi bat pakete batekin zabaltzeko gaitasuna eskaintzen du.
Oharra
Ekintza hau Windows-en soilik onartzen da.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna klonatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| erabiltzaile-izena | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren erabiltzaile izena. |
| pasahitz sekretua | (Beharrezkoa) Erabiltzaile izena / pasahitza autentifikazioa erabiltzen baduzu, konektatzeko erabiltzen ari zaren kontuaren pasahitza. |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| paketea | (Beharrezkoa) paketea duen dll edo zip fitxategirako bide-izena. |
Atariko zereginak
Zeregin hauek ekintza hauek burutzen dituzte Power Pages.
upload-paportal
Datuak kargatzen ditu Power Pages.
| Parametroa | Deskribapenak |
|---|---|
| ingurunearen URLa | (Eskatuta) URL helburuko ingurunea nahi duzuna inportatzeko soluzioaren barruan (adibidez, https://YourOrg.crm.dynamics.com). |
| app-id | Autentifikatzeko IDa erabili behar den aplikazioa. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| client-secret | GitHub kanalizazioa autentifikatzeko erabilitako bezeroaren sekretua. Parametro hau da beharrezkoa Zerbitzu nagusiaren egiaztagiriekin autentifikazioa egitean. |
| tenant-id | Maizterren IDa honekin autentifikatzen denean app-id eta client-secret. |
| igo-bidea | Webguneko edukia biltegiratuko den bide-izena (ezizena: -p). |
| hedapen-profila | Kargatu atariaren datuak ingurunearekin zehaztutako xehetasunekin profileko aldagaiak inplementazio-profiletan/ [profil-izena].deployment.yaml fitxategia. |
| eredu-bertsioa | Kargatu beharreko guneko datuek estandarra (1) edo datu eredu hobetua (2) erabiliko duten adierazten du. Balio lehenetsia '1' da. |
Lortu informazio gehiago Microsoft Power Platform CLI laguntzari buruz Power Pages.
Katalogoko zereginak (aurrebista)
Zeregin hauek katalogoaren aurkako ekintzak burutzen dituzte Power Platform n eta honako hauek barne hartzen dituzte.
Oharra
Une honetan, Power Platform ko katalogo-zereginak aurrebista argitarapena dira.
instalatu
Instalatu katalogo-elementu bat helmuga-ingurunean.
| Parametroa | Deskribapenak |
|---|---|
| katalogo-elementu-id | (Derrigorrezkoa) Katalogoko elementua xede ingurunean instalatu beharrekoa. |
| target-url | (Derrigorrezkoa) Katalogoko elementuak instalatzeko xede-ingurunearen URLa (adibidez, "https://YourOrg.crm.dynamics.com"). |
| ezarpenak | (Derrigorrezkoa) Exekutatu beharreko instalazio-esparrurako exekuzio-paketeen ezarpenak. Katearen formatuak key=value|key=value izan behar du. |
| xede-bertsioa | Instalatzeko xede-bertsioa. Hutsik geratzen bada, argitaratutako bertsioa hautatuko da. |
| inkesta-egoera | Inkesta zure eskaeraren egoera egiaztatzeko. |
bidali
Zerrendatu egungo Dataverse inguruneko (erakundea) argitaratutako katalogoko elementu guztiak.
| Parametroa | Deskribapenak |
|---|---|
| bide-izena | (Derrigorrezkoa) Katalogoa aurkezteko dokumenturako bidea. |
| pakete-zip | Paketearen ZIP fitxategirako bide-izena. |
| irtenbide-zip | Soluzioaren ZIP fitxategirako bide-izena. |
| inkesta-egoera | Inkesta zure eskaeraren egoera egiaztatzeko. |
egoera
Eskuratu katalogoa instalatzeko/bidaltzeko eskaeraren egoera.
| Parametroa | Deskribapenak |
|---|---|
| jarraipena-id | (Derrigorrezkoa) Eskatu jarraipenaren ID. |
| mota | (Derrigorrezkoa) Eskaera mota (Balioak: Instalatu, Bidali) |
GitHub lan-fluxuaren egileak
GitHub lan-fluxuak konposatzeari buruz gehiago jakiteko GitHub ekintzak erabiliz, osatu GitHub ekintzak Microsoft Power Platform laborategiak.
Informazio gehiago: GitHub Actions-i buruz
Ikusi baita ere
Oharrak
Laster erabilgarri: 2024an, GitHub-eko arazoak edukiari buruzko oharrak bidaltzeko mekanismo gisa kenduko dugu apurka-apurka, eta oharrak bidaltzeko sistema berri batekin ordeztuko. Informazio gehiagorako, ikusi: https://aka.ms/ContentUserFeedback.
Bidali eta ikusi honi buruzko oharrak: