Нотатка
Доступ до цієї сторінки потребує авторизації. Можна спробувати ввійти або змінити каталоги.
Доступ до цієї сторінки потребує авторизації. Можна спробувати змінити каталоги.
У наведених нижче розділах описано GitHub Actions для Microsoft Power Platform. У розділах також відображаються зразки робочих циклів GitHub. Докладні відомості про GitHub Actions та способи їх завантаження див. в статті GitHub Actions для Microsoft Power Platform.
Налаштуйте облікові данні для використання зі справами GitHub з Microsoft Power Platform
Для багатьох справ потрібно, щоб ви підключилися до середовища Microsoft Dataverse. Додавайте облікові дані учасника служби або користувача як секрети в сховищі GitHub, а потім використовуйте їх у своїх робочих циклах.
Докладні відомості про те, як налаштувати секрети в GitHub, див. в статті Зашифровані секрети.
Докладні відомості про те, як налаштувати автентифікацію основної служби для Microsoft Power Platform, див. в статті Засоби збирання DevOps.
Після настроювання облікових даних ви можете викликати учасника служби в сценаріях дії.
Визначте такі параметри для сценарію дій GitHub як змінні середовища:
- Ідентифікатор програми, наприклад:
WF_APPLICATION_ID:<your application id> - Ідентифікатор клієнта, наприклад:
WF_TENANT_ID:<your tenant id>
Додайте секрет клієнта як GitHub секрет. Посилання на нього в робочому циклі за допомогою параметра, наприклад: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Завдання помічника
Доступне наступне допоміжне завдання.
дії-встановити
Коли робочий цикл GitHub Actions змушує інсталювати CLI Power Platform у контексті бігуна, а також стається помилка часу очікування, використовуйте версію 1 (@v1) з додатковою дією (actions-install), як показано в наведеному нижче прикладі.
Важливо
- Використання версії 1 (@v1) може призвести до оновлення існуючих дій GitHub, що може призвести до оновлення поточних робочих процесів.
- Додайте завдання Інсталювати інструменти Power Platform як перше завдання в робочому циклі перед будь-якою іншою GitHub Actions платформи 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 Actions див. в статті Дії Power Platform.
whoAmI
Перевіряє підключення до послуги способом з’єднання з послугою та надсилання запиту пакету SDK WhoAmI [далі – «пакет SDK»/Web API]. Це завдання може бути корисно включити на початку робочого циклу GitHub, щоб перевірити підключення перед початком обробки.
| Параметр | Опис |
|---|---|
| environment-url | URL-адреса середовища, до якого ви підключаєтесь. |
| user-name | Ім'я користувача облікового запису, що використовується для підключення. |
| password-secret | Пароль для імені користувача. Визначте GitHub паролі в розділі "Настройки"в розділі "Секрети". Ви не можете отримати таємницю після визначення та збереження. |
| app-id | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
Завдання рішення
Ці завдання виконують дії з рішеннями і містять таке.
import-solution
Імпортує рішення до цільового середовища.
| Параметр | Опис |
|---|---|
| environment-url | (Обов'язково) URL-адреса для цільового середовища, до якого потрібно імпортувати рішення (наприклад, https://YourOrg.crm.dynamics.com). |
| user-name | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, ім'я користувача облікового запису, з яким ви підключаєтесь.. |
| password-secret | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, пароль від облікового запису, з яким ви підключаєтесь. |
| solution-file | (Обов’язково) Шлях та ім'я файлу рішення, який ви бажаєте імпортувати. |
| app-id | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| 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 | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
| solution-name | (Обов'язково) Назва рішення, яке необхідно експортувати. Завжди використовуйте Ім’я рішення, а не його Коротке ім’я. |
| solution-output-file | (Обов’язково) Шлях та ім’я файлу solution.zip, до якого передбачається експортувати вихідне середовище. |
| керовані | (Обов'язково) Установіть значення true, щоб експортувати як кероване рішення; за замовчуванням (false) експортується як некероване рішення. |
unpack-solution
Бере стиснутий файл рішення та розпакує його в кілька XML-файлів. Ці файли можна легко читати та керувати ними в системі керування вихідним кодом.
| Параметр | Опис |
|---|---|
| solution-file | (Обов'язково) Ім’я шляху та ZIP-файлу рішення, яке потрібно розпакувати. |
| solution-folder | (Обов'язково) Шлях і цільова папка, де потрібно розпакувати рішення. |
| solution-type | (Обов'язково) Тип рішення, яке потрібно розпакувати. Параметри включають: Некероване (рекомендовано), Кероване і Обидва. |
pack-solution
Пакує рішення, представлене у вихідному елементі керування, у файл solution.zip, який можна імпортувати до іншого середовища.
| Параметр | Опис |
|---|---|
| solution-file | (Обов'язково) Шлях та ім'я файлу solution.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 | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
clone-solution
Клонує рішення для певного середовища.
| Параметр | Опис |
|---|---|
| environment-url | (Обов'язково) URL-адреса для середовища, з якого потрібно клонувати рішення (наприклад, https://YourOrg.crm.dynamics.com). |
| user-name | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, ім'я користувача облікового запису, з яким ви підключаєтесь.. |
| password-secret | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, пароль від облікового запису, з яким ви підключаєтесь. |
| solution-file | (Обов’язково) Шлях та ім'я файлу рішення, який ви бажаєте імпортувати. |
| app-id | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| 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 | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
| шлях | (Обов’язково) Шлях та ім'я файлу рішення, який ви бажаєте перевірити. |
| географічне розташування | Це географічне розташування служби перевірки Microsoft Power Platform, яку передбачається використовувати. За промовчанням використовується значення «сполучені штати». |
| rule-level-override | Шлях до файлу, який містить масив правил JSON і їхні рівні. Прийняті значення наведено далі: критичне, високе, низьке та інформаційне. Приклад: [{ «Id»:«meta-remove-dup-reg», «OverrideLevel»: «Середній», }{ «Id»:«il-avoid-update-ops», «OverrideLevel»: «Середній» }] |
| 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 | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
| solution-name | (Обов'язково) Ім’я рішення для оновлення. |
| асинхронний | Оновлює рішення асинхронно. |
| max-async-wait-time | Максимальний асинхронний час очікування в хвилинах. Значенням за промовчанням є 60 хвилин. |
Завдання пакета
Ці завдання виконують дії з пакетами.
deploy-package
Розгортає бібліотеку DLL пакета або ZIP-файл із пакетом.
Нотатка
Ця дія підтримується лише для Windows.
| Параметр | Опис |
|---|---|
| environment-url | (Обов'язково) URL-адреса для середовища, з якого потрібно клонувати рішення (наприклад, https://YourOrg.crm.dynamics.com). |
| user-name | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, ім'я користувача облікового запису, з яким ви підключаєтесь.. |
| password-secret | (Обов'язково) Якщо ви використовуєте автентифікацію за іменем і паролем користувача, пароль від облікового запису, з яким ви підключаєтесь. |
| app-id | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
| пакет | (Обов'язково) Шлях до пакета DLL або ZIP-файлу з пакетом. |
Завдання порталу
Ці завдання виконують наведені нижче дії з Power Pages.
upload-paportal
Передає дані до Power Pages.
| Параметр | Опис |
|---|---|
| environment-url | (Обов’язково) URL-адреса середовища, до якого потрібно імпортувати рішення (наприклад, https://YourOrg.crm.dynamics.com). |
| app-id | Ідентифікатор програми для автентифікації. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| client-secret | Секрет клієнта, який використовується для автентифікації воронки продажів GitHub. Це параметр обов’язково при перевірці облікових даних Принципала служби. |
| tenant-id | Це ідентифікатор клієнта під час автентифікації за допомогою app-id та client-secret. |
| upload-path | Шлях, за яким буде збережено вміст (alias: -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-файлу рішення. |
| Статус опитування | Проведіть опитування, щоб перевірити статус вашого запиту. |
status
Отримати стан запиту на інсталяцію або надсилання каталогу.
| Параметр | Опис |
|---|---|
| Ідентифікатор відстеження | (Вимагається) Запросити ідентифікатор відстеження. |
| тип | (Обов'язково) Тип запиту. Припустимі значення Install та Submit. |
Створення робочих циклів GitHub
Щоб дізнатися більше про створення робочих циклів GitHub за допомогою GitHub Actions, заповніть GitHub Actions для лабораторій Microsoft Power Platform.
Докладні відомості див. в статті Про GitHub Actions.