Provision
—— XP

Практика: Nomad за вечер

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

Сейчас ты поднимешь Nomad, запустишь в нём nginx в двух копиях и проверишь главное обещание любого оркестратора: сломанная версия не должна уронить рабочую. Всё на одной машине, в режиме разработки, — так начинают и в официальных руководствах HashiCorp.

Понадобятся два терминала: в одном работает Nomad, во втором ты.

Шаг 1. Установить

Nomad, как и Terraform, — одна программа без зависимостей, и ставится она так же, как Terraform в разделе 15: архивом с зеркала Yandex Cloud, потому что сайт HashiCorp из России может не открываться. Адрес зеркала положим в переменную, номер версии — во вторую.

ubuntu@stand:~$
BASE=https://hashicorp-releases.yandexcloud.net
V=2.0.7

Архив собран под конкретный процессор. Спроси у системы, какой у стенда.

ubuntu@stand:~$
dpkg --print-architecture
ubuntu@stand:~$
amd64

amd64 — обычный процессор Intel или AMD; на Mac с чипом M в виртуалке будет arm64. Положи ответ в третью переменную.

ubuntu@stand:~$
A=amd64
ubuntu@stand:~$
wget $BASE/nomad/$V/nomad_${V}_linux_${A}.zip

Программу ты будешь запускать через sudo, поэтому сначала убедись, что скачал ровно то, что выпустила HashiCorp, а не испорченный или подменённый файл. Рядом с архивами лежит список контрольных сумм.

ubuntu@stand:~$
wget $BASE/nomad/$V/nomad_${V}_SHA256SUMS
ubuntu@stand:~$
sha256sum -c --ignore-missing nomad_${V}_SHA256SUMS
ubuntu@stand:~$
nomad_2.0.7_linux_amd64.zip: OK

sha256sum -c считает сумму файлов из списка и сверяет с записанной; --ignore-missing пропускает архивы, которых у тебя нет, — для других процессоров. OK — файл целый. FAILED — удали архив и скачай заново. Сам список HashiCorp ещё и подписывает своим ключом (файл ….SHA256SUMS.sig), проверку подписи описывает страница о безопасности выпусков. Распакуй и положи программу туда, где шелл ищет команды:

ubuntu@stand:~$
unzip nomad_${V}_linux_${A}.zip
sudo mv nomad /usr/local/bin/

Проверь программу:

ubuntu@stand:~$
nomad version
ubuntu@stand:~$
Nomad v2.0.7

Docker у тебя есть с раздела 7 — Nomad будет запускать контейнеры через него.

Шаг 2. Запустить агента

Во втором терминале запусти Nomad в режиме разработки. Флаг -dev значит «сервер и клиент в одном процессе, состояние в памяти»: остановишь — всё забудется. Для учёбы это удобно, для прода нельзя.

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

Дальше этот терминал не трогай — в нём идёт журнал агента. Пригодится, если что-то пойдёт не так.

Шаг 3. Кластер жив

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

ubuntu@stand:~$
nomad node status
ubuntu@stand:~$
ID        Node Pool  DC   Name  Class   Drain  Eligibility  Status
c17bb7a7  default    dc1  lab   <none>  false  eligible     ready

Один клиент в статусе ready — можно отправлять задания. Веб-интерфейс тоже уже работает: http://localhost:4646.

Шаг 4. Описать задание

Создай каталог ~/hashi и в нём файл web.nomad.hcl. Начнём с самого малого: задание, группа, порт и одна задача.

~/hashi/web.nomad.hcl
job "web" {
  group "app" {
    network {
      port "http" { to = 80 }
    }
    task "nginx" {
      driver = "docker"
      config {
        image = "nginx:1.30"
        ports = ["http"]
      }
    }
  }
}

to = 80 — порт внутри контейнера. Снаружи Nomad выдаст копии случайный порт, чтобы копии на одной машине не столкнулись. driver = "docker" — запускать задачу контейнером Docker.

Шаг 5. Отправить

Команда job run отправляет задание и показывает, как идёт выкат.

ubuntu@stand:~$
cd ~/hashi
ubuntu@stand:~$
nomad job run web.nomad.hcl
ubuntu@stand:~$
Job ID      = web
Job Version = 0
Status      = successful
Description = Deployment completed successfully

successful — копия поднялась и стала здоровой. Список копий — аллокаций — покажет job status:

ubuntu@stand:~$
nomad job status web
конец вывода
Allocations
ID        Node ID   Task Group  Version  Desired  Status   Created  Modified
f6972db0  c17bb7a7  app         0        run      running  16s ago  2s ago

Шаг 6. Найти порт

Посмотри аллокацию — подставь свой номер.

ubuntu@stand:~$
nomad alloc status f6972db0 | grep http
ubuntu@stand:~$
*http  yes      127.0.0.1:30043 -> 80

Порт 30043 на машине ведёт на порт 80 в контейнере. Флаг -I у curl просит только заголовки ответа.

ubuntu@stand:~$
curl -I 127.0.0.1:30043
ubuntu@stand:~$
HTTP/1.1 200 OK
Server: nginx/1.30.6

Искать порт руками каждый раз неудобно — эту задачу в следующей практике решит Consul.

Шаг 7. Две копии

Одна копия — простой при каждом обновлении. Допиши первой строкой внутрь группы app:

web.nomad.hcl, в группу app
    count = 2

Перед отправкой посмотри, что изменится: команда job plan показывает разницу и ничего не меняет — как terraform plan.

