Procédures courantes en mode ONTAP

Cette page décrit les procédures courantes requises pour les tâches en mode ONTAP. Étant donné que de nombreuses tâches de pool de stockage en mode ONTAP unifié Flex utilisent les mêmes prérequis Google Cloud CLI et d'API, vous n'avez besoin d'effectuer cette configuration qu'une seule fois avant de passer à votre tâche spécifique.

Avant de commencer

Procédez comme suit :

  1. Exécutez des exemples de commandes dans un environnement de type Unix : Linux, macOS ou sous-système Windows pour Linux (WSL). La fonction shell ontap_execute et les autres exemples Bash nécessitent Bash. Si votre poste de travail ne fournit pas de shell de type Unix, utilisez Google Cloud Shell, qui inclut bash et Google Cloud CLI.

  2. Installez la version 559.0.0 ou ultérieure de Google Cloud CLI et authentifiez-vous :

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Collectez les valeurs suivantes pour chaque pool que vous administrez :

    • POOL_NAME : nom du pool de stockage.

    • LOCATION : emplacement du pool.

    • PROJECT_ID : ID du projet, facultatif si vous l'avez défini dans la configuration de votre Google Cloud CLI.

Configurer ontap_execute

Définissez POOL_NAME et LOCATION, puis définissez une fonction shell pour exécuter les commandes ONTAP via le proxy Google Cloud CLI ONTAP CLI. La fonction valide les variables à chaque appel. PROJECT_ID utilise la valeur par défaut de votre configuration Google Cloud CLI.

Pour définir la fonction 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}"
 }

Les exemples suivants utilisent ontap_execute "ONTAP-COMMAND" pour exécuter la commande ONTAP spécifiée sur le pool identifié par POOL_NAME et LOCATION. Remplacez les valeurs d'espace réservé telles que SVM_NAME avant d'exécuter chaque commande.

Lorsqu'une procédure implique plusieurs pools, modifiez POOL_NAME et LOCATION avant chaque appel ontap_execute.

Exécuter des commandes ONTAP CLI à l'aide du proxy

Le proxy ONTAP CLI permet d'accéder à la plupart des commandes ONTAP pour votre pool de stockage. Le proxy n'est pas interactif. Par conséquent, les commandes qui demandent une phrase secrète, un mot de passe ou une autre entrée échoueront.

Utilisez ontap_execute pour les commandes non interactives de routine, comme indiqué dans la section Procédures.

Utiliser le proxy d'API REST pour les étapes interactives

Lorsqu'une commande ONTAP nécessite une saisie interactive, utilisez plutôt l'API proxy Google pour les appels d'API REST ONTAP. Ce document inclut des exemples Python. Les requêtes REST via le proxy utilisent une enveloppe body autour de la charge utile de l'API ONTAP.

Rechercher les noms de clusters et de SVM

Pour rechercher les noms de cluster et de SVM dans un pool en mode ONTAP :

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

Notez le nom du cluster à partir de cluster identity show et le nom du SVM de données à partir de vserver show. Les IC-LIF pour le trafic intercluster se trouvent dans l'espace IP Gcnv. La colonne Vserver des FVI-CI affiche Gcnv. Les noms IC-LIF sont intercluster-1, intercluster-2, etc., avec un nom par nœud.

Procédures

Les procédures suivantes incluent des commandes de routine non interactives :

Étapes suivantes