Create DNS records from Ingress
Learn how to create DNS records from Ingress
cloudflare-operator can create DNS records from Ingress resources. This guide shows how to configure the controller to automatically create DNS records for your Ingress resources.
Ingress annotations
The following annotation is required: cloudflare-operator.io/content
or cloudflare-operator.io/ip-ref
To skip the creation of a DNS record, use the annotation cloudflare-operator.io/ignore: "true"
If the DNSRecord was previously created, it get’s deleted after setting the ignore annotation.
The following annotations are optional:
Annotation | Value | Description |
---|---|---|
cloudflare-operator.io/content |
IP address or domain | DNS record content (e.g. 69.42.0.69 ) |
cloudflare-operator.io/ip-ref |
Reference to an IP object | e.g. my-external-ip |
cloudflare-operator.io/proxied |
true or false |
Whether the record should be proxied |
cloudflare-operator.io/ttl |
1 or 60 - 86400 |
TTL of the DNS record |
cloudflare-operator.io/type |
A , AAAA or CNAME |
Desired DNS record type |
cloudflare-operator.io/interval |
e.g. 5m0s |
Interval at which the DNSRecord object should be reconciled |
An example Ingress resource with annotations:
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
cloudflare-operator.io/type: CNAME
cloudflare-operator.io/content: example.com
name: blog
namespace: blog
spec:
rules:
- host: blog.example.com
http:
paths:
- backend:
service:
name: blog
port:
name: http
path: /
pathType: Prefix
This will create a DNS record for the host blog.example.com
with the content example.com
and the type CNAME
.
Note
cloudflare-operator only supports
cloudflare-operator only supports
networking.k8s.io/v1
Ingresses.
Last modified August 14, 2023: fix: use correct interval format (1009d41)