Sealed Secrets: полный рабочий процесс от установки до миграции кластера
Published: 2026-02-11
SealedSecrets позволяет коммитить зашифрованные секреты в Git. Расшифровать их может только контроллер в кластере. В посте - весь рабочий процесс: установка, запечатывание без доступа к кластеру, бэкап сертификата, что будет при переезде на новый кластер и грабли, на которые наступают уже после первой настройки.
Как это работает
При первом запуске контроллер создаёт пару ключей RSA. Публичный ключ может получить любой, у кого есть доступ к кластеру (или копия сертификата). Приватный ключ никогда не покидает кластер.
Вы шифруете манифест Kubernetes Secret публичным ключом → получаете манифест SealedSecret → коммитите его → контроллер расшифровывает его и создаёт настоящий Secret.
По умолчанию шифрование привязано к неймспейсу и имени. SealedSecret для my-secret в неймспейсе app не расшифруется, если переименовать секрет или перенести его в другой неймспейс. Это защищает от replay-атак: SealedSecret, украденный из одного кластера, без приватного ключа в другом кластере не заработает.
Режимы scope
У флага --scope три режима:
| Scope | Привязка |
|---|---|
strict (по умолчанию) |
неймспейс + имя |
namespace-wide |
только неймспейс |
cluster-wide |
без привязки |
cluster-wide удобен для общих секретов (учётные данные container registry), которые должны работать в нескольких неймспейсах без повторного запечатывания. Осторожнее с ним: cluster-wide SealedSecret расшифруется в любом неймспейсе.
Установка
Контроллер ставим через Helm в bootstrap-плейбуке, до запуска FluxCD:
bashhelm repo add sealed-secrets https://bitnami-labs.github.io/sealed-secrets
helm upgrade --install sealed-secrets sealed-secrets/sealed-secrets \
--namespace kube-system \
--set fullnameOverride=sealed-secrets-controller \
--wait --timeout 120s
fullnameOverride=sealed-secrets-controller важен: по умолчанию kubeseal ищет контроллер с именем sealed-secrets-controller. Если релиз называется иначе (например, Helm-релиз sealed-secrets превращается в sealed-secrets-sealed-secrets), kubeseal без явного --controller-name будет падать с невнятными ошибками controller not found.
После установки проверьте, что контроллер запущен и создал ключ:
bashkubectl get pods -n kube-system | grep sealed-secrets
kubectl get secret -n kube-system -l sealedsecrets.bitnami.com/sealed-secrets-key
Селектор по лейблу покажет активный ключ. Если вывод пустой, контроллер ещё не создал ключ. Подождите несколько секунд и повторите.
Получаем и сохраняем публичный сертификат
Когда контроллер запущен, получите публичный сертификат и сохраните его локально:
bashkubeseal --fetch-cert \
--controller-name=sealed-secrets-controller \
--controller-namespace=kube-system \
> ~/.kube/sealed-secrets-infra.pem
Сохраните его в менеджере паролей или в защищённом S3-бакете. Он понадобится, чтобы запечатывать секреты на машинах без kubeconfig-доступа к кластеру.
Сертификат не секретный: это публичный ключ. Его можно спокойно коммитить в репозиторий, в директорию .kubeconfigs/ рядом с SealedSecret, которые им запечатаны. Тогда запечатывать в CI просто, и для самого сертификата не нужно ничего особенного.
Ротация сертификата
По умолчанию контроллер создаёт новый ключ каждые 30 дней, но оставляет старые ключи для расшифровки. Секреты, запечатанные старыми ключами, продолжают работать: контроллер пробует ключи по очереди, пока один не подойдёт.
Принудительная ротация:
bashkubectl annotate secret \
-n kube-system \
-l sealedsecrets.bitnami.com/sealed-secrets-key \
sealedsecrets.bitnami.com/rotate-key=force
После ротации заново получите сертификат и обновите локальный .pem. Старые SealedSecret по-прежнему расшифровываются, новые секреты запечатываются новым ключом.
Запечатывание с доступом к кластеру (самый простой вариант)
Если есть доступ к кластеру:
bash# Создать манифест обычного секрета
kubectl create secret generic my-secret \
--namespace=app \
--from-literal=api-key=supersecret \
--dry-run=client -o yaml \
| kubeseal \
--controller-name=sealed-secrets-controller \
--controller-namespace=kube-system \
--format yaml \
> my-sealed-secret.yaml
kubeseal сам запрашивает сертификат у кластера. Заранее сохранённый .pem не нужен.
Запечатывание без доступа к кластеру (из CI или изолированной сети)
Используйте сохранённый сертификат:
bashkubectl create secret generic my-secret \
--namespace=app \
--from-literal=api-key=supersecret \
--dry-run=client -o yaml \
| kubeseal \
--cert ~/.kube/sealed-secrets-infra.pem \
--format yaml \
> my-sealed-secret.yaml
Так и делает наш GitLab CI, когда запечатывает секреты в пайплайнах деплоя. Сертификат лежит в файловой переменной GitLab CI, kubeconfig не нужен.
Запечатывание для нескольких кластеров из CI
Если кластеров несколько (infra, dev, test) и у каждого свой контроллер Sealed Secrets, для каждого нужен свой .pem:
bash# Запечатать для infra
kubeseal --cert .kubeconfigs/sealed-secrets-infra.pem ...
# Запечатать для dev
kubeseal --cert .kubeconfigs/sealed-secrets-dev.pem ...
Манифесты SealedSecret получатся разными, даже если исходные значения одинаковые: каждый зашифрован своим публичным ключом.
Запечатывание kubeconfig для hub-and-spoke
Kubeconfig - это обычный Secret с ключом-файлом. Запечатываем так же:
bashkubectl create secret generic dev-kubeconfig \
--namespace=flux-system \
--from-file=value=.kubeconfigs/dev.yaml \
--dry-run=client -o yaml \
| kubeseal \
--cert ~/.kube/sealed-secrets-infra.pem \
--format yaml \
> fluxcd/dev-kubeconfig-sealed.yaml
Контроллер на infra его расшифровывает, а Flux через него ходит в dev. Обратите внимание на неймспейс flux-system: он должен совпадать с неймспейсом, где работает Kustomization, которая ссылается на этот секрет.
Запечатывание учётных данных Docker registry
Image pull secrets в формате JSON:
bashkubectl create secret docker-registry registry-creds \
--namespace=app \
--docker-server=registry.example.com \
--docker-username=myuser \
--docker-password=mypass \
--dry-run=client -o yaml \
| kubeseal \
--cert ~/.kube/sealed-secrets-infra.pem \
--format yaml \
> registry-creds-sealed.yaml
Для учётных данных registry на весь кластер (чтобы любой под мог скачивать образы без imagePullSecrets в каждом неймспейсе):
bashkubectl create secret docker-registry registry-creds \
--namespace=kube-system \
--docker-server=registry.example.com \
--docker-username=myuser \
--docker-password=mypass \
--dry-run=client -o yaml \
| kubeseal \
--cert ~/.kube/sealed-secrets-infra.pem \
--scope cluster-wide \
--format yaml \
> registry-creds-sealed.yaml
SealedSecret нельзя обновить частично
Это главная ловушка: операции "обновить поле X" нет. Чтобы поменять любое значение, даже одно поле, придётся заново запечатать весь Secret с новыми значениями и заменить манифест SealedSecret целиком.
Порядок действий:
bash# Получить текущие значения (если они хранятся отдельно)
kubectl get secret my-secret -n app -o yaml | kubectl neat > /tmp/my-secret.yaml
# ИЛИ восстановить с нуля с новыми значениями
# Отредактировать значения в /tmp/my-secret.yaml
# Перезапечатать всё целиком
kubeseal --cert ~/.kube/sealed-secrets-infra.pem --format yaml \
< /tmp/my-secret.yaml > my-sealed-secret.yaml
git add my-sealed-secret.yaml && git commit -m "rotate my-secret" && git push
Поэтому исходные значения нужно хранить где-то ещё (Vault, менеджер паролей). Иначе без доступа к кластеру восстанавливать секрет будет не из чего.
Миграция кластера: перезапечатать всё
Если пересобрать кластер с нуля, контроллер создаст новую пару ключей. Все существующие SealedSecret станут бесполезны: новый контроллер их не расшифрует.
Варианты:
- Восстановить пару ключей: выгрузить ключ из старого кластера до его удаления и загрузить в новый
- Перезапечатать все секреты: скучно, зато чисто, если исходные значения лежат в Vault
Вариант 1: восстановить пару ключей
Выгрузите старый ключ до удаления кластера:
bashkubectl get secret \
-n kube-system \
-l sealedsecrets.bitnami.com/sealed-secrets-key=active \
-o yaml > sealed-secrets-key-backup.yaml
Храните его в менеджере паролей. Это самый чувствительный файл во всей инфраструктуре: у кого он есть, тот расшифрует любой SealedSecret в репозитории.
Загрузите ключ в новый кластер до того, как Flux начнёт реконсиляцию:
bashkubectl apply -f sealed-secrets-key-backup.yaml
kubectl rollout restart deployment sealed-secrets-controller -n kube-system
Контроллер подхватит восстановленный ключ и сможет расшифровать все существующие SealedSecret.
Вариант 2: перезапечатать все секреты
Если все исходные значения лежат в Vault (а так и должно быть), перезапечатать несложно:
- Получить публичный сертификат нового кластера
- Пройтись по всем манифестам SealedSecret
- Взять исходные значения из Vault
- Запечатать их новым сертификатом
- Закоммитить и запушить
Работы больше, но результат чище: не нужно бережно хранить старые ключи.
Проверка расшифровки
После деплоя SealedSecret:
bash# Проверить, синхронизировался ли SealedSecret в настоящий Secret
kubectl get sealedsecret my-secret -n app
kubectl get secret my-secret -n app
# Если Secret не существует, проверить events
kubectl describe sealedsecret my-secret -n app
Типичные ошибки:
| Ошибка | Причина |
|---|---|
no key could decrypt secret |
Не тот кластер: секрет запечатан для другого контроллера |
illegal base64 data |
Сертификат или секрет повредился при копировании |
namespace/name mismatch |
Секрет перенесли или переименовали после запечатывания |
Если видите no key could decrypt secret, проверьте, что SealedSecret запечатан публичным сертификатом нужного кластера. Чаще всего так бывает, когда секрет запечатали для infra, а закоммитили по ошибке в путь dev.