Trust Manager Helm values¶

Trust Manager is an tool that manages trust bundles in Kubernetes and OpenShift clusters. Trust Manager is a small Kubernetes operator that helps reduce the overhead of managing TLS trust bundles in your clusters.

The following Trust Manager Helm values are supoported by the Venafi Kubernetes Manifest tool.

CRDs¶

crds.enabled¶

true

This option decides if the CRDs should be installed as part of the Helm installation.

crds.keep¶

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.

Trust Manager¶

replicaCount¶

1

The number of replicas of trust-manager to run.

For example:
Use integer to set a fixed number of replicas

replicaCount: 2

Use null if you want to omit the replicas field and use the Kubernetes default value.

replicaCount: null

Use a string if you want to insert a variable for post-processing of the rendered template.

replicaCount: ${REPLICAS_OVERRIDE:=3}

nameOverride¶

""

namespace¶

""

The namespace to install trust-manager into. If not set, the namespace of the release is used. This is helpful when installing trust-manager as a chart dependency (sub chart).

imagePullSecrets¶

[]

For Private docker registries, authentication is needed. Registry secrets are applied to the service account.

image.registry¶

Target image registry. This value is prepended to the target image repository, if set.
For example:

registry: quay.io
repository: jetstack/trust-manager

image.repository¶

quay.io/jetstack/trust-manager

Target image repository.

image.tag¶

Override the image tag to deploy by setting this variable. If no value is set, the chart's appVersion is used.

image.digest¶

Target image digest. Override any tag, if set.
For example:

digest: sha256:0e072dddd1f7f8fc8909a2ca6f65e76c5f0d2fcfb8be47935ae3457e8bbceb20

image.pullPolicy¶

IfNotPresent

Kubernetes imagePullPolicy on Deployment.

defaultPackage.enabled¶

true

Whether to load the default trust package during pod initialization, and include it in main container args. This container enables the 'useDefaultCAs' source on Bundles.

defaultPackage.resources¶

{}

Kubernetes pod resource limits for default package init container.

For example:

resources:
  limits:
    cpu: 100m
    memory: 128Mi
  requests:
    cpu: 100m
    memory: 128Mi

defaultPackageImage.registry¶

Target image registry. This value is prepended to the target image repository, if set.
For example:

registry: quay.io
repository: jetstack/cert-manager-package-debian

defaultPackageImage.repository¶

quay.io/jetstack/cert-manager-package-debian

The repository for the default package image. This image enables the 'useDefaultCAs' source on Bundles.

defaultPackageImage.tag¶

"20210119.0"

Override the image tag of the default package image. If no value is set, the chart's appVersion is used.

defaultPackageImage.digest¶

Target image digest. Override any tag, if set.
For example:

digest: sha256:0e072dddd1f7f8fc8909a2ca6f65e76c5f0d2fcfb8be47935ae3457e8bbceb20

defaultPackageImage.pullPolicy¶

IfNotPresent

imagePullPolicy for the default package image.

secretTargets.enabled¶

false

If set to true, enable writing trust bundles to Kubernetes Secrets as a target. trust-manager can only write to secrets which are explicitly allowed via either authorizedSecrets or authorizedSecretsAll. Note that enabling secret targets will grant trust-manager read access to all secrets in the cluster.

secretTargets.authorizedSecretsAll¶

false

If set to true, grant read/write permission to all secrets across the cluster. Use with caution!
If set, ignores the authorizedSecrets list.

secretTargets.authorizedSecrets¶

[]

A list of secret names which trust-manager will be permitted to read and write across all namespaces. These are the only allowable Secrets that can be used as targets. If the list is empty (and authorizedSecretsAll is false), trust-manager can't write to secrets and can only read secrets in the trust namespace for use as sources.

resources¶

{}

Kubernetes pod resource limits for trust.

For example:

resources:
  limits:
    cpu: 100m
    memory: 128Mi
  requests:
    cpu: 100m
    memory: 128Mi

priorityClassName¶

""

