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

APIdns.etorm.com/v1alpha1
Resourcezonesettings (cluster-scoped inside its cluster)
Short nameszs
Available inthe platform only
Statuswritten by a controller through /status

Minimal example

apiVersion: dns.etorm.com/v1alpha1
kind: ZoneSettings
metadata:
  name: example
spec:
  zoneRef:
    name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
zoneRefobjectyesThe DNSZone whose settings these are (it holds the credential).
zoneRef.namestringyeslength 1 to 63Name of the DNSZone.
modestring (one of)"plan"plan, applyplan: report the difference and change nothing at the provider. apply: put the declared settings back.
sslstring (one of)false, flexible, full, strictHow the proxy connects to the origin: strict (certificate checked) is the safe choice for an origin with a real certificate.
minTlsVersionstring (one of)1.0, 1.1, 1.2, 1.3The lowest TLS version the proxy accepts from clients.
alwaysUseHttpsbooleanRedirect plain HTTP requests to HTTPS.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestring (one of)Pending, Synced, Drifted, Planned, FailedSynced 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.
observedGenerationintegerThe generation of the spec this status describes.
observedobjectThe managed settings as the provider holds them.
observed.sslstringThe secure-connection mode.
observed.minTlsVersionstringThe lowest TLS version.
observed.alwaysUseHttpsbooleanWhether plain HTTP is redirected.
originMismatchstringPresent 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.
zoneDriftobjectPresent while the provider differs from the declaration.
zoneDrift.sincestringWhen the difference was first seen (RFC 3339).
conditionslist of objectReady and Drifted.
conditions[].typestringReady or Drifted.
conditions[].statusstringTrue, False or Unknown.

Columns in listings

ColumnFrom
Zone.spec.zoneRef.name
Mode.spec.mode
Phase.status.phase

All resources