Українська
Контрольна точка
Що має працювати
На вашому комп’ютері:
powershell
curl.exe https://<your domain>/healthНа сервері:
bash
readlink /opt/chatex/currentbash
cat /opt/chatex/current/REVISIONbash
systemctl status chatex-apiВаш репозиторій тепер повний. Порівняйте дві останні папки з еталоном:
powershell
git diff --no-index --stat .github D:\Work\Chatex-Reference\.githubpowershell
git diff --no-index --stat Deploy D:\Work\Chatex-Reference\DeployПерша команда нічого не виводить; друга показує лише nginx/chatex.conf, де ваш server_name відрізняється.
Робочий процес і скрипт закомічено в їхніх розділах, а dev злито в main для першого розгортання; git status повідомляє про чисте робоче дерево.
Посібник завершено: Chatex працює в production, і кожна наступна зміна проходить той самий шлях – гілка, CI, запит на злиття, злиття, схвалення, автоматичне й оборотне розгортання.
Типові помилки
Таблиця 24.2. Типові помилки безперервного розгортання
| Симптом | Причина | Виправлення |
|---|---|---|
Set up SSH завершується з SSH_KNOWN_HOSTS contains no host key lines | секрет порожній, належить іншому середовищу або містить лише рядок коментаря | вставте рядок <droplet ip> ssh-ed25519 AAAA… із ssh-keyscan |
Upload release завершується з Host key verification failed. | зафіксований ключ хоста не збігається з сервером (хибна IP-адреса, перебудований сервер) | порівняйте відбитки, надруковані Set up SSH, оновіть SSH_KNOWN_HOSTS |
Upload release завершується з Permission denied (publickey). | публічного ключа розгортання немає в /root/.ssh/authorized_keys або SSH_PRIVATE_KEY – не відповідний приватний ключ | допишіть chatex-deploy.pub на сервері; вставте весь файл приватного ключа в секрет |
Load key "/home/runner/.ssh/deploy_key": error in libcrypto | секрет приватного ключа неповний (бракує рядків -----BEGIN/-----END) | вставте повний файл chatex-deploy |
[chatex-activate] error: ConnectionStrings__Chatex is not set in /etc/chatex/chatex.env | рядка немає або його написано з помилкою у файлі налаштувань | виправте /etc/chatex/chatex.env і запустіть Run workflow |
health check failed, rolling back … і DataAnnotation validation failed for 'JwtOptions' members: 'SigningKey' … у журналі | ключ підпису коротший за 32 символи | внесіть у файл налаштувань ключ з openssl rand -base64 48 |
Smoke test завершується з curl: (22) The requested URL returned error: 400 | AllowedHosts не містить вашого домену | додайте домен у /etc/chatex/chatex.env, systemctl restart chatex-api |
No DbContext named 'Release' was found. під час розгортання вручну | використано -c Release із dotnet ef, де -c означає --context | використайте --configuration Release |
Питання для самоперевірки
- Чим відрізняється безперервна доставка від безперервного розгортання і що з цього робить Chatex?
- Чому
deploy.ymlзнову викликаєci.yml, хоча запит на злиття вже перевірено? - Чому групу паралельності
productionне скасовують під час виконання, а запуски CI скасовують? - Що створює завдання пакування і чому на сервері нічого не збирається?
- Чому API публікується залежним від середовища виконання? Що змінилося б в автономній публікації?
- Що таке пакет міграцій і чому серверу для міграції не потрібні ні SDK, ні вихідний код?
- Чому скрипт активації перевіряє, що його аргумент схожий на хеш коміту?
- Чому міграції застосовуються до перемикання і чому вони мають лишатися сумісними з попереднім релізом?
- Як скрипт атомарно перемикає
currentі чому не просто черезln -sfn? - Що саме відбувається, коли новий реліз не відповідає на
/healthпротягом 30 секунд? - Чому виконавець отримує власний ключ розгортання й зафіксований ключ хоста і від чого запобігає
StrictHostKeyChecking yes? - Які значення є секретами, а яке – змінною? Коли завдання розгортання отримує секрети?
- Як відкотитися вручну і чого відкат не скасовує?
- Що відбувається з користувачами, які ввійшли в систему, коли ключ підпису JWT замінюють?
Вправи
- Помітний реліз. Змініть текст у клієнті на
dev, наприклад опис вindex.html, злийте вmainі простежте розгортання від злиття до браузера. Виміряйте, скільки триває кожне завдання і скільки часу API недоступне під час перезапуску (journalctlпоказує час). - Крайній випадок першого розгортання. Виправте крайній випадок, описаний у розділі Активація релізу:
PREVIOUSмає бути порожнім, колиcurrentще не існує. Який параметрreadlinkце робить і як перевірити зміну, не зламавши сервер (підказка: копія скрипта й підроблений реліз, що завершується невдачею)? - Покажіть версію. Зробіть розгорнуту версію видимою: нехай API читає
REVISIONзі своєї папки релізу й повертає його з нової анонімної кінцевої точки, або нехай Nginx віддаєREVISIONяк/version.txt. Яке рішення відкриває менше і чи потребує зміни CSP або конфігурація кешування? - Розгортання без простою (лише проєкт). Під час
systemctl restartAPI недоступне кілька секунд. Накресліть, як цього можна уникнути двома службами на двох портах і перемиканнямupstreamв Nginx. Чому для Chatex це складніше, ніж для API без стану (подумайте про онлайн-статус у пам’яті та з’єднання SignalR)?