cert-manager is a Kubernetes addon to automate the management and issuance of TLS certificates from various issuing sources.
It will ensure certificates are valid and up to date periodically, and attempt to renew certificates at an appropriate time before expiry.
Full installation instructions, including details on how to configure extra functionality in cert-manager can be found in the installation docs.
Before installing the chart, you must first install the cert-manager CustomResourceDefinition resources. This is performed in a separate step to allow you to easily uninstall and reinstall cert-manager without deleting your installed custom resources.
$ kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.18.6/cert-manager.crds.yaml
To install the chart with the release name cert-manager:
## Add the Jetstack Helm repository $ helm repo add jetstack https://charts.jetstack.io --force-update ## Install the cert-manager helm chart $ helm install cert-manager --namespace cert-manager --version v1.18.6 jetstack/cert-manager
In order to begin issuing certificates, you will need to set up a ClusterIssuer or Issuer resource (for example, by creating a 'letsencrypt-staging' issuer).
More information on the different types of issuers and how to configure them can be found in our documentation.
For information on how to configure cert-manager to automatically provision Certificates for Ingress resources, take a look at the Securing Ingresses documentation.
Tip: List all releases using
helm list
Special considerations may be required when upgrading the Helm chart, and these are documented in our full upgrading guide.
Please check here before performing upgrades!
To uninstall/delete the cert-manager deployment:
$ helm delete cert-manager --namespace cert-manager
The command removes all the Kubernetes components associated with the chart and deletes the release.
If you want to completely uninstall cert-manager from your cluster, you will also need to delete the previously installed CustomResourceDefinition resources:
$ kubectl delete -f https://github.com/cert-manager/cert-manager/releases/download/v1.18.6/cert-manager.crds.yaml
arrayDefault value:
[]
Reference to one or more secrets to be used when pulling images. For more information, see Pull an Image from a Private Registry.
For example:
imagePullSecrets: - name: "image-pull-secret"
objectDefault value:
{}
Labels to apply to all resources.
Please note that this does not add labels to the resources created dynamically by the controllers. For these resources, you have to add the labels in the template in the cert-manager custom resource: For example, podTemplate/ ingressTemplate in ACMEChallengeSolverHTTP01Ingress. For more information, see the cert-manager documentation.
For example, secretTemplate in CertificateSpec
For more information, see the cert-manager documentation.
numberThe number of old ReplicaSets to retain to allow rollback (if not set, the default Kubernetes value is set to 10).
stringDefault value:
""
The optional priority class to be used for the cert-manager pods.
boolDefault value:
true
Create required ClusterRoles and ClusterRoleBindings for cert-manager.
boolDefault value:
true
Aggregate ClusterRoles to Kubernetes default user-facing roles. For more information, see User-facing roles
boolDefault value:
false
Create PodSecurityPolicy for cert-manager.
Note that PodSecurityPolicy was deprecated in Kubernetes 1.21 and removed in Kubernetes 1.25.
boolDefault value:
true
Configure the PodSecurityPolicy to use AppArmor.
numberDefault value:
2
Set the verbosity of cert-manager. A range of 0 - 6, with 6 being the most verbose.
stringDefault value:
kube-system
Override the namespace used for the leader election lease.
stringThe duration that non-leader candidates will wait after observing a leadership renewal until attempting to acquire leadership of a led but unrenewed leader slot. This is effectively the maximum duration that a leader can be stopped before it is replaced by another candidate.
stringThe interval between attempts by the acting master to renew a leadership slot before it stops leading. This must be less than or equal to the lease duration.
stringThe duration the clients should wait between attempting acquisition and renewal of a leadership.
boolDefault value:
false
This option is equivalent to setting crds.enabled=true and crds.keep=true. Deprecated: use crds.enabled and crds.keep instead.
boolDefault value:
false
This option decides if the CRDs should be installed as part of the Helm installation.
boolDefault value:
true
This option makes it so that the "helm.sh/resource-policy": keep annotation is added to the CRD. This will prevent Helm from uninstalling the CRD when the Helm release is uninstalled. WARNING: when the CRDs are removed, all cert-manager custom resources
(Certificates, Issuers, ...) will be removed too by the garbage collector.
numberDefault value:
1
The number of replicas of the cert-manager controller to run.
The default is 1, but in production set this to 2 or 3 to provide high availability.
If replicas > 1, consider setting podDisruptionBudget.enabled=true.
Note that cert-manager uses leader election to ensure that there can only be a single instance active at a time.
objectDefault value:
{}
Deployment update strategy for the cert-manager controller deployment. For more information, see the Kubernetes documentation.
For example:
strategy: type: RollingUpdate rollingUpdate: maxSurge: 0 maxUnavailable: 1
boolDefault value:
false
Enable or disable the PodDisruptionBudget resource.
This prevents downtime during voluntary disruptions such as during a Node upgrade. For example, the PodDisruptionBudget will block kubectl drain if it is used on the Node where the only remaining cert-manager
Pod is currently running.
unknownThis configures the minimum available pods for disruptions. It can either be set to an integer (e.g., 1) or a percentage value (e.g., 25%).
It cannot be used if maxUnavailable is set.
unknownThis configures the maximum unavailable pods for disruptions. It can either be set to an integer (e.g., 1) or a percentage value (e.g., 25%). it cannot be used if minAvailable is set.
stringDefault value:
""
A comma-separated list of feature gates that should be enabled on the controller pod.
numberDefault value:
60
The maximum number of challenges that can be scheduled as 'processing' at once.
stringThe container registry to pull the manager image from.
stringDefault value:
quay.io/jetstack/cert-manager-controller
The container image for the cert-manager controller.
stringOverride the image tag to deploy by setting this variable. If no value is set, the chart's appVersion is used.
stringSetting a digest will override any tag.
stringDefault value:
IfNotPresent
Kubernetes imagePullPolicy on Deployment.
stringDefault value:
""
Override the namespace used to store DNS provider credentials etc. for ClusterIssuer resources. By default, the same namespace as cert-manager is deployed within is used. This namespace will not be automatically created by the Helm chart.
stringDefault value:
""
This namespace allows you to define where the services are installed into. If not set then they use the namespace of the release. This is helpful when installing cert manager as a chart dependency (sub chart).
stringOverride the "cert-manager.fullname" value. This value is used as part of most of the names of the resources created by this Helm chart.
stringOverride the "cert-manager.name" value, which is used to annotate some of the resources that are created by this Chart (using "app.kubernetes.io/name"). NOTE: There are some inconsistencies in the Helm chart when it comes to these annotations (some resources use, e.g., "cainjector.name" which resolves to the value "cainjector").
boolDefault value:
true
Specifies whether a service account should be created.
stringThe name of the service account to use.
If not set and create is true, a name is generated using the fullname template.
objectOptional additional annotations to add to the controller's Service Account. Templates are allowed for both keys and values.
Example using templating:
annotations: "{{ .Chart.Name }}-helm-chart/version": "{{ .Chart.Version }}"
objectOptional additional labels to add to the controller's Service Account.
boolDefault value:
true
Automount API credentials for a Service Account.
boolAutomounting API credentials for a particular pod.
boolDefault value:
false
When this flag is enabled, secrets will be automatically removed when the certificate resource is deleted.
objectDefault value:
{}
This property is used to configure options for the controller pod. This allows setting options that would usually be provided using flags.
If apiVersion and kind are unspecified they default to the current latest version (currently controller.config.cert-manager.io/v1alpha1). You can pin the version by specifying the apiVersion yourself.
For example:
config: apiVersion: controller.config.cert-manager.io/v1alpha1 kind: ControllerConfiguration logging: verbosity: 2 format: text leaderElectionConfig: namespace: kube-system kubernetesAPIQPS: 9000 kubernetesAPIBurst: 9000 numberOfConcurrentWorkers: 200 enableGatewayAPI: true # Feature gates as of v1.18.1. Listed with their default values. # See https://cert-manager.io/docs/cli/controller/ featureGates: AdditionalCertificateOutputFormats: true # GA - default=true AllAlpha: false # ALPHA - default=false AllBeta: false # BETA - default=false ExperimentalCertificateSigningRequestControllers: false # ALPHA - default=false ExperimentalGatewayAPISupport: true # BETA - default=true LiteralCertificateSubject: true # BETA - default=true NameConstraints: true # BETA - default=true OtherNames: false # ALPHA - default=false SecretsFilteredCaching: true # BETA - default=true ServerSideApply: false # ALPHA - default=false StableCertificateRequestName: true # BETA - default=true UseCertificateRequestBasicConstraints: false # ALPHA - default=false UseDomainQualifiedFinalizer: true # GA - default=true ValidateCAA: false # ALPHA - default=false DefaultPrivateKeyRotationPolicyAlways: true # BETA - default=true ACMEHTTP01IngressPathTypeExact: true # BETA - default=true # Configure the metrics server for TLS # See https://cert-manager.io/docs/devops-tips/prometheus-metrics/#tls metricsTLSConfig: dynamic: secretNamespace: "cert-manager" secretName: "cert-manager-metrics-ca" dnsNames: - cert-manager-metrics
stringDefault value:
""
A comma-separated string with the host and port of the recursive nameservers cert-manager should query.
boolDefault value:
false
Forces cert-manager to use only the recursive nameservers for verification. Enabling this option could cause the DNS01 self check to take longer owing to caching performed by the recursive nameservers.
boolDefault value:
false
Option to disable cert-manager's build-in auto-approver. The auto-approver approves all CertificateRequests that reference issuers matching the 'approveSignerNames' option. This 'disableAutoApproval' option is useful when you want to make all approval decisions using a different approver (like approver-policy - https://github.com/cert-manager/approver-policy).
arrayDefault value:
- issuers.cert-manager.io/* - clusterissuers.cert-manager.io/*
List of signer names that cert-manager will approve by default. CertificateRequests referencing these signer names will be auto-approved by cert-manager. Defaults to just approving the cert-manager.io Issuer and ClusterIssuer issuers. When set to an empty array, ALL issuers will be auto-approved by cert-manager. To disable the auto-approval, because, e.g., you are using approver-policy, you can enable 'disableAutoApproval'.
ref: https://cert-manager.io/docs/concepts/certificaterequest/#approval
arrayDefault value:
[]
Additional command line flags to pass to cert-manager controller binary. To see all available flags run docker run quay.io/jetstack/cert-manager-controller:<version> --help.
Use this flag to enable or disable arbitrary controllers. For example, to disable the CertificateRequests approver.
For example:
extraArgs: - --controllers=*,-certificaterequests-approver
arrayDefault value:
[]
Additional environment variables to pass to cert-manager controller binary.
For example:
extraEnv: - name: SOME_VAR value: 'some value'
objectDefault value:
{}
Resources to provide to the cert-manager controller pod.
For example:
requests: cpu: 10m memory: 32Mi
For more information, see Resource Management for Pods and Containers.
objectDefault value:
runAsNonRoot: true seccompProfile: type: RuntimeDefault
Pod Security Context.
For more information, see Configure a Security Context for a Pod or Container.
objectDefault value:
allowPrivilegeEscalation: false capabilities: drop: - ALL readOnlyRootFilesystem: true
Container Security Context to be set on the controller component container. For more information, see Configure a Security Context for a Pod or Container.
arrayDefault value:
[]
Additional volumes to add to the cert-manager controller pod.
arrayDefault value:
[]
Additional volume mounts to add to the cert-manager controller container.
objectOptional additional annotations to add to the controller Deployment.
objectOptional additional annotations to add to the controller Pods.
objectDefault value:
{}
Optional additional labels to add to the controller Pods.
objectOptional annotations to add to the controller Service.
objectOptional additional labels to add to the controller Service.
stringOptionally set the IP family policy for the controller Service to configure dual-stack; see Configure dual-stack.
arrayOptionally set the IP families for the controller Service that should be supported, in the order in which they should be applied to ClusterIP. Can be IPv4 and/or IPv6.
stringPod DNS policy.
For more information, see Pod's DNS Policy.
objectPod DNS configuration. The podDnsConfig field is optional and can work with any podDnsPolicy settings. However, when a Pod's dnsPolicy is set to "None", the dnsConfig field has to be specified. For more information, see Pod's DNS Config.
arrayDefault value:
[]
Optional hostAliases for cert-manager-controller pods. May be useful when performing ACME DNS-01 self checks.
objectDefault value:
kubernetes.io/os: linux
The nodeSelector on Pods tells Kubernetes to schedule Pods on the nodes with matching labels. For more information, see Assigning Pods to Nodes.
This default ensures that Pods are only scheduled to Linux nodes. It prevents Pods being scheduled to Windows nodes in a mixed OS cluster.
stringOptional default issuer to use for ingress resources.
stringOptional default issuer kind to use for ingress resources.
stringOptional default issuer group to use for ingress resources.
stringConfigures the HTTP_PROXY environment variable where a HTTP proxy is required.
stringConfigures the HTTPS_PROXY environment variable where a HTTP proxy is required.
stringConfigures the NO_PROXY environment variable where a HTTP proxy is required, but certain domains should be excluded.
objectDefault value:
{}
A Kubernetes Affinity, if required. For more information, see Affinity v1 core.
For example:
affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: foo.bar.com/role operator: In values: - master
arrayDefault value:
[]
A list of Kubernetes Tolerations, if required. For more information, see Toleration v1 core.
For example:
tolerations: - key: foo.bar.com/role operator: Equal value: master effect: NoSchedule
arrayDefault value:
[]
A list of Kubernetes TopologySpreadConstraints, if required. For more information, see [Topology spread constraint v1 core](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.27/#topologyspreadconstraint-v1-core
For example:
topologySpreadConstraints: - maxSkew: 2 topologyKey: topology.kubernetes.io/zone whenUnsatisfiable: ScheduleAnyway labelSelector: matchLabels: app.kubernetes.io/instance: cert-manager app.kubernetes.io/component: controller
objectDefault value:
enabled: true failureThreshold: 8 initialDelaySeconds: 10 periodSeconds: 10 successThreshold: 1 timeoutSeconds: 15
LivenessProbe settings for the controller container of the controller Pod.
This is enabled by default, in order to enable the clock-skew liveness probe that restarts the controller in case of a skew between the system clock and the monotonic clock. LivenessProbe durations and thresholds are based on those used for the Kubernetes controller-manager. For more information see the following on the
Kubernetes GitHub repository
boolDefault value:
false
enableServiceLinks indicates whether information about services should be injected into the pod's environment variables, matching the syntax of Docker links.
boolDefault value:
true
Enable Prometheus monitoring for the cert-manager controller and webhook. If you use the Prometheus Operator, set prometheus.podmonitor.enabled or prometheus.servicemonitor.enabled, to create a PodMonitor or a
ServiceMonitor resource.
Otherwise, 'prometheus.io' annotations are added to the cert-manager and cert-manager-webhook Deployments. Note that you cannot enable both PodMonitor and ServiceMonitor as they are mutually exclusive. Enabling both will result in an error.
boolDefault value:
false
Create a ServiceMonitor to add cert-manager to Prometheus.
stringThe namespace that the service monitor should live in, defaults to the cert-manager namespace.
stringDefault value:
default
Specifies the prometheus label on the created ServiceMonitor. This is used when different Prometheus instances have label selectors matching different ServiceMonitors.
string,integerDefault value:
http-metrics
The target port to set on the ServiceMonitor. This must match the port that the cert-manager controller is listening on for metrics.
stringDefault value:
/metrics
The path to scrape for metrics.
stringDefault value:
60s
The interval to scrape metrics.
stringDefault value:
30s
The timeout before a metrics scrape fails.
objectDefault value:
{}
Additional labels to add to the ServiceMonitor.
objectDefault value:
{}
Additional annotations to add to the ServiceMonitor.
boolDefault value:
false
Keep labels from scraped data, overriding server-side labels.
objectDefault value:
{}
EndpointAdditionalProperties allows setting additional properties on the endpoint such as relabelings, metricRelabelings etc.
For example:
endpointAdditionalProperties: relabelings: - action: replace sourceLabels: - __meta_kubernetes_pod_node_name targetLabel: instance
boolDefault value:
false
Create a PodMonitor to add cert-manager to Prometheus.
stringThe namespace that the pod monitor should live in, defaults to the cert-manager namespace.
stringDefault value:
default
Specifies the prometheus label on the created PodMonitor. This is used when different Prometheus instances have label selectors matching different PodMonitors.
stringDefault value:
/metrics
The path to scrape for metrics.
stringDefault value:
60s
The interval to scrape metrics.
stringDefault value:
30s
The timeout before a metrics scrape fails.
objectDefault value:
{}
Additional labels to add to the PodMonitor.
objectDefault value:
{}
Additional annotations to add to the PodMonitor.
boolDefault value:
false
Keep labels from scraped data, overriding server-side labels.
objectDefault value:
{}
EndpointAdditionalProperties allows setting additional properties on the endpoint such as relabelings, metricRelabelings etc.
For example:
endpointAdditionalProperties: relabelings: - action: replace sourceLabels: - __meta_kubernetes_pod_node_name targetLabel: instance # Configure the PodMonitor for TLS connections # See https://cert-manager.io/docs/devops-tips/prometheus-metrics/#tls scheme: https tlsConfig: serverName: cert-manager-metrics ca: secret: name: cert-manager-metrics-ca key: "tls.crt"
numberDefault value:
1
Number of replicas of the cert-manager webhook to run.
The default is 1, but in production set this to 2 or 3 to provide high availability.
If replicas > 1, consider setting webhook.podDisruptionBudget.enabled=true.
numberDefault value:
30
The number of seconds the API server should wait for the webhook to respond before treating the call as a failure. The value must be between 1 and 30 seconds. For more information, see
Validating webhook configuration v1.
The default is set to the maximum value of 30 seconds as users sometimes report that the connection between the K8S API server and the cert-manager webhook server times out. If this timeout is reached, the error message will be "context deadline exceeded", which doesn't help the user diagnose what phase of the HTTPS connection timed out. For example, it could be during DNS resolution, TCP connection, TLS negotiation, HTTP negotiation, or slow HTTP response from the webhook server. By setting this timeout to its maximum value the underlying timeout error message has more chance of being returned to the end user.
objectDefault value:
{}
This is used to configure options for the webhook pod. This allows setting options that would usually be provided using flags.
If apiVersion and kind are unspecified they default to the current latest version (currently webhook.config.cert-manager.io/v1alpha1). You can pin the version by specifying the apiVersion yourself.
For example:
apiVersion: webhook.config.cert-manager.io/v1alpha1 kind: WebhookConfiguration # The port that the webhook listens on for requests. # In GKE private clusters, by default Kubernetes apiservers are allowed to # talk to the cluster nodes only on 443 and 10250. Configuring # securePort: 10250 therefore will work out-of-the-box without needing to add firewall # rules or requiring NET_BIND_SERVICE capabilities to bind port numbers < 1000. # This should be uncommented and set as a default by the chart once # the apiVersion of WebhookConfiguration graduates beyond v1alpha1. securePort: 10250 # Configure the metrics server for TLS # See https://cert-manager.io/docs/devops-tips/prometheus-metrics/#tls metricsTLSConfig: dynamic: secretNamespace: "cert-manager" secretName: "cert-manager-metrics-ca" dnsNames: - cert-manager-metrics
objectDefault value:
{}
The update strategy for the cert-manager webhook deployment. For more information, see the Kubernetes documentation
For example:
strategy: type: RollingUpdate rollingUpdate: maxSurge: 0 maxUnavailable: 1
objectDefault value:
runAsNonRoot: true seccompProfile: type: RuntimeDefault
Pod Security Context to be set on the webhook component Pod. For more information, see Configure a Security Context for a Pod or Container.
objectDefault value:
allowPrivilegeEscalation: false capabilities: drop: - ALL readOnlyRootFilesystem: true
Container Security Context to be set on the webhook component container. For more information, see Configure a Security Context for a Pod or Container.
boolDefault value:
false
Enable or disable the PodDisruptionBudget resource.
This prevents downtime during voluntary disruptions such as during a Node upgrade. For example, the PodDisruptionBudget will block kubectl drain if it is used on the Node where the only remaining cert-manager
Pod is currently running.
unknownThis property configures the minimum available pods for disruptions. Can either be set to an integer (e.g., 1) or a percentage value (e.g., 25%).
It cannot be used if maxUnavailable is set.
unknownThis property configures the maximum unavailable pods for disruptions. Can either be set to an integer (e.g., 1) or a percentage value (e.g., 25%).
It cannot be used if minAvailable is set.
objectOptional additional annotations to add to the webhook Deployment.
objectOptional additional annotations to add to the webhook Pods.
objectOptional additional annotations to add to the webhook Service.
objectOptional additional annotations to add to the webhook MutatingWebhookConfiguration.
objectOptional additional annotations to add to the webhook ValidatingWebhookConfiguration.
objectDefault value:
matchExpressions: - key: cert-manager.io/disable-validation operator: NotIn values: - "true"
Configure spec.namespaceSelector for validating webhooks.
objectDefault value:
{}
Configure spec.namespaceSelector for mutating webhooks.
arrayDefault value:
[]
Additional command line flags to pass to cert-manager webhook binary. To see all available flags run docker run quay.io/jetstack/cert-manager-webhook:<version> --help.
arrayDefault value:
[]
Additional environment variables to pass to cert-manager webhook binary.
For example:
extraEnv: - name: SOME_VAR value: 'some value'
stringDefault value:
""
Comma separated list of feature gates that should be enabled on the webhook pod.
objectDefault value:
{}
Resources to provide to the cert-manager webhook pod.
For example:
requests: cpu: 10m memory: 32Mi
For more information, see Resource Management for Pods and Containers.
objectDefault value:
failureThreshold: 3 initialDelaySeconds: 60 periodSeconds: 10 successThreshold: 1 timeoutSeconds: 1
Liveness probe values.
For more information, see Container probes.
objectDefault value:
failureThreshold: 3 initialDelaySeconds: 5 periodSeconds: 5 successThreshold: 1 timeoutSeconds: 1
Readiness probe values.
For more information, see Container probes.
objectDefault value:
kubernetes.io/os: linux
The nodeSelector on Pods tells Kubernetes to schedule Pods on the nodes with matching labels. For more information, see Assigning Pods to Nodes.
This default ensures that Pods are only scheduled to Linux nodes. It prevents Pods being scheduled to Windows nodes in a mixed OS cluster.
objectDefault value:
{}
A Kubernetes Affinity, if required. For more information, see Affinity v1 core.
For example:
affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: foo.bar.com/role operator: In values: - master
arrayDefault value:
[]
A list of Kubernetes Tolerations, if required. For more information, see Toleration v1 core.
For example:
tolerations: - key: foo.bar.com/role operator: Equal value: master effect: NoSchedule
arrayDefault value:
[]
A list of Kubernetes TopologySpreadConstraints, if required. For more information, see Topology spread constraint v1 core.
For example:
topologySpreadConstraints: - maxSkew: 2 topologyKey: topology.kubernetes.io/zone whenUnsatisfiable: ScheduleAnyway labelSelector: matchLabels: app.kubernetes.io/instance: cert-manager app.kubernetes.io/component: controller
objectDefault value:
{}
Optional additional labels to add to the Webhook Pods.
objectDefault value:
{}
Optional additional labels to add to the Webhook Service.
stringDefault value:
""
Optionally set the IP family policy for the controller Service to configure dual-stack; see Configure dual-stack.
arrayDefault value:
[]
Optionally set the IP families for the controller Service that should be supported, in the order in which they should be applied to ClusterIP. Can be IPv4 and/or IPv6.
stringThe container registry to pull the webhook image from.
stringDefault value:
quay.io/jetstack/cert-manager-webhook
The container image for the cert-manager webhook
stringOverride the image tag to deploy by setting this variable. If no value is set, the chart's appVersion will be used.
stringSetting a digest will override any tag
stringDefault value:
IfNotPresent
Kubernetes imagePullPolicy on Deployment.
boolDefault value:
true
Specifies whether a service account should be created.
stringThe name of the service account to use.
If not set and create is true, a name is generated using the fullname template.
objectOptional additional annotations to add to the webhook's Service Account.
objectOptional additional labels to add to the webhook's Service Account.
boolDefault value:
true
Automount API credentials for a Service Account.
boolAutomounting API credentials for a particular pod.
numberDefault value:
10250
The port that the webhook listens on for requests. In GKE private clusters, by default Kubernetes apiservers are allowed to talk to the cluster nodes only on 443 and 10250. Configuring securePort: 10250, therefore will work out-of-the-box without needing to add firewall rules or requiring NET_BIND_SERVICE capabilities to bind port numbers <1000.
boolDefault value:
false
Specifies if the webhook should be started in hostNetwork mode.
Required for use in some managed kubernetes clusters (such as AWS EKS) with custom. CNI (such as calico), because control-plane managed by AWS cannot communicate with pods' IP CIDR and admission webhooks are not working
Since the default port for the webhook conflicts with kubelet on the host network, webhook.securePort should be changed to an available port if running in hostNetwork mode.
stringDefault value:
ClusterIP
Specifies how the service should be handled. Useful if you want to expose the webhook outside of the cluster. In some cases, the control plane cannot reach internal services.
stringSpecify the load balancer IP for the created service.
objectDefault value:
{}
Overrides the mutating webhook and validating webhook so they reach the webhook service using the url field instead of a service.
boolDefault value:
false
Create network policies for the webhooks.
arrayDefault value:
- from: - ipBlock: cidr: 0.0.0.0/0
Ingress rule for the webhook network policy. By default, it allows all inbound traffic.
arrayDefault value:
- ports: - port: 80 protocol: TCP - port: 443 protocol: TCP - port: 53 protocol: TCP - port: 53 protocol: UDP - port: 6443 protocol: TCP to: - ipBlock: cidr: 0.0.0.0/0
Egress rule for the webhook network policy. By default, it allows all outbound traffic to ports 80 and 443, as well as DNS ports.
arrayDefault value:
[]
Additional volumes to add to the cert-manager controller pod.
arrayDefault value:
[]
Additional volume mounts to add to the cert-manager controller container.
boolDefault value:
false
enableServiceLinks indicates whether information about services should be injected into the pod's environment variables, matching the syntax of Docker links.
boolDefault value:
true
Create the CA Injector deployment
numberDefault value:
1
The number of replicas of the cert-manager cainjector to run.
The default is 1, but in production set this to 2 or 3 to provide high availability.
If replicas > 1, consider setting cainjector.podDisruptionBudget.enabled=true.
Note that cert-manager uses leader election to ensure that there can only be a single instance active at a time.
objectDefault value:
{}
This is used to configure options for the cainjector pod. It allows setting options that are usually provided via flags.
If apiVersion and kind are unspecified they default to the current latest version (currently cainjector.config.cert-manager.io/v1alpha1). You can pin the version by specifying the apiVersion yourself.
For example:
apiVersion: cainjector.config.cert-manager.io/v1alpha1 kind: CAInjectorConfiguration logging: verbosity: 2 format: text leaderElectionConfig: namespace: kube-system # Configure the metrics server for TLS # See https://cert-manager.io/docs/devops-tips/prometheus-metrics/#tls metricsTLSConfig: dynamic: secretNamespace: "cert-manager" secretName: "cert-manager-metrics-ca" dnsNames: - cert-manager-metrics
objectDefault value:
{}
Deployment update strategy for the cert-manager cainjector deployment. For more information, see the Kubernetes documentation.
For example:
strategy: type: RollingUpdate rollingUpdate: maxSurge: 0 maxUnavailable: 1
objectDefault value:
runAsNonRoot: true seccompProfile: type: RuntimeDefault
Pod Security Context to be set on the cainjector component Pod. For more information, see Configure a Security Context for a Pod or Container.
objectDefault value:
allowPrivilegeEscalation: false capabilities: drop: - ALL readOnlyRootFilesystem: true
Container Security Context to be set on the cainjector component container. For more information, see Configure a Security Context for a Pod or Container.
boolDefault value:
false
Enable or disable the PodDisruptionBudget resource.
This prevents downtime during voluntary disruptions such as during a Node upgrade. For example, the PodDisruptionBudget will block kubectl drain if it is used on the Node where the only remaining cert-manager
Pod is currently running.
unknownminAvailable configures the minimum available pods for disruptions. It can either be set to
an integer (e.g., 1) or a percentage value (e.g., 25%).
Cannot be used if maxUnavailable is set.
unknownmaxUnavailable configures the maximum unavailable pods for disruptions. It can either be set to
an integer (e.g., 1) or a percentage value (e.g., 25%).
Cannot be used if minAvailable is set.
objectOptional additional annotations to add to the cainjector Deployment.
objectOptional additional annotations to add to the cainjector Pods.
objectOptional additional annotations to add to the cainjector metrics Service.
arrayDefault value:
[]
Additional command line flags to pass to cert-manager cainjector binary. To see all available flags run docker run quay.io/jetstack/cert-manager-cainjector:<version> --help.
arrayDefault value:
[]
Additional environment variables to pass to cert-manager cainjector binary.
For example:
extraEnv: - name: SOME_VAR value: 'some value'
stringDefault value:
""
Comma separated list of feature gates that should be enabled on the cainjector pod.
objectDefault value:
{}
Resources to provide to the cert-manager cainjector pod.
For example:
requests: cpu: 10m memory: 32Mi
For more information, see Resource Management for Pods and Containers.
objectDefault value:
kubernetes.io/os: linux
The nodeSelector on Pods tells Kubernetes to schedule Pods on the nodes with matching labels. For more information, see Assigning Pods to Nodes.
This default ensures that Pods are only scheduled to Linux nodes. It prevents Pods being scheduled to Windows nodes in a mixed OS cluster.
objectDefault value:
{}
A Kubernetes Affinity, if required. For more information, see Affinity v1 core.
For example:
affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: foo.bar.com/role operator: In values: - master
arrayDefault value:
[]
A list of Kubernetes Tolerations, if required. For more information, see Toleration v1 core.
For example:
tolerations: - key: foo.bar.com/role operator: Equal value: master effect: NoSchedule
arrayDefault value:
[]
A list of Kubernetes TopologySpreadConstraints, if required. For more information, see Topology spread constraint v1 core.
For example:
topologySpreadConstraints: - maxSkew: 2 topologyKey: topology.kubernetes.io/zone whenUnsatisfiable: ScheduleAnyway labelSelector: matchLabels: app.kubernetes.io/instance: cert-manager app.kubernetes.io/component: controller
objectDefault value:
{}
Optional additional labels to add to the CA Injector Pods.
objectDefault value:
{}
Optional additional labels to add to the CA Injector metrics Service.
stringThe container registry to pull the cainjector image from.
stringDefault value:
quay.io/jetstack/cert-manager-cainjector
The container image for the cert-manager cainjector
stringOverride the image tag to deploy by setting this variable. If no value is set, the chart's appVersion will be used.
stringSetting a digest will override any tag.
stringDefault value:
IfNotPresent
Kubernetes imagePullPolicy on Deployment.
boolDefault value:
true
Specifies whether a service account should be created.
stringThe name of the service account to use.
If not set and create is true, a name is generated using the fullname template
objectOptional additional annotations to add to the cainjector's Service Account.
objectOptional additional labels to add to the cainjector's Service Account.
boolDefault value:
true
Automount API credentials for a Service Account.
boolAutomounting API credentials for a particular pod.
arrayDefault value:
[]
Additional volumes to add to the cert-manager controller pod.
arrayDefault value:
[]
Additional volume mounts to add to the cert-manager controller container.
boolDefault value:
false
enableServiceLinks indicates whether information about services should be injected into the pod's environment variables, matching the syntax of Docker links.
stringThe container registry to pull the acmesolver image from.
stringDefault value:
quay.io/jetstack/cert-manager-acmesolver
The container image for the cert-manager acmesolver.
stringOverride the image tag to deploy by setting this variable. If no value is set, the chart's appVersion is used.
stringSetting a digest will override any tag.
stringDefault value:
IfNotPresent
Kubernetes imagePullPolicy on Deployment.
This startupapicheck is a Helm post-install hook that waits for the webhook endpoints to become available. The check is implemented using a Kubernetes Job - if you are injecting mesh sidecar proxies into cert-manager pods, ensure that they are not injected into this Job's pod. Otherwise, the installation may time out owing to the Job never being completed because the sidecar proxy does not exit. For more information, see this note.
boolDefault value:
true
Enables the startup api check.
objectDefault value:
runAsNonRoot: true seccompProfile: type: RuntimeDefault
Pod Security Context to be set on the startupapicheck component Pod. For more information, see Configure a Security Context for a Pod or Container.
objectDefault value:
allowPrivilegeEscalation: false capabilities: drop: - ALL readOnlyRootFilesystem: true
Container Security Context to be set on the controller component container. For more information, see Configure a Security Context for a Pod or Container.
stringDefault value:
1m
Timeout for 'kubectl check api' command.
numberDefault value:
4
Job backoffLimit
objectDefault value:
helm.sh/hook: post-install helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded helm.sh/hook-weight: "1"
Optional additional annotations to add to the startupapicheck Job.
objectOptional additional annotations to add to the startupapicheck Pods.
arrayDefault value:
- -v
Additional command line flags to pass to startupapicheck binary. To see all available flags run docker run quay.io/jetstack/cert-manager-startupapicheck:<version> --help.
Verbose logging is enabled by default so that if startupapicheck fails, you can know what exactly caused the failure. Verbose logs include details of the webhook URL, IP address and TCP connect errors for example.
arrayDefault value:
[]
Additional environment variables to pass to cert-manager startupapicheck binary.
For example:
extraEnv: - name: SOME_VAR value: 'some value'
objectDefault value:
{}
Resources to provide to the cert-manager controller pod.
For example:
requests: cpu: 10m memory: 32Mi
For more information, see Resource Management for Pods and Containers.
objectDefault value:
kubernetes.io/os: linux
The nodeSelector on Pods tells Kubernetes to schedule Pods on the nodes with matching labels. For more information, see Assigning Pods to Nodes.
This default ensures that Pods are only scheduled to Linux nodes. It prevents Pods being scheduled to Windows nodes in a mixed OS cluster.
objectDefault value:
{}
A Kubernetes Affinity, if required. For more information, see Affinity v1 core.
For example:
affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: foo.bar.com/role operator: In values: - master
arrayDefault value:
[]
A list of Kubernetes Tolerations, if required. For more information, see Toleration v1 core.
For example:
tolerations: - key: foo.bar.com/role operator: Equal value: master effect: NoSchedule
objectDefault value:
{}
Optional additional labels to add to the startupapicheck Pods.
stringThe container registry to pull the startupapicheck image from.
stringDefault value:
quay.io/jetstack/cert-manager-startupapicheck
The container image for the cert-manager startupapicheck.
stringOverride the image tag to deploy by setting this variable. If no value is set, the chart's appVersion is used.
stringSetting a digest will override any tag.
stringDefault value:
IfNotPresent
Kubernetes imagePullPolicy on Deployment.
objectDefault value:
helm.sh/hook: post-install helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded helm.sh/hook-weight: "-5"
annotations for the startup API Check job RBAC and PSP resources.
boolAutomounting API credentials for a particular pod.
boolDefault value:
true
Specifies whether a service account should be created.
stringThe name of the service account to use.
If not set and create is true, a name is generated using the fullname template.
objectDefault value:
helm.sh/hook: post-install helm.sh/hook-delete-policy: before-hook-creation,hook-succeeded helm.sh/hook-weight: "-5"
Optional additional annotations to add to the Job's Service Account.
boolDefault value:
true
Automount API credentials for a Service Account.
objectOptional additional labels to add to the startupapicheck's Service Account.
arrayDefault value:
[]
Additional volumes to add to the cert-manager controller pod.
arrayDefault value:
[]
Additional volume mounts to add to the cert-manager controller container.
boolDefault value:
false
enableServiceLinks indicates whether information about services should be injected into pod's environment variables, matching the syntax of Docker links.
arrayDefault value:
[]
Create dynamic manifests via values.
For example:
extraObjects: - | apiVersion: v1 kind: ConfigMap metadata: name: '{{ template "cert-manager.fullname" . }}-extra-configmap'
The default pod-level and container-level security contexts, below, adhere to the restricted Pod Security Standards policies.
Default pod-level securityContext:
runAsNonRoot: true seccompProfile: type: RuntimeDefault
Default containerSecurityContext:
allowPrivilegeEscalation: false capabilities: drop: - ALL
Specify each parameter using the --set key=value[,key=value] argument to helm install.
Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,
$ helm install my-release -f values.yaml .
Tip: You can use the default values.yaml
This chart is maintained at github.com/cert-manager/cert-manager.