Resources / PublicRecord
PublicRecord
The DNS records of one public name, kept by the DNS operator of the platform with the DNS provider API: one A or AAAA record per address, proxied or not. Made from a PublicEndpoint, never by hand. The operator marks every record it makes with an ownership comment and only ever changes or deletes records that carry it (plus, with takeover replace, the records it replaced, which it puts back on removal).
Overview
| API | edge.etorm.com/v1alpha1 |
| Resource | publicrecords (cluster-scoped inside its cluster) |
| Short names | pubrec |
| Available in | the platform only |
| Status | written by a controller through /status |
Minimal example
apiVersion: edge.etorm.com/v1alpha1
kind: PublicRecord
metadata:
name: example
spec:
hostname: "<hostname>"
zone: "<zone>"
Spec
| Field | Type | Required | Default | Allowed | Description |
hostname | string | yes | | up to 253 characters | The public name. |
zone | string | yes | | up to 253 characters | The DNS zone that holds it. |
addresses | list of string | | | up to 16 items | The IPv4 and IPv6 addresses the name resolves to (A and AAAA records). |
proxied | boolean | | true | | Whether the provider's proxy stands in front of the name. |
takeover | string (one of) | | "refuse" | refuse, replace | Kept for compatibility; the zone operator adopts and repairs matching records (spec 0051). |
secretRef | object | | | | No longer used (the zone's credential is held by the DNS operator). |
secretRef.name | string | yes | | length 1 to 63 | Name of the Secret. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string | | | | Pending, Ready (the records exist and no worker route shadows the name) or Failed. |
records | list of object | | | | The DNSRecord objects declared for the name. |
records[].id | string | | | | |
records[].type | string | | | | |
records[].content | string | | | | |
records[].record | string | | | | The DNSRecord that declares it. |
replaced | list of object | | | | With takeover replace, the records that were replaced, kept so they can be put back. |
conditions | list of object | | | | Detailed state; Ready says whether the name resolves as wanted. |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
Columns in listings
| Column | From |
|---|
| Hostname | .spec.hostname |
| Phase | .status.phase |
All resources