Сейчас настройки приложения вписаны прямо в Deployment, а пароля базы нет вовсе. Ты вынесешь их в отдельные объекты, как это делают в любом проекте, и подключишь к подам.
Главная часть — в конце: ты поменяешь настройку и убедишься, что работающий под её не заметил. Один раз увидеть это своими глазами дешевле, чем потом искать причину два часа.
Шаг 1. ConfigMap
В каталоге ~/infra/k8s/base создай 10-configmap.yaml. Номер меньше, чем у Deployment: настройки должны существовать раньше подов, которые их читают. Начнём с одной настройки — уровня журнала.
apiVersion: v1 kind: ConfigMap metadata: name: provision-config namespace: provision data: LOG_LEVEL: info
Шаг 2. Применить и посмотреть
Отдай объект кластеру и проверь, что значение на месте.
kubectl apply -f 10-configmap.yamlconfigmap/provision-config createdkubectl describe configmap provision-config | grep -A2 LOGLOG_LEVEL: ---- info
Флаг -A2 у grep печатает ещё две строки после найденной. Значения ConfigMap describe показывает открыто — секретов здесь быть не должно.
Шаг 3. Подключить к приложению
ConfigMap лежит в кластере, но поды о нём не знают. Открой 30-deployment.yaml и замени блок env в контейнере на этот.
envFrom: - configMapRef: name: provision-config
envFrom превращает каждый ключ ConfigMap в переменную окружения пода. Правка шаблона пода — значит, обновление.
kubectl apply -f 30-deployment.yamldeployment.apps/provision-app configuredkubectl rollout status deploy/provision-appdeployment "provision-app" successfully rolled outЗагляни в окружение одного из подов. Запись deploy/provision-app вместо имени пода значит «любой под этого Deployment».
kubectl exec deploy/provision-app -- env | grep LOGLOG_LEVEL=infoШаг 4. Поменять настройку
Теперь ловушка. В 10-configmap.yaml поменяй LOG_LEVEL: info на LOG_LEVEL: debug и примени.
kubectl apply -f 10-configmap.yamlconfigmap/provision-config configuredШаг 5. Поды не заметили
Спроси под, какой у него уровень логов.
kubectl exec deploy/provision-app -- env | grep LOGLOG_LEVEL=infoОбъект в кластере уже debug, а в поде — по-прежнему info. Ничего не сломалось: процесс получил переменные при старте и больше их не читает. Первая мысль в такой ситуации — «не применилось», и она всегда неверная.
Шаг 6. Пересоздать поды
Попроси Deployment заменить поды по одному.
kubectl rollout restart deploy/provision-appdeployment.apps/provision-app restartedПерезапуск идёт в фоне: команда вернула приглашение сразу, а старые поды ещё живы. Спросишь сейчас — exec может попасть в старый под и показать info. Дождись, пока выкат закончится.
kubectl rollout status deploy/provision-appWaiting for deployment "provision-app" rollout to finish: 3 of 4 updated replicas are available... deployment "provision-app" successfully rolled out
kubectl exec deploy/provision-app -- env | grep LOGLOG_LEVEL=debugНовые поды прочитали новое значение. Запомни связку: поменял ConfigMap или Secret — пересоздай поды. В разделе про Helm это будет происходить само.
Шаг 7. Секрет
Пароль базы в ConfigMap не кладут: его значения видны всем, кто может читать объект. Для паролей есть Secret. Создай 11-secret.yaml.
apiVersion: v1 kind: Secret metadata: name: provision-secrets namespace: provision stringData: DB_PASSWORD: provision-local-pass
Пароль тот же, что был у базы в Compose. stringData — значения обычным текстом, кластер сам их закодирует.
kubectl apply -f 11-secret.yamlsecret/provision-secrets createdkubectl describe secret provision-secrets | tail -3Data ==== DB_PASSWORD: 20 bytes
В отличие от ConfigMap, describe показывает только размер. Выглядит надёжно — посмотрим, насколько.
Шаг 8. Раскодировать
Попроси объект целиком в YAML и найди строки с паролем. Флаг -o yaml выводит объект целиком.
kubectl get secret provision-secrets -o yaml | grep PASSDB_PASSWORD: cHJvdmlzaW9uLWxvY2FsLXBhc3M= {"apiVersion":"v1","kind":"Secret","metadata":{"annotations":{},"name":"provision-secrets","namespace":"provision"},"stringData":{"DB_PASSWORD":"provision-local-pass"}}
Строк две. Первая — значение в кодировке base64, раскодируй его. Флаг -d у base64 — раскодировать.
echo cHJvdmlzaW9uLWxvY2FsLXBhc3M= | base64 -dprovision-local-passBase64 — не шифрование, а просто запись байтов буквами. Вторая строка ещё проще: это аннотация last-applied-configuration, в которую kubectl apply кладёт копию файла, — и пароль в ней открытым текстом. Вот и вся «защита»: кто может читать секреты, тот видит пароль. Поэтому права на секреты выдают отдельно, а секреты, созданные командой kubectl create secret, такой аннотации не получают. Об этом подробнее в разделе 18.
Шаг 9. Пароль — в приложение
Отдельный ключ секрета подключают по имени. Допиши в контейнер под envFrom:
env: - name: DB_PASSWORD valueFrom: secretKeyRef: name: provision-secrets key: DB_PASSWORD
secretKeyRef берёт один ключ из секрета. Примени Deployment и проверь:
kubectl exec deploy/provision-app -- env | grep DB_DB_PASSWORD=provision-local-passШаг 10. Что увидит git
Перед коммитом посмотрим, что git собирается взять. Перейди в корень репозитория.
cd ~/infragit status --short?? 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 и допиши строку.
k8s/**/11-secret.yamlДве звёздочки значат «в любом подкаталоге k8s». Проверь — команда печатает путь, если файл игнорируется, и молчит, если нет.
git check-ignore k8s/base/11-secret.yamlk8s/base/11-secret.yamlКоллеге всё равно нужно знать, какой секрет завести. Для этого в git кладут образец без значения. Вернись в каталог описаний (cd ~/infra/k8s/base) и создай 11-secret.yaml.example — окончание .example нарочно не .yaml: kubectl, применяя каталог целиком, берёт только файлы .yaml, и пустой образец не перезапишет настоящий секрет.
# Образец. Скопировать в 11-secret.yaml и заполнить. apiVersion: v1 kind: Secret metadata: name: provision-secrets namespace: provision stringData: DB_PASSWORD: ""
Образец под правило не попадает и уйдёт в репозиторий.
Шаг 12. Адрес базы
Приложению осталось знать, где база. Допиши в ConfigMap адрес и имена — пароль в них не входит, им место здесь.
DB_HOST: provision-db DB_PORT: "5432" DB_NAME: provision DB_USER: provision
Адрес базы — имя сервиса provision-db, которого пока нет. Базу ты поднимешь в миссии, а приложение до тех пор работает без неё: проба /health в базу не ходит. Строку подключения целиком собирает сам кластер — допиши в env Deployment под DB_PASSWORD:
- name: DATABASE_URL value: "postgres://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):$(DB_PORT)/$(DB_NAME)"
Запись $(ИМЯ) — подстановка уже объявленных переменных: кластер соберёт строку подключения сам, и пароль в файле не появится. Примени оба файла одной командой — каждый флаг -f добавляет файл.
kubectl apply -f 10-configmap.yaml -f 30-deployment.yamlconfigmap/provision-config configured deployment.apps/provision-app configured
Deployment изменился, поэтому поды пересоздадутся сами и прочитают новые ключи. Дождись rollout status и проверь:
kubectl exec deploy/provision-app -- env | grep provision-dbDATABASE_URL=postgres://provision:provision-local-pass@provision-db:5432/provision DB_HOST=provision-db
Что дальше
Приложение настроено и доступно внутри кластера. Осталось впустить к нему запросы снаружи — это Ingress.