Häufige Verfahren im ONTAP-Modus

Auf dieser Seite werden die allgemeinen Verfahren beschrieben, die für Aufgaben im ONTAP-Modus erforderlich sind. Da viele Aufgaben für Speicherpools im Flex Unified ONTAP-Modus dieselben Google Cloud CLI- und API-Voraussetzungen verwenden, müssen Sie diese Einrichtung nur einmal ausführen, bevor Sie mit Ihrer spezifischen Aufgabe fortfahren.

Hinweis

Gehen Sie folgendermaßen vor:

  1. Führen Sie Befehlsbeispiele in einer Unix-ähnlichen Umgebung aus: Linux, macOS oder Windows-Subsystem für Linux (WSL). Für die Shell-Funktion ontap_execute und andere Bash-Beispiele ist Bash erforderlich. Wenn Ihre Workstation keine Unix-ähnliche Shell bietet, verwenden Sie Google Cloud Shell, die Bash und die Google Cloud CLI enthält.

  2. Installieren Sie die Google Cloud CLI-Version 559.0.0 oder höher und authentifizieren Sie sich:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Erfassen Sie die folgenden Werte für jeden Pool, den Sie verwalten:

    • POOL_NAME: der Name des Speicherpools.

    • LOCATION: der Standort für den Pool.

    • PROJECT_ID: die Projekt-ID, die optional ist, wenn Sie sie in Ihrer Google Cloud CLI-Konfiguration festgelegt haben.

ontap_execute einrichten

Legen Sie POOL_NAME und LOCATION fest und definieren Sie dann eine Shell-Funktion, um ONTAP-Befehle über den Google Cloud CLI ONTAP CLI-Proxy auszuführen. Die Funktion validiert Variablen bei jedem Aufruf. Für PROJECT_ID wird die Standardeinstellung aus Ihrer Google Cloud CLI-Konfiguration verwendet.

So definieren Sie die Funktion 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}"
 }

In den folgenden Beispielen wird ontap_execute "ONTAP-COMMAND" verwendet, um den angegebenen ONTAP-Befehl für den Pool auszuführen, der durch POOL_NAME und LOCATION identifiziert wird. Ersetzen Sie die Platzhalterwerte wie SVM_NAME, bevor Sie jeden Befehl ausführen.

Wenn ein Verfahren mehr als einen Pool umfasst, ändern Sie POOL_NAME und LOCATION vor jedem ontap_execute-Aufruf.

ONTAP CLI-Befehle mit dem Proxy ausführen

Der ONTAP CLI-Proxy bietet Zugriff auf die meisten ONTAP-Befehle für Ihren Speicherpool. Der Proxy ist nicht interaktiv. Daher schlagen Befehle fehl, die zur Eingabe einer Passphrase, eines Passworts oder anderer Eingaben auffordern.

Verwenden Sie ontap_execute für nicht interaktive Routinebefehle, wie im Abschnitt Prozeduren gezeigt.

REST API-Proxy für interaktive Schritte verwenden

Wenn ein ONTAP-Befehl interaktive Eingaben erfordert, verwenden Sie stattdessen die Google Proxy API für ONTAP REST API-Aufrufe. Dieses Dokument enthält Python-Beispiele. REST-Anfragen über den Proxy verwenden einen body-Umschlag um die ONTAP API-Nutzlast.

Cluster- und SVM-Namen suchen

So suchen Sie die Cluster- und SVM-Namen in einem Pool im ONTAP-Modus:

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

Notieren Sie sich den Clusternamen aus cluster identity show und den Namen der Daten-SVM aus vserver show. IC-LIFs für Intercluster-Traffic befinden sich im IPspace Gcnv. In der Spalte Vserver für IC-LIFs wird Gcnv angezeigt. IC-LIF-Namen sind intercluster-1, intercluster-2 und ähnlich, mit einem Namen pro Knoten.

Prozeduren

Die folgenden Verfahren umfassen nicht interaktive Routinebefehle:

Nächste Schritte