Resources / ZoneSettings
ZoneSettings
The settings of a DNS zone that decide how clients reach it (spec 0051 section 'Zone settings'): the secure-connection mode, the lowest accepted TLS version and the redirect of plain HTTP to HTTPS. The operator reads them back from the provider on every pass, reports a difference as Drifted and puts the declared value back in apply mode. Only the settings named here are managed.
Overview
| API | dns.etorm.com/v1alpha1 |
| Resource | zonesettings (cluster-scoped inside its cluster) |
| Short names | zs |
| Available in | the platform only |
| Status | written by a controller through /status |
Minimal example
apiVersion: dns.etorm.com/v1alpha1
kind: ZoneSettings
metadata:
name: example
spec:
zoneRef:
name: "<name>"
Spec
| Field | Type | Required | Default | Allowed | Description |
zoneRef | object | yes | | | The DNSZone whose settings these are (it holds the credential). |
zoneRef.name | string | yes | | length 1 to 63 | Name of the DNSZone. |
mode | string (one of) | | "plan" | plan, apply | plan: report the difference and change nothing at the provider. apply: put the declared settings back. |
ssl | string (one of) | | | false, flexible, full, strict | How the proxy connects to the origin: strict (certificate checked) is the safe choice for an origin with a real certificate. |
minTlsVersion | string (one of) | | | 1.0, 1.1, 1.2, 1.3 | The lowest TLS version the proxy accepts from clients. |
alwaysUseHttps | boolean | | | | Redirect plain HTTP requests to HTTPS. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string (one of) | | | Pending, Synced, Drifted, Planned, Failed | Synced when the provider holds the declared settings; Drifted while it does not (apply mode repairs it); Planned in plan mode with a difference; Failed when the zone or its credential cannot be used. |
observedGeneration | integer | | | | The generation of the spec this status describes. |
observed | object | | | | The managed settings as the provider holds them. |
observed.ssl | string | | | | The secure-connection mode. |
observed.minTlsVersion | string | | | | The lowest TLS version. |
observed.alwaysUseHttps | boolean | | | | Whether plain HTTP is redirected. |
originMismatch | string | | | | Present while the provider's secure-connection mode makes the proxy connect to a port that the origin's firewall does not open to the public: which endpoint and why. |
zoneDrift | object | | | | Present while the provider differs from the declaration. |
zoneDrift.since | string | | | | When the difference was first seen (RFC 3339). |
conditions | list of object | | | | Ready and Drifted. |
conditions[].type | string | | | | Ready or Drifted. |
conditions[].status | string | | | | True, False or Unknown. |
Columns in listings
| Column | From |
|---|
| Zone | .spec.zoneRef.name |
| Mode | .spec.mode |
| Phase | .status.phase |
All resources