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.

Instale o Astra Trident

Colaboradores

O Astra Trident simplifica o gerenciamento de armazenamento do Amazon FSX for NetApp ONTAP no Kubernetes para permitir que seus desenvolvedores e administradores se concentrem na implantação de aplicações.

Você pode instalar o Astra Trident usando um dos seguintes métodos:

  • Leme

  • Complemento EKS

If you want to make use of the snapshot functionality, install the CSI snapshot controller add-on. Refer to https://docs.aws.amazon.com/eks/latest/userguide/csi-snapshot-controller.html.

Instale o Astra Trident através do leme

  1. Faça o download do pacote de instalação do Astra Trident

    O pacote de instalação do Astra Trident contém tudo o que você precisa para implantar o operador Trident e instalar o Astra Trident. Baixe e extraia a versão mais recente do instalador Astra Trident da seção Assets no GitHub.
    wget https://github.com/NetApp/trident/releases/download/v24.06.0/trident-installer-24.06.0.tar.gz
    tar -xf trident-installer-24.06.0.tar.gz
    cd trident-installer

  2. Defina os valores para os sinalizadores provedor de nuvem e identidade de nuvem usando as seguintes variáveis de ambiente:

    export CP="AWS"
    export CI="'eks.amazonaws.com/role-arn: arn:aws:iam::<accountID>:role/<AmazonEKS_FSxN_CSI_DriverRole>'"

    O exemplo a seguir instala o Astra Trident e define o cloud-provider sinalizador como $CP, e cloud-identity como $CI:

    helm install trident trident-operator-100.2406.0.tgz --set cloudProvider=$CP --set cloudIdentity=$CI -–namespace trident

    Você pode usar o helm list comando para revisar detalhes de instalação, como nome, namespace, gráfico, status, versão do aplicativo e número de revisão.

    helm list -n trident
    NAME                NAMESPACE   REVISION    UPDATED                                 STATUS       CHART                          APP VERSION
    
    trident-operator    trident     1           2024-10-14 14:31:22.463122 +0300 IDT    deployed     trident-operator-100.2406.1    24.06.1

Instale o Astra Trident através do complemento EKS

O complemento Astra Trident EKS inclui os patches de segurança mais recentes, correções de bugs e é validado pela AWS para funcionar com o Amazon EKS. O complemento EKS permite que você garanta consistentemente que seus clusters do Amazon EKS estejam seguros e estáveis e reduza a quantidade de trabalho que você precisa fazer para instalar, configurar e atualizar complementos.

Pré-requisitos

Antes de configurar o complemento Astra Trident para AWS EKS, verifique se você tem o seguinte:

  • Uma conta de cluster do Amazon EKS com assinatura complementar

  • Permissões da AWS para o marketplace da AWS:
    "aws-marketplace:ViewSubscriptions",
    "aws-marketplace:Subscribe",
    "aws-marketplace:Unsubscribe

  • Tipo de AMI: Amazon Linux 2 (AL2_x86_64) ou Amazon Linux 2 ARM(AL2_ARM_64)

  • Tipo de nó: AMD ou ARM

  • Um sistema de arquivos existente do Amazon FSX for NetApp ONTAP

Habilite o complemento Astra Trident para AWS

Cluster DE EKS

Os seguintes comandos de exemplo instalam o complemento Astra Trident EKS:

eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.6.1-eksbuild
eksctl create addon --cluster clusterName --name netapp_trident-operator --version v24.6.1-eksbuild.1 (com uma versão dedicada)

Observação Ao configurar o parâmetro opcional cloudIdentity , certifique-se de especificar cloudProvider durante a instalação do Trident usando o complemento EKS.
Console de gerenciamento
  1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home#/clusters.

  2. No painel de navegação esquerdo, clique em clusters.

  3. Clique no nome do cluster para o qual você deseja configurar o complemento NetApp Trident CSI.

  4. Clique em Add-ons e, em seguida, clique em Get more add-ons.

  5. Na página S*elecionar add-ons, faça o seguinte:

    1. Na seção addons do AWS Marketplace, marque a caixa de seleção Astra Trident by NetApp.

    2. Clique em seguinte.

  6. Na página de configurações Configure Selected add-ons, faça o seguinte:

    1. Selecione a versão que você gostaria de usar.

    2. Para Selecione função IAM, deixe em não definido.

    3. Expanda as Configurações opcionais de configuração, siga o esquema de configuração Add-on e defina o parâmetro configurationValues na seção valores de configuração para a função-arn que você criou na etapa anterior (o valor deve estar no seguinte formato: eks.amazonaws.com/role-arn: arn:aws:iam::464262061435:role/AmazonEKS_FSXN_CSI_DriverRole). Se você selecionar Substituir para o método de resolução de conflitos, uma ou mais configurações para o suplemento existente podem ser sobrescritas com as configurações de complemento do Amazon EKS. Se você não ativar essa opção e houver um conflito com suas configurações existentes, a operação falhará. Você pode usar a mensagem de erro resultante para solucionar o conflito. Antes de selecionar essa opção, certifique-se de que o complemento do Amazon EKS não gerencie as configurações que você precisa para gerenciar automaticamente.

      Observação Ao configurar o parâmetro opcional cloudIdentity , certifique-se de especificar cloudProvider durante a instalação do Trident usando o complemento EKS.
  7. Escolha seguinte.

  8. Na página Revisão e adição, escolha criar.

    Depois que a instalação do complemento estiver concluída, você verá o complemento instalado.

CLI DA AWS
  1. Crie o add-on.json arquivo:

    add-on.json
    {
    
       "clusterName": "<eks-cluster>",
       "addonName": "netapp_trident-operator",
       "addonVersion": "v24.6.1-eksbuild.1",
       "serviceAccountRoleArn": "arn:aws:iam::123456:role/astratrident-role",
       "configurationValues": "{"cloudIdentity": "'eks.amazonaws.com/role-arn: arn:aws:iam::123456:role/astratrident-role'",
       "cloudProvider": "AWS"}"
    }
    Observação Ao configurar o parâmetro opcional cloudIdentity , certifique-se de especificar AWS como o cloudProvider durante a instalação do Trident usando o complemento EKS.
  2. Instalar o complemento Astra Trident EKS"

    aws eks create-addon --cli-input-json file://add-on.json

Atualize o complemento Astra Trident EKS

Cluster DE EKS
  • Verifique a versão atual do seu complemento FSxN Trident CSI. Substitua my-cluster pelo nome do cluster.
    eksctl get addon --name netapp_trident-operator --cluster my-cluster

    Exemplo de saída:

NAME                        VERSION             STATUS    ISSUES    IAMROLE    UPDATE AVAILABLE    CONFIGURATION VALUES
netapp_trident-operator    v24.6.1-eksbuild.1    ACTIVE    0       {"cloudIdentity":"'eks.amazonaws.com/role-arn: arn:aws:iam::139763910815:role/AmazonEKS_FSXN_CSI_DriverRole'"}
  • Atualize o complemento para a versão retornada em ATUALIZAÇÃO DISPONÍVEL na saída da etapa anterior.
    eksctl update addon --name netapp_trident-operator --version v24.6.1-eksbuild.1 --cluster my-cluster --force

    Se você remover --force a opção e qualquer uma das configurações de complemento do Amazon EKS entrar em conflito com as configurações existentes, a atualização do complemento do Amazon EKS falhará; você receberá uma mensagem de erro para ajudá-lo a resolver o conflito. Antes de especificar essa opção, verifique se o complemento do Amazon EKS não gerencia as configurações que você precisa gerenciar, pois essas configurações são sobrescritas com essa opção. Para obter mais informações sobre outras opções para essa configuração, "Complementos"consulte . Para obter mais informações sobre o gerenciamento de campo do Amazon EKS Kubernetes, "Gerenciamento de campo do Kubernetes"consulte .

Console de gerenciamento
  1. Abra o console do Amazon EKS https://console.aws.amazon.com/eks/home#/clusters .

  2. No painel de navegação esquerdo, clique em clusters.

  3. Clique no nome do cluster para o qual você deseja atualizar o complemento NetApp Trident CSI.

  4. Clique na guia Complementos.

  5. Clique em Astra Trident by NetApp e, em seguida, clique em Editar.

  6. Na página Configurar o Astra Trident by NetApp, faça o seguinte:

    1. Selecione a versão que você gostaria de usar.

    2. (Opcional) você pode expandir as Configurações opcionais de configuração e modificar conforme necessário.

    3. Clique em Salvar alterações.

CLI DA AWS

O exemplo a seguir atualiza o complemento EKS:

aws eks update-addon --cluster-name my-cluster netapp_trident-operator vpc-cni --addon-version v24.6.1-eksbuild.1 \
--service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts --preserve

Desinstale/remova o complemento Astra Trident EKS

Você tem duas opções para remover um complemento do Amazon EKS:

  • Preserve o software complementar no cluster – essa opção remove o gerenciamento do Amazon EKS de qualquer configuração. Ele também remove a capacidade do Amazon EKS de notificá-lo de atualizações e atualizar automaticamente o complemento do Amazon EKS depois de iniciar uma atualização. No entanto, ele preserva o software complementar no cluster. Essa opção torna o complemento uma instalação autogerenciada, em vez de um complemento do Amazon EKS. Com essa opção, não há tempo de inatividade para o complemento. Guarde a --preserve opção no comando para preservar o complemento.

  • Remover software complementar inteiramente do cluster – recomendamos que você remova o suplemento do Amazon EKS do cluster somente se não houver recursos no cluster que dependam dele. Remova --preserve a opção do delete comando para remover o complemento.

Observação Se o complemento tiver uma conta do IAM associada a ele, a conta do IAM não será removida.
Cluster DE EKS

O comando a seguir desinstala o complemento Astra Trident EKS:
eksctl delete addon --cluster K8s-arm --name netapp_trident-operator

Console de gerenciamento
  1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home#/clusters.

  2. No painel de navegação esquerdo, clique em clusters.

  3. Clique no nome do cluster para o qual você deseja remover o complemento NetApp Trident CSI.

  4. Clique na guia Complementos e, em seguida, clique em Astra Trident by NetApp.*

  5. Clique em Remover.

  6. Na caixa de diálogo Remover NetApp_Trident-operator confirmation, faça o seguinte:

    1. Se você quiser que o Amazon EKS pare de gerenciar as configurações do complemento, selecione Preserve on cluster. Faça isso se quiser manter o software complementar no cluster para que você possa gerenciar todas as configurações do complemento por conta própria.

    2. Digite NetApp_Trident-operator.

    3. Clique em Remover.

CLI DA AWS

Substitua my-cluster pelo nome do cluster e execute o seguinte comando.

aws eks delete-addon --cluster-name my-cluster --addon-name netapp_trident-operator --preserve