Skip to main content

Cert Manager

@dataverket/cert-managerv2026.11.12.1· AGPL-3.0-only· 9d agoBEHAVIORSACCEPTED WARNINGS
01README

cert-manager for swamp: Certificates, CertificateRequests, ACME Orders and Challenges and issuers as five model types, read with kubectl, and a forced renewal. certificate lists and reads Certificates with their Ready and Issuing conditions, validity window, seconds until expiry, names, issuer, revision and failed issuance attempts. trace walks from one Certificate to its issuer, its current CertificateRequest, the ACME Order and its Challenges in one run, and names the level where issuance stands with its state and reason: the question to ask when a DNS-01 issuance hangs. renew does what cmctl renew does, without cmctl: it sets the Issuing condition to True on the status subresource, refuses when the Certificate is missing or already issuing, changes only what it read, polls briefly and records the revision before and the state after. certificaterequest, order, challenge and issuer list and read the other objects of the chain. Every list also records one inventory of what it saw and how many objects are not in their good state, for a workflow to assert on. An unhealthy object is a record, never a failed method. Nothing secret is stored: no CSR, no certificate body, no ACME token or key, no solver configuration, and no Secret is ever read. kubectl is run by name from PATH and the definition's namespace, kubeconfig and context are honoured.

02Behaviors5
@dataverket/cert-manager/certificatev2026.11.12.1certificate.ts
fn list()
List cert-manager Certificate objects and record each with readiness, expiry and revision, plus one inventory of the run
fn get()
Read one cert-manager Certificate and record readiness, expiry and revision
fn trace()
Walk from one Certificate to its issuer, current CertificateRequest, ACME Order and Challenges, and record the chain with the level where issuance stands
fn renew(waitSeconds?: number)
Force a renewal of one Certificate as cmctl renew does: set the Issuing condition to True on the status subresource, refuse when an issuance is already in progress, then poll briefly and record the revision before and the state after
ArgumentTypeDescription
waitSeconds?numberHow long to poll for the new revision after the trigger. The renewal goes on in the cluster when the poll ends; 0 records the state right after the trigger.

Resources

certificate(infinite)— Certificate state: the Ready and Issuing conditions, the validity window, names, issuer, revision and failed issuance attempts
inventory(infinite)— What one list run saw: every Certificate in scope with its state, and how many are not healthy
trace(infinite)— One Certificate's issuance chain: the issuer, the current CertificateRequest, the Order and its Challenges, and the level where issuance stands
renewal(infinite)— A forced renewal: the revision and expiry before, and what was seen after the trigger
@dataverket/cert-manager/certificaterequestv2026.11.12.1certificaterequest.ts
fn list()
List cert-manager CertificateRequest objects and record each with its state, plus one inventory of the run
fn get()
Read one cert-manager CertificateRequest and record its state

Resources

certificateRequest(30d)— CertificateRequest state: the Certificate and revision it belongs to, the Approved, Denied, Ready and InvalidRequest conditions, the issuer and the failure time
inventory(30d)— What one list run saw: every CertificateRequest in scope with its state, and how many are not healthy
@dataverket/cert-manager/orderv2026.11.12.1order.ts
fn list()
List cert-manager Order objects and record each with its state, plus one inventory of the run
fn get()
Read one cert-manager Order and record its state

Resources

order(30d)— ACME Order state: state and reason, names, the authorizations without URLs or tokens, the failure time and the owning CertificateRequest
inventory(30d)— What one list run saw: every Order in scope with its state, and how many are not healthy
@dataverket/cert-manager/challengev2026.11.12.1challenge.ts
fn list()
List cert-manager Challenge objects and record each with its state, plus one inventory of the run
fn get()
Read one cert-manager Challenge and record its state

Resources

challenge(30d)— ACME Challenge state: type, DNS name, state and reason, presented and processing, the solver kind and the owning Order
inventory(30d)— What one list run saw: every Challenge in scope with its state, and how many are not healthy
@dataverket/cert-manager/issuerv2026.11.12.1issuer.ts
fn list(kind?: enum)
List cert-manager ClusterIssuer and Issuer objects and record each with its Ready state, plus one inventory of the run when both kinds are listed
ArgumentTypeDescription
kind?enumRestrict to one kind. Omit to list both. A list of one kind records the issuers and no inventory.
fn get(kind?: enum)
Read one cert-manager Issuer or ClusterIssuer and record its Ready state
ArgumentTypeDescription
kind?enumIssuer or ClusterIssuer

Resources

issuer(infinite)— Issuer or ClusterIssuer state: its type, the Ready condition and the ACME directory URL
inventory(infinite)— What one list run saw: every issuer in scope with its state, and how many are not healthy
03Previous Versions1
2026.11.10.1AGPL-3.0-only
04Stats
A
100 / 100
Downloads
4
Archive size
110.6 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

06Platforms
07Labels