Provision
—— XP

Миссия: Nomad, Consul и Vault вместе

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

Это финал раздела. Три программы, которые ты запускал по одной, заработают вместе: Nomad запустит nginx, Consul даст ему имя и цвет страницы, а Vault — приветствие, причём пароля к Vault не будет ни в задании, ни в переменных. Это та же схема, на которой в компаниях с HashiStack живут настоящие сервисы.

Понадобятся четыре терминала: Consul, Vault и Nomad работают в своих, четвёртый — твой. Держи их окнами tmux из практики про Consul (tmux attach -t hashi, если сессия жива). Если Consul и Vault работают с прошлых практик, ключ web/color и секрет secret/default/web/config уже на месте.

Если стенд выключался

Все три агента в режиме разработки держат состояние в памяти. Выключил стенд между вечерами — пропали ключ, секреты и политика, и миссия упрётся в пустоту. Проверь, жив ли ключ.

ubuntu@stand:~$
consul kv get web/color
ubuntu@stand:~$
green

Цвет на месте — переходи к требованиям. Если вместо него Error! No key exists at: web/color или connection refused, восстанови стенд: запусти в отдельных окнах tmux consul agent -dev и vault server -dev -dev-root-token-id=root, задай в рабочем окне VAULT_ADDR и VAULT_TOKEN как в практике про Vault и положи данные заново.

ubuntu@stand:~$
consul kv put web/color green
ubuntu@stand:~$
vault kv put secret/default/web/config greeting=привет
ubuntu@stand:~$
vault policy write web-read ~/hashi/web-read.hcl

Файл политики лежит на диске с прошлой практики — пропала только её копия в памяти Vault. Так выглядит главный минус режима разработки, и поэтому в проде агенты запускают с каталогом данных на диске (data_dir у Nomad и Consul, storage у Vault), а Vault после перезапуска ещё и распечатывают ключами.

Требования

Миссия засчитывается, когда выполнено всё из списка — его проверит команда сдачи.

  • Vault доверяет Nomad: метод входа jwt-nomad создан.
  • Задание web работает в двух копиях, страница собрана из ключа Consul и секрета Vault.
  • В файле задания нет ни значения секрета, ни токена Vault.
  • В ~/hashi/passport.txt — сравнение с Kubernetes, не меньше шести строк.

Шаг 1. Научить Nomad про Vault

Nomad должен знать, где Vault и какое удостоверение выдавать задачам. Создай ~/hashi/vault.hcl:

~/hashi/vault.hcl
vault {
  enabled = true
  address = "http://127.0.0.1:8200"
  default_identity {
    aud = ["vault.io"]
    ttl = "1h"
  }
}

default_identity — какое удостоверение получит каждая задача с блоком vault: aud — для кого оно выписано, ttl — срок жизни.

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

В терминале Nomad останови его (Ctrl+C) и запусти с этим файлом. Флаг -config добавляет файл настроек к режиму разработки, который включает знакомый флаг -dev.

ubuntu@stand:~$
cd ~/hashi
sudo nomad agent -dev -config=vault.hcl

Задание после перезапуска снова забыто — это нормально, отправишь его в шаге 5.

Шаг 3. Научить Vault доверять Nomad

В рабочем терминале проверь, что переменные Vault на месте: VAULT_ADDR и VAULT_TOKEN=root из прошлой практики. Если терминал новый — задай их заново.

Связку со стороны Vault делает одна команда: она включает метод входа jwt-nomad, создаёт роль и политику, по которой задание читает секреты под secret/data/<пространство>/<задание>/. Флаг -y отвечает «да» на все вопросы.

ubuntu@stand:~$
nomad setup vault -y

Проверь, что метод входа появился: vault auth list, в списке должна быть строка jwt-nomad/.

Шаг 4. Задача просит секрет

Открой ~/hashi/web.nomad.hcl. В задачу nginx добавь пустой блок — он говорит «этой задаче нужен Vault»:

в задачу nginx
      vault {}

Шаблон из прошлой практики замени на такой. Конструкция <<-EOT … EOT — многострочный текст в HCL.

