InfraClusterVersionPreflight [upgrade.alauda.io/v1alpha1]
- 描述
- InfraClusterVersionPreflight is the provider's read-only evaluation of one platform upgrade for one cluster, covering every hop before anything changes. It holds no lock and is re-evaluated continuously; CVO gates setting an InfraClusterVersion's desired state on it. There is one per cluster and platform upgrade, named <cluster>-<kubernetesVersion>-<8 hex hash> so that the controller and the CLI derive the same name for the same upgrade and share one object.
- 类型
object- 必填
spec
规格
.spec
- 描述
- InfraClusterVersionPreflightSpec is the "upgrade to where" part of an InfraClusterVersion's spec.desired, plus the cluster's identity. It carries no starting version: the provider plans the path from whatever the cluster runs when it evaluates, so the result always reflects the current state. The whole spec is immutable, including whether an optional field is present. The object's name is derived from the spec, so a different spec under the same name is a conflict to report, never an edit to accept.
- 类型
object- 必填
clusterNameinfrastructureRefkubernetesVersionrelease
.spec.components
- 描述
- components are hints only, under the same contract as on InfraClusterVersion.
- 类型
array
.spec.components[]
- 描述
- ComponentHint is a version hint for one component. It is only a hint: providers must not depend on its presence or value, and CVO does not promise to fill it.
- 类型
object
.spec.infrastructureRef
- 描述
- InfrastructureReference identifies the CAPI infrastructure cluster kind, copied from Cluster.spec.infrastructureRef. The kind decides which provider handles the object.
- 类型
object- 必填
apiVersionkind
.spec.release
- 描述
- release is the target ACP release of this platform upgrade.
- 类型
object- 必填
version
.status
- 描述
- InfraClusterVersionPreflightStatus is written only by the provider, on every evaluation. A result is fresh only when observedGeneration equals a non-zero metadata.generation and observedAt is recent; CVO trusts nothing else. resolvedImages and hops are extensions; the rest are core fields every provider must implement. All are optional in the schema.
- 类型
object
.status.checks
- 类型
array
.status.checks[]
- 描述
- PreflightCheck is one provider-defined check.
- 类型
object
.status.conditions
- 类型
array
.status.conditions[]
- 描述
- Condition contains details for one aspect of the current state of this API Resource.
- 类型
object- 必填
lastTransitionTimemessagereasonstatustype
.status.hops
- 描述
- hops lists the versions the provider plans to pass, in order, with kubernetesVersion only.
- 类型
array
.status.hops[]
- 描述
- Hop is one Kubernetes version change of at most one minor that the provider performs inside a generation. An InfraClusterVersionPreflight lists hops with kubernetesVersion only.
- 类型
object
.status.resolvedImages
- 描述
- resolvedImages previews the image each hop will use, one entry per hop and per KubeadmControlPlane or MachineDeployment. CVO does not read it; image problems are reported as checks.
- 类型
array
.status.resolvedImages[]
- 描述
- ResolvedImage is the image one KubeadmControlPlane or MachineDeployment uses for one hop.
- 类型
object
.status.resolvedImages[].machineTemplateRef
- 描述
- machineTemplateRef is the MachineTemplate used for the hop. It may be omitted for a hop not yet entered, and on a preflight it is at most the expected name: the template need not exist.
- 类型
object
.status.resolvedImages[].targetRef
- 描述
- targetRef is the KubeadmControlPlane or a MachineDeployment.
- 类型
object
API 端点
可用的 API 端点如下:
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflightsDELETE: delete collection of InfraClusterVersionPreflightGET: list objects of kind InfraClusterVersionPreflightPOST: create a new InfraClusterVersionPreflight
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflights/{name}DELETE: delete the specified InfraClusterVersionPreflightGET: read the specified InfraClusterVersionPreflightPATCH: partially update the specified InfraClusterVersionPreflightPUT: replace the specified InfraClusterVersionPreflight
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflights/{name}/statusGET: read status of the specified InfraClusterVersionPreflightPATCH: partially update status of the specified InfraClusterVersionPreflightPUT: replace status of the specified InfraClusterVersionPreflight
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflights
- HTTP 方法
DELETE- 描述
- delete collection of InfraClusterVersionPreflight
- HTTP 响应
- HTTP 方法
GET- 描述
- list objects of kind InfraClusterVersionPreflight
- HTTP 响应
- HTTP 方法
POST- 描述
- create a new InfraClusterVersionPreflight
- 查询参数
- 请求体参数
- HTTP 响应
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflights/{name}
- HTTP 方法
DELETE- 描述
- delete the specified InfraClusterVersionPreflight
- 查询参数
- HTTP 响应
- HTTP 方法
GET- 描述
- read the specified InfraClusterVersionPreflight
- HTTP 响应
- HTTP 方法
PATCH- 描述
- partially update the specified InfraClusterVersionPreflight
- 查询参数
- HTTP 响应
- HTTP 方法
PUT- 描述
- replace the specified InfraClusterVersionPreflight
- 查询参数
- 请求体参数
- HTTP 响应
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionpreflights/{name}/status
- HTTP 方法
GET- 描述
- read status of the specified InfraClusterVersionPreflight
- HTTP 响应
- HTTP 方法
PATCH- 描述
- partially update status of the specified InfraClusterVersionPreflight
- 查询参数
- HTTP 响应
- HTTP 方法
PUT- 描述
- replace status of the specified InfraClusterVersionPreflight
- 查询参数
- 请求体参数
- HTTP 响应