Українська
Розгортання та експлуатація
Крок 1. Перше розгортання
Навіщо. Усе на місці: сервер із теми 23, скрипт активації, ключ розгортання, середовище й обидва робочі процеси в dev. Злиття в main запускає конвеєр.
Що зробити. На GitHub відкрийте запит на злиття з базою main і порівнянням dev (або використайте той, що з теми 22). Для нього запускається CI; коли Backend і Frontend зелені, злийте його. Надсилання до main запускає робочий процес Deploy: відкрийте Actions → Deploy і новий запуск.
- CI / Backend і CI / Frontend працюють як у темі 22, близько п’яти хвилин.
- Package збирає реліз і вивантажує артефакт chatex-release, ще кілька хвилин.
- Deploy показує
Waitingі банер про те, що розгортання вproductionпотребує перегляду. Натисніть Review deployments, позначтеproductionі Approve and deploy. Лише тепер завдання запускається й отримує секрети.
Перевірка
Журнал кроку Activate release першого розгортання:
[chatex-activate] installed /opt/chatex/releases/<sha>
[chatex-activate] applying migrations
Failed executing DbCommand (18ms) [Parameters=[], CommandType='Text', CommandTimeout='30']
SELECT migration_id, product_version
FROM "__EFMigrationsHistory"
ORDER BY migration_id;
Acquiring an exclusive lock for migration application. See https://aka.ms/efcore-docs-migrations-lock for more information if this takes too long.
Applying migration '20261029094940_InitialCreate'.
Done.
[chatex-activate] switching to <sha>
[chatex-activate] <sha> is liveЗапит із позначкою «failed» нешкідливий і з’являється лише раз: пакет спершу шукає свою таблицю історії, якої немає в порожній базі даних, а потім створює схему. Smoke test друкує Healthy, запуск зелений, а сторінка запуску показує середовище production із посиланням на ваш сайт.
Крок 2. Перевірка живого сайту
Що зробити. Відкрийте https://<your domain> у браузері. З’являється сторінка входу Chatex зі значком замка HTTPS. Зареєструйте користувача, відкрийте приватне вікно й зареєструйте другого користувача, почніть між ними особистий чат і надсилайте повідомлення туди й назад: повідомлення, індикатори набору тексту й онлайн-статус надходять у реальному часі – через WebSocket, який Nginx пропускає до хаба.
Потім подивіться на сервер:
bash
readlink /opt/chatex/current/opt/chatex/releases/<sha>bash
systemctl status chatex-apiСтан – active (running), головний процес – /usr/bin/dotnet /opt/chatex/current/api/Chatex.Api.dll.
bash
journalctl -u chatex-api -n 20Журнал містить запуск API, кожен рядок із префіксом chatex-api[<pid>]::
… chatex-api[252]: Microsoft.Hosting.Lifetime[14] Now listening on: http://127.0.0.1:5000
… chatex-api[252]: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down.
… chatex-api[252]: Microsoft.Hosting.Lifetime[0] Hosting environment: ProductionПеревірка
ls /var/lib/chatexпоказуєkeysіuploads: API створило свій ключ Data Protection під час першого запуску; завантажені файли з’являться вuploads, коли хтось надішле вкладення.- Зі свого комп’ютера
curl.exe -i http://<droplet ip>/healthвідповідає400 Bad Request: гола IP-адреса відсутня вAllowedHosts, тож API відхиляє запити, що не називають ваш домен. curl.exe -I https://<your domain>/показуєCache-Control: no-cacheі заголовки безпеки; хешований файл на кшталтhttps://<your domain>/main-<hash>.js(візьміть назву з коду сторінки) показуєCache-Control: public, max-age=31536000, immutable.
Відтепер кожне злиття в main проходить так само: CI, пакування, ваше схвалення, розгортання. Типове розгортання на кілька секунд перериває роботу API під час перезапуску; клієнт Angular перепідключається до хаба самостійно (тема 20).
Крок 3. Щоденні команди
Ці команди зібрано в Docs/Deployment.md у розділі «Useful commands».
Стежте за журналами API наживо (Ctrl+C зупиняє стеження, а не API):
bash
journalctl -u chatex-api -fПокажіть активний реліз:
bash
readlink /opt/chatex/currentПерезапустіть API, наприклад після зміни налаштування в /etc/chatex/chatex.env:
bash
systemctl restart chatex-apiПеревірте використання диска – база даних, завантаження й збережені релізи з часом ростуть, а диск дроплета невеликий:
bash
df -h / && du -sh /var/lib/postgresql /var/lib/chatex/uploads /opt/chatex/releasesЗробіть резервну копію бази даних у файл:
bash
sudo -u postgres pg_dump -Fc chatex > chatex.dump-Fc – стиснутий власний формат PostgreSQL, який pg_restore може завантажити, зокрема таблиця за таблицею. Резервна копія на тому самому диску не переживе втрати сервера: скопіюйте її на свій комп’ютер, зі свого комп’ютера:
powershell
scp root@<droplet ip>:chatex.dump .Завантажені файли в /var/lib/chatex/uploads теж належать до резервної копії: база даних зберігає лише їхні шляхи.
Фонова робота API
Дві частини застосунку допомагають оператору без жодної команди. MaintenanceService (тема 13) запускається щогодини й видаляє завантаження, які ніколи не було надіслано, і токени оновлення, строк дії яких давно минув або які було відкликано. А /health перевіряє базу даних на звичайному з’єднанні без повторів, тож відповідає 503 за лічені секунди, коли PostgreSQL не працює, – що й уможливлює автоматичний відкат і моніторинг.
Крок 4. Відкат
Навіщо. Іноді реліз проходить усі перевірки, а проте має помилку, яку помічають користувачі. Найшвидше виправлення – повернутися до попереднього релізу й спокійно виправити помилку.
Що зробити. Перелічіть збережені релізи, найновіші першими:
bash
ls -t /opt/chatex/releasesАктивуйте потрібний:
bash
chatex-activate <commit>Скрипт не знаходить вивантаження для цього коміту й повторно активує наявний реліз:
[chatex-activate] no upload for <commit>, re-activating the existing release
[chatex-activate] applying migrations
…
No migrations were applied. The database is already up to date.
Done.
[chatex-activate] switching to <commit>
[chatex-activate] <commit> is liveВідкат не скасовує міграцій
Старіший реліз працює на новішій схемі бази даних. Це можливо, бо міграції пишуться сумісними з попереднім релізом (розширення–стиснення, див. Активація релізу). Якщо міграція була руйнівною, для відкату потрібна резервна копія бази даних, тому резервну копію роблять перед ризикованими релізами.
Пам’ятайте, що main усе ще містить поганий коміт: наступне злиття розгорне виправлену версію й замінить відкат. Щоб знову розгорнути main без нового коміту, скористайтеся Actions → Deploy → Run workflow.
Крок 5. Заміна секретів
Навіщо. Секрети витікають: знімок екрана, загублений ноутбук, колега, що йде. Кожен секрет має замінюватися за кілька хвилин, без нового релізу.
Ключ підпису JWT
Згенеруйте новий ключ і внесіть його у файл налаштувань:
bash
openssl rand -base64 48bash
nano /etc/chatex/chatex.envbash
systemctl restart chatex-apiУсі токени доступу, підписані старим ключем, відразу стають недійсними. Користувачі цього не помічають: клієнт отримує 401, оновлює токен через cookie оновлення й повторює запит (тема 16). Токени оновлення – це випадкові значення, що зберігаються як хеші, незалежно від ключа підпису, тож сеанси переживають заміну. Щоб завершити й усі сеанси, відкличте токени оновлення в базі даних.
Пароль бази даних
bash
sudo -u postgres psql -c "ALTER ROLE chatex PASSWORD 'NEW_PASSWORD'"Потім замініть пароль у ConnectionStrings__Chatex через nano /etc/chatex/chatex.env і перезапустіть API командою systemctl restart chatex-api. Виконуйте ці три кроки один за одним: між першим і останнім нові з’єднання працюючого API з базою даних завершувалися б помилкою.
Ключ розгортання
Створіть нову пару ключів на своєму комп’ютері, як у розділі Доступ для GitHub, допишіть новий публічний ключ до /root/.ssh/authorized_keys, замініть секрет SSH_PRIVATE_KEY і один раз розгорніть через Run workflow, щоб довести, що це працює. Потім видаліть рядок старого ключа з authorized_keys через nano. Якщо сам сервер було перебудовано, його ключ хоста змінився: оновіть і SSH_KNOWN_HOSTS, інакше завдання зупиниться на перевірці ключа хоста – як і має.
Крок 6. Розгортання вручну
Навіщо. Якщо GitHub Actions недоступний або ви розгортаєте на тестову машину, реліз можна зібрати й активувати без робочого процесу. Кроки ті самі, що в робочому процесі, але виконуєте їх ви – разом із відповідальністю розгортати лише той коміт, який пройшов CI.
Що зробити. З кореня репозиторію на своєму комп’ютері спершу видаліть стару папку release/, якщо вона є, потім зберіть реліз:
powershell
dotnet publish Source/Chatex.Api -c Release -r linux-x64 --self-contained false -o release/apipowershell
dotnet tool restore && dotnet ef migrations bundle --project Source/Chatex.Data --configuration Release -r linux-x64 -o release/efbundle --forcepowershell
npm --prefix Source/Chatex.Web ci && npm --prefix Source/Chatex.Web run build && cp -r Source/Chatex.Web/dist/chatex/browser release/webВідома помилка в еталонній документації
Docs/Deployment.md записує команду пакета з -c Release. У dotnet ef -c – це скорочення для --context, а не --configuration, тож ця команда зупиняється з No DbContext named 'Release' was found. Використовуйте --configuration Release, як вище й як робить deploy.yml.
Назвою релізу має бути хеш коміту; візьміть коротку форму поточного коміту:
powershell
git rev-parse --short HEADВивантажте реліз до incoming/ і активуйте його:
powershell
scp -r release root@<your domain>:/opt/chatex/incoming/<commit>powershell
ssh root@<your domain> chatex-activate <commit>Вивід такий самий, як у журналі робочого процесу. Реліз, зібраний так, не має файлу REVISION; про коміт повідомляє назва його папки.