Skip to main content
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Implante o Trident

Colaboradores juliantap netapp-aruldeepa joan-ing netapp-mwallis
PDFs

O Trident para Docker oferece integração direta com o ecossistema Docker para plataformas de storage NetApp. Ele dá suporte ao provisionamento e gerenciamento de recursos de storage da plataforma de storage para hosts Docker, com uma estrutura para adicionar plataformas adicionais no futuro.

Várias instâncias do Trident podem ser executadas simultaneamente no mesmo host. Isso permite conexões simultâneas a vários sistemas de armazenamento e tipos de armazenamento, com a capacidade de personalizar o armazenamento usado para os volumes Docker.

O que você vai precisar

Consulte "pré-requisitos para implantação". Depois de garantir que os pré-requisitos sejam atendidos, você estará pronto para implantar o Trident.

Método de plug-in gerenciado Docker (versão 1,13/17,03 e posterior)

Observação
Antes de começar
Se você usou o Trident pré Docker 1,13/17,03 no método daemon tradicional, certifique-se de parar o processo Trident e reiniciar o seu daemon Docker antes de usar o método do plugin gerenciado.

  1. Parar todas as instâncias em execução:

    pkill /usr/local/bin/netappdvp
pkill /usr/local/bin/trident

  2. Reinicie o Docker.

    systemctl restart docker

  3. Certifique-se de que tem o Docker Engine 17,03 (novo 1,13) ou posterior instalado.

    docker --version

    Se a sua versão estiver desatualizada, "instale ou atualize a instalação".

Passos

  1. Crie um arquivo de configuração e especifique as opções da seguinte forma:

    • config: O nome do arquivo padrão é config.json, no entanto, você pode usar qualquer nome que você escolher especificando a config opção com o nome do arquivo. O arquivo de configuração deve estar localizado /etc/netappdvp no diretório no sistema host.

    • log-level: Especifique o nível de registo (debug, info, warn error , , fatal ). A predefinição é info.

    • debug: Especifique se o log de depuração está ativado. O padrão é falso. Substitui o nível de log, se verdadeiro.

      1. Crie um local para o arquivo de configuração:

        sudo mkdir -p /etc/netappdvp

      2. Crie o arquivo de configuração:

        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. Inicie o Trident usando o sistema de plug-in gerenciado. Substitua <version> pela versão do plugin (xxx.xx.x) que você está usando.

    docker plugin install --grant-all-permissions --alias netapp netapp/trident-plugin:<version> config=myConfigFile.json

  3. Comece a usar o Trident para consumir storage do sistema configurado.

    1. Crie um volume chamado "firstvolume":

      docker volume create -d netapp --name firstVolume

    2. Crie um volume padrão quando o contentor for iniciado:

      docker run --rm -it --volume-driver netapp --volume secondVolume:/my_vol alpine ash

    3. Remover o volume "firstvolume":

      docker volume rm firstVolume

Método tradicional (versão 1,12 ou anterior)

Antes de começar

  1. Certifique-se de que você tem o Docker versão 1,10 ou posterior.

    docker --version

    Se a sua versão estiver desatualizada, atualize a instalação.

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

    Ou, "siga as instruções para sua distribuição".

  2. Certifique-se de que NFS e/ou iSCSI estão configurados para o seu sistema.

Passos

  1. Instale e configure o plug-in de volume do Docker do NetApp:

    1. Baixe e descompacte o aplicativo:

      ----trident-installer-26.10.1.tar.gz
wget https://github.com/NetApp/trident/releases/download/10.0/
tar zxf trident-installer-26.10.1.tar.gz
.. Move to a location in the bin path:
+
[source,console]

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

.. Create a location for the configuration file:
+
[source,console]

sudo mkdir -p /etc/netappdvp

.. Create the configuration file:
+
[source,console]

cat << EOF > /etc/netappdvp/ontap-nas.json

+
[source,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

. After placing the binary and creating the configuration file, start the Trident daemon using the desired configuration file.
+
[source,console]

sudo trident --config=/etc/netappdvp/ontap-nas.json

+
NOTE: Unless specified, the default name for the volume driver is "netapp".
+
After the daemon is started, you can create and manage volumes by using the Docker CLI interface.

. Create a volume:
+
[source,console]

docker volume create -d netapp --name trident_1

. Provision a Docker volume when starting a container:
+
[source,console]

docker run --rm -it --volume-driver netapp --volume trident_2:/my_vol alpine ash

. Remove a Docker volume:
+
[source,console]

docker volume rm trident_1

+
[source,console]

docker volume rm trident_2

== Start Trident at system startup

A sample unit file for systemd based systems can be found at `contrib/trident.service.example` in the Git repo. To use the file with RHEL, do the following:

. Copy the file to the correct location.
+
You should use unique names for the unit files if you have more than one instance running.
+
[source,console]

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

. Edit the file, change the description (line 2) to match the driver name and the configuration file path (line 9) to reflect your environment.
. Reload systemd for it to ingest changes:
+
[source,console]

systemctl daemon-reload

. Enable the service.
+
This name varies depending on what you named the file in the `/usr/lib/systemd/system` directory.
+
[source,console]

systemctl enable trident

. Start the service.
+
[source,console]

systemctl start trident

. View the status.
+
[source,console]

systemctl status trident

NOTE: Any time you modify the unit file, run the `systemctl daemon-reload` command for it to be aware of the changes.