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

Déploiement manuel de l'opérateur Trident (mode hors ligne)

10/29/2025 Contributeurs

Vous pouvez déployer manuellement l'opérateur Trident pour installer Trident. Ce processus s'applique aux installations où les images de conteneur requises par Trident sont stockées dans un registre privé. Si vous ne disposez pas d'un registre d'images privé, utilisez le"processus de déploiement standard" .

Informations essentielles concernant le Trident 25.06

Vous devez lire les informations essentielles suivantes concernant Trident.

<strong>Informations essentielles concernant Trident</strong>

Kubernetes 1.34 est désormais pris en charge dans Trident. Mettez à niveau Trident avant de mettre à niveau Kubernetes.
Trident impose strictement l'utilisation de la configuration multipathing dans les environnements SAN, avec une valeur recommandée de find_multipaths: no dans le fichier multipath.conf.

Utilisation d'une configuration sans chemins multiples ou utilisation de find_multipaths: yes ou find_multipaths: smart La valeur dans le fichier multipath.conf entraînera des échecs de montage. Trident a recommandé l'utilisation de find_multipaths: no depuis la version du 21 juillet.

Déployez manuellement l'opérateur Trident et installez Trident.

Revoir"aperçu de l'installation" pour vous assurer que vous avez respecté les prérequis d'installation et sélectionné l'option d'installation appropriée à votre environnement.

Avant de commencer

Connectez-vous à l'hôte Linux et vérifiez qu'il gère un système fonctionnel et"cluster Kubernetes pris en charge" et que vous disposez des privilèges nécessaires.

Avec OpenShift, utilisez oc au lieu de kubectl Dans tous les exemples suivants, connectez-vous d'abord en tant que system:admin en exécutant la commande suivante : oc login -u system:admin ou oc login -u kube-admin .

Details

Vérifiez votre version de Kubernetes :
```
kubectl version
```
Vérifier les privilèges d'administrateur du cluster :
```
kubectl auth can-i '*' '*' --all-namespaces
```
Vérifiez que vous pouvez lancer un pod utilisant une image provenant de Docker Hub et accéder à votre système de stockage via le réseau de pods :
```
kubectl run -i --tty ping --image=busybox --restart=Never --rm -- \
  ping <management IP>
```

Étape 1 : Téléchargez le package d’installation de Trident

Le package d'installation de Trident contient tout ce dont vous avez besoin pour déployer l'opérateur Trident et installer Trident. Téléchargez et extrayez la dernière version du programme d'installation de Trident depuis"la section Assets sur GitHub" .

wget https://github.com/NetApp/trident/releases/download/v6.0/trident-installer-25.06.0.tar.gz
tar -xf trident-installer-25.06.0.tar.gz
cd trident-installer

Étape 2 : Créer le `TridentOrchestrator` CRD

Créez le TridentOrchestrator Définition de ressource personnalisée (CRD). Vous allez créer un TridentOrchestrator Ressources personnalisées ultérieurement. Utilisez la version YAML CRD appropriée dans deploy/crds créer le TridentOrchestrator CRD :

kubectl create -f deploy/crds/<VERSION>.yaml

Étape 3 : Mettre à jour l’emplacement du registre dans l’opérateur

Dans /deploy/operator.yaml , mise à jour image: docker.io/netapp/trident-operator:25.06.0 pour refléter l'emplacement de votre registre d'images. Ton"Images de Trident et de CSI" Les images peuvent être stockées dans un seul registre ou dans plusieurs registres, mais toutes les images CSI doivent être stockées dans le même registre. Par exemple:

`image: <your-registry>/trident-operator:25.06.0`si toutes vos images sont situées dans un seul registre.
`image: <your-registry>/netapp/trident-operator:25.06.0`si votre image Trident se trouve dans un registre différent de celui de vos images CSI.

Étape 4 : Déployer l’opérateur Trident

Le programme d'installation de Trident fournit un fichier bundle qui peut être utilisé pour installer l'opérateur et créer les objets associés. Le fichier bundle est un moyen simple de déployer l'opérateur et d'installer Trident en utilisant une configuration par défaut.

Pour les clusters exécutant Kubernetes 1.24, utilisez bundle_pre_1_25.yaml .
Pour les clusters exécutant Kubernetes 1.25 ou une version ultérieure, utilisez bundle_post_1_25.yaml .

Avant de commencer

Par défaut, le programme d'installation de Trident déploie l'opérateur dans le trident espace de noms. Si le trident L'espace de noms n'existe pas, créez-le en utilisant :
```
kubectl apply -f deploy/namespace.yaml
```
Pour déployer l'opérateur dans un espace de noms autre que le trident espace de noms, mise à jour serviceaccount.yaml , clusterrolebinding.yaml et operator.yaml et générez votre fichier bundle en utilisant kustomization.yaml .
1. Créez le kustomization.yaml en utilisant la commande suivante où <bundle.yaml> est bundle_pre_1_25.yaml ou bundle_post_1_25.yaml en fonction de votre version de Kubernetes.
  cp deploy/kustomization_<bundle.yaml> deploy/kustomization.yaml
2. Compilez le bundle à l'aide de la commande suivante où <bundle.yaml> est bundle_pre_1_25.yaml ou bundle_post_1_25.yaml en fonction de votre version de Kubernetes.
  kubectl kustomize deploy/ > deploy/<bundle.yaml>

Étapes

Créer les ressources et déployer l'opérateur :
```
kubectl create -f deploy/<bundle.yaml>
```
Vérifiez que l'opérateur, le déploiement et les ensembles de réplicas ont bien été créés.
```
kubectl get all -n <operator-namespace>
```

