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-apiserver is accessing is installed on master nodes;
  • if the webhook is unavailable, the apiservice is 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.name field of a Certificate if .spec.issuerRef.kind is set to ClusterIssuer;
  • the cert-manager.io/cluster-issuer annotation 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.