Посібник: автоматизація розгортання рішень за допомогою справ GitHub для Microsoft Power Platform

У цьому посібнику ви дізнаєтеся, як:

  • створювати нові репозиторії GitHub;
  • створювати два робочі процеси GitHub за допомогою дій GitHub для Microsoft Power Platform

Робочі процеси можуть автоматично експортувати вашу програму (як некероване рішення) з середовища розгортання, створити артефакт створення (кероване рішення) і розгорнути програму у ваше виробниче середовище. У цьому посібнику використовується створене вами рішення ALMLab і середовища, які ви встановили в попередньому посібнику.

Пов'язані посібники: Початок роботи і Створення модельної програми.

Створення облікового запису GitHub

  1. Перейдіть до https://github.com і натисніть Реєстрація або Розпочати роботу з ознайомлювальною версією (або ввійдіть у систему, якщо ви вже маєте обліковий запис).

    Створення облікового запису

  2. Після створення облікового запису створіть репозиторій, натиснувши Створити репозиторій або Створити.

    Створення репозиторію

    Ви можете бачити такий альтернативний екран

    Створення нового репозиторію

  3. Створіть свій новий репозиторій і назвіть його "poweractionslab". Переконайтеся, що ви вибрали Додати файл README, щоб запустити репозиторій і виберіть Створити репозиторій.

    Ініціюйте репозиторій.

Створення нового секрету для автентифікації принципала служби

  1. Перейдіть до свого сховища та натисніть Налаштування, потім розгорніть Секрети, а потім натисніть Дії.

  2. На сторінці «Секрети » назвіть секрет «PowerPlatformSPN». Використовуйте секрет клієнта з реєстрації програми, створеної в Microsoft Entra ньому, і введіть його в поле Value , а потім виберіть Додати секрет. На цей секрет клієнта надаватимуться посилання у файлах YML, що пізніше використовуватимуться для визначення робочих циклів GitHub у цьому практичному посібнику.

    Створіть секрет принципала служби

    Тепер секрет клієнта надійно збережено як секрет GitHub.

