Skip to main content

ManagedOSVersion reference

The ManagedOSVersion resource is responsible of defining an OS image version that can be used with SeedImage or ManagedOSImage resources.

There are several keys that can be configured under a ManagedOSVersion resource spec.

managedosversion-example.yaml
apiVersion: elemental.cattle.io/v1beta1
kind: ManagedOSVersion
metadata:
labels:
elemental.cattle.io/channel: elemental-channel
name: v2.0.2
namespace: fleet-default
spec:
metadata:
displayName: SLE Micro
upgradeImage: registry.suse.com/suse/sle-micro/5.5:2.0.2
type: container
version: v2.0.2

ManagedOSVersionSpec reference​

KeyTypeDefault valueDescription
metadataobjectnullThis defines some data about the OS image. See reference
minVersionstringnullNot used
typestringemptyDefines the OS image type, could be container or iso
versionstringemptyOS image version
upgradeContainerobjectnullAn upgrade container that can be defined. See reference
ISO image example
metadata:
displayName: SLE Micro ISO x86_64
uri: registry.suse.com/suse/sl-micro/6.0/baremetal-iso-image:2.2.0
type: iso
version: v2.2.0
Container image example
metadata:
displayName: SLE Micro
upgradeImage: registry.suse.com/suse/sl-micro/6.0/baremetal-os-container:2.2.0
type: container
version: v2.2.0

metadata​

This describes the needed informations to define an OS image in Elemental.

If type is set to container:

KeyTypeDefault valueDescription
displayNamestringemptyOS image name as seen in Rancher UI
upgradeImagestringemptyFully qualified Containter image (OCI reference or HTTP URI)
platformslistemptyThe supported platforms (linux/x86_64, linux/aarch64, or both).

If type is set to iso:

KeyTypeDefault valueDescription
displayNamestringemptyOS image name as seen in Rancher UI
uristringemptyFully qualified ISO image
platformslistemptyThe supported platforms (linux/x86_64, linux/aarch64, or both).

upgradeContainer​

This allows to overwrite the default upgrade field of System Upgrade Controller plans (see upgrade compontents) based on this ManagedOSVersion. These keys are translated by the System Upgrade Controller to a Kubernetes container specification. This is the container responsible of running an OS upgrade.