ubuntu@stand:~$
nomad job plan web.nomad.hcl
ubuntu@stand:~$
+/- Job: "web"
+/- Task Group: "app" (1 create, 1 in-place update)
  +/- Count: "1" => "2" (forces create)
      Task: "nginx"

Одну копию создадут, существующую не тронут. Отправь nomad job run web.nomad.hcl — в job status станет две аллокации running.

Шаг 8. Сломанный выкат

Поменяй в файле образ на несуществующий nginx:9.99 и посмотри план.

ubuntu@stand:~$
nomad job plan web.nomad.hcl
ubuntu@stand:~$
+/- Job: "web"
+/- Task Group: "app" (1 create/destroy update, 1 ignore)
  +/- Task: "nginx" (forces create/destroy update)
    +/- Config {
      +/- image: "nginx:1.30" => "nginx:9.99"

1 create/destroy update, 1 ignore — менять будут по одной копии. Отправь nomad job run web.nomad.hcl и через минуту посмотри копии:

ubuntu@stand:~$
nomad job status web
конец вывода
ID        Node ID   Task Group  Version  Desired  Status    Created    Modified
66478918  c17bb7a7  app         2        run      pending   35s ago    1s ago
a095decd  c17bb7a7  app         2        stop     failed    1m40s ago  35s ago
f1204355  c17bb7a7  app         1        run      running   2m13s ago  2m2s ago
f6972db0  c17bb7a7  app         1        stop     complete  2m37s ago  1m40s ago

Читай снизу вверх. Одну старую копию Nomad остановил (complete), новая на её месте не скачала образ (failed), Nomad пробует ещё раз (pending). Вторая старая копия работает — даже без настроек Nomad меняет копии по одной и не трогает следующую, пока предыдущая не стала здоровой. Но сайт уже на половине копий, и сам Nomad назад не вернётся: будет пытаться, пока не выйдет срок, по умолчанию десять минут.

Шаг 9. Откатить руками

Каждая отправка задания — новая версия. Посмотри историю.

ubuntu@stand:~$
nomad job history web
ubuntu@stand:~$
Version     = 2
Stable      = false
Version     = 1
Stable      = true
Version     = 0
Stable      = true

Вывод сокращён до двух строк на версию. Stable = false — версия 2 так и не стала здоровой. Последняя рабочая — версия 1, две копии nginx:1.30. Откатись на неё:

ubuntu@stand:~$
nomad job revert web 1

Через полминуты job status покажет две копии running. Откат — это новая версия 3, копия версии 1: история не переписывается. Верни в файле образ nginx:1.30, чтобы файл совпадал с кластером.

Шаг 10. Автооткат

Ночью руками откатывать некому. Правила выката описывает блок update — допиши его в группу, перед task:

web.nomad.hcl, в группу app, перед task
    update {
      auto_revert       = true
      healthy_deadline  = "1m"
      progress_deadline = "2m"
    }

auto_revert — откатить, если новая версия не станет здоровой. healthy_deadline — сколько ждать здоровья одной копии, progress_deadline — сколько ждать прогресса всего выката. Короткие сроки здесь только ради того, чтобы не ждать в практике десять минут. Отправь файл с nginx:1.30 — выкат пройдёт, — затем снова поставь nginx:9.99 и отправь.

ubuntu@stand:~$
nomad job deployments web
ubuntu@stand:~$
ID        Job ID  Job Version  Status      Description
4e6dea65  web     6            successful  Deployment completed successfully
0c60728d  web     5            failed      Failed due to progress deadline - rolling back to job version 4
356e73fe  web     4            successful  Deployment completed successfully

Новая копия не скачала образ, за отведённое время выкат не продвинулся, и Nomad сам вернул версию 4 — это и есть версия 6 сверху. Старые копии всё это время работали. Верни в файле образ nginx:1.30, чтобы файл совпадал с кластером.

Шаг 11. Журнал задачи

Посмотри, что пишет сам nginx. Команда alloc logs показывает вывод программы, как docker logs.

ubuntu@stand:~$
nomad alloc logs f1204355
ubuntu@stand:~$
172.17.0.1 - - [02/Oct/2026:12:10:02 +0000] "HEAD / HTTP/1.1" 200 0 "-" "curl/8.5.0" "-"

Это твой запрос из шага 6, если ты спрашивал эту копию. Адрес клиента — не 127.0.0.1, с которого ты стучался, а 172.17.0.1: запрос в контейнер переправил Docker, и nginx видит адрес шлюза моста Docker — ту же сеть docker0, что в разделе 07. Отправь команду сдачи.

Что дальше

Nomad запускает задачи, но не знает, как сервисам найти друг друга. Это работа Consul — о нём следующий урок.

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

Отправлять задание в Nomad, находить его аллокации и порт и разбирать неудачный выкат.

  • Кластер работает
  • Две копии работают
  • Был выкат и откат
  • Работает рабочий образ
  • Автооткат включён
Команда сдачи — выполни на своей машине
команда
echo "NODES=$(nomad node status 2>/dev/null | grep -c ready)"; echo "RUNNING=$(nomad job status web 2>/dev/null | grep -c ' running ')"; echo "VERSIONS=$(nomad job history web 2>/dev/null | grep -c '^Version')"; echo "IMAGE=$(nomad job inspect web 2>/dev/null | grep -o 'nginx:[0-9.]*' | head -1)"; echo "REVERT=$(grep -c 'auto_revert *= *true' ~/hashi/web.nomad.hcl 2>/dev/null)"

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