Provision
—— XP

Практика: настройки и пароль стенда

практика~35 минут+625 XP

Сейчас настройки приложения вписаны прямо в Deployment, а пароля базы нет вовсе. Ты вынесешь их в отдельные объекты, как это делают в любом проекте, и подключишь к подам.

Главная часть — в конце: ты поменяешь настройку и убедишься, что работающий под её не заметил. Один раз увидеть это своими глазами дешевле, чем потом искать причину два часа.

Шаг 1. ConfigMap

В каталоге ~/infra/k8s/base создай 10-configmap.yaml. Номер меньше, чем у Deployment: настройки должны существовать раньше подов, которые их читают. Начнём с одной настройки — уровня журнала.

nano 10-configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: provision-config
  namespace: provision
data:
  LOG_LEVEL: info

Шаг 2. Применить и посмотреть

Отдай объект кластеру и проверь, что значение на месте.

ubuntu@stand:~$
kubectl apply -f 10-configmap.yaml
ubuntu@stand:~$
configmap/provision-config created
ubuntu@stand:~$
kubectl describe configmap provision-config | grep -A2 LOG
ubuntu@stand:~$
LOG_LEVEL:
----
info

Флаг -A2 у grep печатает ещё две строки после найденной. Значения ConfigMap describe показывает открыто — секретов здесь быть не должно.

Шаг 3. Подключить к приложению

ConfigMap лежит в кластере, но поды о нём не знают. Открой 30-deployment.yaml и замени блок env в контейнере на этот.

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

envFrom превращает каждый ключ ConfigMap в переменную окружения пода. Правка шаблона пода — значит, обновление.

ubuntu@stand:~$
kubectl apply -f 30-deployment.yaml
ubuntu@stand:~$
deployment.apps/provision-app configured
ubuntu@stand:~$
kubectl rollout status deploy/provision-app
ubuntu@stand:~$
deployment "provision-app" successfully rolled out

Загляни в окружение одного из подов. Запись deploy/provision-app вместо имени пода значит «любой под этого Deployment».

ubuntu@stand:~$
kubectl exec deploy/provision-app -- env | grep LOG
ubuntu@stand:~$
LOG_LEVEL=info

Шаг 4. Поменять настройку

Теперь ловушка. В 10-configmap.yaml поменяй LOG_LEVEL: info на LOG_LEVEL: debug и примени.

ubuntu@stand:~$
kubectl apply -f 10-configmap.yaml
ubuntu@stand:~$
configmap/provision-config configured

Шаг 5. Поды не заметили

Спроси под, какой у него уровень логов.

ubuntu@stand:~$
kubectl exec deploy/provision-app -- env | grep LOG
ubuntu@stand:~$
LOG_LEVEL=info

Объект в кластере уже debug, а в поде — по-прежнему info. Ничего не сломалось: процесс получил переменные при старте и больше их не читает. Первая мысль в такой ситуации — «не применилось», и она всегда неверная.

Шаг 6. Пересоздать поды

Попроси Deployment заменить поды по одному.

ubuntu@stand:~$
kubectl rollout restart deploy/provision-app
ubuntu@stand:~$
deployment.apps/provision-app restarted

Перезапуск идёт в фоне: команда вернула приглашение сразу, а старые поды ещё живы. Спросишь сейчас — exec может попасть в старый под и показать info. Дождись, пока выкат закончится.

ubuntu@stand:~$
kubectl rollout status deploy/provision-app
ubuntu@stand:~$
Waiting for deployment "provision-app" rollout to finish: 3 of 4 updated replicas are available...
deployment "provision-app" successfully rolled out
ubuntu@stand:~$
kubectl exec deploy/provision-app -- env | grep LOG
ubuntu@stand:~$
LOG_LEVEL=debug

Новые поды прочитали новое значение. Запомни связку: поменял ConfigMap или Secret — пересоздай поды. В разделе про Helm это будет происходить само.

Шаг 7. Секрет

Пароль базы в ConfigMap не кладут: его значения видны всем, кто может читать объект. Для паролей есть Secret. Создай 11-secret.yaml.

nano 11-secret.yaml
apiVersion: v1
kind: Secret
metadata:
  name: provision-secrets
  namespace: provision
stringData:
  DB_PASSWORD: provision-local-pass

Пароль тот же, что был у базы в Compose. stringData — значения обычным текстом, кластер сам их закодирует.

ubuntu@stand:~$
kubectl apply -f 11-secret.yaml
ubuntu@stand:~$
secret/provision-secrets created
ubuntu@stand:~$
kubectl describe secret provision-secrets | tail -3
ubuntu@stand:~$
Data
====
DB_PASSWORD:  20 bytes

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

Шаг 8. Раскодировать

Попроси объект целиком в YAML и найди строки с паролем. Флаг -o yaml выводит объект целиком.

ubuntu@stand:~$
kubectl get secret provision-secrets -o yaml | grep PASS
ubuntu@stand:~$
  DB_PASSWORD: cHJvdmlzaW9uLWxvY2FsLXBhc3M=
      {"apiVersion":"v1","kind":"Secret","metadata":{"annotations":{},"name":"provision-secrets","namespace":"provision"},"stringData":{"DB_PASSWORD":"provision-local-pass"}}

