Install cert-manager with a cluster management project
Introduced in GitLab 14.0.
Assuming you already have a Cluster management project created from a
management project template, to install cert-manager you should
uncomment this line from your helmfile.yaml:
- path: applications/cert-manager/helmfile.yaml
cert-manager:
- Is installed by default into the
gitlab-managed-appsnamespace of your cluster. - Can be installed with or without a default
Let's Encrypt
ClusterIssuer, which requires an email address to be specified. The email address is used by Let's Encrypt to contact you about expiring certificates and issues related to your account.
The following configuration in your applications/cert-manager/helmfile.yaml is required to install cert-manager:
certManager:
installed: true
letsEncryptClusterIssuer:
installed: true
email: "user@example.com"
Or without the default ClusterIssuer:
certManager:
installed: true
letsEncryptClusterIssuer:
installed: false
You can customize the installation of cert-manager by defining a
.gitlab/managed-apps/cert-manager/values.yaml file in your cluster
management project. Refer to the
chart for the
available configuration options.
Support for installing the Cert Manager managed application is provided by the GitLab Configure group. If you run into unknown issues, open a new issue, and ping at least 2 people from the Configure group.