Skip to main content
Une version plus récente de ce produit est disponible.
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Déployer Trident

PDF

Trident pour Docker offre 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 depuis la plateforme de stockage vers les hôtes Docker, avec un cadre permettant l'ajout de 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 de stockage et types de stockage, avec la possibilité de personnaliser le stockage utilisé pour les volumes Docker.

Ce dont vous aurez besoin

Consultez la "conditions préalables au déploiement". Une fois que vous vous êtes assuré que les prérequis sont remplis, vous êtes prêt à déployer Trident.

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

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 (new 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, cependant, vous pouvez utiliser n'importe quel nom de votre choix en spécifiant l'option config avec le nom de fichier. Le fichier de configuration doit se trouver dans le répertoire /etc/netappdvp 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 false. Remplace log-level si true.

      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. Remplacez <version> par 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 à partir 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. Supprimez le volume "firstVolume" :

      docker volume rm firstVolume

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

Avant de commencer

  1. Assurez-vous d'avoir Docker version 1.10 ou ultérieure.

    docker --version

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

    curl -fsSL https://get.docker.com/ | sh

    Ou, "Suivez les instructions pour votre distribution".

  2. Assurez-vous que NFS et/ou iSCSI sont configurés pour votre système.

Étapes

  1. Installez et configurez le plugin Docker Volume NetApp :

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

      wget https://github.com/NetApp/trident/releases/download/10.0/trident-installer-25.10.0.tar.gz
tar zxf trident-installer-25.10.0.tar.gz

    2. Accédez à un emplacement dans le chemin du bin :

      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".

    Après le démarrage du démon, vous pouvez créer et gérer des volumes à l'aide de l'interface CLI 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émarrer Trident au démarrage du système

Un exemple de fichier d'unité pour les systèmes basés sur systemd est disponible à 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 correct.

    Vous devez utiliser des noms uniques pour les fichiers d'unité si vous avez plus d'une instance 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 répertoire.

    systemctl enable trident

  5. Démarrez le service.

    systemctl start trident

  6. Consultez le statut.

    systemctl status trident
Remarque Chaque fois que vous modifiez le fichier d'unité, exécutez la commande systemctl daemon-reload pour qu'il prenne en compte les modifications.