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/31/2024 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 "du déploiement standard".

Informations critiques sur Trident 24.10

Vous devez lire les informations critiques suivantes sur Trident.

<strong> informations sur le Trident </strong>

Kubernetes 1.31 est désormais pris en charge dans Trident. Mise à niveau de Trident avant la mise à niveau de Kubernetes.
Trident applique strictement l'utilisation de la configuration de chemins d'accès multiples dans les environnements SAN, avec une valeur recommandée de find_multipaths: no dans le fichier multipath.conf.

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

Déployer manuellement l'opérateur Trident et installer Trident

Révision "présentation de l'installation" pour vous assurer que les conditions préalables à l'installation sont respectées et que vous avez sélectionné l'option d'installation appropriée pour votre environnement.

Avant de commencer

Connectez-vous à l'hôte Linux et vérifiez qu'il gère un environnement de travail 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 qui suivent, et connectez-vous en tant que system:admin en premier lieu en cours d'exécution oc login -u system:admin ou oc login -u kube-admin.

Details

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

Étape 1 : téléchargez le package du programme d'installation de Trident

Le programme 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 sur "La section Assets sur GitHub".

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

Étape 2 : créez le `TridentOrchestrator` CRD

Créez la TridentOrchestrator définition de ressource personnalisée (CRD). Vous créez ensuite des TridentOrchestrator ressources personnalisées. Utilisez la version CRD YAML appropriée dans deploy/crds pour créer le TridentOrchestrator CRD :

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

Étape 3 : mettez à jour l'emplacement du registre dans l'opérateur

Dans /deploy/operator.yaml, mettez à jour image: docker.io/netapp/trident-operator:24.10.0 pour refléter l'emplacement de votre registre d'images. Votre "Images Trident et CSI" peut être situé dans un registre ou dans des registres différents, mais toutes les images CSI doivent se trouver dans le même registre. Par exemple :

image: <your-registry>/trident-operator:24.10.0 si vos images se trouvent toutes dans un registre.
image: <your-registry>/netapp/trident-operator:24.10.0 Si votre image Trident se trouve dans un registre différent de vos images CSI.

Étape 4 : déploiement de l'opérateur Trident

Le programme d'installation de Trident fournit un fichier de bundle qui peut être utilisé pour installer l'opérateur et créer des objets associés. Le fichier de bundle est un moyen facile de déployer l'opérateur et d'installer Trident à l'aide d'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 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 trident espace de noms. Si le trident l'espace de noms n'existe pas. créez-le à l'aide des éléments suivants :
```
kubectl apply -f deploy/namespace.yaml
```
Pour déployer l'opérateur dans un espace de nom autre que le trident espace de noms, mettre à jour serviceaccount.yaml, clusterrolebinding.yaml et operator.yaml et générez votre fichier de bundle à l'aide du kustomization.yaml.
1. Créer le kustomization.yaml en utilisant la commande suivante où <bundle.yaml> est bundle_pre_1_25.yaml ou bundle_post_1_25.yaml Basé sur 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 Basé sur 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 réplicateurs ont été créés.
```
kubectl get all -n <operator-namespace>
```

Il ne doit y avoir que une 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`

Votre "Images Trident et CSI" Peut être situé dans un registre ou dans des registres différents, mais toutes les images CSI doivent se trouver dans le même registre. Mise à jour deploy/crds/tridentorchestrator_cr.yaml pour ajouter les spécifications d'emplacement supplémentaires en fonction de votre configuration de registre.

Images dans un registre

imageRegistry: "<your-registry>"
autosupportImage: "<your-registry>/trident-autosupport:24.10"
tridentImage: "<your-registry>/trident:24.10.0"

Images dans différents registres

imageRegistry: "<your-registry>"
autosupportImage: "<your-registry>/trident-autosupport:24.10"
tridentImage: "<your-registry>/trident:24.10.0"

Étape 6 : créez le `TridentOrchestrator` Et installer Trident

Vous pouvez maintenant créer TridentOrchestrator et installer Trident. Vous pouvez également "Personnalisez votre installation de Trident"utiliser les attributs de la TridentOrchestrator spécification. L'exemple suivant montre une installation dans laquelle les images Trident et CSI se trouvent dans différents registres.

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:24.10
  Debug:              true
  Image Registry:     <your-registry>
  Namespace:          trident
  Trident Image:      <your-registry>/trident:24.10.0
Status:
  Current Installation Params:
    IPv6:                       false
    Autosupport Hostname:
    Autosupport Image:          <your-registry>/trident-autosupport:24.10
    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:24.10.0
  Message:                Trident installed
  Namespace:              trident
  Status:                 Installed
  Version:                v24.10.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érifiez l'installation

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

À l'aide de `TridentOrchestrator` état

Le statut de TridentOrchestrator Indique si l'installation a réussi et affiche la version de Trident installée. Pendant l'installation, l'état de TridentOrchestrator modifications de Installing à Installed. Si vous observez l' Failed l'état et l'opérateur ne parvient pas à récupérer lui-même, "vérifiez les journaux".

État Description

État	Description
Installation	L'opérateur installe Trident à l'aide de ce `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 ; l'opérateur essaiera automatiquement de récupérer à partir de cet état. Si cet état persiste, vous devrez effectuer un dépannage.
Mise à jour	L'opérateur met à jour une installation existante.
Erreur	Le `TridentOrchestrator` n'est pas utilisé. Un autre existe déjà.

Installation

L'opérateur installe Trident à l'aide de ce 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 ; l'opérateur essaiera automatiquement de récupérer à partir de cet état. Si cet état persiste, vous devrez effectuer un dépannage.

Mise à jour

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

Erreur

Le TridentOrchestrator n'est pas utilisé. Un autre existe déjà.

Utilisation du statut de création du pod

Vous pouvez vérifier si l'installation de Trident est terminée en vérifiant 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

À l'aide de `tridentctl`

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

./tridentctl -n trident version

+----------------+----------------+
| SERVER VERSION | CLIENT VERSION |
+----------------+----------------+
| 24.10.0        | 24.10.0        |
+----------------+----------------+

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

Creating your file...