Skip to main content
Version: 1.2

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: v1.1.5
namespace: fleet-default
spec:
metadata:
displayName: Elemental Teal OS
upgradeImage: registry.suse.com/rancher/elemental-teal/5.3:1.1.5
type: container
version: v1.1.5

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: Elemental Teal ISO x86_64
uri: registry.suse.com/rancher/elemental-teal-iso/5.3:1.1.5
type: iso
version: v1.1.5
Container image example
metadata:
displayName: Elemental Teal OS
upgradeImage: registry.suse.com/rancher/elemental-teal/5.3:1.1.5
type: container
version: v1.1.5

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)

If type is set to iso:

KeyTypeDefault valueDescription
displayNamestringemptyOS image name as seen in Rancher UI
uristringemptyFully qualified ISO image

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.