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

  1. apiVersion: elemental.cattle.io/v1beta1
  2. kind: ManagedOSVersion
  3. metadata:
  4.   labels:
  5.     elemental.cattle.io/channel: elemental-channel
  6.   name: v1.1.5
  7.   namespace: fleet-default
  8. spec:
  9.   metadata:
  10.     displayName: Elemental Teal OS
  11.     upgradeImage: registry.suse.com/rancher/elemental-teal/5.3:1.1.5
  12.   type: container
  13.   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

  1. metadata:
  2.   displayName: Elemental Teal ISO x86_64
  3.   uri: registry.suse.com/rancher/elemental-teal-iso/5.3:1.1.5
  4. type: iso
  5. version: v1.1.5

Container image example

  1. metadata:
  2.   displayName: Elemental Teal OS
  3.   upgradeImage: registry.suse.com/rancher/elemental-teal/5.3:1.1.5
  4. type: container
  5. 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.