GraphRevision
The GraphRevision is an immutable snapshot of a ResourceGraphDefinition spec. kro creates GraphRevisions internally to track revision history and enable safe rollouts.
API Specification
API Version
internal.kro.run/v1alpha1Kind
GraphRevisionScope
ClusterFields Reference
Spec
| Field | Type | Description |
|---|---|---|
revisionrequired | integer | Revision is a monotonic revision number assigned per ResourceGraphDefinition name. |
snapshotrequired | object | Snapshot is an immutable capture of the source ResourceGraphDefinition identity and spec at the time this revision was issued. |
generationrequired | integer | Generation is the metadata.generation of the source ResourceGraphDefinition when this revision was issued. Informational only. |
namerequired | string | Name identifies the source ResourceGraphDefinition by name. This is the authoritative identity for adoption decisions. |
specrequired | object | Spec is an immutable copy of the source ResourceGraphDefinition spec. This includes user-authored schema and resource templates. |
Status
| Field | Type | Description |
|---|---|---|
conditions | []object | Conditions represent the latest available observations of the GraphRevision state. GraphRevision exposes GraphVerified plus aggregate Ready. |
lastTransitionTime | string | Last time the condition transitioned from one status to another. |
message | string | A human-readable message indicating details about the transition. |
observedGeneration | integer | observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance. |
reason | string | The reason for the condition's last transition. |
statusrequired | string | Status of the condition, one of True, False, Unknown. |
typerequired | string | Type is the type of the Condition |
resources | []object | Resources provides detailed information about each resource in the graph. |
dependencies | []object | Dependencies lists all resources that this resource depends on. A resource depends on another if it references it in a CEL expression. These dependencies determine the order of resource creation. |
id | string | ID is the unique identifier of the resource as defined in the resources list. |
topologicalOrder | []string | TopologicalOrder is the ordered list of resource IDs based on dependencies. |