Prosedur umum mode ONTAP

Halaman ini menjelaskan prosedur umum yang diperlukan untuk tugas mode ONTAP. Karena banyak tugas pool penyimpanan mode ONTAP terpadu Flex menggunakan prasyarat Google Cloud CLI dan API yang sama, Anda hanya perlu menyelesaikan penyiapan ini satu kali sebelum melanjutkan ke tugas tertentu.

Sebelum memulai

Selesaikan langkah-langkah berikut:

  1. Jalankan contoh perintah di lingkungan yang mirip Unix: Linux, macOS, atau Windows Subsystem for Linux (WSL). Fungsi shell ontap_execute dan contoh bash lainnya memerlukan bash. Jika workstation Anda tidak menyediakan shell seperti Unix, gunakan Google Cloud Shell, yang mencakup bash dan Google Cloud CLI.

  2. Instal Google Cloud CLI versi 559.0.0 atau yang lebih baru dan lakukan autentikasi:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Kumpulkan nilai berikut untuk setiap kumpulan yang Anda kelola:

    • POOL_NAME: nama pool penyimpanan.

    • LOCATION: lokasi pool.

    • PROJECT_ID: ID project, yang bersifat opsional jika Anda telah menyetelnya di konfigurasi Google Cloud CLI.

Menyiapkan ontap_execute

Tetapkan POOL_NAME dan LOCATION, lalu tentukan fungsi shell untuk menjalankan perintah ONTAP melalui proxy CLI ONTAP Google Cloud CLI. Fungsi ini memvalidasi variabel pada setiap panggilan. PROJECT_ID menggunakan default dari konfigurasi Google Cloud CLI Anda.

Untuk menentukan fungsi 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}"
 }

Contoh berikut menggunakan ontap_execute "ONTAP-COMMAND" untuk menjalankan perintah ONTAP yang ditentukan pada kumpulan yang diidentifikasi oleh POOL_NAME dan LOCATION. Ganti nilai placeholder seperti SVM_NAME sebelum Anda menjalankan setiap perintah.

Jika prosedur melibatkan lebih dari satu kumpulan, ubah POOL_NAME dan LOCATION sebelum setiap panggilan ontap_execute.

Menjalankan perintah ONTAP CLI menggunakan proxy

Proxy ONTAP CLI menyediakan akses ke sebagian besar perintah ONTAP untuk pool penyimpanan Anda. Proxy tidak interaktif, sehingga perintah yang meminta frasa sandi, sandi, atau input lainnya akan gagal.

Gunakan ontap_execute untuk perintah non-interaktif rutin, seperti yang ditunjukkan di bagian Prosedur.

Menggunakan proxy REST API untuk langkah-langkah interaktif

Jika perintah ONTAP memerlukan input interaktif, gunakan Google proxy API untuk panggilan ONTAP REST API sebagai gantinya. Dokumen ini menyertakan contoh Python. Permintaan REST melalui proxy menggunakan envelope body di sekitar payload ONTAP API.

Mencari nama cluster dan SVM

Untuk mencari nama cluster dan SVM di pool mode ONTAP:

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

Catat nama cluster dari cluster identity show dan nama SVM data dari vserver show. IC-LIF untuk traffic antar-cluster berada di IPspace Gcnv. Kolom Vserver untuk IC-LIF menampilkan Gcnv. Nama IC-LIF adalah intercluster-1, intercluster-2, dan yang serupa, dengan satu nama per node.

Prosedur

Prosedur berikut mencakup perintah non-interaktif rutin:

Langkah berikutnya