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
| API | platform.etorm.com/v1alpha1 |
| Resource | approvals (cluster-scoped inside its cluster) |
| Short names | none |
| Available in | the platform and project clusters |
| Status | written by a controller through /status |
Minimal example
apiVersion: platform.etorm.com/v1alpha1
kind: Approval
metadata:
name: example
spec:
type: Bootstrap
reason: "<reason>"
Spec
| Field | Type | Required | Default | Allowed | Description |
type | string (one of) | yes | | Bootstrap, Freeze, GateWaiver, Override, Custody | Bootstrap: 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. |
reason | string | yes | | length 1 to 500 | Why the person decided this. |
requestRef | reference to BootstrapRequest | | | | The BootstrapRequest this approves (type Bootstrap). |
secretRef | reference to Secret | | | | The custody secret this confirms (type Custody). |
subjectRef | object | | | | The object an exception or freeze concerns, if any. |
subjectRef.group | string | | | up to 253 characters | API group. |
subjectRef.kind | string | | | up to 63 characters | Kind. |
subjectRef.name | string | | | up to 63 characters | Name. |
expiresAt | string | | | up to 40 characters | When the decision ends (RFC 3339). Empty means it lasts until deleted. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string (one of) | | | Active, Expired | Active until expiresAt. |
approvedBy | string | | | | The authenticated principal that made the decision. |
approvedAt | string | | | | When it was made (RFC 3339). |
conditions | list of object | | | | Detailed state. |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
Columns in listings
| Column | From |
|---|
| Type | .spec.type |
| ApprovedBy | .status.approvedBy |
| Phase | .status.phase |
| Expires | .spec.expiresAt |
All resources