Раздел закончен, и это урок-справочник: как за минуту понять, на каком из трёх слоёв сломалось, какие команды держать под рукой и какие программы живут вокруг HashiStack. Ставить ничего прямо сейчас не нужно.
Быстрая отладка
Сломаться может любая из трёх программ, и начинать стоит с вопроса «какая». Пять команд идут от задачи к окружению.
nomad job status web # какие аллокации живы, какие упали nomad alloc status a1b2c3d4 # события: почему упала nomad alloc logs a1b2c3d4 # что написала программа consul catalog services # зарегистрирован ли сервис vault status # жив ли Vault и не запечатан ли
Если задача не стартует и в событиях висит шаблон, причина почти всегда на соседнем слое: нет ключа в Consul — шаблон ждёт его вечно; запечатан Vault или путь не совпал с политикой — permission denied. Подробно отладку разберём в разделе 20.
Отладка — это когда сломалось. На каждый день хватит короткого списка.
Шпаргалка раздела
Восемь команд, которые встретились в практиках.
nomad job plan web.nomad.hcl # что изменится, без изменений nomad job run web.nomad.hcl # отправить задание nomad job history web # версии задания nomad job revert web 0 # вернуть версию consul kv put web/color blue # записать ключ vault kv get secret/default/web/config # прочитать секрет vault policy write web-read web-read.hcl # загрузить политику vault token lookup # свой токен и его политики
Эти команды закрывают ручную работу. Остальное за тебя делают программы вокруг набора.
Интерфейсы и шаблоны
У всех трёх программ есть встроенный веб-интерфейс: Nomad на порту 4646, Consul на 8500, Vault на 8200. В отличие от Kubernetes, ставить для этого ничего не нужно — интерфейс входит в ту же программу.
Для повторяющихся заданий есть nomad-pack: пакет — шаблон задания со значениями, как чарт Helm. Реестр пакетов заметно меньше, чем у Helm, и многие команды пишут задания руками, а общие куски выносят в переменные. Сами кластеры и настройки Vault в проде часто описывают Terraform-провайдерами nomad и vault — тем же способом, что в разделе 15.
Последняя группа — вокруг Vault, потому что он встречается и без двух других.
Вокруг Vault
Vault Agent — помощник, который сам входит в Vault, получает секреты и кладёт их в файл рядом с приложением. Нужен там, где нет Nomad с его блоком template: на обычных машинах или в Kubernetes.
External Secrets — оператор Kubernetes из раздела 18: тянет секреты из Vault и превращает их в обычные объекты Secret. OpenBao — открытый форк Vault под Linux Foundation; команды и понятия совпадают, и всё из этого раздела к нему применимо.
Что дальше
HashiStack разобран. Дальше — раздел про отладку и инциденты: как искать причину аварии на любом слое, от Linux до кластера.