Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Mettez à niveau une installation Trident à l'aide de l'opérateur Trident ou de Helm

Contributeurs

Vous pouvez mettre à niveau Trident à l'aide de l'opérateur Trident manuellement ou à l'aide d'Helm. Vous pouvez effectuer une mise à niveau d'une installation opérateur Trident vers une autre installation opérateur Trident ou passer d'une tridentctl installation à une version opérateur Trident. Révision "Sélectionnez une méthode de mise à niveau" avant la mise à niveau d'une installation de l'opérateur Trident.

Mettre à niveau une installation manuelle

Vous pouvez effectuer une mise à niveau d'une installation d'opérateur Trident dont le périmètre est défini dans le cluster vers une autre installation d'opérateur Trident dont le périmètre est défini dans le cluster. Toutes les versions de Trident 21.01 et supérieures utilisent un opérateur cluster-scoped.

Remarque Pour mettre à niveau à partir de Trident qui a été installé à l'aide de l'opérateur Namespace-scoped (versions 20.07 à 20.10), utilisez les instructions de mise à niveau pour "votre version installée" de Trident.
Description de la tâche

Trident fournit un fichier bundle que vous pouvez utiliser pour installer l'opérateur et créer les objets associés pour votre version Kubernetes.

Avant de commencer

Assurez-vous d'utiliser un cluster Kubernetes en cours d'exécution "Version Kubernetes prise en charge".

Étapes
  1. Vérifiez votre version de Trident :

    ./tridentctl -n trident version
  2. Supprimez l'opérateur Trident qui a été utilisé pour installer l'instance Trident actuelle. Par exemple, si vous mettez à niveau depuis 23.07, exécutez la commande suivante :

    kubectl delete -f 23.07.0/trident-installer/deploy/<bundle.yaml> -n trident
  3. Si vous avez personnalisé votre installation initiale à l'aide de TridentOrchestrator attributs, vous pouvez modifier le TridentOrchestrator objet pour modifier les paramètres d'installation. Cela peut inclure des modifications visant à spécifier les registres d'images en miroir Trident et CSI pour le mode hors ligne, à activer les journaux de débogage ou à spécifier les secrets d'extraction d'images.

  4. Installez Trident à l'aide du fichier YAML de bundle approprié pour votre environnement, où <bundle.yaml> est
    bundle_pre_1_25.yaml ou bundle_post_1_25.yaml basé sur votre version de Kubernetes. Par exemple, si vous installez Trident 24.10, exécutez la commande suivante :

    kubectl create -f 24.10.0/trident-installer/deploy/<bundle.yaml> -n trident

Mettre à niveau une installation Helm

Vous pouvez mettre à niveau une installation Trident Helm.

Avertissement Lors de la mise à niveau d'un cluster Kubernetes de la version 1.24 vers la version 1.25 ou ultérieure sur lequel Trident est installé, vous devez mettre à jour values.yaml pour définir excludePodSecurityPolicy sur true ou ajouter la --set excludePodSecurityPolicy=true helm upgrade commande avant de pouvoir mettre à niveau le cluster.

Si vous avez déjà mis à niveau votre cluster Kubernetes de 1.24 à 1.25 sans mettre à niveau le contrôleur Trident Helm, la mise à niveau Helm échoue. Pour effectuer la mise à niveau de Helm, effectuez les étapes suivantes en tant que conditions préalables :

  1. Installez le plug-in Helm-mapkubeapis à partir de https://github.com/helm/helm-mapkubeapis.

  2. Effectuez une exécution à sec pour la version Trident dans l'espace de nom où Trident est installé. Cette liste répertorie les ressources qui seront nettoyées.

    helm mapkubeapis --dry-run trident  --namespace trident
  3. Effectuez une analyse complète avec Helm pour effectuer le nettoyage.

    helm mapkubeapis trident  --namespace trident
Étapes
  1. Si vous "Installez Trident à l'aide de Helm - effectué", vous pouvez utiliser helm upgrade trident netapp-trident/trident-operator --version 100.2410.0 pour effectuer une mise à niveau en une seule étape. Si vous n'avez pas ajouté le Helm repo ou si vous ne pouvez pas l'utiliser pour mettre à niveau :

    1. Téléchargez la dernière version de Trident sur "La section Assets sur GitHub".

    2. Utilisez helm upgrade la commande où reflète la version vers laquelle trident-operator-24.10.0.tgz vous souhaitez effectuer la mise à niveau.

      helm upgrade <name> trident-operator-24.10.0.tgz
      Remarque Si vous définissez des options personnalisées lors de l'installation initiale (par exemple, si vous spécifiez des registres privés en miroir pour les images Trident et CSI), ajoutez le helm upgrade commande à l'aide de --set pour vous assurer que ces options sont incluses dans la commande de mise à niveau, sinon les valeurs sont réinitialisées sur les valeurs par défaut.
  2. Courez helm list pour vérifier que le graphique et la version de l'application ont tous deux été mis à niveau. Courez tridentctl logs pour consulter les messages de débogage.

Mise à niveau à partir d'un tridentctl Installation sur l'opérateur Trident

Vous pouvez effectuer la mise à niveau vers la dernière version de l'opérateur Trident à partir d'un tridentctl installation. Les systèmes back-end et ESV existants seront automatiquement disponibles.

Remarque Avant de passer d'une méthode d'installation à l'autre, consultez "Passage d'une méthode d'installation à l'autre".
Étapes
  1. Téléchargez la dernière version de Trident.

    # Download the release required [24.10.0]
    mkdir 24.10.0
    cd 24.10.0
    wget https://github.com/NetApp/trident/releases/download/v24.10.0/trident-installer-24.10.0.tar.gz
    tar -xf trident-installer-24.10.0.tar.gz
    cd trident-installer
  2. Créer le tridentorchestrator CRD du manifeste.

    kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml
  3. Déployer l'opérateur cluster-scoped dans le même namespace.

    kubectl create -f deploy/<bundle-name.yaml>
    
    serviceaccount/trident-operator created
    clusterrole.rbac.authorization.k8s.io/trident-operator created
    clusterrolebinding.rbac.authorization.k8s.io/trident-operator created
    deployment.apps/trident-operator created
    podsecuritypolicy.policy/tridentoperatorpods created
    
    #Examine the pods in the Trident namespace
    NAME                                  READY   STATUS    RESTARTS   AGE
    trident-controller-79df798bdc-m79dc   6/6     Running   0          150d
    trident-node-linux-xrst8              2/2     Running   0          150d
    trident-operator-5574dbbc68-nthjv     1/1     Running   0          1m30s
  4. Créez une TridentOrchestrator CR pour installer Trident.

    cat deploy/crds/tridentorchestrator_cr.yaml
    apiVersion: trident.netapp.io/v1
    kind: TridentOrchestrator
    metadata:
      name: trident
    spec:
      debug: true
      namespace: trident
    
    kubectl create -f deploy/crds/tridentorchestrator_cr.yaml
    
    #Examine the pods in the Trident namespace
    NAME                                READY   STATUS    RESTARTS   AGE
    trident-csi-79df798bdc-m79dc        6/6     Running   0          1m
    trident-csi-xrst8                   2/2     Running   0          1m
    trident-operator-5574dbbc68-nthjv   1/1     Running   0          5m41s
  5. Vérifiez que Trident a été mis à niveau vers la version prévue.

    kubectl describe torc trident | grep Message -A 3
    
    Message:                Trident installed
    Namespace:              trident
    Status:                 Installed
    Version:                v24.10.0