#ClusterVersionShadow [config.alauda.io/v1]

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

spec is the desired state of the cluster upgrade.

status contains information about cluster upgrade.

desiredUpdate is an optional field that indicates the desired value of the cluster version. Setting this value will trigger an upgrade (if the current version does not match the desired version).

force allows an administrator to update to an image that has failed checks that are designed to keep the cluster safe.

Use only if:

• testing
• working around a known bug

image is a container image reference that contains the update.

version is the container image tag that identifies the update.

availableUpdates contains available updates. This list may be

conditions provides information about the cluster version. The condition "Ready" is set to true if the desiredUpdate has been reached. The condition "Reconciling" is set to true if an update is being applied. The condition "Degraded" is set to true if an update is currently blocked by a temporary or permanent error.

Conditions are only valid for the current desiredUpdate when metadata.generation is equal to status.generation.

current is the currently applied release version and image of the cluster.

desired is the version that the cluster is reconciling towards. If the cluster is not yet fully initialized, desired will be set with the information available, which may be an image or a tag.

history contains a list of the most recent versions applied to the cluster. This value may be empty during cluster startup, and then will be updated when a new update is being applied. The newest update is first in the list and it is ordered by recency. Updates in the history have state Completed if the rollout completed - if an update was failing or halfway applied the state will be Partial. Only a limited amount of update history is preserved.

observedGeneration of the object. When this matches the object's metadata.generation, it indicates the status is up-to-date.

preflight records information used during an in-progress upgrade to support deterministic preflight reentry behavior.

stages expose the execution stages and per-operation DAG for the current update. Stages are executed sequentially; operations within a stage form a DAG.

image is a container image location that contains the update. When this field is part of spec, image is optional if version is specified.

version is a semantic version identifying the update version. When this field is part of spec, version is optional if image is specified.

lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.

message is a human readable message indicating details about the transition. This may be an empty string.

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 contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.

status of the condition, one of True, False, Unknown.

type of condition in CamelCase or in foo.example.com/CamelCase.

image is a container image location that contains the update. When this field is part of spec, image is optional if version is specified.

version is a semantic version identifying the update version. When this field is part of spec, version is optional if image is specified.

image is a container image location that contains the update. When this field is part of spec, image is optional if version is specified.

version is a semantic version identifying the update version. When this field is part of spec, version is optional if image is specified.

acceptedRisks records risks which were accepted to initiate the update.

completionTime if set, is when the update was fully applied. The update that is currently being applied will have a null completion time. Completion time will always be set for entries that are not the current update (usually to the started time of the next update).

image is a container image location that contains the update. This value is always populated.

startedTime is the time at which the update was started.

state reflects whether the update was fully applied. The Partial state indicates the update is not fully applied, while the Completed state indicates the update was successfully rolled out at least once (all parts of the update successfully applied).

version is a semantic version identifying the update version. If the requested image does not define a version, or if a failure occurs retrieving the image, this value may be empty.

checks records the latest evaluation result for each preflight check.

observedAt is the time when preflight was last evaluated.

message contains human-readable details for the last result.

name is the preflight check name.

policy indicates how the check behaves on reentry.

reason is a programmatic identifier for the last result.

state is the latest result state for the check.

name is the stage display name.

operations are the DAG nodes in this stage.

phase is the lifecycle status of this stage.

priority is the stage execution order (ascending).

action is Install/Upgrade/Delete (omit for no-op/unknown).

currentVersion is the observed value at build/progress time.

dependsOn lists direct predecessor operation names within this stage.

moduleInfo is the backing ModuleInfo name (if any).

name is the operation/component identifier (stable ID).

phase is the current operation phase string (e.g. Running/UpgradePending/Failed).

targetVersion is the desired value at build/progress time.