NetApp Trident Operator

Configure o armazenamen NetApp Trident e para os clusters d IBM Cloud Satellite®. É possível usar modelos de armazenamento do Satellite para criar configurações de armazenamento. Quando você designa uma configuração de armazenamento para os seus clusters, os drivers de armazenamento do provedor de armazenamento selecionado sãoinstalados em seu cluster.

Deve-se implementar o modelo NetApp Trident em seus clusters para poder criar configurações com os modelos NetApp ONTAP-NAS ou NetApp ONTAP-SAN.

Antes de implantar modelos de armazenamento em clusters em sua localidade, certifique-se de configurar o “ Satellite Config” selecionando a opção “Habilitar acesso de administrador de cluster para o ‘ Satellite Config’” no console ou incluindo a opção “ --enable-config-admin ” ao criar seu cluster.

Não é possível definir o escopo de um serviço de armazenamen Satellite e para grupos de recursos. No entanto, se você estiver definindo o escopo de outros recursos, como localização e cluster, para grupos de recursos, será necessário adicionar uma função de leitor d Satellite e uma função de administrador de links para todos os recursos da conta.

Pré-requisitos para NetApp Trident

  1. Crie um local do Satellite.

Criando e designando uma configuração no console.

  1. No console “Locais”, selecione o local onde deseja criar uma configuração de armazenamento.
  2. Selecione Armazenamento > Criar configuração de armazenamento
  3. Insira um nome para a sua configuração.
  4. Selecione o tipo de armazenamento.
  5. Selecione a versão e clique em “Avançar”
  6. Se o Tipo de armazenamento selecionado aceitar parâmetros customizados, insira-os na guia Parâmetros.
  7. Se o Tipo de armazenamento que você selecionou requer segredos, insira-os na guia Segredos.
  8. Na guia Classes de armazenamento, revise as classes de armazenamento implementadas pela configuração ou crie uma classe de armazenamento customizada.
  9. Na guia Designar ao serviço, selecione o serviço ao qual você deseja designar a sua configuração.
  10. Clique em Concluído para designar sua configuração de armazenamento.

Criando uma configuração na CLI

  1. Efetue login na CLI do IBM Cloud .

    ibmcloud login

  2. Liste seus locais do Satellite e observe a coluna Managed from.

    ibmcloud sat location ls

  3. Direcione a região Managed from do local do Satellite. Por exemplo, para wdc, direcione us-east. Para obter mais informações, consulte Regiões do Satellite.

    ibmcloud target -r us-east

  4. Se você usar um grupo de recursos diferente do default, direcione-o.

    ibmcloud target -g RESOURCE_GROUP

  5. Copie um dos comandos de exemplo a seguir para a versão do modelo que você deseja utilizar Para obter mais informações sobre o comando, consulte ibmcloud sat storage config create na referência de comando

    Exemplo de comando para criar uma configuração da versão 24.02

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 24.02

    Exemplo de comando para criar uma configuração da versão 25.06.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 25.06

  6. Customize o comando com base nas configurações que você deseja usar

  7. Execute o comando para criar uma configuração.

  8. Verifique se sua configuração foi criada.

    ibmcloud sat storage config get --config CONFIG

Criando uma configuração na API

  1. Gere uma chave API e, em seguida, solicite um token de atualização. Para obter mais informações, consulte Gerando um token do IAM do IBM Cloud usando uma chave de API.

  2. Copie uma das seguintes solicitações de exemplo e substitua as variáveis que deseja usar.

    Solicitação de exemplo para criar uma configuração da versão 24.02

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-trident\", \"storage-template-version\": \"24.02\", \"update-assignments\": true}

    Exemplo de solicitação para criar uma versão da configuração 25.06.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-trident\", \"storage-template-version\": \"25.06\", \"update-assignments\": true}

Criação de uma tarefa na interface de linha de comando (CLI)

  1. Liste suas configurações de armazenamento e anote a configuração de armazenamento que você deseja atribuir aos seus clusters.

    ibmcloud sat storage config ls

  2. Obtenha o ID do cluster, do grupo de clusters ou do serviço ao qual você deseja atribuir armazenamento.

    Para assegurar que seu cluster seja registrado com o Satellite Config ou para criar grupos, consulte Configurando clusters para uso com o Satellite Config.

    Exemplo de comando para listar grupos de clusters.

    ibmcloud sat group ls

    Exemplo de comando para listar clusters.

    ibmcloud oc cluster ls --provider satellite

    Comando exemplo para lista Satellite serviços.

    ibmcloud sat service ls --location LOCATION

  3. Atribua sua configuração de armazenamento para o cluster, grupo ou serviço que você recuperou anteriormente. Para obter mais informações, consulte o comando ibmcloud sat storage assignment create .

    Exemplo comando para atribuir uma configuração a um grupo de clusters.

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME

    Comando exemplo para designar uma configuração a um cluster.

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME

    Exemplo comando para designar uma configuração a um cluster de serviços.

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME

  4. Verifique se a sua designação foi criada.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

Criação de uma atribuição de armazenamento na interface de programação de aplicativos (API)

  1. Copie um dos seguintes pedidos de exemplo.

    Exemplo de solicitação para atribuir uma configuração a um cluster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"

    Exemplo de solicitação para atribuir configuração a um grupo de clusters.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"

  2. Substitua as variáveis por seus detalhes e execute a solicitação.

  3. Verifique a atribuição foi criada listando suas designações.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Atualizando designações de armazenamento no console

É possível usar o console do Satellite console para aplicar as atualizações de correção mais recentes às designações.

  1. Na página Locais no console do Satellite, selecione seu local.

  2. Clique na guia Armazenamento para visualizar suas configurações..

  3. Clique na configuração que você deseja atualizar.

  4. Clique no ícone Informações (i) para aplicar a revisão ou correção mais recente.

  5. Opcional: ative as atualizações de correção automática para sua designação de armazenamento. A ativação de atualizações de correção automáticas assegura que sua designação sempre tenha as correções de segurança mais recentes

