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 станут бесполезны: новый контроллер их не расшифрует.

Варианты:

  1. Восстановить пару ключей: выгрузить ключ из старого кластера до его удаления и загрузить в новый
  2. Перезапечатать все секреты: скучно, зато чисто, если исходные значения лежат в 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 (а так и должно быть), перезапечатать несложно:

  1. Получить публичный сертификат нового кластера
  2. Пройтись по всем манифестам SealedSecret
  3. Взять исходные значения из Vault
  4. Запечатать их новым сертификатом
  5. Закоммитить и запушить

Работы больше, но результат чище: не нужно бережно хранить старые ключи.


Проверка расшифровки

После деплоя 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.