external-dns for Anexia CloudDNS

The Anexia Webhook Provider for ExternalDNS allows you to use Anexia’s DNS API to manage DNS records for your domains.

The provider is heavily inspired by the ExternalDNS - IONOS Webhook and some inspiration taken from the External DNS - Adguard Home Provider.

The initial work was by done by @ProbstenHias, who still serves as the primary maintainer. Thanks a lot! :purple_heart:

Configuration

See cmd/webhook/init/configuration/configuration.go for all available configuration options for the webhook sidecar, and internal/anexia/configuration.go for all available configuration options for the Anexia provider.

Kubernetes Deployment

The Anexia Webhook Provider is provided as an OCI image in ghcr.io/anexia/k8s-external-dns-webhook.

The following is an example deployment for the Anexia Webhook Provider:

 1helm repo add external-dns https://kubernetes-sigs.github.io/external-dns/
 2
 3# create the anexia configuration
 4kubectl create secret generic anexia-credentials \
 5    --from-literal=token='<ANEXIA_API_TOKEN>'
 6
 7# create the helm values file
 8cat <<EOF > external-dns-anexia-values.yaml
 9
10# -- ExternalDNS Log level.
11logLevel: debug # reduce in production
12
13# -- if true, _ExternalDNS_ will run in a namespaced scope (Role and Rolebinding will be namespaced too).
14namespaced: false
15
16# -- _Kubernetes_ resources to monitor for DNS entries.
17sources:
18  - ingress
19  - service
20  - crd
21
22extraArgs:
23  ## must override the default value with port 8888 with port 8080 because this is hard-coded in the helm chart
24  - --webhook-provider-url=http://localhost:8080
25  ## You should filter the domains that can be requested to limit the amount of requests done to the anxia engine.
26  ## This will help you avoid running into rate limiting
27  - --domain-filter=your.domain.com
28
29provider:
30  name: webhook
31  webhook:
32    image: ghcr.io/anexia/k8s-external-dns-webhook
33    tag: v0.2.0
34    env:
35      - name: LOG_LEVEL
36        value: debug # reduce in production
37      - name: ANEXIA_API_URL
38        value: <ANEXIA_API_URL>
39      - name: ANEXIA_API_TOKEN
40        valueFrom:
41          secretKeyRef:
42            name: anexia-credentials
43            key: token
44      - name: SERVER_HOST
45        value: "0.0.0.0"
46      - name: SERVER_PORT
47        value: "8080"
48      - name: DRY_RUN
49        value: "false"
50EOF
51
52# install external-dns with helm
53helm upgrade -i external-dns-anexia external-dns/external-dns -f external-dns-anexia-values.yaml