Microsoft Power Platform ‑kehittämistä varten käytettävissä olevat GitHub-toiminnot
GitHub-toiminnot Microsoft Power Platform on kuvattu seuraavissa osissa. Lisäksi esillä on GitHub-esimerkkityönkulkuja. Lisätietoja GitHub-toiminnoista ja niiden lataamisesta on kohdassa Microsoft Power Platformin GitHub-toiminnot,
Tunnistetietojen määrittäminen Microsoft Power Platformin GitHub-toimintoja varten
Monet toiminnot edellyttävät yhteyden muodostamista Microsoft Dataverse -ympäristöön. Palveluobjekti tai käyttäjän tunnistetiedot voivat lisätä salaisuuksina GitHub-säilöön, jonka jälkeen niitä voi käytätä työnkuluissa.
Lisätietoja salaisuuksien määrittämisestä GitHubissa on kohdassa Salatut salaisuudet
Lisätietoja Microsoft Power Platformin palveluobjektin todentamisen määrittämisestä on kohdassa DevOps-koontityökalut
Määrityksen jälkeen palveluobjekti voidaan kutsua toimintokomentosarjoissa.
GitHubin toimintokomentosarjoissa ympäristömuuttujina määritettävät parametrit:
- Sovellustunnus, kuten
WF_APPLICATION_ID:<your application id> - Vuokraajan tunnus, kuten
WF_TENANT_ID:<your tenant id>
Asiakasohjelman salasana on lisättävä ja tallennettava GitHub-salaisuutena, ja siihen viitataan työnkulussa parametrilla, kuten client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Avustajatehtävät
Käytettävissä olevat avustajatehtävä käsitellään seuraavaksi.
actions-install
Jos GitHub Actions -työnkulku pakottaa Power Platform CLI:n asennuksen suoritinkontekstissa ja aikakatkaisuvirhe esiintyy, on käytettävä versiota 1 (@v1) ja lisätoimintoa (actions-install), kuten alla.
Tärkeää
- Version 1 (@v1) käyttäminen voi johtaa aiemmin luotujen GitHub-toimintojen päivitykseen, jonka vuoksi nykyiset työnkulut päivitetään.
- Asenna Power Platform Tools -tehtävä on lisättävä työnkulun ensimmäiseksi tehtäväksi ennen mitään muuta Power Platformin GitHub Actions -toimintoa.
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'
Lisää GitHub Actions -esimerkkejä on Power Platform -toiminnoissa.
whoAmI
Tarkistaa palveluyhteyden muodostamalla yhteyden palveluun ja lähettämällä WhoAmI [SDK/Web API] -pyynnön. Tämä tehtävä voi olla hyvä sisällyttää aikaisessa vaiheessa GitHub-työnkulkuun tarkistamaan yhteys ennen käsittelyn alkamista.
| 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 | Käyttäjänimen salasana. GitHub-salasanat määritetään Salasanat-kohdan Asetukset-kohdassa. Salaisuutta ei voi noutaa sen jälkeen, kun se on määritetty ja tallennettu. |
| 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ä asiakasohjelman salasana. 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. |
Ratkaisutehtävät
Nämä tehtävät suorittavat ratkaisuille 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ä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ä asiakasohjelman salasana. 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. |
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änimen ja salasanan todennusta, käyttäjänimen salasana. GitHub-salasanat määritetään Salasanat-kohdan Asetukset-kohdassa. Salaisuutta ei voi noutaa sen jälkeen, kun se on määritetty ja tallennettu. |
| 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ä asiakasohjelman salasana. 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 parametria nimi eikä näyttönimi. |
| solution-output-file | (Pakollinen) Sen ratkaisu.zip-tiedoston polku ja nimi, johon lähdeympäristö viedään. |
| managed | (Pakollinen) Aseta arvoksi tosi viedäksesi hallittuna ratkaisuna; oletusarvoinen (epätosi) on viedä hallitsemattomana ratkaisuna. |
unpack-solution
Vie pakatun ratkaisun tiedoston ja purkaa sen useisiin XML-tiedostoihin, jotta lähteenhallintajärjestelmä pystyy helpommin lukemaan ja hallitsemaan kyseisiä tiedostoja.
| 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) Purettavan ratkaisun tyyppi. Vaihtoehtoja ovat Hallitsematon (suositeltava), Hallittu ja Molemmat. |
pack-solution
Pakkaa lähteenhallinnan ratkaisun solution.zip-tiedostoon, joka voidaan tuoda toiseen ympäristöön.
| Parametri | Kuvaus |
|---|---|
| solution-file | (Pakollinen) Sen solution.zip-tiedoston polku ja tiedostonimi, jonne ratkaisu pakataan (esimerkiksi out/CI/ALMLab.zip). |
| solution-folder | (Pakollinen) Pakattavan ratkaisun polku ja lähdekansio. |
| solution-type | (Valinnainen) Pakattavan ratkaisun tyyppi. Vaihtoehtoja ovat Hallitsematon (suositeltava), Hallittu 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ä asiakasohjelman salasana. 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. |
clone-solution
Kloonaa tietyn ympäristön ratkaisun.
| 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. |
| 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ä asiakasohjelman salasana. 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) Kloonaamiseen tarvittavan ratkaisu.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
Etsi epäjohdonmukaisuuksia tarkistamalla ratkaisutiedoston.
| 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. |
| 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 palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakasohjelman salasana. 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. |
| path | (Pakollinen) Tarkistettavan ratkaisutiedoston polku ja nimi. |
| geo | Käytettävä Microsoft Power Platform -tarkistuspalvelun maantieteellinen sijainti Oletusarvo on 'united states'. |
| rule-level-override | Polku JSON-sääntömatriisin ja niiden tasot sisältävään tiedostoon. Hyväksytyt arvot: Critical, High, Low ja Informational. 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
Antaa mahdollisuuden ratkaisun päivittämiseen.
| 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. |
| 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ä asiakasohjelman salasana. 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) Päivitettävän ratkaisun nimi. |
| async | Päivittää ratkaisun asynkronisesti. |
| max-async-wait-time | Pisin asynkroninen odotusaika minuutteina. Oletusarvo on 60 minuuttia. |
Paketointitehtävät
Seuraavat tehtävät koskevat paketteja.
deploy-package
Antaa mahdollisuuden ottaa käyttöön paketin dll- tai zip-tiedoston paketin mukana.
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. |
| 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 palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakasohjelman salasana. 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. |
| package | (Pakollinen) Pakettiin sisältyvän paketin dll- tai zip-tiedoston polku. |
Portaalin tehtävät
Nämä tehtävät suorittavat seuraavat toiminnot Power Pages -sivustoille.
upload-paportal
Lataa 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 palveluobjektin tunnistetietoja. |
| client-secret | GitHub-putken todentamiseen käytettävä asiakasohjelman salasana. 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. |
| upload-path | Polku, johon sivuston sisältö on tallennettu (alias: -p). |
| deployment-profile | Lataa portaalin tiedot sekä ympäristön tiedot, jotka on määritetty profiilimuuttujien deployment-profiles/[profile-name].deployment.yaml-tiedostossa. |
| malli-versio | Ilmaisee, käytetäänkö ladattavissa sivustotiedoissa vakiomuotoista (1) vai parannettua tietomallia (2). Oletusarvo on 1. |
Lue lisää Microsoft Power Platform CLI:n Power Pages -tuesta.
Hakemistotehtävät (esiversio)
Nämä tehtävät suorittavat hakemistolle toimintoja Power Platformissa ja sisältävät seuraavat asiat.
Muistiinpano
Tällä hetkellä Power Platformin hakemistotehtävät ovat esiversio-julkaisu.
asenna
Asenna Catalog-nimike kohdeympäristöön.
| Parametri | Kuvaus |
|---|---|
| catalog-item-id | (Pakollinen) Kohdeympäristöön asennettava hakemistokohde. |
| target-url | (Pakollinen) Hakemistokohteen asennuksen kohdeympäristön URL-osoite (kuten https://YourOrg.crm.dynamics.com"). |
| asetukset | (Pakollinen) Suoritettavan asennuskehyksen suoritusaikaisen paketin asetukset. Merkkijonon muodon on oltava key=value|key=value. |
| target-version | Asennettava kohdeversio. Jos tämä jätetään tyhjäksi, valitaan julkaistu versio. |
| poll-status | Kysely pyynnön tilan tarkastamista varten. |
lähetä
Tekee luettelon kaikista kulloisenkin Dataverse-ympäristön (organisaatio) julkaisuista hakemistokohteista.
| Parametri | Kuvaus |
|---|---|
| path | (Pakollinen) Hakemiston lähetysasiakirjan polku. |
| package-zip | Paketin zip-tiedoston polku. |
| solution-zip | Ratkaisun zip-tiedoston polku. |
| poll-status | Kysely pyynnön tilan tarkistamiseksi. |
tila
Hae Catalogin asennus-/lähetyspyynnön tila.
| Parametri | Kuvaus |
|---|---|
| tracking-id | (Pakollinen) Pyynnön seurantatunnus. |
| type | (Required) Pyyntötyyppi (Arvot: Asenna, Lähetä) |
GitHub-työnkulun laatiminen
Lisätietoja GitHub-työnkulkujen laatimisesta GitHub-toiminnoilla saa suorittamalla Microsoft Power Platformin GitHub-toimintoja testiympäristössä.
Lisätietoja: Tietoja GitHub-toiminnoista.