Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Seuraavissa osioissa kuvataan Microsoft Power Platform GitHub Actions. Osioissa näytetään myös GitHubin mallityönkulkuja. Lisätietoja GitHub Actionsista ja niiden lataamisesta on artikkelissa GitHub Actions for Microsoft Power Platform.
Tunnistetietojen määrittäminen käytettäväksi Microsoft Power Platformin GitHub Actionsin kanssa
Monet toiminnot edellyttävät yhteyden muodostamista Microsoft Dataverse -ympäristöön. Lisää palvelun päänimiobjekti tai käyttäjän tunnistetiedot salaisuuksina GitHub-säilöösi ja käytä niitä sitten työnkuluissasi.
Lisätietoja salaisuuksien määrittämisestä GitHubissa on artikkelissa Encrypted secrets.
Lisätietoja siitä, miten voit määrittää Microsoft Power Platform -palvelun päänimen todennuksen, on artikkelissa DevOps Build tools.
Kun olet määrittänyt tunnistetiedot, voit kutsua palvelun päänimeä Action-komentosarjoissa.
Määritä seuraavat parametrit GitHub Action -komentosarjassasi ympäristömuuttujiksi:
- Sovellustunnus, kuten:
WF_APPLICATION_ID:<your application id> - Vuokraajan tunnus, kuten:
WF_TENANT_ID:<your tenant id>
Lisää client secret GitHub-salaisuutena. Voit viitata siihen työnkulusta käyttämällä seuraavankaltaista parametria: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Avustajatehtävät
Seuraava aputehtävä on käytettävissä.
actions-install
Kun GitHub Actions -työnkulku pakottaa Power Platform -komentorivikäyttöliittymän asennuksen juoksijan kontekstiin ja tapahtuu aikakatkaisuvirhe, käytä versiota 1 (@v1) lisätoiminnolla (actions-install) seuraavassa esimerkissä esitetyllä tavalla.
Tärkeää
- Version 1:n (@v1) käyttäminen voi johtaa olemassa olevien GitHub Actions -toimintojen päivityksiin, minkä seurauksena nykyiset työnkulut saattavat päivittyä.
- Lisää Install Power Platform Tools -tehtävä työnkulun ensimmäiseksi tehtäväksi ennen muita Power Platformin GitHub Actions -toimintoja.
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'
Voit löytää lisää esimerkkejä GitHub Actions kohdasta Power Platform Actions.
whoAmI
Tarkistaa palveluyhteyden muodostamalla yhteyden palveluun ja lähettämällä WhoAmI [SDK/Web API] -pyynnön. Tämä tehtävä voi olla hyödyllistä sisällyttää GitHub-työnkulkuun aikaisessa vaiheessa yhteyden toimivuuden varmistamiseksi ennen käsittelyn aloittamista.
| Parametri | Kuvaus |
|---|---|
| environment-url | Sen ympäristön URL-osoite, jonne muodostat yhteyden. |
| user-name | Sen tilin käyttäjätunnus, jonka avulla muodostat yhteyden. |
| password-secret | Salasana kohteelle user-name. Määritä GitHub-salasanat kohdassa Asetukset osiossa Salaisuudet. Et voi hakea salaisuutta sen määrittämisen ja tallentamisen jälkeen. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principal -tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
Ratkaisutehtävät
Nämä tehtävät suorittavat ratkaisuihin kohdistuvia toimintoja ja sisältävät seuraavat asiat.
import-solution
Tuo ratkaisun kohdeympäristöön.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen kohdeympäristön URL-osoite, johon ratkaisu halutaan tuoda (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimi-/salasanatodennusta, anna sen tilin käyttäjätunnus, jolla muodostat yhteyden. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jonka avulla muodostat yhteyden. |
| solution-file | (Pakollinen) Tuotavan ratkaisutiedoston polku ja nimi. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakkaan salaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
export-solution
Vie ratkaisun lähdeympäristöstä.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, josta ratkaisu halutaan viedä (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin käyttäjätunnus, jonka avulla muodostat yhteyden. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimi-/salasanatodennusta, salasana kohteelle user-name. Määritä GitHub-salasanat Asetukset-kohdan Salaisuudet-osiossa. Et voi hakea salaisuutta sen määrittämisen ja tallentamisen jälkeen. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| tenant-id | vuokraajan tunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| solution-name | (Pakollinen) Vietävän ratkaisun nimi. Käytä aina ratkaisun nimeä, ei sen näyttönimeä. |
| solution-output-file | (Pakollinen) Sen solution.zip-tiedoston polku ja nimi, johon lähdeympäristö viedään. |
| hallittu | (Pakollinen) Aseta arvoksi true, jotta vienti tapahtuu hallittuna ratkaisuna; oletusarvo (false) on viedä hallitsemattomana ratkaisuna. |
unpack-solution
Ottaa pakatun ratkaisutiedoston ja purkaa sen useiksi XML-tiedostoiksi. Voit helpommin lukea ja hallita näitä tiedostoja versionhallintajärjestelmässä.
| Parametri | Kuvaus |
|---|---|
| solution-file | (Pakollinen) Purettavan ratkaisu.zip-tiedoston polku ja tiedostonimi. |
| solution-folder | (Pakollinen) Polku ja kohdekansio, johon haluat purkaa ratkaisun. |
| solution-type | (Pakollinen) Sen ratkaisun tyyppi, jonka haluat purkaa. Vaihtoehtoja ovat Ei hallittu (suositeltava), Hallittu ja Molemmat. |
pack-solution
Pakkaa lähdeohjausobjektissa edustetun ratkaisun solution.zip tiedostoon, jonka voit tuoda toiseen ympäristöön.
| Parametri | Kuvaus |
|---|---|
| solution-file | (Pakollinen) Sen solution.zip-tiedoston polku ja tiedoston nimi, joksi ratkaisu pakataan (esimerkiksi out/CI/ALMLab.zip). |
| solution-folder | (Pakollinen) Pakattavan ratkaisun polku ja lähdekansio. |
| solution-type | (Valinnainen) Pakattavan ratkaisun tyyppi. Vaihtoehtoja ovat Ei hallittu (suositeltava), Hallinnoitu ja Molemmat. |
publish-solution
Julkaisee ratkaisun mukautukset.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, johon ratkaisu halutaan julkaista (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin käyttäjätunnus, jonka avulla muodostat yhteyden. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jonka avulla muodostat yhteyden. |
| solution-file | (Pakollinen) Tuotavan ratkaisutiedoston polku ja nimi. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennuksessa käytetään Service Principalin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
clone-solution
Kloonaa ratkaisun tiettyä ympäristöä varten.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, josta ratkaisu halutaan kloonata (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin käyttäjänimi, jolla muodostat yhteyden. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jonka avulla muodostat yhteyden. |
| solution-file | (Pakollinen) Tuotavan ratkaisutiedoston polku ja nimi. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| solution-name | (Pakollinen) Kloonaamiseen tarvittavan solution.zip-tiedoston polku ja nimi (kuten out/CI/ALMLab.zip). |
| solution-version | Kloonattavan ratkaisun versio. |
| target-folder | Kohdekansio, johon purettu ratkaisu sijoitetaan (kuten, Git repository\target-solution-folder). |
| Working-directory | Keskeneräisen työn tilapäiskansio ratkaisun kloonauksessa tarvittaville artefakteille. oletus: root of the repository |
check-solution
Tarkistaa ratkaisutiedoston epäjohdonmukaisuuksien havaitsemiseksi.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, josta ratkaisu halutaan kloonata (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimi/salasana-todennusta, sen tilin käyttäjätunnus, jota käytät yhteyden muodostamiseen. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jonka avulla muodostat yhteyden. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään palvelun päänimen tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| polku | (Pakollinen) Tarkistettavan ratkaisutiedoston polku ja nimi. |
| alue | Mitä Microsoft Power Platform Checker -palvelun maantieteellistä sijaintia käytetään? Oletusarvo on 'united states'. |
| sääntötason ohitus | Polku JSON-taulukon sääntöjä ja niiden tasoja sisältävään tiedostoon. Hyväksytyt arvot: Kriittinen, Korkea, Matala ja Tiedoksi. Esimerkki: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Sen artefaktikansion nimi, johon Microsoft Power Platform -tarkistuslokit ladataan. Oletusarvo on 'CheckSolutionLogs'. |
upgrade-solution
Päivittää ratkaisun uudemmaksi.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, josta ratkaisu halutaan kloonata (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, anna sen tilin käyttäjätunnus, jonka avulla muodostat yhteyden. |
| password-secret | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jota käytät yhteyden muodostamiseen. |
| solution-file | (Pakollinen) Tuotavan ratkaisutiedoston polku ja nimi. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään palvelun päänimen tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| solution-name | (Pakollinen) Päivitettävän ratkaisun nimi. |
| asynkroninen | Päivittää ratkaisun asynkronisesti. |
| max-async-wait-time | Enimmäisasynkroninen odotusaika minuutteina. Oletusarvo on 60 minuuttia. |
Paketointitehtävät
Nämä tehtävät suorittavat toimintoja paketteihin.
deploy-package
Ottaa käyttöön paketin DLL:n tai paketin sisältävän ZIP-tiedoston.
Muistiinpano
Tätä toimintoa tuetaan vain Windowsissa.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, josta ratkaisu halutaan kloonata (kuten https://YourOrg.crm.dynamics.com). |
| user-name | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin käyttäjätunnus, jonka avulla muodostat yhteyden. |
| salasanasalaisuus | (Pakollinen) Jos käytät käyttäjänimen ja salasanan todennusta, sen tilin salasana, jonka avulla muodostat yhteyden. |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| paketti | (Pakollinen) Sen DLL- tai ZIP-pakettitiedoston polku, joka sisältää paketin. |
Portaalin tehtävät
Nämä tehtävät suorittavat seuraavat toiminnot Power Pagesissa.
upload-paportal
Lähettää tietoja Power Pages -sivustoihin.
| Parametri | Kuvaus |
|---|---|
| environment-url | (Pakollinen) Sen ympäristön URL-osoite, johon ratkaisu halutaan tuoda (kuten https://YourOrg.crm.dynamics.com). |
| app-id | Todennuksessa käytettävä sovellustunnus. Tämä parametri on pakollinen, kun todennukseen käytetään Service Principalin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakassalaisuus. Tämä parametri on pakollinen, kun todennukseen käytetään palveluobjektin tunnistetietoja. |
| tenant-id | Vuokraajatunnus, kun todennuksessa on käytössä app-id ja client-secret. |
| upload-path | Polku, johon sivuston sisältö on tallennettu (alias: -p). |
| deployment-profile | Lataa deployment-profiles/[profile-name].deployment.yaml-tiedostossa profiilimuuttujien avulla määritetyt portaalin tiedot ja ympäristön tiedot. |
| mallin versio | Ilmaisee, käyttävätkö ladattavat sivuston tiedot vakiotietomallia (1) vai parannettua tietomallia (2). Oletusarvo on 1. |
Lue lisää Microsoft Power Platform CLI:n Power Pages -tuesta.
Luettelon tehtävät (esikatselu)
Nämä tehtävät suorittavat toimintoja Power Platformin luetteloon.
Muistiinpano
Power Platformin luettelotehtävät ovat tällä hetkellä esiversiona.
asentaa
Asenna luettelonimike kohdeympäristöön.
| Parametri | Kuvaus |
|---|---|
| catalog-item-id | (Pakollinen) Kohdeympäristöön asennettava luettelokohde. |
| target-url | (Pakollinen) Luettelokohteen asennuksen kohdeympäristön URL-osoite (esimerkiksi https://YourOrg.crm.dynamics.com). |
| asetukset | (Pakollinen) Suoritusaikaisen paketin asetukset, jotka asennuskehys tarvitsee suorittamiseen. Merkkijonon muodon on oltava key=value|key=value. |
| target-version | Asennettava kohdeversio. Jos et määritä versiota, julkaistu versio on valittuna. |
| poll-status | Tarkista pyyntösi tila. |
lähetä
Luettele kaikki kulloisenkin Dataverse-ympäristön (organisaation) julkaistut luettelokohteet.
| Parametri | Kuvaus |
|---|---|
| polku | (Pakollinen) Luettelon lähetysasiakirjan polku. |
| package-zip | Polku paketin zip-tiedostoon. |
| solution-zip | Ratkaisun zip-tiedoston polku. |
| poll-status | Tarkista pyyntösi tila. |
tila
Hanki katalogin asennuksen tila tai lähetä pyyntö.
| Parametri | Kuvaus |
|---|---|
| tracking-id | (Pakollinen) Pyynnön seurantatunnus. |
| tyyppi | (Pakollinen) Pyynnön tyyppi. Kelvollisia arvoja ovat: Install ja Submit. |
GitHub-työnkulun laatiminen
Jos haluat lisätietoja GitHub-työnkulkujen luomisesta GitHub Actionsin avulla, suorita GitHub Actions for Microsoft Power Platform -laboratoriot.
Lisätietoja on artikkelissa Tietoja GitHub Actions.