Install cert-manager with a cluster management project
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Assuming you already have a 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
And update the applications/cert-manager/helmfile.yaml
with a valid email address.
values:
- letsEncryptClusterIssuer:
#
# IMPORTANT: This value MUST be set to a valid email.
#
email: example@example.com
If your Kubernetes version is earlier than 1.20 and you are
migrating from GitLab Managed Apps to a cluster management project,
then you can instead use - path: applications/cert-manager-legacy/helmfile.yaml
to
take over an existing release of cert-manager v0.10.
cert-manager:
- Is installed by default into the
gitlab-managed-apps
namespace of your cluster. - Includes a
Let’s Encrypt
ClusterIssuer
enabled by default. In thecertmanager-issuer
release, the issuer requires a valid email address forletsEncryptClusterIssuer.email
. Let’s Encrypt uses this email address to contact you about expiring certificates and issues related to your account. - Can be customized in
applications/cert-manager/helmfile.yaml
by passing customvalues
to thecertmanager
release. Refer to the chart for the available configuration options.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support