external-dns/docs/tutorials/exoscale.md
Ivan Ka 84a0c6409f
chore(docs): add mkdocs-macros plugin (#5412)
* chore(docs): add mkdocs-macros plugin

* chore(docs): add mkdocs-macros plugin

Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>

* chore(docs): add mkdocs-macros plugin

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>

---------

Signed-off-by: ivan katliarchuk <ivan.katliarchuk@gmail.com>
Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com>
2025-05-19 01:33:15 -07:00

2.0 KiB

Exoscale

Prerequisites

Exoscale provider support was added via this PR, thus you need to use external-dns v0.5.5.

The Exoscale provider expects that your Exoscale zones, you wish to add records to, already exists and are configured correctly. It does not add, remove or configure new zones in anyway.

To do this please refer to the Exoscale DNS documentation.

Additionally you will have to provide the Exoscale...:

  • API Key
  • API Secret
  • Elastic IP address, to access the workers

Deployment

Deploying external DNS for Exoscale is actually nearly identical to deploying it for other providers. This is what a sample deployment.yaml looks like:

[[% include 'exoscale/extdns.yaml' %]]

Optional arguments --exoscale-apizone and --exoscale-apienv define Exoscale API Zone (default ch-gva-2) and Exoscale API environment (default api, can be used to target non-production API server) respectively.

RBAC

If your cluster is RBAC enabled, you also need to setup the following, before you can run external-dns:

[[% include 'exoscale/rbac.yaml' %]]

Testing and Verification

Important!: Remember to change example.com with your own domain throughout the following text.

Spin up a simple nginx HTTP server with the following spec (kubectl apply -f):

[[% include 'exoscale/how-to-test.yaml' %]]

Important!: Don't run dig, nslookup or similar immediately (until you've confirmed the record exists). You'll get hit by negative DNS caching, which is hard to flush.

Wait about 30s-1m (interval for external-dns to kick in), then check Exoscales portal... via-ingress.example.com should appear as a A and TXT record with your Elastic-IP-address.