Сейчас ты поднимешь Nomad, запустишь в нём nginx в двух копиях и проверишь главное обещание любого оркестратора: сломанная версия не должна уронить рабочую. Всё на одной машине, в режиме разработки, — так начинают и в официальных руководствах HashiCorp.
Понадобятся два терминала: в одном работает Nomad, во втором ты.
Шаг 1. Установить
Nomad, как и Terraform, — одна программа без зависимостей, и ставится она так же, как Terraform в разделе 15: архивом с зеркала Yandex Cloud, потому что сайт HashiCorp из России может не открываться. Адрес зеркала положим в переменную, номер версии — во вторую.
BASE=https://hashicorp-releases.yandexcloud.net V=2.0.7
Архив собран под конкретный процессор. Спроси у системы, какой у стенда.
dpkg --print-architectureamd64amd64 — обычный процессор Intel или AMD; на Mac с чипом M в виртуалке будет arm64. Положи ответ в третью переменную.
A=amd64wget $BASE/nomad/$V/nomad_${V}_linux_${A}.zipПрограмму ты будешь запускать через sudo, поэтому сначала убедись, что скачал ровно то, что выпустила HashiCorp, а не испорченный или подменённый файл. Рядом с архивами лежит список контрольных сумм.
wget $BASE/nomad/$V/nomad_${V}_SHA256SUMSsha256sum -c --ignore-missing nomad_${V}_SHA256SUMSnomad_2.0.7_linux_amd64.zip: OKsha256sum -c считает сумму файлов из списка и сверяет с записанной; --ignore-missing пропускает архивы, которых у тебя нет, — для других процессоров. OK — файл целый. FAILED — удали архив и скачай заново. Сам список HashiCorp ещё и подписывает своим ключом (файл ….SHA256SUMS.sig), проверку подписи описывает страница о безопасности выпусков. Распакуй и положи программу туда, где шелл ищет команды:
unzip nomad_${V}_linux_${A}.zip sudo mv nomad /usr/local/bin/
Проверь программу:
nomad versionNomad v2.0.7Docker у тебя есть с раздела 7 — Nomad будет запускать контейнеры через него.
Шаг 2. Запустить агента
Во втором терминале запусти Nomad в режиме разработки. Флаг -dev значит «сервер и клиент в одном процессе, состояние в памяти»: остановишь — всё забудется. Для учёбы это удобно, для прода нельзя.
sudo nomad agent -dev==> Nomad agent configuration: Client: true Server: true ==> Nomad agent started! Log data will stream in below:
Дальше этот терминал не трогай — в нём идёт журнал агента. Пригодится, если что-то пойдёт не так.
Шаг 3. Кластер жив
В первом терминале посмотри на узлы.
nomad node statusID 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. Начнём с самого малого: задание, группа, порт и одна задача.
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 отправляет задание и показывает, как идёт выкат.
cd ~/hashinomad job run web.nomad.hclJob ID = web Job Version = 0 Status = successful Description = Deployment completed successfully
successful — копия поднялась и стала здоровой. Список копий — аллокаций — покажет job status:
nomad job status webAllocations ID Node ID Task Group Version Desired Status Created Modified f6972db0 c17bb7a7 app 0 run running 16s ago 2s ago
Шаг 6. Найти порт
Посмотри аллокацию — подставь свой номер.
nomad alloc status f6972db0 | grep http*http yes 127.0.0.1:30043 -> 80Порт 30043 на машине ведёт на порт 80 в контейнере. Флаг -I у curl просит только заголовки ответа.
curl -I 127.0.0.1:30043HTTP/1.1 200 OK Server: nginx/1.30.6
Искать порт руками каждый раз неудобно — эту задачу в следующей практике решит Consul.
Шаг 7. Две копии
Одна копия — простой при каждом обновлении. Допиши первой строкой внутрь группы app:
count = 2Перед отправкой посмотри, что изменится: команда job plan показывает разницу и ничего не меняет — как terraform plan.
nomad job plan web.nomad.hcl+/- 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 и посмотри план.
nomad job plan web.nomad.hcl+/- 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 и через минуту посмотри копии:
nomad job status webID 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. Откатить руками
Каждая отправка задания — новая версия. Посмотри историю.
nomad job history webVersion = 2 Stable = false Version = 1 Stable = true Version = 0 Stable = true
Вывод сокращён до двух строк на версию. Stable = false — версия 2 так и не стала здоровой. Последняя рабочая — версия 1, две копии nginx:1.30. Откатись на неё:
nomad job revert web 1Через полминуты job status покажет две копии running. Откат — это новая версия 3, копия версии 1: история не переписывается. Верни в файле образ nginx:1.30, чтобы файл совпадал с кластером.
Шаг 10. Автооткат
Ночью руками откатывать некому. Правила выката описывает блок update — допиши его в группу, перед task:
update { auto_revert = true healthy_deadline = "1m" progress_deadline = "2m" }
auto_revert — откатить, если новая версия не станет здоровой. healthy_deadline — сколько ждать здоровья одной копии, progress_deadline — сколько ждать прогресса всего выката. Короткие сроки здесь только ради того, чтобы не ждать в практике десять минут. Отправь файл с nginx:1.30 — выкат пройдёт, — затем снова поставь nginx:9.99 и отправь.
nomad job deployments webID 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.
nomad alloc logs f1204355172.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 — о нём следующий урок.