Mettre à niveau le module complémentaire de gouvernance des tâches

Vérifiez la version actuelle du module complémentaire et définissez un répertoire de travail.

aws eks describe-addon --region region --cluster-name cluster-name \
  --addon-name amazon-sagemaker-hyperpod-taskgovernance \
  --query 'addon.addonVersion' --output text

Vérifiez que la sortie commence parv1.3.. Définissez BACKUP_DIR ensuite un chemin absolu dans un répertoire accessible en écriture et créez-le. Les étapes suivantes permettent de lire et d'écrire dans cette variable. Exécutez donc chaque étape dans la même session shell.

export BACKUP_DIR=/absolute/path/to/backup-dir
mkdir -p "$BACKUP_DIR"

Sauvegardez chaque ressource personnalisée Kueue dans des fichiers locaux.

for crd in admissionchecks clusterqueues cohorts localqueues multikueueclusters \
           multikueueconfigs provisioningrequestconfigs resourceflavors topologies \
           workloadpriorityclasses workloads; do
  kubectl get "${crd}.kueue.x-k8s.io" --all-namespaces -o json \
    > "$BACKUP_DIR/${crd}.json" 2>/dev/null
  echo "${crd}: $(jq '.items | length' "$BACKUP_DIR/${crd}.json" 2>/dev/null || echo 0)"
done

Supprimez les objets sauvegardés et effacez l'ancienne version stockée de chaque CRD.

Cela supprime l'entrée v1alpha1 (ouv1beta1) status.storedVersions afin que les CRD v1.5 ou versions ultérieures puissent être installés. Les objets sont en sécurité dans votre sauvegarde et sont restaurés ultérieurement.

for crd in admissionchecks clusterqueues cohorts localqueues multikueueclusters \
           multikueueconfigs provisioningrequestconfigs resourceflavors topologies \
           workloadpriorityclasses workloads; do
  kubectl get crd "${crd}.kueue.x-k8s.io" >/dev/null 2>&1 || continue
  kubectl delete "${crd}.kueue.x-k8s.io" --all --all-namespaces \
    --ignore-not-found=true --wait=false --request-timeout=30s
  kubectl patch crd "${crd}.kueue.x-k8s.io" --subresource=status --type=merge \
    --request-timeout=30s -p '{"status":{"storedVersions":["v1beta2"]}}'
done

Mettez à jour le module complémentaire vers votre version cible (v1.5.0-eksbuild.1 ou version ultérieure).

target-versionRemplacez-la par la version du module complémentaire cible, par exemple v1.5.0-eksbuild.1 ouv1.6.0-eksbuild.1.

aws eks update-addon --region region --cluster-name cluster-name \
  --addon-name amazon-sagemaker-hyperpod-taskgovernance \
  --addon-version target-version --resolve-conflicts OVERWRITE

Attendez que le statut soit ACTIVE :

aws eks describe-addon --region region --cluster-name cluster-name \
  --addon-name amazon-sagemaker-hyperpod-taskgovernance \
  --query 'addon.status' --output text

Attendez que la nouvelle installation soit terminée avant de procéder à la restauration.

Ne restaurez pas immédiatement après les rapports du module complémentaireACTIVE. Attendez que le contrôleur, son webhook et les tâches de post-installation soient prêts, sinon la restauration à l'étape suivante risque de se bloquer.

kubectl rollout status deploy/kueue-controller-manager -n kueue-system --timeout=300s

until [ -n "$(kubectl get endpoints -n kueue-system kueue-webhook-service \
              -o jsonpath='{.subsets[*].addresses[*].ip}' 2>/dev/null)" ]; do
  echo "waiting for kueue webhook endpoint..."; sleep 5
done

kubectl wait --for=condition=complete job -l app.kubernetes.io/name=kueue \
  -n kueue-system --timeout=180s || true

Restaurez vos objets selon le nouveau schéma.

Cela transforme chaque objet sauvegardé en schéma v1.5 ou version ultérieure (v1beta2) et le réapplique.

transform() {
  jq '
    .apiVersion = "kueue.x-k8s.io/v1beta2"
    | del(.status)
    | del(.metadata.resourceVersion, .metadata.uid, .metadata.creationTimestamp,
          .metadata.generation, .metadata.managedFields, .metadata.selfLink)
    | del(.metadata.annotations."kubectl.kubernetes.io/last-applied-configuration")
    | if .kind == "Cohort" and (.spec.parent != null)
        then .spec.parentName = (.spec.parentName // .spec.parent) | del(.spec.parent) else . end
    | if .kind == "ClusterQueue" and (.spec.cohort != null)
        then .spec.cohortName = (.spec.cohortName // .spec.cohort) | del(.spec.cohort) else . end
    | if .kind == "ClusterQueue" then del(.spec.admissionChecks) else . end
    | if .kind == "AdmissionCheck" then del(.spec.retryDelayMinutes) else . end
  '
}

for crd in resourceflavors topologies workloadpriorityclasses admissionchecks cohorts \
           provisioningrequestconfigs multikueueclusters multikueueconfigs \
           clusterqueues localqueues workloads; do
  f="$BACKUP_DIR/${crd}.json"
  [ -s "$f" ] || continue
  count=$(jq '.items | length' "$f")
  for (( i=0; i<count; i++ )); do
    obj=$(jq -c ".items[$i]" "$f" | transform)
    name=$(printf '%s' "$obj" | jq -r '.kind + "/" + .metadata.name')
    if printf '%s' "$obj" | kubectl apply --request-timeout=30s -f - >/dev/null 2>&1; then
      echo "applied $name"
    else
      echo "check $name (may already be recreated by the add-on)"
    fi
  done
done

Vérifiez le résultat.

aws eks describe-addon --region region --cluster-name cluster-name \
  --addon-name amazon-sagemaker-hyperpod-taskgovernance \
  --query 'addon.{version:addonVersion,status:status}'

Voici un exemple de sortie (votre résultat version correspond à celui que target-version vous avez défini à l'étape 4).

{
    "version": "v1.5.0-eksbuild.1",
    "status": "ACTIVE"
}

Vérifiez que vos objets sont présents et qu'aucun CRD n'est toujours v1alpha1 répertorié :

kubectl get clusterqueues
kubectl get localqueues --all-namespaces
kubectl get crd clusterqueues.kueue.x-k8s.io -o jsonpath='{.status.storedVersions}'

La storedVersions sortie ne doit contenir que v1beta2 (ou v1beta1 etv1beta2), jamaisv1alpha1. Comparez les objets restaurés avec les fichiers pour vous $BACKUP_DIR assurer que les valeurs de configuration restent inchangées.