VK Cloud logo

Использование cert-operator

Используйте аддон cert-operator, чтобы загружать образы из реестров контейнеров с самоподписанными сертификатами. Аддон самостоятельно обеспечивает доверие к реестру.

Подготовительные шаги

  1. Создайте кластер актуальной версии, если это еще не сделано.

  2. Убедитесь, что вы можете подключиться к кластеру с помощью kubectl.

  3. Установите аддон cert-operator, если это еще не сделано.

  4. Подготовьте CA-сертификат реестра в формате PEM. Если нужна цепочка, объедините несколько сертификатов подряд.

    Аддон работает только с CA-сертификатами и их цепочками. Клиентские сертификаты, приватные ключи и взаимная аутентификация TLS (mutual TLS, mTLS) не используются.

1. Создайте объект RegistryCertificate

  1. Создайте манифест registry-certificate.yaml — объект типа RegistryCertificate, который описывает CA-сертификат реестра:

    apiVersion: crio.registry/v1alpha1kind: RegistryCertificatemetadata:  name: <ИМЯ_ОБЪЕКТА>spec:  host: <АДРЕС_РЕЕСТРА>  certificate: |    -----BEGIN CERTIFICATE-----    <СОДЕРЖИМОЕ_СЕРТИФИКАТА>    -----END CERTIFICATE-----

    Здесь:

    • <ИМЯ_ОБЪЕКТА> — любое уникальное имя. Объект относится ко всему кластеру, пространство имен не указывается.

    • <АДРЕС_РЕЕСТРА> — адрес реестра в формате host[:port], например registry.example.com:5000.

      Если для одного адреса реестра создано несколько объектов, применяется первый по алфавиту. Если адрес реестра в объекте указан некорректно, объект не применяется.

    • <СОДЕРЖИМОЕ_СЕРТИФИКАТА> — содержимое CA-сертификата.

      Если сертификат в объекте некорректен, он не применяется. Если для этого реестра ранее был применен CA-сертификат, он остается без изменений.

  2. Примените созданный манифест в кластере:

    kubectl apply -f registry-certificate.yaml

    Аддон перенесет CA-сертификат на все worker-узлы. По умолчанию это занимает не более 30 секунд. Если позднее изменить CA-сертификат в объекте, аддон заменит прежний сертификат на узлах новым.

2. Проверьте работу аддона

Убедитесь, что аддон применил CA-сертификат, выполнив команду:

kubectl describe regcert <ИМЯ_ОБЪЕКТА>

Состояние применения CA-сертификата для каждого worker-узла указано в поле State:

  • Synced — CA-сертификат применен.
  • Failed — CA-сертификат не применен. Причина указана в поле Message.

Подробнее об особенностях и ограничениях применения CA-сертификатов с помощью cert-operator в разделе Аддоны.

Удалите неиспользуемые ресурсы

Работающий кластер тарифицируется и потребляет вычислительные ресурсы. Если ресурсы Kubernetes, созданные для проверки работы аддона cert-operator, вам больше не нужны, удалите их:

  1. Удалите объект RegistryCertificate:

    kubectl delete regcert <ИМЯ_ОБЪЕКТА>

    Аддон удалит CA-сертификат с worker-узлов. В результате CA-сертификат перестанет применяться, а реестр перестанет быть доверенным.

  2. (Опционально) Удалите аддон.

    CA-сертификаты, уже записанные на узлы, останутся, но синхронизация объектов RegistryCertificate прекратится. Чтобы возобновить синхронизацию, необходимо будет установить аддон повторно.

  3. Остановите созданный кластер, чтобы воспользоваться им позже, или удалите его навсегда.

Была ли статья полезна?