Procedimentos comuns no modo ONTAP

Esta página descreve os procedimentos comuns necessários para tarefas no modo ONTAP. Como muitas tarefas de pool de armazenamento no modo ONTAP unificado do Flex usam os mesmos pré-requisitos da API e da Google Cloud CLI, você só precisa concluir essa configuração uma vez antes de prosseguir para sua tarefa específica.

Antes de começar

Siga estas etapas:

  1. Execute exemplos de comandos em um ambiente semelhante ao Unix: Linux, macOS ou Subsistema do Windows para Linux (WSL). A função de shell ontap_execute e outros exemplos de bash exigem o bash. Se a estação de trabalho não fornecer um shell semelhante ao Unix, use o Google Cloud Shell, que inclui bash e a Google Cloud CLI.

  2. Instale a CLI do Google Cloud versão 559.0.0 ou mais recente e faça a autenticação:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Colete os seguintes valores para cada pool que você administra:

    • POOL_NAME: o nome do pool de armazenamento.

    • LOCATION: o local do pool.

    • PROJECT_ID: o ID do projeto, que é opcional se você o tiver definido na configuração da Google Cloud CLI.

Configurar ontap_execute

Defina POOL_NAME e LOCATION e defina uma função de shell para executar comandos do ONTAP pelo proxy da CLI do ONTAP da CLI do Google Cloud. A função valida variáveis em cada chamada. O PROJECT_ID usa o padrão da configuração da Google Cloud CLI.

Para definir a função ontap_execute:

 export POOL_NAME="mypool"
 export LOCATION="us-central1-a"

 ontap_execute() {
   : "${POOL_NAME:?Set POOL_NAME to your ONTAP-mode storage pool name}"
   : "${LOCATION:?Set LOCATION to the pool zone (for example us-central1-a) or region (for example us-central1)}"

   local project="${PROJECT_ID:-$(gcloud config get-value project 2>/dev/null)}"

   if [[ -z "${project}" ]]; then
     echo "Set PROJECT_ID or run: gcloud config set project PROJECT_ID" >&2
     return 1
   fi

   gcloud netapp storage-pools execute "${POOL_NAME}" "$1" \
     --project="${project}" \
     --location="${LOCATION}"
 }

Os exemplos a seguir usam ontap_execute "ONTAP-COMMAND" para executar o comando ONTAP especificado no pool identificado por POOL_NAME e LOCATION. Substitua os valores de marcador, como SVM_NAME, antes de executar cada comando.

Quando um procedimento envolve mais de um pool, mude POOL_NAME e LOCATION antes de cada chamada de ontap_execute.

Executar comandos da CLI do ONTAP usando o proxy

O proxy da CLI do ONTAP oferece acesso à maioria dos comandos do ONTAP para seu pool de armazenamento. O proxy não é interativo. Portanto, comandos que pedem uma senha, senha ou outra entrada vão falhar.

Use ontap_execute para comandos não interativos de rotina, conforme mostrado na seção Procedimentos.

Usar o proxy de API REST para etapas interativas

Quando um comando do ONTAP exigir entrada interativa, use a API de proxy do Google para chamadas da API REST do ONTAP. Este documento inclui exemplos em Python. As solicitações REST feitas pelo proxy usam um envelope body ao redor do payload da API ONTAP.

Pesquisar nomes de cluster e SVM

Para pesquisar os nomes do cluster e da SVM em um pool no modo ONTAP:

 ontap_execute "cluster identity show"
 ontap_execute "vserver show"
 ontap_execute "network interface show -role intercluster"

Anote o nome do cluster em cluster identity show e o nome da SVM de dados em vserver show. As IC-LIFs para tráfego entre clusters estão no IPspace Gcnv. A coluna Vserver para IC-LIFs mostra Gcnv. Os nomes de IC-LIF são intercluster-1, intercluster-2 e semelhantes, com um nome por nó.

Procedimentos

Os procedimentos a seguir incluem comandos não interativos de rotina:

A seguir