Procedimientos comunes en modo ONTAP

En esta página, se describen los procedimientos comunes necesarios para las tareas del modo ONTAP. Debido a que muchas tareas del grupo de almacenamiento del modo ONTAP de Flex Unified usan los mismos requisitos previos de Google Cloud CLI y de la API, solo debes completar esta configuración una vez antes de continuar con tu tarea específica.

Antes de comenzar

Completa los siguientes pasos:

  1. Ejecuta ejemplos de comandos en un entorno similar a Unix: Linux, macOS o el Subsistema de Windows para Linux (WSL). La función de shell ontap_execute y otros ejemplos de bash requieren bash. Si tu estación de trabajo no proporciona un shell similar a Unix, usa Google Cloud Shell, que incluye bash y Google Cloud CLI.

  2. Instala la versión 559.0.0 o posterior de Google Cloud CLI y autentícate:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Recopila los siguientes valores para cada grupo que administres:

    • POOL_NAME: el nombre del grupo de almacenamiento

    • LOCATION: la ubicación del grupo

    • PROJECT_ID: el ID del proyecto, que es opcional si lo configuraste en tu configuración de Google Cloud CLI

Configura ontap_execute

Establece POOL_NAME y LOCATION, y, luego, define una función de shell para ejecutar comandos de ONTAP a través del proxy de la CLI de ONTAP de Google Cloud CLI. La función valida las variables en cada llamada. PROJECT_ID usa el valor predeterminado de tu configuración de Google Cloud CLI.

Para definir la función ontap_execute, haz lo siguiente:

 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}"
 }

En los siguientes ejemplos, se usa ontap_execute "ONTAP-COMMAND" para ejecutar el comando de ONTAP especificado en el grupo identificado por POOL_NAME y LOCATION. Reemplaza los valores de marcador de posición, como SVM_NAME, antes de ejecutar cada comando.

Cuando un procedimiento involucra más de un grupo, cambia POOL_NAME y LOCATION antes de cada llamada a ontap_execute.

Ejecuta comandos de la CLI de ONTAP con el proxy

El proxy de la CLI de ONTAP proporciona acceso a la mayoría de los comandos de ONTAP para tu grupo de almacenamiento. El proxy no es interactivo, por lo que fallarán los comandos que soliciten una frase de contraseña, una contraseña o cualquier otra entrada.

Usa ontap_execute para los comandos no interactivos de rutina, como se muestra en la sección Procedimientos.

Usa el proxy de API de REST para los pasos interactivos

Cuando un comando de ONTAP requiere una entrada interactiva, usa la API de proxy de Google para las llamadas a la API de REST de ONTAP en su lugar. Este documento incluye ejemplos de Python. Las solicitudes de REST a través del proxy usan un sobre body alrededor de la carga útil de la API de ONTAP.

Busca nombres de clústeres y SVM

Para buscar los nombres de clústeres y SVM en un grupo del modo ONTAP, haz lo siguiente:

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

Toma nota del nombre del clúster de cluster identity show y del nombre de la SVM de datos de vserver show. Las IC-LIF para el tráfico entre clústeres están en el espacio IP Gcnv. La columna Vserver para las IC-LIF muestra Gcnv. Los nombres de las IC-LIF son intercluster-1, intercluster-2 y similares, con un nombre por nodo.

Procedimientos

Los siguientes procedimientos incluyen comandos no interactivos de rutina:

¿Qué sigue?