Українська
Дроплет
Як читати команди цього модуля
Команди в блоках powershell виконуються на вашому комп’ютері, як і раніше. Команди в блоках bash виконуються на сервері, у сеансі SSH, від імені root. Їх узято з Docs/Deployment.md; <your domain>, <droplet ip> та подібні заповнювачі замініть своїми значеннями, без кутових дужок. Кожен прапорець перевірки каже, що ви маєте побачити на своєму сервері.
Крок 1. Одна машина для всього
Навіщо. Chatex у production складається з трьох програм: Nginx попереду, API за ним і PostgreSQL за API. Великі системи розміщують кожну на власних машинах, за балансувальниками навантаження, з керованою базою даних. Chatex запускає всі три на одному невеликому віртуальному сервері з трьох причин:
- цього досить: сервер лише запускає застосунок, усе збирання відбувається на виконавцях GitHub, а 1–2 ГБ пам’яті обслуговують багато користувачів чату;
- це просто: одну машину треба налаштувати, оновлювати й розуміти, а між API та базою даних немає мережі;
- копія API має бути одна в будь-якому разі: онлайн-статус із теми 14 живе в пам’яті процесу API, тож дві копії розходилися б у питанні, хто в мережі.
Ззовні до машини доходить лише два види трафіку (табл. 23.1): відвідувачі на вебпортах і адміністратор – згодом також робочий процес розгортання – через SSH. API й PostgreSQL слухають лише на адресі зворотного зв’язку 127.0.0.1 і невидимі з інтернету.
Таблиця 23.1. Програми й порти на сервері
| Програма | Слухає на | Доступна з |
|---|---|---|
sshd | порт 22 | інтернету: ви й GitHub Actions, лише за ключами |
| Nginx | порти 80 і 443 | інтернету: браузери користувачів |
chatex-api (Kestrel) | 127.0.0.1:5000 | лише Nginx і скрипт активації на тій самій машині |
| PostgreSQL | localhost:5432 | лише API, пакет міграцій і psql на тій самій машині |
Крок 2. Ключ SSH і дроплет
Навіщо. Сервер в інтернеті отримує спроби підбору паролів уже за кілька хвилин після створення. Вхід за ключем SSH замість пароля робить підбір безглуздим: приватний ключ ніколи не залишає ваш комп’ютер, а сервер зберігає лише публічну половину. DigitalOcean кладе публічний ключ у /root/.ssh/authorized_keys, коли створює дроплет.
Що зробити. Створіть пару ключів на своєму комп’ютері, якщо ще не маєте. Прийміть файл за замовчуванням і задайте парольну фразу, яка захистить ключ, якщо хтось скопіює файл:
powershell
ssh-keygen -t ed25519Публічний ключ – це файл id_ed25519.pub у папці .ssh вашого профілю користувача. Потім на панелі керування DigitalOcean виберіть Create → Droplets:
- Image: Ubuntu 26.04 (LTS) x64;
- Size: базовий дроплет з 1 ГБ або 2 ГБ пам’яті;
- Region: центр обробки даних поблизу ваших користувачів;
- Authentication: SSH Key, New SSH Key, і вставте вміст
id_ed25519.pub.
Коли дроплет буде готовий, скопіюйте його публічну адресу IPv4 і увійдіть:
powershell
ssh root@<droplet ip>Під час першого з’єднання сервер запитає, чи довіряєте ви його ключу хоста (Are you sure you want to continue connecting (yes/no/[fingerprint])?); дайте відповідь yes. Ключ запам’ятовується у вашому файлі known_hosts, а інший ключ за тією самою адресою згодом буде позначено як можливу атаку.
Перевірка
Запрошення змінюється на root@<droplet name>:~#. Запитайте сервер, яку систему він запускає:
bash
cat /etc/os-releaseПерший рядок – PRETTY_NAME="Ubuntu 26.04.1 LTS" (або пізніший проміжний випуск).
Навчальне налаштування: усе від імені root
Як і Docs/Deployment.md, цей модуль адмініструє сервер від імені root через SSH, і робочий процес розгортання з теми 24 теж підключається як root. Так кількість рухомих частин мінімальна, а небезпечна частина – застосунок – і так працює від імені непривілейованого користувача в пісочниці. Робоча команда пішла б далі: персональні облікові записи адміністраторів із sudo, вимкнений вхід root через SSH і окремий користувач розгортання, якому дозволено виконувати рівно одну команду, chatex-activate, через sudo (заголовок activate-release.sh у темі 24 написано саме для цього випадку). Вправа 3 контрольної точки просить вас це спланувати.
Крок 3. Запис DNS
Навіщо. Браузери потрапляють на сайт за іменем, а сертифікат наприкінці цієї теми видається для імені після того, як Let’s Encrypt перевірить, що ім’я вказує на цей сервер. Зміни DNS поширюються хвилини, а іноді години, тому ми створюємо запис зараз і використаємо його наприкінці.
Що зробити. У провайдера, що керує вашим доменом, створіть запис A: ім’я – це бажаний піддомен (наприклад, chatex, що дає chatex.<your domain>), значення – адреса IPv4 дроплета. Еталон використовує chatex.mvano.com. Далі в модулі <your domain> означає це повне ім’я.
Перевірка
На вашому комп’ютері:
powershell
nslookup <your domain>У відповіді під Address перелічено IP-адресу дроплета. Якщо там Non-existent domain, зачекайте кілька хвилин і спробуйте знову.
Крок 4. Пакети
Навіщо. Серверу потрібні програми з таблиці 23.1 і кілька інструментів – але не .NET SDK чи Node.js: реліз, що надійде в темі 24, уже зібрано. Кожен пакет походить із власного архіву Ubuntu, який Ubuntu оновлює виправленнями безпеки; Ubuntu 26.04 постачає .NET 10 і PostgreSQL 18 безпосередньо, тож додаткові джерела пакетів не потрібні.
Що зробити. Одна команда встановлює все:
bash
apt update && apt install -y aspnetcore-runtime-10.0 postgresql nginx certbot python3-certbot-nginx ufw rsync curlaspnetcore-runtime-10.0– середовище виконання ASP.NET Core з хостомdotnet, якого досить, щоб запускатиChatex.Api.dll. SDK, що компілює, було б удесятеро більшим і більшою поверхнею атаки.postgresql– сервер баз даних; пакет створює й запускає кластер, що слухає лише наlocalhost.nginx– вебсервер і зворотний проксі.certbot,python3-certbot-nginx– клієнт Let’s Encrypt і його плагін, що змінює конфігурацію Nginx.ufw– «некомпліковний брандмауер» (uncomplicated firewall), надбудова над фільтром пакетів Linux.rsync– приймає реліз від GitHub Actions у темі 24.curl– клієнт HTTP для перевірок стану.
-y відповідає «так» на підтвердження, тож команда виконується без запитань.
Перевірка
bash
dotnet --list-runtimesMicrosoft.AspNetCore.App 10.0.15 [/usr/lib/dotnet/shared/Microsoft.AspNetCore.App]
Microsoft.NETCore.App 10.0.15 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]Номер патча може бути вищим. nginx -v виводить nginx version: nginx/1.28.3 (Ubuntu), а psql --version – psql (PostgreSQL) 18.6 …, або пізніші версії патчів.
Оновлення безпеки
Образи сервера Ubuntu встановлюють і вмикають unattended-upgrades, який щодня застосовує оновлення безпеки з архіву Ubuntu. Тож встановлені вище пакети отримують виправлення автоматично. Перевірте, що служба активна, командою systemctl status unattended-upgrades, і час від часу заглядайте до /var/log/unattended-upgrades/. Оновлення ядра набувають чинності лише після перезавантаження; повідомлення під час входу каже, коли воно потрібне.
Крок 5. Брандмауер
Навіщо. Зараз кожна програма, що відкриває порт, доступна з інтернету. Брандмауер обертає це: усе заблоковано, крім того, що ми дозволяємо свідомо, – SSH, HTTP і HTTPS. Тоді служба, що випадково слухає на публічній адресі, або забутий тестовий сервер лишаються невидимими.
Що зробити.
bash
ufw allow OpenSSH && ufw allow 'Nginx Full' && ufw enableOpenSSHіNginx Full– профілі застосунків, які встановлюють пакети (ufw app listїх показує): порт 22, а також порти 80 і 443.- Порядок важливий.
ufw enableпочинає блокувати відразу. Якби SSH не було дозволено першим, ваш сеанс завис би, і щоб повернутися, знадобилася б вебконсоль провайдера.ufwзапитуєCommand may disrupt existing ssh connections. Proceed with operation (y|n)?; дайте відповідьy.
Перевірка
bash
ufw statusStatus: active
To Action From
-- ------ ----
OpenSSH ALLOW Anywhere
Nginx Full ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
Nginx Full (v6) ALLOW Anywhere (v6)Брандмауер залишається активним після перезавантаження (Firewall is active and enabled on system startup).
Хмарні брандмауери
Деякі провайдери мають власний брандмауер перед машиною (DigitalOcean називає його Cloud Firewalls). За замовчуванням він вимкнений. Якщо ви його ввімкнете, дозвольте там ті самі три порти, інакше браузер і GitHub не зможуть дістатися до сервера, навіть якщо ufw їх дозволяє.
Крок 6. Копія репозиторію
Навіщо. Файли сервера з наступних розділів – шаблон налаштувань, служба systemd, сайт Nginx – записано в репозиторії, переглядаються як код і копіюються на сервер із клону. Тоді файли в репозиторії та на сервері не можуть непомітно розійтися, а новий сервер налаштовують із тих самих файлів.
Що зробити. Клонуйте свій репозиторій до домашньої папки root і перейдіть до нього:
bash
git clone <your repository url> chatex && cd chatexРепозиторій приватний, тож Git запитує ім’я користувача й пароль. GitHub не приймає тут паролів облікового запису: створіть на GitHub дрібнозернистий персональний токен доступу (Settings → Developer settings → Personal access tokens) лише з правом читання вмісту цього одного репозиторію й вставте його як пароль.
Файли цієї теми закомічено в dev, тож перемкніться на цю гілку:
bash
git switch devВідтепер кожен розділ пише свої файли на вашому комп’ютері, комітить і надсилає їх до dev, а на сервері отримує так:
bash
git pullGit щоразу просить токен знову під час git pull; тримайте його в менеджері паролів, доки сервер не буде налаштовано.
Перевірка
bash
git statusВивід починається з On branch dev і Your branch is up to date with 'origin/dev'.