Provision
—— XP

Практика: сервис по имени и страница из ключа

практика~30 минут+700 XP

В прошлой практике ты искал порт nginx глазами. Сейчас это сделает Consul: ты зарегистрируешь сервис, найдёшь его по имени и заставишь страницу поменяться, не выкатывая задание заново.

Понадобятся три терминала: Consul, Nomad и твой рабочий. Три окна SSH держать неудобно, и при обрыве связи агенты умрут вместе с ними. Удобнее tmux из раздела 03: он держит окна на стенде, даже если ты отключился.

ubuntu@stand:~$
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. Меняются только имя и версия.

ubuntu@stand:~$
BASE=https://hashicorp-releases.yandexcloud.net
V=2.0.4
A=amd64
ubuntu@stand:~$
wget $BASE/consul/$V/consul_${V}_linux_${A}.zip
wget $BASE/consul/$V/consul_${V}_SHA256SUMS
ubuntu@stand:~$
sha256sum -c --ignore-missing consul_${V}_SHA256SUMS
ubuntu@stand:~$
consul_2.0.4_linux_amd64.zip: OK
ubuntu@stand:~$
unzip consul_${V}_linux_${A}.zip
sudo mv consul /usr/local/bin/
ubuntu@stand:~$
consul version
ubuntu@stand:~$
Consul v2.0.4

Шаг 2. Перезапустить Nomad после Consul

Nomad в режиме разработки ищет Consul при старте. Поэтому порядок такой: останови Nomad во втором терминале (Ctrl+C), запусти там Consul, а Nomad — в третьем. Задание забудется, его отправишь заново.

Во втором терминале — Consul. Флаг -dev здесь значит то же, что у Nomad: один узел, состояние в памяти.

ubuntu@stand:~$
consul agent -dev
ubuntu@stand:~$
==> Starting Consul agent...
==> Log data will now stream in as it occurs:

В третьем — Nomad, как в прошлой практике:

ubuntu@stand:~$
sudo nomad agent -dev
ubuntu@stand:~$
==> Nomad agent started! Log data will stream in below:

Шаг 3. Consul жив

В рабочем терминале посмотри на узлы Consul.

ubuntu@stand:~$
consul members
ubuntu@stand:~$
Node    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:

в группу app
    service {
      name = "web"
      port = "http"
    }

port = "http" — это имя порта из блока network, а не число: настоящий номер Nomad выберет сам и сообщит его Consul. Отправь задание — в кластере его сейчас нет, Nomad перезапускался.

ubuntu@stand:~$
cd ~/hashi
nomad job run web.nomad.hcl
ubuntu@stand:~$
    Deployment "16893d17" successful

Каталог Consul — список всех зарегистрированных сервисов.

ubuntu@stand:~$
consul catalog services
ubuntu@stand:~$
consul
nomad
nomad-client
web

Шаг 5. Найти по имени

Спроси DNS Consul об адресах web. У dig запись @127.0.0.1 — какой сервер спрашивать, -p — порт, +short — только ответ.

ubuntu@stand:~$
dig @127.0.0.1 -p 8600 web.service.consul +short
ubuntu@stand:~$
127.0.0.1

Обе копии живут на одном стенде, поэтому адрес один. Порт в обычной записи не передаётся; его хранит запись типа SRV — «где найти сервис: адрес и порт».

ubuntu@stand:~$
dig @127.0.0.1 -p 8600 web.service.consul SRV +short
ubuntu@stand:~$
1 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 — адрес положи в переменную.

ubuntu@stand:~$
C=127.0.0.1:8500
curl -s $C/v1/health/checks/web
ubuntu@stand:~$
[]

Пустой список: проверок нет. Если nginx внутри зависнет, Consul продолжит раздавать его адрес. Допиши в блок service проверку:

в блок service
      check {
        type     = "http"
        path     = "/"
        interval = "10s"
        timeout  = "2s"
      }

Раз в 10 секунд Consul запросит / у каждой копии и подождёт ответа 2 секунды. Отправь задание и через полминуты спроси снова, оставив только строки со статусом:

