Provision
—— XP

ConfigMap и Secret: настройки отдельно от образа

теория~7 минут+250 XP

Частая ошибка новичка — вписать адрес базы и пароль прямо в образ или в описание Deployment. Работает, пока среда одна. Потом понадобится стенд с другой базой, и придётся собирать второй образ или держать вторую копию описания, а пароль окажется в git у всех, кто клонировал репозиторий. Этот урок о том, как держать настройки и секреты отдельно от приложения.

ConfigMap — объект кластера для настроек приложения: уровень логов, адрес базы, имя среды. Secret — такой же объект для того, что показывать нельзя: паролей, токенов, ключей. Оба подключаются к поду как переменные окружения или как файлы.

Это то же, что в Compose из раздела 08 делали environment: и файл .env: один образ работает и на стенде, и в проде, а различаются они только подключёнными настройками. Но у кластера есть свои подвохи, и главный из них — правка, которая не доходит до работающего пода.

ConfigMap

ConfigMap — просто список пар «ключ: значение», вроде листка с подписанными строчками. Посмотри на короткий пример.

10-configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: provision-config
  namespace: provision
data:
  LOG_LEVEL: info
  DB_HOST: provision-db
  DB_PORT: "5432"      # кавычки обязательны

Все значения в ConfigMap — строки. Число 5432 без кавычек YAML прочитает как число, и kubectl откажется применять файл, поэтому кавычки обязательны.

Подключить все ключи сразу переменными окружения можно четырьмя строками в описании контейнера.

в 30-deployment.yaml, внутри контейнера
          envFrom:
            - configMapRef:
                name: provision-config

Каждый ключ станет переменной с тем же именем: в поде появятся LOG_LEVEL, DB_HOST, DB_PORT. Целые конфигурационные файлы тоже кладут в ConfigMap и подключают томом — тогда они появляются в контейнере как файлы в каталоге. Этот способ ты встретишь в чужих чартах, для стенда хватит переменных.

Правка не доходит до пода

Здесь ловушка, на которой теряют часы. Ты поменял LOG_LEVEL в ConfigMap, применил файл, kubectl get configmap показывает новое значение, а приложение пишет логи по-старому.

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

Лечится пересозданием подов. Вручную это одна команда: kubectl rollout restart deploy/provision-app — Deployment заменит поды по одному, как при обновлении. Автоматически это делают через контрольную сумму настроек в описании пода; её считает Helm, и ты увидишь её в следующем разделе.

Secret

Secret устроен почти так же. Вместо data удобно писать stringData — обычным текстом, а кластер закодирует сам.

11-secret.yaml — в git НЕ кладётся
apiVersion: v1
kind: Secret
metadata:
  name: provision-secrets
  namespace: provision
stringData:
  DB_PASSWORD: provision-local-pass

В кластере значение хранится в кодировке base64 — способ записать любые байты буквами и цифрами. Выглядит это как шифр, но не шифр: строка раскодируется одной командой base64 -d в любом терминале. Кодирование появилось затем, чтобы двоичный ключ не ломал YAML, а не ради защиты.

Чем же Secret лучше ConfigMap? Права на чтение секретов выдают отдельно, kubectl describe не печатает их значения, а шифрование хранилища etcd можно включить именно для них. Сам по себе он ничего не прячет: кто может читать секреты в пространстве имён, знает все пароли в нём.

В git файл секрета не кладут никогда: base64 не защищает, а история хранит значение навсегда. В репозитории лежит образец с пустыми значениями, а настоящий файл — в .gitignore, как .env в разделе 08. Для работы командой есть инструменты, которые хранят секреты зашифрованными или берут их из хранилища вроде Vault из раздела 19: Sealed Secrets, SOPS, External Secrets. Пока достаточно знать, что они есть.

Данные, которые переживают под

Настройки и пароли вынесены. Остаётся третий вид состояния — данные базы. Всё, что записано внутрь контейнера, исчезает вместе с подом, а под смертен.

Пять понятий хранилища: emptyDir живёт со подом, hostPath привязывает к узлу, PersistentVolume это сам том, PersistentVolumeClaim — заявка на него, StorageClass — способ создания.
Под просит объём заявкой, а чем её выполнить, решает кластер по классу хранилища. Поэтому одно описание работает и на ноутбуке, и в облаке.

Диск в кластере получают через заявку — PersistentVolumeClaim, сокращённо PVC: «мне нужно 2 гигабайта с записью». Кластер выдаёт под неё том (PersistentVolume), а как его создать, знает класс хранилища. В k3s класс называется local-path и просто заводит каталог на узле, в облаке это настоящий сетевой диск.

Базы описывают не Deployment, а StatefulSet: у его подов постоянные имена вроде provision-db-0, и каждый получает свою заявку, которая не удаляется вместе с подом. Состояние заявки показывает kubectl get pvc: Bound — том выдан, Pending — тома пока нет. В k3s это бывает и в норме: хранилище local-path выдаёт диск на конкретном узле, поэтому ждёт, пока под с заявкой назначат на узел (режим WaitForFirstConsumer), и только потом создаёт том. Заявка без пода висит в Pending — это не поломка; поломка — когда под уже есть, а заявка так и не стала Bound. Базу стенда ты поднимешь так в миссии раздела.

Словарь урока

ConfigMap
Объект с настройками «ключ: значение». Подключается к поду переменными окружения или файлами. ↩ к тексту
Secret
Такой же объект для чувствительных значений. Хранит их в base64 — это кодирование, а не шифрование. ↩ к тексту
envFrom
Подключение всех ключей ConfigMap или Secret переменными окружения разом.
rollout restart
Пересоздание подов Deployment по одному. Нужно, чтобы поды увидели новые переменные.
PersistentVolumeClaim
Заявка на диск. Bound — выдан, Pending — ещё не выдан: ждёт под или не нашлось подходящего. ↩ к тексту

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

  • Поправили ConfigMap, а приложение не видит изменений. Почему?
    Переменные окружения читаются при старте процесса. Нужно пересоздать поды: kubectl rollout restart или контрольная сумма конфигурации в аннотации пода.
  • Secret безопаснее ConfigMap?
    Сам по себе почти нет: base64 раскодируется одной командой. Безопаснее то, что вокруг: отдельные права, шифрование etcd, внешнее хранилище секретов.
  • Как хранить секреты для кластера в git?
    Открытыми — никак. Образец без значений в репозитории, сами значения — через Sealed Secrets, SOPS или оператор, который берёт их из Vault.

Что дальше

В практике ты вынесешь настройки и пароль стенда в эти два объекта, раскодируешь секрет своими руками и поймаешь ловушку с переменными, которые не обновляются.

Проверь себя+250 XPдве попытки
1
Настройки отдельно
Зачем выносить настройки из образа и из Deployment в ConfigMap?
2
Не обновляется само
Ты поменял значение в ConfigMap и применил файл. Что увидит приложение, читающее переменную окружения?
3
Secret
Что даёт кодирование base64 в Secret?
4
Данные
В k3s заявка на диск висит в Pending, а пода, который её использует, ещё нет. Что это значит?
ответь на все вопросы, чтобы проверить

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