Configure the priority class of the pod. For more information, see PriorityClass.

nodeSelector¶

kubernetes.io/os: linux

Configure the nodeSelector. This defaults to any Linux node (Trust Manager doesn't support Windows nodes).

affinity¶

{}

Kubernetes Affinity. For more information, see Affinity v1 core.
For example:

affinity:
  nodeAffinity:
   requiredDuringSchedulingIgnoredDuringExecution:
     nodeSelectorTerms:
     - matchExpressions:
       - key: foo.bar.com/role
         operator: In
         values:
         - master

tolerations¶

[]

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

topologySpreadConstraints¶

[]

List of Kubernetes TopologySpreadConstraints. For more information, see 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

filterExpiredCertificates.enabled¶

false

Whether to filter expired certificates from the trust bundle.

app.logLevel¶

1

The verbosity of trust-manager logging. This takes a value from 1-5, with the higher value being more verbose.

app.readinessProbe.port¶

6060

The container port on which to expose the trust-manager HTTP readiness probe using the default network interface.

app.readinessProbe.path¶

/readyz

The path on which to expose the trust-manager HTTP readiness probe using the default network interface.

app.trust.namespace¶

cert-manager

The namespace used as the trust source. Note that the namespace must exist before installing trust-manager.

app.securityContext.seccompProfileEnabled¶

true

If false, disables the default seccomp profile, which might be required to run on certain platforms.

app.podLabels¶

{}

Pod labels to add to trust-manager pods.

app.podAnnotations¶

{}

Pod annotations to add to trust-manager pods.

Webhook¶

app.webhook.host¶

0.0.0.0

Host that the webhook listens on.

app.webhook.port¶

6443

Port that the webhook listens on.

app.webhook.timeoutSeconds¶

5

Timeout of webhook HTTP request.

app.webhook.service.type¶

ClusterIP

The type of Kubernetes Service used by the Webhook.

app.webhook.service.nodePort¶

The nodePort set on the Service used by the webhook.

app.webhook.tls.approverPolicy.enabled¶

false

Whether to create an Approver Policy CertificateRequestPolicy allowing auto-approval of the Trust Manager webhook certificate. If you have Approver Policy installed, you almost certainly want to enable this.

app.webhook.tls.approverPolicy.certManagerNamespace¶

cert-manager

The namespace in which cert-manager was installed. Only used if app.webhook.tls.approverPolicy.enabled is true.

app.webhook.tls.approverPolicy.certManagerServiceAccount¶

cert-manager

The name of cert-manager's Service Account. Only used if app.webhook.tls.approverPolicy.enabled is true.

app.webhook.hostNetwork¶

false

This value specifies if the app should be started in hostNetwork mode. It is required for use in some managed Kubernetes clusters (such as AWS EKS) with custom CNI.

Metrics¶

app.metrics.port¶

9402

The port for exposing Prometheus metrics on 0.0.0.0 on path '/metrics'.

app.metrics.service.servicemonitor¶

true

Create a Service resource to expose the metrics endpoint.

app.metrics.service.servicemonitor¶

ClusterIP

The Service type to expose metrics.

app.metrics.service.servicemonitor.enabled¶

false

Create a Prometheus ServiceMonitor for Trust Manager.

app.metrics.service.servicemonitor.prometheusInstance¶

default

Sets the value of the "prometheus" label on the ServiceMonitor. This is used so that separate Prometheus instances can select different ServiceMonitors using labels.

app.metrics.service.servicemonitor.interval¶

10s

The interval to scrape the metrics.

app.metrics.service.servicemonitor.scrapeTimeout¶

5s

The timeout for a metrics scrape.

app.metrics.service.servicemonitor.labels¶

{}

Additional labels to add to the ServiceMonitor.

podDisruptionBudget.enabled¶

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 Trust Manager Pod is currently running.

podDisruptionBudget.minAvailable¶

This 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.

podDisruptionBudget.maxUnavailable¶

This 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.

commonLabels¶

{}

Labels to apply to all resources.