Українська
Контрольна точка
Що має працювати
powershell
./Run.ps1 checkpowershell
git status --shortПорівняйте робочий процес з еталоном:
powershell
git diff --no-index .github/workflows/ci.yml D:\Work\Chatex-Reference\.github\workflows\ci.ymlКоманда нічого не виводить.
Типові помилки
Таблиця 22.2. Типові помилки безперервної інтеграції
| Симптом | Причина | Виправлення |
|---|---|---|
надсилання до main не запускає жодного запуску | ci.yml працює лише для запитів на злиття й надсилань до dev | працюйте в dev і зливайте в main через запит на злиття |
| вкладка Actions повідомляє, що файл робочого процесу недійсний | символ табуляції або хибний відступ у YAML | робіть відступи лише пробілами, порівняйте з лістингом |
error WHITESPACE: Fix whitespace formatting. на кроці Check formatting | код не відформатовано перед комітом | ./Run.ps1 format, коміт, надсилання |
Changes have been made to the model since the last migration. Add a new migration. | сутність або конфігурацію змінено без міграції | ./Run.ps1 migration <Name>, перевірте згенеровану міграцію, закомітьте її |
npm ci can only install packages when your package.json and package-lock.json are in sync | пакет додано до package.json вручну або файл блокування не закомічено | виконайте npm install у Source/Chatex.Web і закомітьте package-lock.json |
тести серверної частини локально падають із Docker is either not running or misconfigured | Docker Desktop не запущено | запустіть Docker; на виконавці Docker завжди доступний |
відновлення або збирання падає з NU1901–NU1904 без змін у коді | аудит NuGet знайшов нове повідомлення про вразливість для версії пакета, що використовується | оновіть цей пакет у Directory.Packages.props на гілці й дайте CI перевірити |
| Backend і Frontend не можна вибрати в наборі правил | перевірки ще ніколи не запускалися в цьому репозиторії | один раз надішліть до dev, потім змініть набір правил |
Питання для самоперевірки
- Яку проблему розв’язує безперервна інтеграція, чого не розв’язує підхід «усі запускають тести перед надсиланням»?
- Поясніть робочий процес, завдання, крок, виконавця й дію на прикладі
ci.yml. - Які три події запускають
ci.ymlі чому серед них немає надсилання доmain? - Чому робочий процес оголошує
permissions: contents: read? - Чого досягає група паралельності в
ci.ymlі чому виклик ізdeploy.ymlніколи не стикається зі звичайним запуском? - Чому завдання серверної частини збирає в Release і чому наступні кроки використовують
--no-restoreта--no-build? - Як
has-pending-model-changesвиявляє відсутню міграцію без бази даних? - Як тести серверної частини отримують PostgreSQL на виконавці і чому контейнер служби в робочому процесі не вибрано?
- Чому в CI
npm ci, а неnpm install? Що змінює--omit=devв аудиті? - Які перевірки можуть зробити збирання червоним без жодних змін у нашому коді і чому це бажано?
- Чому
./Run.ps1 checkіci.ymlмають містити ті самі кроки? Що буде, якщо вони розійдуться? - Що набір правил для
mainдодає до робочого процесу, який уже повідомляє червоне чи зелене?
Вправи
- Оновлення пакета з CI. На гілці від
devпідніміть версію одного тестового пакета (наприклад,Shouldly) уDirectory.Packages.props, запустіть./Run.ps1 check, надішліть гілку й відкрийте запит на злиття вdev. Прочитайте запуск і вирішіть, зливати його чи закрити. Так безпечно оновлюють залежності; сам посібник зберігає зафіксовані версії. - Звіт про тести. З’ясуйте, як Microsoft Testing Platform записує звіт TRX, зробіть так, щоб крок
Testйого створював, і зламайте тест на тимчасовій гілці: запуск має запропонувати артефактtest-resultsзі звітом. - Фіксація дій. Замініть кожне
uses: owner/name@vNповним хешем коміту цього тега та коментарем із тегом. Що ви виграєте і яку додаткову роботу це коштує під час оновлення дії? - Запланований аудит. Повідомлення про вразливості з’являються між надсиланнями. Додайте другий тригер,
schedule:з тижневим виразом cron, щоб CI запускався ще й раз на тиждень. З якої гілки запланований запуск бере код і чи це та гілка, яку ви хочете перевіряти?