このページでは、ONTAP モードのタスクに必要な一般的な手順について説明します。多くの Flex Unified ONTAP モードのストレージ プール タスクでは同じ Google Cloud CLI と API の前提条件が使用されるため、特定のタスクに進む前にこの設定を 1 回だけ完了する必要があります。
始める前に
次の手順を行います。
コマンドの例は、Unix 系の環境(Linux、macOS、Linux 用 Windows サブシステム(WSL))で実行します。
ontap_executeシェル関数と他の bash の例には bash が必要です。ワークステーションに Unix 系のシェルがない場合は、bash と Google Cloud CLI を含む Google Cloud Shell を使用します。Google Cloud CLI バージョン 559.0.0 以降をインストールして認証します。
gcloud auth login gcloud config set project PROJECT_ID
管理する各プールについて、次の値を収集します。
POOL_NAME: ストレージ プールの名前。LOCATION: プールのロケーション。PROJECT_ID: プロジェクト ID。Google Cloud CLI 構成で設定している場合は省略可能です。
ontap_execute を設定する
POOL_NAME と LOCATION を設定し、Google Cloud CLI ONTAP CLI プロキシを介して ONTAP コマンドを実行するシェル関数を定義します。この関数は、呼び出しごとに変数を検証します。PROJECT_ID は、Google Cloud CLI 構成のデフォルトを使用します。
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}"
}
次の例では、ontap_execute "ONTAP-COMMAND" を使用して、POOL_NAME と LOCATION で識別されるプールで指定された ONTAP コマンドを実行します。各コマンドを実行する前に、SVM_NAME などのプレースホルダ値を置き換えます。
プロシージャに複数のプールが含まれる場合は、各 ontap_execute 呼び出しの前に POOL_NAME と LOCATION を変更します。
プロキシを使用して ONTAP CLI コマンドを実行する
ONTAP CLI プロキシを使用すると、ストレージ プールのほとんどの ONTAP コマンドにアクセスできます。プロキシはインタラクティブではないため、パスフレーズ、パスワード、その他の入力を求めるコマンドは失敗します。
手順セクションに示すように、非インタラクティブなルーチン コマンドには ontap_execute を使用します。
インタラクティブなステップに REST API プロキシを使用する
ONTAP コマンドでインタラクティブな入力が必要な場合は、代わりに ONTAP REST API 呼び出し用の Google プロキシ API を使用します。このドキュメントには Python の例が含まれています。プロキシを介した REST リクエストでは、ONTAP API ペイロードの周りに body エンベロープが使用されます。
クラスタ名と SVM 名を検索する
ONTAP モードのプールでクラスタ名と SVM 名を検索するには:
ontap_execute "cluster identity show" ontap_execute "vserver show" ontap_execute "network interface show -role intercluster"
cluster identity show のクラスタ名と vserver show のデータ SVM 名をメモします。クラスタ間トラフィックの IC-LIF は IPspace Gcnv にあります。IC-LIF の Vserver 列には Gcnv が表示されます。IC-LIF の名前は intercluster-1、intercluster-2 などで、ノードごとに 1 つの名前が付けられます。
プロシージャ
次の手順には、ルーティン非インタラクティブ コマンドが含まれています。