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

Key	Type	Default value	Description
metadata	object	null	This defines some data about the OS image. See reference
minVersion	string	null	Not used
type	string	empty	Defines the OS image type, could be container or iso
version	string	empty	OS image version
upgradeContainer	object	null	An 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:

Key	Type	Default value	Description
displayName	string	empty	OS image name as seen in Rancher UI
upgradeImage	string	empty	Fully qualified Containter image (OCI reference or HTTP URI)
platforms	list	empty	The supported platforms (linux/x86_64, linux/aarch64, or both).

If type is set to iso:

Key	Type	Default value	Description
displayName	string	empty	OS image name as seen in Rancher UI
uri	string	empty	Fully qualified ISO image
platforms	list	empty	The 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.