Skip to main content

Module renewal

Module renewal 

Source
Expand description

Renewal, monitoring, and the expiry alarm for the account-zone wildcard certificate (epic #1158, ticket #1162 / A3).

One wildcard cert authenticates every account host for a deployment, so one cert failing to renew breaks all account resolution — a total-outage surface. Per the ticket, the alarm ships with the feature, not as a follow-up.

What this module owns:

  • CertRenewer: on a schedule, asks the WildcardCertIssuer to refresh the cert and pushes the result into a CertHandle.
  • CertHealth/CertHealthMonitor: computes a coarse health state (Ok / ExpiringSoon / Critical / Expired / Unissued / Unprovisioned) from the current cert’s NotAfter and the last issuance outcome, and surfaces it loudly via tracing — the alarm. The health state is also exposed as a pub field so a metrics/event plane can scrape it.

CertRenewer uses the same trait seams as issuance; it does not depend on a specific ACME client or DNS backend.

Structs§

AlarmThresholds
Tunable lead times for the alarm.
CertHealthMonitor
A monitor that recomputes CertHealth and logs it loudly when not Ok.
CertRenewer
Background renewal + alarm loop for the account-zone wildcard cert.

Enums§

CertHealth
Coarse health classification for the account-zone cert. The alarm state.

Functions§

classify
Computes the alarm state from the current cert and the last issuance result.