В прошлой практике ты искал порт nginx глазами. Сейчас это сделает Consul: ты зарегистрируешь сервис, найдёшь его по имени и заставишь страницу поменяться, не выкатывая задание заново.
Понадобятся три терминала: Consul, Nomad и твой рабочий. Три окна SSH держать неудобно, и при обрыве связи агенты умрут вместе с ними. Удобнее tmux из раздела 03: он держит окна на стенде, даже если ты отключился.
tmux new -s hashiНовое окно — Ctrl+B, затем C; следующее окно — Ctrl+B, затем N. Отключиться, оставив всё работать, — Ctrl+B, затем D; вернуться — tmux attach -t hashi. Учти только, что режим разработки держит всё в памяти: выключишь стенд — Consul, Nomad и Vault забудут ключи, задания и секреты, и их придётся положить заново.
Шаг 1. Установить Consul
Consul ставится так же, как Nomad в прошлой практике: архив с зеркала, сверка суммы, программа в /usr/local/bin. Меняются только имя и версия.
BASE=https://hashicorp-releases.yandexcloud.net V=2.0.4 A=amd64
wget $BASE/consul/$V/consul_${V}_linux_${A}.zip wget $BASE/consul/$V/consul_${V}_SHA256SUMS
sha256sum -c --ignore-missing consul_${V}_SHA256SUMSconsul_2.0.4_linux_amd64.zip: OKunzip consul_${V}_linux_${A}.zip sudo mv consul /usr/local/bin/
consul versionConsul v2.0.4Шаг 2. Перезапустить Nomad после Consul
Nomad в режиме разработки ищет Consul при старте. Поэтому порядок такой: останови Nomad во втором терминале (Ctrl+C), запусти там Consul, а Nomad — в третьем. Задание забудется, его отправишь заново.
Во втором терминале — Consul. Флаг -dev здесь значит то же, что у Nomad: один узел, состояние в памяти.
consul agent -dev==> Starting Consul agent... ==> Log data will now stream in as it occurs:
В третьем — Nomad, как в прошлой практике:
sudo nomad agent -dev==> Nomad agent started! Log data will stream in below:Шаг 3. Consul жив
В рабочем терминале посмотри на узлы Consul.
consul membersNode Address Status Type Build Protocol DC Partition Segment ubuntu 127.0.0.1:8301 alive server 2.0.4 2 dc1 default <all>
alive — узел жив, server — он же и хранит данные. Веб-интерфейс — http://localhost:8500. Загляни туда: в списке сервисов уже есть nomad и nomad-client — Nomad зарегистрировал сам себя.
Шаг 4. Минимальная регистрация
Начни с самого малого: имя сервиса и порт, ничего больше. Открой ~/hashi/web.nomad.hcl и добавь в группу, сразу после блока network:
service { name = "web" port = "http" }
port = "http" — это имя порта из блока network, а не число: настоящий номер Nomad выберет сам и сообщит его Consul. Отправь задание — в кластере его сейчас нет, Nomad перезапускался.
cd ~/hashi nomad job run web.nomad.hcl
Deployment "16893d17" successfulКаталог Consul — список всех зарегистрированных сервисов.
consul catalog servicesconsul nomad nomad-client web
Шаг 5. Найти по имени
Спроси DNS Consul об адресах web. У dig запись @127.0.0.1 — какой сервер спрашивать, -p — порт, +short — только ответ.
dig @127.0.0.1 -p 8600 web.service.consul +short127.0.0.1Обе копии живут на одном стенде, поэтому адрес один. Порт в обычной записи не передаётся; его хранит запись типа SRV — «где найти сервис: адрес и порт».
dig @127.0.0.1 -p 8600 web.service.consul SRV +short1 1 20927 7f000001.addr.dc1.consul. 1 1 29230 7f000001.addr.dc1.consul.
Третье число в строке — порт копии, и копий две. Последнее поле — имя, по которому искать адрес. 7f000001 — это сам адрес, записанный шестнадцатеричными числами по байту: 7f — 127, 00 — 0, 00 — 0, 01 — 1, то есть 127.0.0.1. Consul упаковывает адрес прямо в имя, чтобы клиенту не пришлось делать второй запрос.
Шаг 6. Проверка здоровья
Сервис нашёлся, но Consul ничего не знает о его здоровье. Спроси у него проверки сервиса через HTTP API — адрес положи в переменную.
C=127.0.0.1:8500 curl -s $C/v1/health/checks/web
[]Пустой список: проверок нет. Если nginx внутри зависнет, Consul продолжит раздавать его адрес. Допиши в блок service проверку:
check { type = "http" path = "/" interval = "10s" timeout = "2s" }
Раз в 10 секунд Consul запросит / у каждой копии и подождёт ответа 2 секунды. Отправь задание и через полминуты спроси снова, оставив только строки со статусом:
nomad job run web.nomad.hcl curl -s $C/v1/health/checks/web | grep '"Status"'
"Status": "passing", "Status": "passing",
passing — проверка проходит. Копию, которая начнёт отвечать ошибкой, Consul пометит critical и уберёт из ответов DNS. Другие виды проверок — tcp (порт открыт), grpc и script (своя команда) — описаны в документации Nomad.
Шаг 7. Страница из шаблона
Теперь пусть страница nginx собирается из хранилища ключей Consul. В задачу nginx, рядом с блоком config, добавь шаблон:
template { data = "Цвет: {{ key \"web/color\" }}" destination = "local/index.html" change_mode = "noop" }
Шаблон возьмёт значение ключа web/color и запишет index.html в каталог local задачи. change_mode = "noop" — после перерисовки ничего не делать: nginx и так читает файл с диска при каждом запросе. Другие варианты — restart (перезапустить задачу) и signal (послать программе сигнал, например перечитать конфиг).
А в сам блок config добавь строку, которая подложит каталог local вместо стандартных страниц nginx:
volumes = ["local:/usr/share/nginx/html"]Ключ ты ещё не записал — так и задумано. Отправь задание и посмотри, что получится.
nomad job run web.nomad.hclКоманда не заканчивается: выкат идёт и не продвигается. Прерви её (Ctrl+C — выкат продолжится без тебя) и посмотри на копии.
nomad job status webID Node ID Task Group Version Desired Status Created Modified a4a29e98 8b0641fd app 2 run pending 40s ago 36s ago 2c2194b1 8b0641fd app 1 stop complete 2m36s ago 39s ago cb7d5fc6 8b0641fd app 1 run running 2m36s ago 1m4s ago
Новая копия версии 2 висит в pending, одна старая уже остановлена, вторая продолжает работать. Причину покажет журнал событий копии — подставь свой номер:
nomad alloc status a4a29e98 | tail -4Time Type Description 2026-10-24T11:15:32Z Template Missing: kv.block(web/color) 2026-10-24T11:15:29Z Task Setup Building Task Directory 2026-10-24T11:15:29Z Received Task received by client
Missing: kv.block(web/color) — шаблон ждёт ключ и не даёт задаче стартовать.
Шаг 8. Записать ключ
Копия ждёт — дай ей ключ. Запись в хранилище делает consul kv put: путь ключа, затем значение.
consul kv put web/color greenSuccess! Data written to: web/colorКопия дождалась ключа и запустилась. Но посмотри на историю выкатов:
nomad job deployments webID Job ID Job Version Status Description 4f973804 web 3 successful Deployment completed successfully 776b7613 web 2 failed Failed due to progress deadline - rolling back to job version 1
Это блок update из прошлой практики: на здоровье копии отведена минута, на весь выкат — две, а шаблон всё это время ждал ключ. Nomad решил, что выкат сломан, и вернул версию 1 — без шаблона. Так и в проде: ключ, конфиг или секрет кладут до выката, иначе ожидание съедает отведённое время. Ключ теперь есть — отправь задание ещё раз.
nomad job run web.nomad.hcl nomad job deployments web | head -2
ID Job ID Job Version Status Description 40e0362c web 4 successful Deployment completed successfully
Шаг 9. Страница
Копии новые — значит, и порты новые. Узнай их у DNS и открой любую копию. Флаг -s у curl убирает строку прогресса.
dig @127.0.0.1 -p 8600 web.service.consul SRV +short1 1 20718 7f000001.addr.dc1.consul. 1 1 25467 7f000001.addr.dc1.consul.
curl -s 127.0.0.1:20718Цвет: greenШаг 10. Поменять без выката
Поменяй ключ.
consul kv put web/color blueSuccess! Data written to: web/colorЧерез пару секунд снова запроси страницу.
curl -s 127.0.0.1:20718Цвет: blueЗадание не перевыкатывалось, контейнер не перезапускался — Nomad увидел изменение ключа и перерисовал файл. Так в проде меняют конфиг балансировщика, когда добавляется новая копия сервиса. Отправь команду сдачи.
Что дальше
Сервисы находят друг друга, конфиг меняется сам. Остались секреты: пароль базы в ключе Consul хранить нельзя. Для этого Vault.