Строк две. Первая — значение в кодировке base64, раскодируй его. Флаг -d у base64 — раскодировать.

ubuntu@stand:~$
echo cHJvdmlzaW9uLWxvY2FsLXBhc3M= | base64 -d
ubuntu@stand:~$
provision-local-pass

Base64 — не шифрование, а просто запись байтов буквами. Вторая строка ещё проще: это аннотация last-applied-configuration, в которую kubectl apply кладёт копию файла, — и пароль в ней открытым текстом. Вот и вся «защита»: кто может читать секреты, тот видит пароль. Поэтому права на секреты выдают отдельно, а секреты, созданные командой kubectl create secret, такой аннотации не получают. Об этом подробнее в разделе 18.

Шаг 9. Пароль — в приложение

Отдельный ключ секрета подключают по имени. Допиши в контейнер под envFrom:

30-deployment.yaml, внутри контейнера, под envFrom
          env:
            - name: DB_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: provision-secrets
                  key: DB_PASSWORD

secretKeyRef берёт один ключ из секрета. Примени Deployment и проверь:

ubuntu@stand:~$
kubectl exec deploy/provision-app -- env | grep DB_
ubuntu@stand:~$
DB_PASSWORD=provision-local-pass

Шаг 10. Что увидит git

Перед коммитом посмотрим, что git собирается взять. Перейди в корень репозитория.

ubuntu@stand:~$
cd ~/infra
ubuntu@stand:~$
git status --short
ubuntu@stand:~$
?? k8s/base/10-configmap.yaml
?? k8s/base/11-secret.yaml
?? k8s/base/30-deployment.yaml

11-secret.yaml с паролем — в списке. Одно git add k8s — и пароль навсегда в истории.

Шаг 11. Закрыть настоящий файл от git

Открой nano ~/infra/.gitignore и допиши строку.

~/infra/.gitignore, в конец
k8s/**/11-secret.yaml

Две звёздочки значат «в любом подкаталоге k8s». Проверь — команда печатает путь, если файл игнорируется, и молчит, если нет.

ubuntu@stand:~$
git check-ignore k8s/base/11-secret.yaml
ubuntu@stand:~$
k8s/base/11-secret.yaml

Коллеге всё равно нужно знать, какой секрет завести. Для этого в git кладут образец без значения. Вернись в каталог описаний (cd ~/infra/k8s/base) и создай 11-secret.yaml.example — окончание .example нарочно не .yaml: kubectl, применяя каталог целиком, берёт только файлы .yaml, и пустой образец не перезапишет настоящий секрет.

nano 11-secret.yaml.example
# Образец. Скопировать в 11-secret.yaml и заполнить.
apiVersion: v1
kind: Secret
metadata:
  name: provision-secrets
  namespace: provision
stringData:
  DB_PASSWORD: ""

Образец под правило не попадает и уйдёт в репозиторий.

Шаг 12. Адрес базы

Приложению осталось знать, где база. Допиши в ConfigMap адрес и имена — пароль в них не входит, им место здесь.

10-configmap.yaml, в data
  DB_HOST: provision-db
  DB_PORT: "5432"
  DB_NAME: provision
  DB_USER: provision

Адрес базы — имя сервиса provision-db, которого пока нет. Базу ты поднимешь в миссии, а приложение до тех пор работает без неё: проба /health в базу не ходит. Строку подключения целиком собирает сам кластер — допиши в env Deployment под DB_PASSWORD:

30-deployment.yaml, в env
            - name: DATABASE_URL
              value: "postgres://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):$(DB_PORT)/$(DB_NAME)"

Запись $(ИМЯ) — подстановка уже объявленных переменных: кластер соберёт строку подключения сам, и пароль в файле не появится. Примени оба файла одной командой — каждый флаг -f добавляет файл.

ubuntu@stand:~$
kubectl apply -f 10-configmap.yaml -f 30-deployment.yaml
ubuntu@stand:~$
configmap/provision-config configured
deployment.apps/provision-app configured

Deployment изменился, поэтому поды пересоздадутся сами и прочитают новые ключи. Дождись rollout status и проверь:

ubuntu@stand:~$
kubectl exec deploy/provision-app -- env | grep provision-db
ubuntu@stand:~$
DATABASE_URL=postgres://provision:provision-local-pass@provision-db:5432/provision
DB_HOST=provision-db

Что дальше

Приложение настроено и доступно внутри кластера. Осталось впустить к нему запросы снаружи — это Ingress.

Практика 05+625 XP

Подключать настройки и секреты к поду отдельными объектами и знать, что после их правки поды надо пересоздать.

  • Настройки пришли из ConfigMap
  • Пароль пришёл из Secret
  • Новое значение доехало до пода
  • Файл секрета исключён из git
Команда сдачи — выполни на своей машине
команда
kubectl -n provision exec deploy/provision-app -- env | grep -E 'LOG_LEVEL|DB_HOST|DATABASE_URL'; git -C ~/infra check-ignore k8s/base/11-secret.yaml

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