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éployez Trident

Contributeurs
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 jusqu'aux hôtes Docker, par exemple, l'ajout de plateformes supplémentaires à l'avenir.

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

Ce dont vous avez besoin

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

Méthode de plug-in géré Docker (version 1.13/17.03 et ultérieure)

Remarque
Avant de commencer
Si vous avez utilisé Trident antérieur à Docker 1.13/17.03 dans la méthode démon classique, veillez à arrêter le processus Trident et à redémarrer votre démon Docker avant d'utiliser la méthode du plug-in géré.

  1. Arrêter 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. Vérifiez que Docker Engine 17.03 (nouveau modèle 1.13) ou ultérieur est installé.

    docker --version

    Si votre version est obsolète, "installez ou mettez à 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 un nom quelconque en spécifiant le config avec le nom de fichier. Le fichier de configuration doit se trouver dans le /etc/netappdvp répertoire sur le système hôte.

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

    • debug: Spécifiez si la journalisation de débogage est activée. La valeur par défaut est FALSE. Remplace le niveau de journalisation si vrai.

      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 à l'aide du système de plug-in géré. Remplacez <version>-le par la version du plug-in (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éer un volume nommé « firstVolume » :

      docker volume create -d netapp --name firstVolume

    2. Créez 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. Vérifiez que Docker version 1.10 ou ultérieure est installé.

    docker --version

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

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

    Ou "suivez les instructions relatives à votre distribution".

  2. Vérifiez que NFS et/ou iSCSI sont configurés pour votre système.

Étapes

  1. Installez et configurez le plug-in de volume NetApp Docker :

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

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

    2. Déplacer 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 de Docker

  3. Créer un volume :

    docker volume create -d netapp --name trident_1

  4. Provisionnement d'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émarrez Trident au démarrage du système

Un exemple de fichier d'unité pour les systèmes basés sur le système se trouve à l'adresse contrib/trident.service.example Dans le Git repo. 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 plusieurs instances sont en cours d'exécution.

    cp contrib/trident.service.example /usr/lib/systemd/system/trident.service

  2. Modifiez le fichier, modifiez la description (ligne 2) pour qu'elle corresponde au nom du pilote et au chemin du fichier de configuration (ligne 9) pour qu'elle corresponde à votre environnement.

  3. Recharger le système pour qu'il ingère les modifications :

    systemctl daemon-reload

  4. Activer le service.

    Ce nom varie en fonction de ce que vous avez nommé le fichier dans le /usr/lib/systemd/system répertoire.

    systemctl enable trident

  5. Démarrer le service.

    systemctl start trident

  6. Afficher l'état.

    systemctl status trident
Remarque Chaque fois que vous modifiez le fichier d'unité, exécutez le systemctl daemon-reload commande pour que le service it soit conscient des modifications.