Налични действия на GitHub за разработка на Microsoft Power Platform
Действията на GitHub за Microsoft Power Platform са описани в следващите раздели. Освен това са показани и примерни работни потоци на GitHub. За повече информация относно действия на GitHub и как да ги изтеглите, отидете на Действия на GitHub за Microsoft Power Platform.
Конфигурирайте идентификационни данни, които да се използват с GitHub Действия с Microsoft Power Platform
Много от действията изискват да се свържете със среда на Microsoft Dataverse. Можете да добавите пълномощници на услуги или потребителски идентификационни данни като тайни във вашето хранилище на GitHub и след това да ги използвате в работните си процеси.
За подробности как да настроите тайни в GitHub, вижте Шифровани тайни
За подробности как да настроите удостоверяване на главницата на услугата за Microsoft Power Platform, вижте Инструменти за изграждане на DevOps
След като бъде конфигуриран, можете да се обадите на Директора на услугата от скриптовете за действие.
Параметри, които да дефинирате във вашия GitHub Action Script като Променливи на среда:
- ИД на приложение, като:
WF_APPLICATION_ID:<your application id> - ИД на клиент, като:
WF_TENANT_ID:<your tenant id>
Клиентската тайна трябва да бъде добавена и съхранена като GitHub Secret и ще бъде препращана от работния поток с помощта на параметър като: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Задачи за помощник
Наличната помощна задача е описана по-долу.
действия-инсталиране
Когато работен поток на GitHub Actions принудително инсталира CLI Power Platform в контекста на изпълняващ и възникне грешка при изчакване, тогава трябва да използвате версия 1 (@v1) с допълнително действие (actions-install), както е показано по-долу.
Важно
- Използването на версия 1 (@v1) може да доведе до актуализации на съществуващи действия в GitHub, които могат да доведат до актуализиране на текущите работни потоци.
- Трябва да добавите задачата Инструменти Power Platform за инсталиране като първа задача във вашия работен поток преди всички други действия на GitHub за. 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 в Power Platform Actions.
whoAmI
Проверява връзката на услугата, като се свързва с услугата и изпраща WhoAmI [SDK/Уеб API] заявка. Тази задача може да бъде полезна за включване в началото на работния процес на GitHub, за да се провери свързаността преди започване на обработката.
| Параметър | Описание |
|---|---|
| environment-url | URL адресът за средата, към която се свързвате. |
| user-name | Потребителското име на акаунта, с който се свързвате. |
| password-secret | Паролата за user-name. Паролите за GitHub са дефинирани в Настройки под Тайни. Не можете да извлечете тайна, след като тя е била дефинирана и запазена. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
Задачи на решение
Тези задачи изпълняват действия срещу решения и включват следното.
import-solution
Импортира решение в целева среда.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за целевата среда, в която искате да импортирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| solution-file | (Задължително) Пътят и името на файла с решение, който искате да импортирате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
export-solution
Експортира решение от източник среда.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за средата, от която искате да експортирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата за user-name. Паролите за GitHub са дефинирани в Настройки под Тайни. Не можете да извлечете тайна, след като тя е била дефинирана и запазена. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| solution-name | (Задължително) Името на решението, което ще се експортира. Винаги използвайте име, а не показвано име на решенията. |
| solution-output-file | (Задължително) Пътят и името на файла solution.zip за експортиране в изходната среда. |
| managed | (Задължително) Задайте на true, за да експортирате като завършено решение; по подразбиране (false) е да се експортира като незавършено решение. |
unpack-solution
Взема компресиран файл с решение и го разлага на множество XML файлове и други файлове, така че тези файлове да бъдат по-лесно четени и управлявани от система за контрол на източника.
| Параметър | Описание |
|---|---|
| solution-file | (Задължително) Пътят и името на файла на solution.zip файла за разопаковане. |
| solution-folder | (Задължително) Пътят и целевата папка, в която искате да разопаковате решението. |
| solution-type | (Задължително) Типът решение, което искате да разопаковате. Опциите включват Незавършено (препоръчително), Завършено и И двете. |
pack-solution
Пакетирайте решение, представено в контрола на източника, във файл solution.zip, който може да бъде импортиран в друга среда.
| Параметър | Описание |
|---|---|
| solution-file | (Задължително) Пътят и името на файла на .zip файла на решението, в който се пакетира решението (например out/CI/ALMLab.zip). |
| solution-folder | (Задължително) Пътят и изходната папка на решението за опаковане. |
| solution-type | (По избор) Типът решение за пакетиране. Опциите включват Незавършено (препоръчително), Завършено и И двете. |
publish-solution
Публикува персонализации на решението.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за среда, в която искате да публикувате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| solution-file | (Задължително) Пътят и името на файла с решение, който искате да импортирате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
clone-solution
Клонира решението за дадена среда.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за средата, от която искате да клонирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| solution-file | (Задължително) Пътят и името на файла с решение, който искате да импортирате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| solution-name | (Задължително) Пътят и името на файла solution.zip, необходим за клониране (например out / CI / ALMLab.zip). |
| solution-version | Версията на решението за клониране. |
| target-folder | Целева папка, в която да поставите извлечения разтвор. (например Git хранилище\target-solution-folder). |
| Working-directory | Временна папка за незавършени артефакти, необходими за клониране на решението. по подразбиране: root of the repository |
check-solution
Проверява файла с решение, за да открие несъответствия.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за средата, от която искате да клонирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| път | (Задължително) Пътят и името на файла с решение, който искате да проверите. |
| geo | Кое геоместоположение на услугата за инструмент за проверка на Microsoft Power Platform да се използва. Стойността по подразбиране е „САЩ“. |
| rule-level-override | Път към файл, съдържащ JSON набор от правила и техните нива. Приетите стойности са: Критично, Високо, Ниско и Информационно. Пример: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Името на папката с артефакти, за която Microsoft Power Platform регистрационните файлове за проверка ще бъдат качени. Стойността по подразбиране е 'CheckSolutionLogs'. |
upgrade-solution
Осигурява възможност за надграждане на решението.
| Параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за средата, от която искате да клонирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| solution-file | (Задължително) Пътят и името на файла с решение, който искате да импортирате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| solution-name | (Задължително) Име на решението за надстройка. |
| async | Надстройва решение асинхронно. |
| max-async-wait-time | Максимално време за асинхронно изчакване в минути. Стойността по подразбиране е 60 минути. |
Пакетни задачи
Тези задачи изпълняват действия срещу пакети и включват следното.
deploy-package
Осигурява възможност за разполагане на dll пакет или zip файл с пакет.
Бележка
Това действие се поддържа само в Windows.
| параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за средата, от която искате да клонирате решението (например https://YourOrg.crm.dynamics.com). |
| user-name | (Задължително) Ако използвате удостоверяване на потребителско име/парола, потребителското име на акаунта, с който се свързвате. |
| password-secret | (Задължително) Ако използвате удостоверяване на потребителско име/парола, паролата на акаунта, с който се свързвате. |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| package | (Задължително) Пътят към dll на пакет или zip файл с пакет. |
Задачи на портала
Тези задачи изпълняват следните действия срещу Power Pages.
upload-paportal
Качва данни в Power Pages.
| параметър | Описание |
|---|---|
| environment-url | (Задължително) URL адресът за среда, в която искате да импортирате решението (например https://YourOrg.crm.dynamics.com). |
| app-id | ИД на приложение за удостоверяване. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| client-secret | Клиентската тайна, използвана за удостоверяване на конвейера на GitHub. Този параметър е задължителен при удостоверяване с идентификационни данни на Principal Service. |
| tenant-id | Идентификаторът на клиента при удостоверяване с app-id и client-secret. |
| upload-path | Път, където ще се съхранява съдържанието на уеб сайта (псевдоним: -p). |
| deployment-profile | Качвайте данни от портала с подробности за средата, дефинирани чрез променливи на профила във файла deployment-profiles/[profile-name].deployment.yaml |
| модел-версия | Показва дали данните от сайта, които ще бъдат качени, ще използват стандартния (1) или подобрения модел на данни(2). Стойността по подразбиране е "1". |
Научете повече за Microsoft Power Platform поддръжката на CLI за. Power Pages
Каталожни задачи (преглед)
Тези задачи извършват действия спрямо каталога и Power Platform включват следното.
Бележка
В момента каталожните задачи за Power Platform са предварителен преглед.
Инсталиране
Инсталиране на елемент от каталога в целевата среда.
| параметър | Описание |
|---|---|
| каталожен идентификатор на елемента | (Задължително) Елемент от каталога, който трябва да бъде инсталиран в целевата среда. |
| target-url | (Задължително) URL адресът на целевата среда за инсталиране на каталожния елемент в (например "https://YourOrg.crm.dynamics.com"). |
| настройки | (Задължително) пакет за изпълнение по време на изпълнение за инсталационната рамка за изпълнение. Форматът на низа трябва да бъде key=value|key=value. |
| целева версия | Целева версия за инсталиране. Ако се остави празна, се избира публикуваната версия. |
| Статус на анкетата | Анкета, за да проверите статуса на заявката си. |
подаване
Избройте всички публикувани елементи от каталога от текущата Dataverse среда (организация).
| параметър | Описание |
|---|---|
| път | (Задължително) Път до документа за подаване на каталог. |
| Опаковка-цип | Път към zip файла на пакета. |
| Решение-цип | Път към zip файла на решението. |
| Статус на анкетата | Анкета, за да проверите статуса на заявката си. |
състояние
Получаване на състоянието на заявката за подаване/инсталиране за каталога.
| параметър | Описание |
|---|---|
| Проследяващ идентификатор | (Задължително) Идентификатор на заявката за проследяване. |
| тип | (Задължително) Тип заявка (Стойности: Инсталиране, Изпращане) |
GitHub създаване на работен процес
За да научите повече за съставянето на работни потоци в GitHub с помощта на GitHub действия, попълнете GitHub Действия за Microsoft Power Platform лаборатории.
Повече информация: Информация за действия на GitHub