InfraClusterVersion [upgrade.alauda.io/v1alpha1]
- 描述
- InfraClusterVersion is the long-lived desired Kubernetes and OS state of one immutable cluster. CVO sets it once per platform upgrade; the cluster's provider converges it and reports status. There is one per immutable cluster, in the Global cluster's cpaas-system, named after the cluster: the API server then guarantees at most one per cluster, and a repeated create returns AlreadyExists instead of a duplicate. Each generation is one platform upgrade.
- 类型
object- 必填
spec
规格
.spec
- 描述
- InfraClusterVersionSpec is written only by CVO.
- 类型
object- 必填
clusterNamedesiredinfrastructureRef
.spec.desired
- 描述
- desired is the target of the current platform upgrade.
- 类型
object- 必填
kubernetesVersionrelease
.spec.desired.components
- 描述
- components are hints only; see ComponentHint.
- 类型
array
.spec.desired.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.desired.preflightRef
- 描述
- preflightRef names the InfraClusterVersionPreflight this generation was gated on. CVO always sets it in automatic mode and leaves it empty in manual mode. Providers treat it as informational.
- 类型
object
.spec.desired.release
- 描述
- release is the target ACP release of this platform upgrade.
- 类型
object- 必填
version
.spec.infrastructureRef
- 描述
- infrastructureRef is copied from the CAPI Cluster.
- 类型
object- 必填
apiVersionkind
.status
- 描述
- InfraClusterVersionStatus is written only by the provider, and describes the generation in observedGeneration. Core fields -- observedGeneration, phase, conditions, lock, current, startedTime and completionTime -- are what CVO reads and every provider must implement. The rest are extensions for observability that CVO does not read. All are optional in the schema: CVO creates the object with an empty status.
- 类型
object
.status.components
- 类型
array
.status.components[]
- 描述
- ComponentStatus is informational only: neither CVO nor any component may base a decision on it.
- 类型
object
.status.conditions
- 类型
array
.status.conditions[]
- 描述
- Condition contains details for one aspect of the current state of this API Resource.
- 类型
object- 必填
lastTransitionTimemessagereasonstatustype
.status.current
- 描述
- current is what the cluster has actually reached. kubernetesVersion advances with every completed hop, intermediate minors included; releaseVersion is written only when a whole generation succeeds.
- 类型
object
.status.generationStart
- 描述
- generationStart is the version at the start of the current generation. The history entry appended on success copies it into from: by then current.kubernetesVersion has moved on with every hop. The provider writes it once, when it observes a new generation and moves it to Preparing: kubernetesVersion from the KubeadmControlPlane's spec.version, releaseVersion from current, which is empty on a new object. It does not change it again within the generation -- not across hops, restarts, leader changes or provider upgrades -- and the next generation overwrites it, except a retargeted generation, one in which CVO replaced the target of an unfinished generation: that one keeps it, so it stays the start of the whole platform upgrade. On an object created while the cluster was already mid-upgrade, for example after a disaster-recovery switchover, it is what the provider observed when it took over, which may be an intermediate version. It is for audit only; providers do not decide their next step from it, except that in a retargeted generation they use it to tell this upgrade's own rollouts, those whose spec.version is at or above its kubernetesVersion, from external ones.
- 类型
object
.status.history
- 描述
- history gains one entry per completed generation, oldest first. Providers keep at most 20 entries, dropping the oldest. The schema does not enforce that limit: a cap would reject the provider's write rather than let it trim.
- 类型
array
.status.history[]
- 描述
- HistoryEntry records one completed generation, that is one platform upgrade; intermediate hops are not recorded separately.
- 类型
object
.status.history[].from
- 描述
- from is the version at the start of the generation, copied from status.generationStart.
- 类型
object
.status.history[].to
- 描述
- to is the final version of the generation.
- 类型
object
.status.hops
- 描述
- hops is the path the provider plans to walk, in order. Reset when a new generation starts; empty for a no-op generation.
- 类型
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.lock
- 描述
- LockStatus records which provider is executing the current generation. The cluster is locked while the current generation is unfinished, Stalled included; the lock is released when it succeeds and the record stays for audit until the next generation is taken over. There is no renewal and no time-based takeover.
- 类型
object
.status.resolvedImages
- 描述
- resolvedImages has one entry per hop and per KubeadmControlPlane or MachineDeployment, the same shape as on InfraClusterVersionPreflight.
- 类型
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
.status.rollout
- 类型
array
.status.rollout[]
- 描述
- RolloutStatus counts machines for one KubeadmControlPlane or MachineDeployment. There is deliberately no per-machine detail.
- 类型
object
.status.rollout[].ref
- 描述
- TypedLocalReference names an object in the same namespace by kind and name, for example a KubeadmControlPlane, a MachineDeployment or a MachineTemplate.
- 类型
object
.status.steps
- 描述
- steps is the progress inside the current hop. Reset on entering each hop and when a new generation starts.
- 类型
array
.status.steps[]
- 描述
- Step is one provider-defined step inside the current hop, for example KubeOVN, ControlPlane or Workers/<machinedeployment>.
- 类型
object
API 端点
可用的 API 端点如下:
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversionsDELETE: delete collection of InfraClusterVersionGET: list objects of kind InfraClusterVersionPOST: create a new InfraClusterVersion
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversions/{name}DELETE: delete the specified InfraClusterVersionGET: read the specified InfraClusterVersionPATCH: partially update the specified InfraClusterVersionPUT: replace the specified InfraClusterVersion
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversions/{name}/statusGET: read status of the specified InfraClusterVersionPATCH: partially update status of the specified InfraClusterVersionPUT: replace status of the specified InfraClusterVersion
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversions
- HTTP 方法
DELETE- 描述
- delete collection of InfraClusterVersion
- HTTP 响应
- HTTP 方法
GET- 描述
- list objects of kind InfraClusterVersion
- HTTP 响应
- HTTP 方法
POST- 描述
- create a new InfraClusterVersion
- 查询参数
- 请求体参数
- HTTP 响应
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversions/{name}
- HTTP 方法
DELETE- 描述
- delete the specified InfraClusterVersion
- 查询参数
- HTTP 响应
- HTTP 方法
GET- 描述
- read the specified InfraClusterVersion
- HTTP 响应
- HTTP 方法
PATCH- 描述
- partially update the specified InfraClusterVersion
- 查询参数
- HTTP 响应
- HTTP 方法
PUT- 描述
- replace the specified InfraClusterVersion
- 查询参数
- 请求体参数
- HTTP 响应
/apis/upgrade.alauda.io/v1alpha1/namespaces/{namespace}/infraclusterversions/{name}/status
- HTTP 方法
GET- 描述
- read status of the specified InfraClusterVersion
- HTTP 响应
- HTTP 方法
PATCH- 描述
- partially update status of the specified InfraClusterVersion
- 查询参数
- HTTP 响应
- HTTP 方法
PUT- 描述
- replace status of the specified InfraClusterVersion
- 查询参数
- 请求体参数
- HTTP 响应