Se você ativar atualizações de correção automáticas, ainda deverá aplicar as principais atualizações manualmente.

Fazendo upgrade manualmente de designações na CLI

Faça upgrade de uma designação para usar a revisão do modelo de armazenamento mais recente

  1. Liste as suas designações de armazenamento do Satellite, anote a designação do Satellite da qual você deseja fazer upgrade.

    ibmcloud sat storage assignment ls

  2. Liste os modelos de armazenamento do Satellite para ver as versões mais recentes disponíveis.

    ibmcloud sat storage template ls

  3. Faça upgrade da designação do Satellite.

    Exemplo de comando para atualizar uma designação.

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT

Ativando atualizações de correção automáticas para configurações e designações na CLI

É possível usar a CLI do sat storage assignment autopatch enable para ativar as atualizações de correção automáticas para suas designações A ativação de atualizações de correção automática aplica as revisões mais recentes do modelo de armazenamento (correções) automaticamente. Você ainda deve aplicar atualizações principais manualmente.

  1. Liste suas configurações de armazenamento do Satellite. Anote o ID da configuração.

    ibmcloud sat storage assignment ls

  2. Execute um dos comandos de exemplo a seguir para ativar atualizações de correção automáticas para sua configuração e suas designações associadas. Digite o ID de configuração que você obteve na etapa anterior.

    Comando de exemplo para ativar atualizações de correção automática para uma designação.

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])

    Comando de exemplo para ativar atualizações de correção automática para todas as designações de armazenamento sob uma determinada configuração.

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all

    Exemplo de comando para desativar as atualizações de correção automáticas para todas as designações sob uma configuração específica

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all

    Exemplo de comando para desativar as atualizações de correção automáticas para uma única designação e uma configuração específica

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID

    Exemplo de comando para desativar as atualizações de correção automáticas para uma designação múltipla e uma configuração específica

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID

Atualizando configurações manualmente na CLI

Você pode atualizar suas configurações de armazenamento do Satellite para obter a revisão mais recente do modelo de armazenamento dentro da mesma versão principal.

  1. Liste as suas configurações de armazenamento do Satellite, anote a configuração do Satellite da qual você deseja fazer upgrade.

    ibmcloud sat storage config ls

  2. Faça upgrade da configuração do Satellite. Note que somente a configuração é atualizada. Se você deseja fazer upgrade das designações que usam essa configuração, é possível especificar a opção --include-assignments ou atualizar manualmente cada designação usando o comando assignment update.

    Comando de exemplo para atualizar uma configuração para a revisão mais recente.

    ibmcloud sat storage config upgrade --config CONFIG [--include-assignments]

    Exemplo de comando para atualizar uma configuração e suas atribuições associadas para a revisão mais recente.

    ibmcloud sat storage config upgrade --config CONFIG --include-assignments

Fazendo upgrade de uma configuração e designações na API

É possível usar a API do /v2/storage/satellite/updateAssignment para atualizar suas designações com novos clusters ou grupos de clusters Configure updateConfigVersion como true para aplicar a atualização de revisão

  1. Copie a seguinte solicitação de exemplo e substitua as variáveis para os grupos de clusters e designações que você deseja atualizar.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"

  2. Execute o pedido.

  3. Obtenha os detalhes de você atribuição para verificar a atualização.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Ativando atualizações de correção automáticas para designações na API

É possível usar a API /v2/storage/satellite/setAssignmentAutoupgrade para ativar atualizações de correção automáticas para suas designações. A ativação de atualizações de correção automática aplica as revisões mais recentes do modelo de armazenamento (correções) automaticamente. Você ainda deve aplicar atualizações principais manualmente.

  1. Copie a seguinte solicitação de exemplo e substitua as variáveis para os grupos de clusters e designações que você deseja atualizar.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }

  2. Execute o pedido.

  3. Obtenha os detalhes de sua designação para verificar o upgrade

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Removendo a designação e configuração de armazenamento do NetApp Trident por meio do console

Use o console para remover uma designação de armazenamento e uma configuração de armazenamento.

  1. No painel de armazenamento do Satellite, selecione a configuração de armazenamento que você deseja excluir.
  2. Selecione Ações > Excluir
  3. Insira o nome da sua configuração de armazenamento.
  4. Selecione ** Excluir **.

Removendo a designação e configuração de armazenamento do NetApp Trident da CLI

Use a CLI para remover uma designação de armazenamento e uma configuração de armazenamento.

  1. Liste suas designações de armazenamento e localize aquela que você usou para o seu cluster.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

  2. Remova a designação. Após a remoção da designação, os pods do driver NetApp Trident e a classe de armazenamento são removidos de todos os clusters que faziam parte da designação de armazenamento.

    ibmcloud sat storage assignment rm --assignment ASSIGNMENT_ID

  3. Liste os pods no namespace trident e verifique se os pods do driver de armazenamento do NetApp Trident foram removidos.

    oc get pods -n trident

  4. Verifique se o namespace trident foi removido.

    oc get ns

    Se o namespace trident estiver preso no status Terminating, siga as etapas para remover o namespace. Como alternativa, você pode seguir a documentação do NetApp para desinstalar o operador Trident

  5. Opcional: liste suas configurações de armazenamento e remova a sua configuração do Trident.

    ibmcloud sat storage config ls

    ibmcloud sat storage config rm --config CONFIG_NAME

Como obter ajuda e suporte para o NetApp Trident

Se você tiver algum problema com o NetApp Trident, acesse a página de suporte NetApp.