Resources / Approval

Approval

A person's recorded decision that automatic loops may not make for themselves (a new trust anchor, a freeze, a gate waiver, an override, a custody check). Only a user principal can create one; service accounts, processes and platform components cannot. It never changes after it is made; delete it to withdraw it. Only in the root cluster and in system projects.

Overview

APIplatform.etorm.com/v1alpha1
Resourceapprovals (cluster-scoped inside its cluster)
Short namesnone
Available inthe platform and project clusters
Statuswritten by a controller through /status

Minimal example

apiVersion: platform.etorm.com/v1alpha1
kind: Approval
metadata:
  name: example
spec:
  type: Bootstrap
  reason: "<reason>"

Spec

FieldTypeRequiredDefaultAllowedDescription
typestring (one of)yesBootstrap, Freeze, GateWaiver, Override, CustodyBootstrap: let a BootstrapRequest proceed. Freeze: every release and remediation controller stops acting. GateWaiver, Override: a person's exception named by subjectRef. Custody: the custodians confirmed they can produce the key a custody secret stands for.
reasonstringyeslength 1 to 500Why the person decided this.
requestRefreference to BootstrapRequestThe BootstrapRequest this approves (type Bootstrap).
secretRefreference to SecretThe custody secret this confirms (type Custody).
subjectRefobjectThe object an exception or freeze concerns, if any.
subjectRef.groupstringup to 253 charactersAPI group.
subjectRef.kindstringup to 63 charactersKind.
subjectRef.namestringup to 63 charactersName.
expiresAtstringup to 40 charactersWhen the decision ends (RFC 3339). Empty means it lasts until deleted.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestring (one of)Active, ExpiredActive until expiresAt.
approvedBystringThe authenticated principal that made the decision.
approvedAtstringWhen it was made (RFC 3339).
conditionslist of objectDetailed state.
conditions[].typestringAspect.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
Type.spec.type
ApprovedBy.status.approvedBy
Phase.status.phase
Expires.spec.expiresAt

All resources