Доступно в редакциях:  Open/CE, BE, SE, SE+, Ultimate/EE, Core, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)

Входит в расширения: Продвинутое межкластерное взаимодействие

Стадия жизненного цикла модуля: General Availability

Устанавливает надежную и высокодоступную инсталляцию cert-manager версии 1.21.2.

При установке модуля автоматически учитываются особенности кластера:

  • компонент (webhook), к которому обращается kube-apiserver, устанавливается на master-узлы;
  • в случае недоступности вебхука производится временное удаление apiservice, чтобы недоступность cert-manager не блокировала работу кластера.

Обновление самого модуля происходит в автоматическом режиме, в том числе с миграцией ресурсов cert-manager.

Возможности модуля cert-manager (с учетом внесенных изменений)

Модуль обеспечивает использование всех возможностей оригинального cert-manager, в том числе:

  • заказ сертификатов во всех поддерживаемых источниках, таких как Let’s Encrypt, HashiCorp Vault, Venafi;
  • выпуск самоподписанных сертификатов;
  • поддержку актуальности сертификатов, автоматический перевыпуск и т. д.

Изменения в оригинальный cert-manager были внесены, чтобы поды cm-acme-http-solver могли выполняться на master-узлах и выделенных узлах.

Ограничение ClusterIssuer для проектов

При включённом модуле multitenancy-manager модуль cert-manager регистрирует ClusterIssuer как cluster-wide-ресурс, использование которого из пространств имён проектов можно ограничить. Регистрация — это GrantableClusterResourceDefinition clusterissuers. Она распространяется на следующие ссылки:

  • поле .spec.issuerRef.name ресурса Certificate, если в .spec.issuerRef.kind указано ClusterIssuer;
  • аннотацию cert-manager.io/cluster-issuer ресурса Ingress.

По умолчанию каждый ClusterIssuer доступен всем проектам. Чтобы сократить список или задать ClusterIssuer, используемый по умолчанию, создайте ClusterResourceGrantPolicy с resourceName: clusterissuers.

Мониторинг

Модуль обеспечивает экспорт метрик в Prometheus для мониторинга:

  • срока действия сертификатов;
  • корректности перевыпуска сертификатов.

Роли доступа к ресурсам

В модуле предопределены несколько продуманных ролей для удобного доступа к ресурсам:

  • User – доступ на чтение к ресурсам Certificate и Issuer в доступных ему namespace, а также к глобальным ClusterIssue;
  • Editor – управление ресурсами Certificate и Issuer в доступных ему namespace;
  • ClusterEditor – управление ресурсами Certificate и Issuer в любых namespace;
  • SuperAdmin – управление внутренними служебными объектами.

Внешние компоненты

Список стороннего программного обеспечения, используемого в модуле cert-manager (информация представлена на английском языке):

  • cert-manager 1.21.2

    License: Apache License 2.0

    A Kubernetes add-on to automate the management and issuance of TLS certificates from various issuing sources.

  • cert-manager-webhook-yandex 1a7dd500a97e9206fa5cfebb102decd3889e3544

    License: Apache License 2.0

    ACME DNS-01 webhook for Yandex Cloud DNS.