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

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

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

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

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

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

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

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

  2. Створивши обліковий запис, створіть сховище, вибравши створити сховище або Створити.

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

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

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

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

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

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

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

  2. На сторінці Секрети назвіть секрет PowerPlatformSPN. Введіть секрет клієнта з реєстрації програми, створеної в Microsoft Entra, у поле Значення, а потім натисніть кнопку Додати секрет. Ви будете посилатися на секрет клієнта у файлах 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 Actions і хочете дізнатися більше, перегляньте офіційну документацію на веб-сайті https://docs.github.com/en/actions.

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

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

Вітаємо, ви створили свій перший робочий цикл GitHub, виконавши такі дії:

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

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

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

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

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

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

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

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

  4. Виберіть гілку, яку створила дія.

  5. Переконайтеся, що папку solutions/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> ідентифікатор програми (клієнта), який ви знайдете в App registrations лопаті Azure Portal Microsoft, вибравши реєстрацію, створену раніше в цьому посібнику.
    • Оновіть <TENANT_ID> ідентифікатор каталогу (клієнта), знайдений у App registrations лопаті Azure Portal Microsoft, вибравши реєстрацію, створену раніше в цьому посібнику.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. Виберіть Save Table. Додати стовпець.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Див. також

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

  • Востаннє оновлено: