Skip to main content
Uma versão mais recente deste produto está disponível.
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.

Implantar Trident

Trident for Docker oferece integração direta com o ecossistema Docker para plataformas de storage NetApp. Ele suporta o provisionamento e o 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 múltiplos sistemas de storage e tipos de storage, com a possibilidade de personalizar o storage usado para os volumes do Docker.

O que você vai precisar

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

Método de plugin gerenciado pelo Docker (versão 1.13/17.03 e later)

Observação
Antes de começar
Se você utilizou Trident em versões anteriores ao Docker 1.13/17.03 com o método tradicional de daemon, certifique-se de interromper o processo do Trident e reiniciar o daemon do Docker antes de usar o método de plugin gerenciado.
  1. Interrompa todas as instâncias em execução:

    pkill /usr/local/bin/netappdvp
    pkill /usr/local/bin/trident
  2. Reinicie Docker.

    systemctl restart docker
  3. Certifique-se de que você tenha o Docker Engine 17.03 (new 1.13) ou posterior instalado.

    docker --version

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

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

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

    • log-level: Especifique o nível de registro (debug, info, warn, error, fatal). O padrão é info.

    • debug: especifique se o registro de depuração está ativado. O padrão é false. Substitui log-level se true.

      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 Trident usando o sistema de plugins gerenciados. 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 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 contêiner for iniciado:

      docker run --rm -it --volume-driver netapp --volume secondVolume:/my_vol alpine ash
    3. Remova o volume "firstVolume":

      docker volume rm firstVolume

Método tradicional (versão 1.12 ou anterior)

Antes de começar
  1. Certifique-se de ter Docker versão 1.10 ou posterior.

    docker --version

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

    curl -fsSL https://get.docker.com/ | sh
  2. Certifique-se de que NFS e/ou iSCSI estejam configurados para o seu sistema.

Passos
  1. Instale e configure o NetApp Docker Volume Plugin:

    1. Baixe e descompacte o aplicativo:

      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. Mova para um local no caminho do 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. Crie um local para o arquivo de configuração:

      sudo mkdir -p /etc/netappdvp
    4. Crie o arquivo de configuração:

      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. Após colocar o arquivo binário e criar o arquivo de configuração, inicie o daemon Trident usando o arquivo de configuração desejado.

    sudo trident --config=/etc/netappdvp/ontap-nas.json
    Observação A menos que especificado, o nome padrão para o driver de volume é "netapp".

    Após o daemon ser iniciado, você pode criar e gerenciar volumes usando a interface Docker CLI.

  3. Crie um volume:

    docker volume create -d netapp --name trident_1
  4. Provisione um volume Docker ao iniciar um contêiner:

    docker run --rm -it --volume-driver netapp --volume trident_2:/my_vol alpine ash
  5. Remova um volume do Docker:

    docker volume rm trident_1
    docker volume rm trident_2

Iniciar Trident na inicialização do sistema

Um arquivo de unidade de exemplo para sistemas baseados em systemd pode ser encontrado em contrib/trident.service.example no repositório Git. Para usar o arquivo com RHEL, faça o seguinte:

  1. Copie o arquivo para o local correto.

    Você deve usar nomes exclusivos para os arquivos de unidade se tiver mais de uma instância em execução.

    cp contrib/trident.service.example /usr/lib/systemd/system/trident.service
  2. Edite o arquivo, altere a descrição (linha 2) para corresponder ao nome do driver e o caminho do arquivo de configuração (linha 9) para refletir seu ambiente.

  3. Recarregue o systemd para que ele incorpore as alterações:

    systemctl daemon-reload
  4. Ative o serviço.

    Esse nome varia dependendo do nome que você deu ao arquivo no /usr/lib/systemd/system diretório.

    systemctl enable trident
  5. Inicie o serviço.

    systemctl start trident
  6. Veja o status.

    systemctl status trident
Observação Sempre que você modificar o arquivo de unidade, execute o comando systemctl daemon-reload para que ele reconheça as alterações.