Створення робочого циклу для експорту та розпакування файлу рішення до нового відгалуження

  1. клацніть Дії, далі клацніть Настроїти робочий цикл самостійно або клацніть «Настроїти» у полі Простий робочий цикл у розділі пропозиції для цього репозиторію.

    Налаштування робочого процесу.

  2. Буде створено новий файл YAML з основним робочим циклом — так вам буде простіше розпочати роботу з діями GitHub.

    Приклад файлу YML

  3. Видаліть попередньо створений вміст, вставте вміст із файлу export-and-branch-solution-with-spn-auth.yml , а потім перейменуйте файл на «export-and-branch-solution».yml.

    Перейменовуйте та замінюйте вміст.

  4. Змініть <ENVIRONMENTURL>, вказавши URL-адресу для середовища розгортання, з якого потрібно здійснити експорт (наприклад: https://poweractionsdev.crm.dynamics.com).

  5. Оновіть <APPID> і <TENANT ID>, вказавши ваші значення.

    • Якщо ви використовуєте облікові дані, вставте файл export-and-branch-solution.yml замість вмісту файлу export-and-branch-solution-with-spn-auth.yml . Оновіть <USERNAME> з іменем користувача, яке використовується для підключення до середовища.

      Перейменування та заміна вмісту

    Порада

    Якщо ви не знайомі з діями GitHub і хочете дізнатися більше, зверніться до офіційної документації: https://docs.github.com/en/actions.

  6. Тепер ви готові підтвердити свої зміни. Натисніть Розпочати підтвердження, введіть Створити експорт yml у поле назви й додайте опис (необов'язково). Потім натисніть Підтвердити новий файл.

    Почніть робити коміт.

Вітаємо, ви щойно створили свій перший робочий цикл GitHub за допомогою таких дій.

  • Хто я: гарантує, що ви можете успішно підключитися до середовища, з якого експортуєте.
  • Експортувати рішення: експортує файл рішення з вашого середовища розробки.
  • Рішення для розпакування: файл рішення, який експортується з сервера, є стисненим (zip) файлом із консолідованими файлами конфігурації. Ці дані не підходять для керування вихідним кодом, оскільки вони не структуровані, щоб системи керування вихідним кодом могли правильно виконувати розрізнення файлів і фіксувати зміни, які ви хочете підтвердити в системі керування версіями. Вам потрібно «розпакувати» файли рішення, щоб зробити їх придатними для зберігання та обробки систем керування версіями.
  • Рішення для гілок: створює нову гілку для зберігання експортованого рішення.

Перевірте робочий цикл експорту і розпакування

  1. Потім перевірте, чи запустився робочий цикл. Перейдіть до менюДії, Запустити робочий цикл і натисніть Запустити робочий цикл. Якщо ім'я вашого рішення відрізняється від «ALMLab», змініть тут це значення, але залиште інші значення незмінними.

    Запустіть робочий процес.

  2. Робочий цикл запуститься впродовж 5–10 секунд і ви можете вибрати запущений робочий цикл для відстеження прогресу.

    Натисніть, щоб переглянути робочий процес.

    Виберіть і перегляньте робочий процес.

  3. Після завершення робочого циклу перевірте, щоб було створене нове відгалуження з розпакованим рішенням у папку рішень/ALMLab. Перейдіть на вкладку Код і розгорніть випадаюче меню гілок.

  4. Виберіть відгалуження, що було створене дією.

  5. Переконайтеся, що папка рішень/ALMLab була створена в новому відгалуженні і потім створіть запит на внесення змін, щоб виконати злиття змін у головне відгалуження. Натисніть Зробити внесок і у випадаючому вікні натисніть Відкрити запит на Пул.

  6. На екрані Відкрити запит на внесення змін додайте заголовок і назву на власний розсуд, потім клацніть Створити запит на внесення змін

  7. На екрані з'явиться новостворений запит на внесення змін. Коли запит на внесення змін буде створено, ви побачите підтвердження того, що в нашому відгалуженні немає конфліктів з основним відгалуженням. Це підтвердження означає, що зміни можна автоматично злити з основним відгалуженням. Натисніть Запит на злиття , а потім натисніть Підтвердити злиття. Також можна натиснути «Видалити відгалуження», щоб очистити відгалуження, що стало непотрібним.

    Перегляд відгалужень

  8. Поверніться до стандартного (основного) відгалуження й переконайтеся, що рішення тепер доступне й там.

Створіть робочий цикл для повторного використання, щоб створити артефакт збірки й імпортувати його у робоче середовище.

У цьому розділі ми будемо створювати додатковий робочий цикл, що:

  • створює кероване рішення та публікує його як артефакт GitHub;
  • імпортує артефакт створення в виробниче середовище.

  1. Перейдіть до меню Дії й натисніть Новий робочий цикл.

    Створіть новий робочий процес.

  2. Виберіть налаштувати робочий цикл самостійно.

    Налаштуйте робочий процес.

  3. Перейменуйте назву робочого процесу на «release-solution-to-prod-with-inputs» і скопіюйте вміст із файлу release-solution-to-prod-with-inputs.yml та вставте його на екран «Редагувати новий файл ».

    Перейменуйте та вставте код.

  4. Підтвердіть зміни. Натисніть Розпочати підтвердження, додайте назву й опис (необов'язково). Потім натисніть Підтвердити новий файл.

    Внесіть зміни.

Виклик робочого циклу для повторного використання при виникненні події випуску

У цьому розділі буде викликано робочий цикл для повторного використання при настанні події випуску.

  1. Перейдіть до меню Дії й натисніть Новий робочий цикл.

    Створіть новий робочий процес.

  2. Виберіть налаштувати робочий цикл самостійно.

    Налаштуйте робочий процес.

  3. Перейменуйте назву робочого процесу на «release-action-call» і скопіюйте вміст із файлу release-action-call.yml та вставте його на екран «Редагувати новий файл ».

    Перейменуйте та вставте код.

  4. Оновіть наведені нижче змінні в новому файлі робочого циклу.

    • Оновіть <BUILD_ENVIRONMENT> з URL-адресою для середовища створення, що використовується для створення керованого рішення. Наприклад: https://poweractionsbuild.crm.dynamics.com.
    • Оновіть <PROD_ENVIRONMENT> з URL-адресою для виробничого середовища, до якого здійснюється розгортання. Наприклад: https://poweractionsprod.crm.dynamics.com.
    • Оновіть <APP_ID>, вказавши Ідентифікатор програми (клієнта), який можна знайти в зрізі Реєстрації програм порталу Microsoft Azure, натиснувши на реєстрацію, створену раніше в цьому посібнику.
    • Оновіть <TENANT_ID>, вказавши Ідентифікатор каталогу (клієнта), який можна знайти в зрізі Реєстрації програм порталу Microsoft Azure, натиснувши на реєстрацію, створену раніше в цьому посібнику.

  5. Підтвердіть зміни. Натисніть Розпочати підтвердження, додайте назву (необов'язково) й опис (необов'язково). Потім натисніть Підтвердити новий файл.

    Внесіть зміни.

Перевірте випуск робочого циклу виробництва

Тепер ви готові до тестування останнього робочого циклу. Цей робочий цикл запускається, коли новий випуск розгортається у виробництво.

  1. Перейдіть до Випусків.

    Перейдіть до випусків.

  2. Натисніть Створити чернетку нового випуску.

  3. Додайте тег і назву випуску й натисніть Публікування випуску.

  4. Натисніть Дії, щоб переглянути запущений робочий цикл.

    Натисніть, щоб переглянути робочий процес.

  5. Виберіть запущений робочий цикл, щоб переглядати дії в порядку виконання.

    Перегляд робочого процесу.

  6. Зачекайте на завершення кожної дії.

    Переглянути гілку.

  7. Після завершення робочого циклу увійдіть у виробниче середовище й переконайтеся, що рішення було розгорнуте як кероване рішення.

Перед створенням випуску для виробництва розгорніть оновлення й перегляньте зміни

Тепер ми протестуємо процес від початку до кінця і потім побачимо, як можна переглядати та перевіряти зміни до програми перед її розгортанням для виробництва.

  1. Перейдіть до рішення ALMLab у середовища розгортання й натисніть Редагувати, або клацніть коротке ім'я рішення.

    Відредагувати рішення.

  2. Виберіть і перегляньте таблицю Запит на вільний час.

    Переглянути таблицю.

  3. Клацніть+ Додати стовпець і створіть новий стовпець, як показано на малюнку нижче.

    Додати стовпець.

    Оновлені значення полів:**

    • Відображуване ім’я: Затверджено
    • Тип даних: Так/Ні

  4. Натисніть Готово.

  5. Натисніть Зберегти таблицюДодати стовпець.

  6. Поверніться до репозиторіїв GitHub, на вкладку Дії, виберіть пункт Запустити робочий цикл і натисніть кнопку Запустити робочий цикл.

    Запустіть робочий процес.

  7. Робочий цикл запуститься впродовж 5–10 секунд і ви можете вибрати запущений робочий цикл для відстеження прогресу.

    Виберіть робочий процес.

    Перегляд робочого процесу.

  8. Після завершення робочого циклу перейдіть до нового відгалуження, натиснувши Код і Відгалуження.

    Перейдіть до гілки.

  9. Виберіть створене відгалуження, розгорнувши зробити внесок, і клацніть Відкрити запит на внесення змін.

  10. Додайте назву (необов'язково) й клацніть Створити запит на внесення змін.

  11. Після оновлення вмісту перейдіть на вкладку Змінені файли.

  12. Зверніть увагу, що зміни в рішенні виділені зеленим кольором, щоб вказати, що цей розділ біло додано, порівняно з тим самим файлом у головному відгалуженні.

  13. Поверніться на вкладку Розмова. ВиберітьЗапити на внесення змін і натисніть попередній створений запит на внесення змін.

  14. На сторінці Запит на внесення змін натисніть Стискання та злиття , щоб виконати злиття файлів оновленого рішення у головне відгалуження, і, за бажання, видаліть вміст, що було злито до основного відгалуження.

    Відкрийте запит на злиття для нової гілки, перегляньте зміни та об’єднайте з гілкою за замовчуванням

  15. Виконуйте кроки наведені в розділі Тестування та випуск до виробничого середовища, щоб створити новий випуск і переконатися, що оновлене рішення було розгорнуто до вашого середовища виробництва.

Вітаємо, ви щойно створили свій перший робочий цикл CI/CD за допомогою дій GitHub!

Див. також

Автоматизуйте робочий процес від ідеї до виробництва

  • Last updated on