Provision
—— XP

Инструменты: вокруг HashiStack

теория~3 минут+280 XP

Раздел закончен, и это урок-справочник: как за минуту понять, на каком из трёх слоёв сломалось, какие команды держать под рукой и какие программы живут вокруг 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 до кластера.

Проверь себя+280 XPдве попытки
1
Быстрая отладка
Аллокация упала. Какая команда покажет события и причину?
2
Шаблоны заданий
Для чего нужен nomad-pack?
3
Вокруг Vault
Что такое OpenBao?
ответь на все вопросы, чтобы проверить

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