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

One of the following annotations is required: cloudflare-operator.io/content or cloudflare-operator.io/ip-ref

Ingress objects that do not have one of these annotations will be ignored by cloudflare-operator.

These are the available annotations:

Annotation	Value	Description	Required
`cloudflare-operator.io/content`	IP address or domain	DNS record content (e.g. `69.42.0.69`)	yes if `ip-ref` is not set
`cloudflare-operator.io/ip-ref`	Reference to an IP object	e.g. `my-external-ip`	yes if `content` is not set
`cloudflare-operator.io/proxied`	`true` or `false`	Whether the record should be proxied	no
`cloudflare-operator.io/ttl`	`1` or `60` - `86400`	TTL of the DNS record	no
`cloudflare-operator.io/type`	`A`, `AAAA` or `CNAME`	Desired DNS record type	no
`cloudflare-operator.io/interval`	e.g. `5m0s`	Interval at which the DNSRecord object should be reconciled	no

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 networking.k8s.io/v1 Ingresses.

Last modified February 4, 2024: docs: update ingress behavior (7d81544)