mirror of
https://github.com/kubernetes-sigs/external-dns.git
synced 2025-10-28 17:20:59 +01:00
ExternalDNS
ExternalDNS synchronizes exposed Kubernetes Services and Ingresses with DNS providers.
Installing the Chart
Before you can install the chart you will need to add the external-dns repo to Helm.
helm repo add external-dns https://kubernetes-sigs.github.io/external-dns/
After you've installed the repo you can install the chart.
helm upgrade --install external-dns/external-dns
Configuration
The following table lists the configurable parameters of the ExternalDNS chart and their default values.
| Parameter | Description | Default |
|---|---|---|
image.repository |
Image repository. | k8s.gcr.io/external-dns/external-dns |
image.tag |
Image tag, will override the default tag derived from the chart app version. | "" |
image.pullPolicy |
Image pull policy. | IfNotPresent |
imagePullSecrets |
Image pull secrets. | [] |
nameOverride |
Override the name of the chart. |
"" |
fullnameOverride |
Override the fullname of the chart. |
"" |
serviceAccount.create |
If true, create a new serviceaccount. |
true |
serviceAccount.annotations |
Annotations to add to the service account. | {} |
serviceAccount.name |
Service account to be used. If not set and serviceAccount.create is true, a name is generated using the full name template. |
"" |
rbac.create |
If true, create the RBAC resources. |
true |
podLabels |
Labels to add to the pod. | {} |
podAnnotations |
Annotations to add to the pod. | {} |
podSecurityContext |
Security context for the pod, this supports the full PodSecurityContext API. | see values.yaml |
securityContext |
Security context for the external-dns container, this supports the full SecurityContext API. | see values.yaml |
priorityClassName |
Priority class name to use for the pod. | "" |
terminationGracePeriodSeconds |
Termination grace period for the pod. | null |
serviceMonitor.enabled |
If true, create a Prometheus service monitor. |
false |
serviceMonitor.additionalLabels |
Additional labels to be set on the ServiceMonitor. | {} |
serviceMonitor.interval |
Prometheus scrape frequency. | 1m |
serviceMonitor.scrapeTimeout |
Prometheus scrape timeout. | 10s |
env |
Environment variables for the external-dns container, this supports the full EnvVar API including secrets and configmaps. | [] |
livenessProbe |
Liveness probe for the external-dns container, this supports the full Probe API. | See values.yaml |
readinessProbe |
Readiness probe for the external-dns container, this supports the full Probe API. | See values.yaml |
service.port |
Port to expose via the service. | 7979 |
extraVolumes |
Additional volumes for the pod, this supports the full VolumeDevice API. | [] |
extraVolumeMounts |
Additional volume mounts for the external-dns container, this supports the full VolumeMount API. | [] |
resources |
Resource requests and limits for the external-dns container, this supports the full ResourceRequirements API. | {} |
nodeSelector |
Node labels for pod assignment. | {} |
tolerations |
Tolerations for pod assignment, this supports the full Toleration API. | [] |
affinity |
Affinity settings for pod assignment, this supports the full Affinity API. | {} |
logLevel |
Verbosity of the logs, available values are: panic, debug, info, warn, error, fatal. |
info |
logFormat |
Formats of the logs, available values are: text, json. |
text |
interval |
The interval for DNS updates. | 1m |
triggerLoopOnEvent |
When enabled, triggers run loop on create/update/delete events in addition of regular interval. | false |
sources |
K8s resources type to be observed for new DNS entries. | See values.yaml |
policy |
How DNS records are synchronized between sources and providers, available values are: sync, upsert-only. |
upsert-only |
registry |
Registry Type, available types are: txt, noop. |
txt |
txtOwnerId |
TXT registry identifier. | "" |
txtPrefix |
Prefix to create a TXT record with a name following the pattern prefix.<CNAME record>. |
"" |
domainFilters |
Limit possible target zones by domain suffixes. | [] |
provider |
DNS provider where the DNS records will be created, for the available providers and how to configure them see the README. | aws |
extraArgs |
Extra arguments to pass to the external-dns container, these are needed for provider specific arguments. | [] |