Implement elemental-register upgrade

[anmazzotti]

Part of rancher/elemental#1565

This PR introduces the elemental-register upgrade subcommand to replace the suc-upgrade script.

Most of the logic from suc-upgrade was kept, except the isHigherVersion and FORCE=true logic, which got eliminated.
Instead, the elemental-register upgrade commands accepts a correlationID that will be applied to the Elemental snapshot during upgrade.

By default we are using the ManagedOSImage.Spec sha224 hash as correlationID. With some quirks, for example the spec.Targets is always nullified to avoid re-applying upgrades whenever the target clusters are updated.

For example, this will be the resulting state after a successful upgrade:

apiVersion: elemental.cattle.io/v1beta1
kind: ManagedOSImage
metadata:
  name: dev-upgrade
  namespace: fleet-default
  labels:
    elemental.cattle.io/upgrade-correlation-id: 468c501b8597d483f9c5e24bad840c9473cdae750b9806c152ad0f46
spec:
  osImage: "172.18.0.2:30000/elemental-os:dev-next"
  clusterTargets:
    - clusterName: volcano
  upgradeContainer:
    envs:
      # Use UPGRADE_RECOVERY to upgrade both system and recovery partitions.
      - name: UPGRADE_RECOVERY
        value: "true"

On downstream, the snapshot will carry the CorrelationID

test-e5331e3b-1e1b-4ce7-b080-235ed9a6d07c:~ # elemental state
date: "2024-10-25T13:28:20Z"
snapshotter:
    type: btrfs
    max-snaps: 2
    config: {}
efi:
    label: COS_GRUB
oem:
    label: COS_OEM
persistent:
    label: COS_PERSISTENT
recovery:
    label: COS_RECOVERY
    recovery:
        source: dir:///run/rootfsbase
        fs: squashfs
        labels:
            correlationID: 468c501b8597d483f9c5e24bad840c9473cdae750b9806c152ad0f46
            image: 172.18.0.2:30000/elemental-os:dev-next
            managedOSImage: dev-upgrade
        date: "2024-10-25T13:28:20Z"
        fromAction: upgrade
state:
    label: COS_STATE
    snapshots:
        1:
            source: dir:///run/rootfsbase
            date: "2024-10-25T13:25:03Z"
            fromAction: install
        2:
            source: dir:///
            active: true
            labels:
                correlationID: 468c501b8597d483f9c5e24bad840c9473cdae750b9806c152ad0f46
                image: 172.18.0.2:30000/elemental-os:dev-next
                managedOSImage: dev-upgrade
            date: "2024-10-25T13:28:20Z"
            fromAction: upgrade

And the plan as well:

test-e5331e3b-1e1b-4ce7-b080-235ed9a6d07c:~ # kubectl -n cattle-system get plans os-upgrader-dev-upgrade -o yaml
apiVersion: upgrade.cattle.io/v1
kind: Plan
metadata:
  annotations:
    meta.helm.sh/release-name: mos-dev-upgrade
    meta.helm.sh/release-namespace: default
    objectset.rio.cattle.io/id: default-mos-dev-upgrade
  creationTimestamp: "2024-10-25T13:27:34Z"
  generation: 2
  labels:
    app.kubernetes.io/managed-by: Helm
    elemental.cattle.io/upgrade-correlation-id: 468c501b8597d483f9c5e24bad840c9473cdae750b9806c152ad0f46
    objectset.rio.cattle.io/hash: 3d9ab475f418bf210ef5034b761aaa5dfc14f587
  name: os-upgrader-dev-upgrade
  namespace: cattle-system
  resourceVersion: "4272"
  uid: 5cca77bc-238f-48aa-9d5f-ff5f46d92e6c
spec:
  concurrency: 1
  cordon: true
  drain:
    deleteLocalData: true
    force: true
    ignoreDaemonSets: true
    skipWaitForDeleteTimeout: 60
  exclusive: true
  nodeSelector: {}
  secrets:
  - name: os-upgrader-dev-upgrade
    path: /run/data
  serviceAccountName: os-upgrader-dev-upgrade
  tolerations:
  - operator: Exists
  upgrade:
    command:
    - /usr/sbin/suc-upgrade
    envs:
    - name: FORCE
      value: "false"
    - name: UPGRADE_RECOVERY
      value: "true"
    - name: UPGRADE_RECOVERY_ONLY
      value: "false"
    - name: ELEMENTAL_REGISTER_UPGRADE_SNAPSHOT_LABELS
      value: managedOSImage=dev-upgrade,image=172.18.0.2:30000/elemental-os:dev-next
    - name: ELEMENTAL_REGISTER_UPGRADE_CORRELATION_ID
      value: 468c501b8597d483f9c5e24bad840c9473cdae750b9806c152ad0f46
    image: 172.18.0.2:30000/elemental-os
  version: dev-next
status:
  conditions:
  - lastUpdateTime: "2024-10-25T13:36:18Z"
    reason: PlanIsValid
    status: "True"
    type: Validated
  - lastUpdateTime: "2024-10-25T13:36:18Z"
    reason: Version
    status: "True"
    type: LatestResolved
  - lastUpdateTime: "2024-10-25T13:29:54Z"
    status: "True"
    type: Complete
  latestHash: 52588095671b923da6784fd19a810deafc37a9b6d67b395b394173bc
  latestVersion: dev-next