Provision
—— XP

Миссия: новый сервис не виден снаружи

практика~45 минут+325 XP

Коллега поднял на стенде новый сервис на порту 9099 и ушёл в отпуск. На самом стенде всё открывается, а с любой другой машины — нет. Тебе нужно понять почему, починить и оставить описание сети машины, чтобы следующий человек не начинал с нуля.

Здесь понадобится весь раздел. Готового вывода у команд нет — это миссия, вывод ты увидишь сам и сам решишь, что он значит. Нужны включённый файрвол из раздела 03 и строка provision.internal в /etc/hosts из практики про DNS. Окно стенда открой в tmux, чтобы сервис коллеги пережил обрыв SSH.

Подготовка: сервис коллеги

Выполни на стенде. Блок воспроизводит сервис ровно в том виде, в котором его оставили.

стенд · подготовкаскрипт подготовки, выполняется целиком
mkdir -p ~/devops-lab/www ~/devops-lab/reports
echo "<h1>provision</h1>" > ~/devops-lab/www/index.html
cd ~/devops-lab/www
python3 -m http.server 9099 --bind 127.0.0.1 &

Это тот же встроенный веб-сервер Python, что в практике про три причины: -m http.server запускает его, --bind задаёт адрес, -p у mkdir не ругается на существующие каталоги. Окно со стендом не закрывай: сервис живёт в нём, в фоне.

Часть 1. Пройти ступени

Иди по ступеням, как в уроке про порядок проверки, и стучись со своей машины. На каждой ступени запиши себе ответ — он попадёт в паспорт.

Адрес 192.168.1.50 здесь и дальше — пример: подставляй адрес своего стенда. Узнать его можно на стенде командой ip -br a — адрес стоит в строке интерфейса со словом UP, до косой черты.

  1. Имя. На стенде — какой адрес у provision.internal?
  2. Машина. Отвечает ли стенд на ping со своей машины? Это проверка связи до машины, а не порта: ufw пропускает ping, даже когда все порты, кроме SSH, закрыты.
  3. Порт. Что отвечает nc -zv -w 3 на порт 9099 — отказ, таймаут или успех?
  4. Служба. На стенде: на каком адресе слушает 9099?
  5. Приложение. Что вернёт curl -I — и со стенда, и со своей машины?

Команды, которые понадобятся, ты уже знаешь:

ubuntu@stand:~$
getent hosts provision.internal      # на стенде
ping -c 3 192.168.1.50               # со своей машины
nc -zv -w 3 192.168.1.50 9099        # со своей машины
ss -tln | grep 9099                  # на стенде

Флаги: -c 3 у ping — три пакета, -z у nc — только проверить порт, -v — сказать результат словами, -w 3 — ждать не больше трёх секунд. У ss флаги -tln — TCP, слушающие, порты числами.

Часть 2. Починить

Причин две, и вторая проявится только после того, как починишь первую. Это нормально: в жизни поломки тоже прячутся одна за другой.

Первым ты увидишь таймаут. Пакеты молча не доходят — вспомни раздел 03 про ufw. Открывай ровно один порт и ровно по TCP. Пока порт закрыт, ты не узнаешь ничего о самой службе: файрвол выбрасывает пакет раньше, чем машина посмотрит, слушает ли кто-то порт.

После этого придёт отказ. Значит, служба слушает не тот адрес, и её нужно перезапустить с правильным. Остановить её можно командой pkill -f "http.server 9099" — она найдёт процесс даже после переподключения. Запуск — та же команда из подготовки, только подумай, какой адрес в ней нужен. Запускать нужно из каталога ~/devops-lab/www, иначе сервер отдаст не тот каталог.

Готово, когда со своей машины curl -I http://192.168.1.50:9099/ — с адресом твоего стенда — возвращает 200 OK. Проверь и по имени — на стенде:

ubuntu@stand:~$
curl -I http://provision.internal:9099/

Часть 3. Сетевой паспорт

