mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
1.9 KiB
1.9 KiB
hip, title, author, type, category, status, implementation-rust, created
| hip | title | author | type | category | status | implementation-rust | created |
|---|---|---|---|---|---|---|---|
| 0406 | DNS CRD | Hanzo Platform Team | Standards Track | Operator | Final | partial | 2026-05-19 |
HIP-0406: DNS CRD
Abstract
The DNS CRD models DNS zone serving and management. It deploys CoreDNS as the authoritative + cluster nameserver, optionally syncs zones to Cloudflare, and reads/writes zone records from a backing database (SQL CR). The CRD encapsulates a complete DNS stack rather than individual records.
Specification
Group + version
hanzo.ai/v1, plural dns, shortname hdns.
Spec fields
| Field | Type | Description |
|---|---|---|
zones |
[]DNSZoneSpec | name + optional Cloudflare zone ID |
coredns |
CoreDNSSpec | image, replicas, api/dns ports, resources |
cloudflare |
CloudflareSyncSpec | enabled, credentials ref |
database |
DatabaseSpec | enabled, credentials ref, syncInterval |
oidc |
OIDCSpec | enabled, issuer, audience |
ingress |
IngressSpec | management API ingress |
Example CR
apiVersion: hanzo.ai/v1
kind: DNS
metadata:
name: dns
namespace: hanzo
spec:
zones:
- name: hanzo.ai
- name: hanzo.id
coredns:
image: ghcr.io/hanzoai/dns:0.10.0
replicas: 2
apiPort: 8053
dnsPort: 53
cloudflare:
enabled: true
credentialsRef:
name: cloudflare-credentials
database:
enabled: true
credentialsRef:
name: dns-db
syncInterval: 30s
oidc:
enabled: true
issuer: https://hanzo.id
audience: app-dns
Generated K8s resources
- Deployment (CoreDNS, multi-replica)
- ClusterIP Service (port 53 UDP/TCP + management API)
- Optional Ingress for the management API
- Optional CronJob for Cloudflare reconciliation
Operator reconciler
~/work/hanzo/operator/src/controllers/dns.rs.
Related services
- HIP-0049 (DNS Service Standard) — overarching design doc.
Status
Implemented in hanzoai/operator v0.3.0+. CR dns active in cluster.