Available in editions: Open/CE, BE, SE, SE+, Ultimate/EE, Core
Included in extensions: Cluster Union
The module lifecycle stage: General Availability
This module installs the reliable and highly available cert-manager release 1.21.2.
The installation process automatically takes into account cluster aspects:
- the component (webhook) that the
kube-apiserveris accessing is installed on master nodes; - if the webhook is unavailable, the
apiserviceis temporary deleted so that the unavailability of cert-manager does not block regular cluster operation.
The module itself is updated automatically (including the migration of cert-manager resources).
Features of the cert-manager module (with the changes made)
The module has all the features of the original cert-manager, including:
- Provisioning certificates of all the supported CA such as Let’s Encrypt, HashiCorp Vault, Venafi;
- Issuing self-signed certificates;
- Keeping certificates up-to-date, reissuing them automatically, etc.
Changes to the original cert-manager were made so that the cm-acme-http-solver Pods could run on master and dedicated nodes.
Restricting ClusterIssuers for projects
When the multitenancy-manager module is enabled, cert-manager registers ClusterIssuer as a cluster-wide resource whose use from project namespaces can be restricted. The registration is the clusterissuers GrantableClusterResourceDefinition. It applies to the following references:
- the
.spec.issuerRef.namefield of a Certificate if.spec.issuerRef.kindis set to ClusterIssuer; - the
cert-manager.io/cluster-issuerannotation of an Ingress.
By default, every ClusterIssuer is available to every project. To limit the list or set the ClusterIssuer used by default, create a ClusterResourceGrantPolicy with resourceName: clusterissuers.
Monitoring
The module can expose metrics in the Prometheus format, allowing you to monitor:
- certificate validity;
- correctness of the certificate reissue.
Module roles
The module has several well-thought-out roles for managing resources:
User– has read-only access to Certificate & Issuers resources in the permitted namespaces and to the global clusterIssues;Editor– manages Certificate and Issuer resources in the permitted namespaces;ClusterEditor– manages Certificate & Issuer resources in all namespaces;SuperAdmin– manages internal service objects.
Third-party components
List of third-party software used in the cert-manager module:
-
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.