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.

Déployer Trident

Contributeurs netapp-aruldeepa

Trident pour Docker assure une intégration directe avec l'écosystème Docker pour les plateformes de stockage NetApp . Il prend en charge le provisionnement et la gestion des ressources de stockage de la plateforme de stockage vers les hôtes Docker, avec un cadre permettant d'ajouter des plateformes supplémentaires à l'avenir.

Plusieurs instances de Trident peuvent s'exécuter simultanément sur le même hôte. Cela permet des connexions simultanées à plusieurs systèmes et types de stockage, avec la possibilité de personnaliser le stockage utilisé pour les volumes Docker.

Ce dont vous aurez besoin

Voir le"conditions préalables au déploiement" . Une fois que vous vous êtes assuré que les conditions préalables sont remplies, vous êtes prêt à déployer Trident.

Méthode de plugin géré par Docker (version 1.13/17.03 et ultérieures)

Remarque
Avant de commencer
Si vous avez utilisé Trident avant Docker 1.13/17.03 dans la méthode traditionnelle du démon, assurez-vous d'arrêter le processus Trident et de redémarrer votre démon Docker avant d'utiliser la méthode du plugin géré.
  1. Arrêtez toutes les instances en cours d'exécution :

    pkill /usr/local/bin/netappdvp
    pkill /usr/local/bin/trident
  2. Redémarrez Docker.

    systemctl restart docker
  3. Assurez-vous d'avoir installé Docker Engine 17.03 (nouvelle version 1.13) ou une version ultérieure.

    docker --version

    Si votre version est obsolète, "installer ou mettre à jour votre installation" .

Étapes
  1. Créez un fichier de configuration et spécifiez les options comme suit :

    • config: Le nom de fichier par défaut est config.json , vous pouvez toutefois utiliser n'importe quel nom de votre choix en spécifiant le config option avec le nom de fichier. Le fichier de configuration doit être situé dans le /etc/netappdvp répertoire sur le système hôte.

    • log-level`Spécifiez le niveau de journalisation(`debug , info , warn , error , fatal ). La valeur par défaut est info .

    • debug: Indiquez si la journalisation de débogage est activée. La valeur par défaut est fausse. Remplace le niveau de journalisation si la valeur est vraie.

      1. Créez un emplacement pour le fichier de configuration :

        sudo mkdir -p /etc/netappdvp
      2. Créez le fichier de configuration :

        cat << EOF > /etc/netappdvp/config.json
        {
          "version": 1,
          "storageDriverName": "ontap-nas",
          "managementLIF": "10.0.0.1",
          "dataLIF": "10.0.0.2",
          "svm": "svm_nfs",
          "username": "vsadmin",
          "password": "password",
          "aggregate": "aggr1"
        }
        EOF
  2. Démarrez Trident en utilisant le système de plugins gérés. Remplacer <version> avec la version du plugin (xxx.xx.x) que vous utilisez.

    docker plugin install --grant-all-permissions --alias netapp netapp/trident-plugin:<version> config=myConfigFile.json
  3. Commencez à utiliser Trident pour consommer du stockage du système configuré.

    1. Créez un volume nommé « firstVolume » :

      docker volume create -d netapp --name firstVolume
    2. Créer un volume par défaut au démarrage du conteneur :

      docker run --rm -it --volume-driver netapp --volume secondVolume:/my_vol alpine ash
    3. Supprimer le volume « firstVolume » :

      docker volume rm firstVolume

Méthode traditionnelle (version 1.12 ou antérieure)

Avant de commencer
  1. Assurez-vous d'avoir la version 1.10 ou ultérieure de Docker.

    docker --version

    Si votre version est obsolète, mettez à jour votre installation.

    curl -fsSL https://get.docker.com/ | sh
  2. Assurez-vous que NFS et/ou iSCSI sont configurés sur votre système.

Étapes
  1. Installez et configurez le plugin NetApp Docker Volume :

    1. Téléchargez et décompressez l'application :

      wget https://github.com/NetApp/trident/releases/download/v25.06.0/trident-installer-25.06.0.tar.gz
      tar zxf trident-installer-25.06.0.tar.gz
    2. Déplacez-vous vers un emplacement dans le chemin du bac :

      sudo mv trident-installer/extras/bin/trident /usr/local/bin/
      sudo chown root:root /usr/local/bin/trident
      sudo chmod 755 /usr/local/bin/trident
    3. Créez un emplacement pour le fichier de configuration :

      sudo mkdir -p /etc/netappdvp
    4. Créez le fichier de configuration :

      cat << EOF > /etc/netappdvp/ontap-nas.json
      {
        "version": 1,
        "storageDriverName": "ontap-nas",
        "managementLIF": "10.0.0.1",
        "dataLIF": "10.0.0.2",
        "svm": "svm_nfs",
        "username": "vsadmin",
        "password": "password",
        "aggregate": "aggr1"
      }
      EOF
  2. Après avoir placé le fichier binaire et créé le fichier de configuration, démarrez le démon Trident en utilisant le fichier de configuration souhaité.

    sudo trident --config=/etc/netappdvp/ontap-nas.json
    Remarque Sauf indication contraire, le nom par défaut du pilote de volume est « netapp ».

    Une fois le démon démarré, vous pouvez créer et gérer des volumes à l'aide de l'interface de ligne de commande Docker.

  3. Créer un volume :

    docker volume create -d netapp --name trident_1
  4. Provisionnez un volume Docker lors du démarrage d'un conteneur :

    docker run --rm -it --volume-driver netapp --volume trident_2:/my_vol alpine ash
  5. Supprimer un volume Docker :

    docker volume rm trident_1
    docker volume rm trident_2

Démarrage de Trident au démarrage du système

Un exemple de fichier d'unité pour les systèmes basés sur systemd est disponible à l'adresse suivante : contrib/trident.service.example dans le dépôt Git. Pour utiliser le fichier avec RHEL, procédez comme suit :

  1. Copiez le fichier à l'emplacement approprié.

    Vous devez utiliser des noms uniques pour les fichiers d'unité si vous avez plusieurs instances en cours d'exécution.

    cp contrib/trident.service.example /usr/lib/systemd/system/trident.service
  2. Modifiez le fichier, changez la description (ligne 2) pour qu'elle corresponde au nom du pilote et le chemin du fichier de configuration (ligne 9) pour qu'il reflète votre environnement.

  3. Rechargez systemd pour qu'il prenne en compte les modifications :

    systemctl daemon-reload
  4. Activez le service.

    Ce nom varie en fonction du nom que vous avez donné au fichier dans le /usr/lib/systemd/system annuaire.

    systemctl enable trident
  5. Démarrer le service.

    systemctl start trident
  6. Consultez le statut.

    systemctl status trident
Remarque Chaque fois que vous modifiez le fichier d'unité, exécutez le systemctl daemon-reload commande pour qu'il prenne connaissance des changements.