Создай ~/devops-lab/reports/net-passport.txt. Это описание машины для человека, который придёт после тебя. Пиши подписанными строками:

  • адрес: — адрес стенда с маской (из ip -br a);
  • шлюз: — из строки default в ip route;
  • резолвер: — из resolvectl status;
  • внешний: — из curl ifconfig.me;
  • слушает: — какие порты и на каких адресах (из sudo ss -tlnp);
  • открыто в ufw: — какие правила (из sudo ufw status);
  • разбор: — что ты увидел до каждой починки (Connection refused или timed out) и что это значило.

Последний пункт — главный. «Починил» ничего не говорит следующему человеку, а «сначала timed out — порт закрыт в ufw, открыл 9099/tcp; потом refused — служба слушала 127.0.0.1, перезапустил на 0.0.0.0» — готовая инструкция. Подписи можно писать и латиницей: address, gateway, resolver.

Шпаргалка раздела

Команды на каждый день и те, с которых начинают, когда «не открывается».

на каждый день
ip -br a                       # адреса машины
ip route                       # шлюз и маршруты
sudo ss -tlnp                  # кто какой порт слушает
getent hosts имя               # адрес, как его видят программы
dig +short имя                 # что ответил DNS-сервер
не открывается: по ступеням
getent hosts site.ru           # имя
ping -c 3 site.ru              # машина
mtr -r -c 10 site.ru           # где теряется путь
nc -zv -w 3 site.ru 443        # порт: refused или timeout
curl -I https://site.ru        # что отвечает приложение

У mtr флаг -r — напечатать отчёт и выйти, -c 10 — десять пакетов на узел. У curl флаг -I — только заголовки ответа. У ip флаг -br — кратко, по строке на интерфейс. У ss флаг -p — показать процесс.

Уборка

После сдачи останови сервис командой pkill -f "http.server 9099" и удали правило: sudo ufw delete allow 9099/tcp.

Как это решал бы инженер

Разбор откроется, когда миссию примут: сначала пройди ступени сам и запиши, что увидел.

Решение откроется после сдачи.

Сначала попробуй сам — блок сдачи внизу страницы. Когда сдачу примут, здесь появится, как её решал бы инженер: в каком порядке, какими командами и как проверял.

Что спросят на собеседовании

  • Сервис открывается с сервера, но не открывается снаружи. Твои шаги?
    Со своей машины проверить порт через nc: отказ — смотреть на сервере ss -tlnp, на каком адресе слушает служба; таймаут — файрвол на сервере, группа безопасности в облаке, маршрут. Потом curl -I.
  • Почему после исправления одной причины сервис всё ещё недоступен?
    Поломки часто стоят друг за другом: пока файрвол выбрасывал пакеты, не было видно, что служба слушает только петлю. Каждая ступень проверяется заново после каждой починки.
  • Что должно быть в описании сети сервера?
    Адрес и маска, шлюз, DNS-резолвер, внешний адрес, слушающие порты и правила файрвола — то, без чего следующий человек начнёт диагностику с нуля.

Раздел закрыт

Ты умеешь прочитать адрес и маску, найти шлюз, узнать, кто какой порт слушает, пройти диагностику «не открывается» по ступеням и проверить DNS.

Дальше — раздел 05 «Nginx»: веб-сервер, который встаёт на 80-й и 443-й порты и передаёт запросы приложению. Всё, что ты делал с ss, curl -I и кодами ответа, там пригодится в первый же день.

Практика 04+325 XP

Пройти диагностику «не открывается» от имени до приложения самостоятельно, починить найденное и описать сеть машины так, чтобы по описанию мог работать другой человек.

  • Служба слушает все адреса
  • Порт 9099 открыт в файрволе
  • Имя provision.internal по-прежнему находится
  • В паспорте записаны оба симптома: отказ и таймаут
  • В паспорте адрес с маской, шлюз и резолвер
Команда сдачи — выполни на своей машине
команда
cat ~/devops-lab/reports/net-passport.txt; ss -tln | grep 9099; sudo ufw status | grep 9099; getent hosts provision.internal

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.