KubernetesUpgrade v1alpha1 — tuppr.home-operations.com

apiVersion string

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 string

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

metadata object

spec object

KubernetesUpgradeSpec defines the desired state of KubernetesUpgrade

healthChecks []object

HealthChecks defines a list of CEL-based health checks to perform before the upgrade

apiVersion string required

APIVersion of the resource to check

description string

Description of what this check validates (for status/logging)

expr string required

CEL expression that must evaluate to true for the check to pass The resource object is available as 'object' and status as 'status'

kind string required

Kind of the resource to check

name string

Name of the specific resource (optional, if empty checks all resources of this kind)

namespace string

Namespace of the resource (optional, for namespaced resources)

timeout string

Timeout for this health check

pattern: ^([0-9]+[smh])+$

minLength: 2

kubernetes object required

Kubernetes defines the target Kubernetes configuration

version string required

Version is the target Kubernetes version to upgrade to (e.g., "v1.34.0")

pattern: ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9\-\.]+)?$

maintenance object

Maintenance configuration behavior for upgrade operations

windows []object

minItems: 1

duration string required

How long the window stays open (e.g., "4h", "2h30m")

pattern: ^([0-9]+[smh])+$

start string required

Cron expression (5-field): minute hour day-of-month month day-of-week

minLength: 9

timezone string

IANA timezone (e.g., "UTC", "Europe/Paris")

talosctl object

Talosctl specifies the talosctl configuration for upgrade operations

image object

Image specifies the talosctl container image

pullPolicy string

PullPolicy describes a policy for if/when to pull a container image

enum: Always, Never, IfNotPresent

repository string

Repository is the talosctl container image repository

tag string

Tag is the talosctl container image tag If not specified, defaults to the target version

status object

KubernetesUpgradeStatus defines the observed state of KubernetesUpgrade

completedAt string

CompletedAt is the time the upgrade reached a terminal phase

format: date-time

controllerNode string

ControllerNode is the controller node being used for the upgrade

currentVersion string

CurrentVersion is the current Kubernetes version detected in the cluster

history []object

History records past version transitions on this CR, newest first

maxItems: 10

completedAt string required

CompletedAt is when the run reached its terminal phase

format: date-time

fromVersion string

FromVersion is the cluster version detected at the start of the run

lastError string

LastError is the final error message when Phase is Failed

phase string required

Phase is the terminal phase reached (Completed or Failed)

enum: Pending, HealthChecking, Draining, Upgrading, Rebooting, Completed, Failed, MaintenanceWindow

retries integer

Retries is the number of retries recorded during the run

minimum: 0

startedAt string required

StartedAt is when the run began

format: date-time

toVersion string required

ToVersion is the spec-target version at the time of completion

jobName string

JobName is the name of the job handling the upgrade

lastError string

LastError contains the last error message

lastUpdated string

LastUpdated timestamp of last status update

format: date-time

message string

Message provides details about the current state

nextMaintenanceWindow string

NextMaintenanceWindow reflect the next time a maintenance can happen

format: date-time

observedGeneration integer

ObservedGeneration reflects the generation of the most recently observed spec

format: int64

phase string

Phase represents the current phase of the upgrade

enum: Pending, HealthChecking, Draining, Upgrading, Rebooting, Completed, Failed, MaintenanceWindow

retries integer

Retries is the number of times the upgrade was attempted

minimum: 0

startedAt string

StartedAt is the time the current upgrade attempt began

format: date-time

targetVersion string

TargetVersion is the target version from the spec