в задачу nginx, вместо старого template
      template {
        data = <<-EOT
          Цвет: {{ key "web/color" }}
          {{ with secret "secret/data/default/web/config" }}Привет: {{ .Data.data.greeting }}{{ end }}
        EOT
        destination = "local/index.html"
        change_mode = "noop"
      }

Первая строка берёт ключ из Consul, вторая — поле greeting секрета из Vault. Слово default в пути — пространство имён Nomad, web — имя задания: ровно этот путь разрешила политика из шага 3.

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

Отправь задание с новым шаблоном.

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

Если выкат завис, разбери аллокацию, как в уроке про Nomad: nomad job status web, затем nomad alloc status с номером. Ошибка шаблона видна в событиях — например, permission denied, если путь секрета не совпал с политикой.

Шаг 6. Найти и открыть

Найди порт копии через Consul, как в практике 5:

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

И открой страницу по этому порту:

ubuntu@stand:~$
curl -s 127.0.0.1:23456

На странице должны быть обе строки: цвет из Consul и «Привет: привет» из Vault.

Шаг 7. Пароля нет нигде

Проверь главное: значения секрета нет в описании задания. Флаг -c у grep считает совпадения.

ubuntu@stand:~$
grep -c привет web.nomad.hcl

Ноль. Токена Vault там тоже нет: задача доказала, кто она, удостоверением, которое подписал Nomad.

Шаг 8. Поменять секрет

Поменяй приветствие в Vault:

ubuntu@stand:~$
vault kv put secret/default/web/config greeting=здравствуй

Обычные секреты KV шаблон перечитывает не мгновенно, а раз в несколько минут. Подожди и снова запроси страницу — приветствие поменяется без выката. Для секретов, которые обязаны меняться сразу, в шаблоне ставят change_mode = "restart" и перевыкатывают задание.

Шаг 9. Паспорт со сравнением

Создай ~/hashi/passport.txt. В каждой строке — задача и как она решена здесь и в разделах 16–18 про Kubernetes, в формате «задача: Nomad … / Kubernetes …» — двоеточие после задачи и косая черта между ответами обязательны, по ним паспорт и проверяется. Минимум шесть строк:

  • запуск копий;
  • выкат и откат;
  • поиск сервиса по имени;
  • конфигурация, меняющаяся без выката;
  • секреты;
  • права приложения на секреты.

Например: «секреты: Vault с политикой на путь / Secret в base64 или Vault через External Secrets». Отправь команду сдачи.

Что спросят на собеседовании

  • Как задание Nomad получает секрет из Vault без токена в описании?
    Nomad выдаёт задаче подписанное удостоверение, Vault проверяет его по методу входа jwt-nomad и выдаёт токен с политикой на путь этого задания. Секрет приходит в задачу через template.
  • Чем HashiStack отличается от Kubernetes в эксплуатации?
    Три отдельные программы вместо одной системы: проще поставить и понять каждую, но связывать их приходится самому, а готовых решений вокруг меньше.

Что дальше

Раздел закончен. Остался обзор инструментов вокруг HashiStack с быстрой отладкой и шпаргалкой.

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

Запускать сервис на HashiStack с секретом из Vault без паролей в описании и объяснять, чем это отличается от того же в Kubernetes.

  • Страница собрана из Consul и Vault
  • Vault доверяет Nomad
  • Задача просит Vault
  • Секрета нет в описании
  • Две копии работают
  • Паспорт со сравнением
Команда сдачи — выполни на своей машине
команда
export VAULT_ADDR=http://127.0.0.1:8200; 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 | tr '\n' ' ')"; echo "AUTH=$(VAULT_TOKEN=root vault auth list 2>/dev/null | grep -c jwt-nomad)"; echo "VAULTBLOCK=$(grep -c 'vault *{' ~/hashi/web.nomad.hcl 2>/dev/null)"; echo "PLAIN=$(grep -c 'привет' ~/hashi/web.nomad.hcl 2>/dev/null)"; echo "RUNNING=$(nomad job status web 2>/dev/null | grep -c ' running ')"; echo "PASSPORT=$(grep -c ':.*/' ~/hashi/passport.txt 2>/dev/null)"; echo ---; cat ~/hashi/passport.txt 2>/dev/null

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