Il ne devrait y avoir qu'une seule instance de l'opérateur dans un cluster Kubernetes. Ne créez pas plusieurs déploiements de l'opérateur Trident .

Étape 5 : Mettez à jour l’emplacement du registre d’images dans le `TridentOrchestrator`

Ton"Images de Trident et de CSI" Les images peuvent être stockées dans un seul registre ou dans plusieurs registres, mais toutes les images CSI doivent être stockées dans le même registre. Mise à jour deploy/crds/tridentorchestrator_cr.yaml pour ajouter les spécifications de localisation supplémentaires en fonction de la configuration de votre registre.

Des images dans un seul registre

imageRegistry: "<your-registry>"
autosupportImage: "<your-registry>/trident-autosupport:25.06"
tridentImage: "<your-registry>/trident:25.06.0"

Images dans différents registres

imageRegistry: "<your-registry>"
autosupportImage: "<your-registry>/trident-autosupport:25.06"
tridentImage: "<your-registry>/trident:25.06.0"

Étape 6 : Créer le `TridentOrchestrator` et installer Trident

Vous pouvez maintenant créer le TridentOrchestrator et installez Trident. Vous pouvez également, si vous le souhaitez, aller plus loin."Personnalisez votre installation Trident" en utilisant les attributs dans le TridentOrchestrator spécification L'exemple suivant illustre une installation où les images Trident et CSI sont situées dans des registres différents.

kubectl create -f deploy/crds/tridentorchestrator_cr.yaml
tridentorchestrator.trident.netapp.io/trident created

kubectl describe torc trident

Name:        trident
Namespace:
Labels:      <none>
Annotations: <none>
API Version: trident.netapp.io/v1
Kind:        TridentOrchestrator
...
Spec:
  Autosupport Image:  <your-registry>/trident-autosupport:25.06
  Debug:              true
  Image Registry:     <your-registry>
  Namespace:          trident
  Trident Image:      <your-registry>/trident:25.06.0
Status:
  Current Installation Params:
    IPv6:                       false
    Autosupport Hostname:
    Autosupport Image:          <your-registry>/trident-autosupport:25.06
    Autosupport Proxy:
    Autosupport Serial Number:
    Debug:                      true
    Http Request Timeout:       90s
    Image Pull Secrets:
    Image Registry:       <your-registry>
    k8sTimeout:           30
    Kubelet Dir:          /var/lib/kubelet
    Log Format:           text
    Probe Port:           17546
    Silence Autosupport:  false
    Trident Image:        <your-registry>/trident:25.06.0
  Message:                Trident installed
  Namespace:              trident
  Status:                 Installed
  Version:                v25.06.0
Events:
    Type Reason Age From Message ---- ------ ---- ---- -------Normal
    Installing 74s trident-operator.netapp.io Installing Trident Normal
    Installed 67s trident-operator.netapp.io Trident installed

Vérifier l'installation

Il existe plusieurs façons de vérifier votre installation.

En utilisant `TridentOrchestrator` statut

Le statut de TridentOrchestrator indique si l'installation a réussi et affiche la version de Trident installée. Lors de l'installation, l'état de TridentOrchestrator changements de Installing à Installed . Si vous observez le Failed état et l'opérateur est incapable de se rétablir par lui-même,"vérifier les journaux" .

Statut Description

Statut	Description
Installation	L'opérateur installe Trident à l'aide de ceci `TridentOrchestrator` CR.
Installé	Trident a été installé avec succès.
Désinstallation	L'opérateur désinstalle Trident, car `spec.uninstall=true` .
Désinstallé	Trident est désinstallé.
Échec	L'opérateur n'a pas pu installer, corriger, mettre à jour ou désinstaller Trident; il tentera automatiquement de récupérer à partir de cet état. Si cet état persiste, un dépannage sera nécessaire.
Mise à jour	L'opérateur met à jour une installation existante.
Erreur	Le `TridentOrchestrator` n'est pas utilisé. Il en existe déjà un autre.

Installation

L'opérateur installe Trident à l'aide de ceci TridentOrchestrator CR.

Installé

Trident a été installé avec succès.

Désinstallation

L'opérateur désinstalle Trident, car
spec.uninstall=true .

Désinstallé

Trident est désinstallé.

Échec

L'opérateur n'a pas pu installer, corriger, mettre à jour ou désinstaller Trident; il tentera automatiquement de récupérer à partir de cet état. Si cet état persiste, un dépannage sera nécessaire.

Mise à jour

L'opérateur met à jour une installation existante.

Erreur

Le TridentOrchestrator n'est pas utilisé. Il en existe déjà un autre.

Utilisation de l'état de création du pod

Vous pouvez vérifier si l'installation de Trident est terminée en consultant l'état des pods créés :

kubectl get pods -n trident

NAME                                       READY   STATUS    RESTARTS   AGE
trident-controller-7d466bf5c7-v4cpw        6/6     Running   0           1m
trident-node-linux-mr6zc                   2/2     Running   0           1m
trident-node-linux-xrp7w                   2/2     Running   0           1m
trident-node-linux-zh2jt                   2/2     Running   0           1m
trident-operator-766f7b8658-ldzsv          1/1     Running   0           3m

En utilisant `tridentctl`

Vous pouvez utiliser tridentctl pour vérifier la version de Trident installée.

./tridentctl -n trident version

+----------------+----------------+
| SERVER VERSION | CLIENT VERSION |
+----------------+----------------+
| 25.06.0        | 25.06.0        |
+----------------+----------------+

Déploiement manuel de l'opérateur Trident (mode hors ligne)

Creating your file...