mirror of
https://github.com/kubernetes-sigs/external-dns.git
synced 2025-10-15 11:50:59 +02:00
65f4239d44
Use `int64(ep.RecordTTL)` in `newRecord()` Fallback to hardcoded 300s for backwards-compat Add `TestNewRecords()` Add notes in *ttl.md*
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
Configure DNS record TTL (Time-To-Live)
|
|
=======================================
|
|
|
|
An optional annotation `external-dns.alpha.kubernetes.io/ttl` is available to customize the TTL value of a DNS record.
|
|
|
|
To configure it, simply annotate a service/ingress, e.g.:
|
|
|
|
```yaml
|
|
apiVersion: v1
|
|
kind: Service
|
|
metadata:
|
|
annotations:
|
|
external-dns.alpha.kubernetes.io/hostname: nginx.external-dns-test.my-org.com.
|
|
external-dns.alpha.kubernetes.io/ttl: "60"
|
|
...
|
|
```
|
|
|
|
TTL must be a positive integer encoded as string.
|
|
|
|
Providers
|
|
=========
|
|
|
|
- [x] AWS (Route53)
|
|
- [ ] Azure
|
|
- [ ] Cloudflare
|
|
- [ ] DigitalOcean
|
|
- [x] Google
|
|
- [ ] InMemory
|
|
|
|
PRs welcome!
|
|
|
|
Notes
|
|
=====
|
|
When the `external-dns.alpha.kubernetes.io/ttl` annotation is not provided, the Ttl will default to 0 seconds and `enpoint.TTL.isConfigured()` will be false.
|
|
|
|
### AWS Provider
|
|
The AWS Provider overrides the value to 300s when the Ttl is 0.
|
|
This value is a constant in the provider code.
|
|
|
|
### Google Provider
|
|
Previously with the Google Provider, Ttl's were hard-coded to 300s.
|
|
For safety, the Google Provider overrides the value to 300s when the Ttl is 0.
|
|
This value is a constant in the provider code.
|
|
|
|
For the moment, it is impossible to use a Ttl value of 0 with the AWS and Google Providers.
|
|
This behavior may change in the future.
|