ubuntu@stand:~$
nomad job run web.nomad.hcl
curl -s $C/v1/health/checks/web | grep '"Status"'
ubuntu@stand:~$
        "Status": "passing",
        "Status": "passing",

passing — проверка проходит. Копию, которая начнёт отвечать ошибкой, Consul пометит critical и уберёт из ответов DNS. Другие виды проверок — tcp (порт открыт), grpc и script (своя команда) — описаны в документации Nomad.

Шаг 7. Страница из шаблона

Теперь пусть страница nginx собирается из хранилища ключей Consul. В задачу nginx, рядом с блоком config, добавь шаблон:

в задачу nginx
      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:

в блок config
        volumes = ["local:/usr/share/nginx/html"]

Ключ ты ещё не записал — так и задумано. Отправь задание и посмотри, что получится.

ubuntu@stand:~$
nomad job run web.nomad.hcl

Команда не заканчивается: выкат идёт и не продвигается. Прерви её (Ctrl+C — выкат продолжится без тебя) и посмотри на копии.

ubuntu@stand:~$
nomad job status web
ubuntu@stand:~$
ID        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, одна старая уже остановлена, вторая продолжает работать. Причину покажет журнал событий копии — подставь свой номер:

ubuntu@stand:~$
nomad alloc status a4a29e98 | tail -4
ubuntu@stand:~$
Time                  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: путь ключа, затем значение.

ubuntu@stand:~$
consul kv put web/color green
ubuntu@stand:~$
Success! Data written to: web/color

Копия дождалась ключа и запустилась. Но посмотри на историю выкатов:

ubuntu@stand:~$
nomad job deployments web
ubuntu@stand:~$
ID        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 — без шаблона. Так и в проде: ключ, конфиг или секрет кладут до выката, иначе ожидание съедает отведённое время. Ключ теперь есть — отправь задание ещё раз.

ubuntu@stand:~$
nomad job run web.nomad.hcl
nomad job deployments web | head -2
ubuntu@stand:~$
ID        Job ID  Job Version  Status      Description
40e0362c  web     4            successful  Deployment completed successfully

Шаг 9. Страница

Копии новые — значит, и порты новые. Узнай их у DNS и открой любую копию. Флаг -s у curl убирает строку прогресса.

ubuntu@stand:~$
dig @127.0.0.1 -p 8600 web.service.consul SRV +short
ubuntu@stand:~$
1 1 20718 7f000001.addr.dc1.consul.
1 1 25467 7f000001.addr.dc1.consul.
ubuntu@stand:~$
curl -s 127.0.0.1:20718
ubuntu@stand:~$
Цвет: green

Шаг 10. Поменять без выката

Поменяй ключ.

ubuntu@stand:~$
consul kv put web/color blue
ubuntu@stand:~$
Success! Data written to: web/color

Через пару секунд снова запроси страницу.

ubuntu@stand:~$
curl -s 127.0.0.1:20718
ubuntu@stand:~$
Цвет: blue

Задание не перевыкатывалось, контейнер не перезапускался — Nomad увидел изменение ключа и перерисовал файл. Так в проде меняют конфиг балансировщика, когда добавляется новая копия сервиса. Отправь команду сдачи.

Что дальше

Сервисы находят друг друга, конфиг меняется сам. Остались секреты: пароль базы в ключе Consul хранить нельзя. Для этого Vault.

Практика 02+700 XP

Регистрировать сервис в Consul, находить его по имени и менять конфигурацию через ключи без нового выката.

  • Consul работает
  • Сервис в реестре
  • DNS отдаёт две копии
  • Страница собрана из ключа
Команда сдачи — выполни на своей машине
команда
echo "CONSUL=$(consul members 2>/dev/null | grep -c alive)"; echo "SERVICE=$(consul catalog services 2>/dev/null | grep -cx web)"; echo "DNS=$(dig @127.0.0.1 -p 8600 web.service.consul SRV +short 2>/dev/null | wc -l)"; echo "KV=$(consul kv get web/color 2>/dev/null)"; PORT=$(dig @127.0.0.1 -p 8600 web.service.consul SRV +short 2>/dev/null | head -1 | cut -d' ' -f3); echo "PAGE=$(curl -s -m 3 127.0.0.1:$PORT 2>/dev/null)"

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