NetApp Workload Factory で CloudShell を使用する
CloudShell を開いて、 NetApp Workload Factory コンソールのどこからでも AWS またはONTAP CLI コマンドを実行します。
タスクの内容
CloudShell を使用すると、Workload Factory コンソール内からシェルのような環境で AWS CLI コマンドまたはONTAP CLI コマンドを実行できます。ブラウザでターミナル セッションをシミュレートし、ターミナル機能を提供し、Workload Factory のバックエンドを通じてメッセージをプロキシします。これにより、 NetAppアカウントで提供した AWS 認証情報とONTAP認証情報を使用できるようになります。
CloudShellには次の機能があります。
-
複数のCloudShellセッション:複数のCloudShellセッションを一度に展開して、複数のコマンドシーケンスを並行して発行します。
-
複数のビュー:CloudShellタブセッションを分割して、2つ以上のタブを水平または垂直に同時に表示できるようにします。
-
セッション名の変更:必要に応じてセッション名を変更
-
Last session content persistence(前回のセッションのコンテンツの永続性):誤って閉じた場合は、最後のセッションを再度開きます。
-
設定の環境設定:フォントサイズと出力タイプの変更
-
ONTAP CLIコマンドに対するAIが生成するエラー応答
-
オートコンプリートのサポート:コマンドの入力を開始し、* Tab *キーを使用して使用可能なオプションを表示します。
CloudShellコマンド
CloudShell GUIインターフェイス内で、と入力して使用可能なCloudShellコマンドを表示できます help
。コマンドを実行すると help
、次のリファレンスが表示されます。
NetApp CloudShell は、 NetApp Workload Factory に組み込まれた GUI インターフェイスであり、シェルのような環境で AWS CLI コマンドまたはONTAP CLI コマンドを実行できます。ブラウザでターミナル セッションをシミュレートし、ターミナル機能を提供し、Workload Factory のバックエンドを通じてメッセージをプロキシします。これにより、 NetAppアカウントで提供した AWS 認証情報とONTAP認証情報を使用できるようになります。
-
clear
-
help
-
[--fsx <fsxId>] <ontap-command> [parameters]
-
aws <aws-command> <aws-sub-command> [parameters]
各ターミナルセッションは、クレデンシャル、リージョン、およびオプションでFSx for ONTAPファイルシステムという特定のコンテキストで実行されます。
+ すべての AWS コマンドは、提供されたコンテキストで実行されます。 AWS コマンドは、提供された認証情報に指定されたリージョンでの権限がある場合にのみ成功します。
+ ONTAPコマンドをオプションで指定できます fsxId
。あなたが `fsxId`個別のONTAPコマンドを使用する場合、この ID はコンテキスト内の ID をオーバーライドします。ターミナルセッションにFSx for ONTAPファイルシステムIDコンテキストがない場合は、以下を提供する必要があります。 `fsxId`各ONTAPコマンドとともに。
+ 異なるコンテキストの詳細を更新するには、次の操作を行います。 * 資格情報を変更するには:「using credentials <credentialId>」 * リージョンを変更するには:「using region <regionCode>」 * ONTAPファイルシステムの FSx を変更するには:「using fsx <fileSystemId>」
-
使用可能な認証情報を表示するには:"show credentials"
-
利用可能な地域を表示するには:"show regions"
-
コマンド履歴を表示するには:"show history"
変数の設定と使用例を次に示します。変数の値にスペースが含まれている場合は、引用符で囲んで設定してください。
+ * 変数を設定するには: $<variable> = <value> * 変数を使用するには: $<variable> * 変数を設定する例: $svm1 = svm123 * 変数を使用する例: --fsx FileSystem-1 volumes show --vserver $svm1 * 文字列値で変数を設定する例 $comment1 = "スペースを含むコメント"
パイプ、バックグラウンド実行 &
、リダイレクト `>`などのシェル演算子は `|`サポートされていません。これらの演算子を含めると、コマンドの実行は失敗します。
開始する前に
CloudShellは、AWSクレデンシャルのコンテキストで機能します。CloudShellを使用するには、AWSクレデンシャルを少なくとも1つ指定する必要があります。
|
CloudShellを使用すると、AWSまたはONTAPの任意のCLIコマンドを実行できます。ただし、FSx for ONTAPファイルシステムのコンテキスト内で作業する場合は、必ず次のコマンドを実行してください。 using fsx <file-system-name>
|
CloudShellを導入する
CloudShell は、 NetApp Workload Factory コンソールのどこからでもデプロイできます。 NetAppコンソールから CloudShell をデプロイすることもできます。
-
ログイン "ワークロードファクトリーコンソール"。
-
メニューから、[管理]、[CloudShell] の順に選択します。
-
[CloudShell]ウィンドウで、CloudShellセッションのクレデンシャルとリージョンを選択し、矢印を選択して続行します。
-
と入力し `help`て使用可能なコマンドと手順を表示するか、次のCLIリファレンスマニュアルを参照してCloudShellコマンドください。
-
"AWS CLIリファレンス":FSx for ONTAPに関連するコマンドについては、* FSx *を選択します。
-
-
CloudShellセッション内でコマンドを発行します。
ONTAP CLIコマンドの実行後にエラーが発生した場合は、電球のアイコンを選択すると、AIによって生成された簡単なエラー応答と、障害の説明、障害の原因、および詳細な解決策が表示されます。詳細については、*[続きを読む]*を選択してください。
-
ログイン"NetAppコンソール"。
-
メニューから、*ワークロード*を選択し、次に*管理*を選択します。
-
管理メニューから*CloudShell*を選択します。
-
[CloudShell]ウィンドウで、CloudShellセッションのクレデンシャルとリージョンを選択し、矢印を選択して続行します。
-
と入力し `help`て使用可能なCloudShellコマンドとその手順を表示するか、使用可能なコマンドについては次のCLIリファレンスドキュメントを参照してください。
-
"AWS CLIリファレンス":FSx for ONTAPに関連するコマンドについては、* FSx *を選択します。
-
-
CloudShellセッション内でコマンドを発行します。
ONTAP CLIコマンドの実行後にエラーが発生した場合は、電球のアイコンを選択すると、AIによって生成された簡単なエラー応答と、障害の説明、障害の原因、および詳細な解決策が表示されます。詳細については、*[続きを読む]*を選択してください。
このスクリーンショットに表示されている CloudShell タスクは、開いている CloudShell セッション タブのアクション メニューを選択することで完了できます。各タスクの手順は次のとおりです。
CloudShellセッションタブの名前変更
CloudShellセッションタブの名前を変更して、セッションを識別しやすくすることができます。
-
CloudShell セッション タブのアクション メニューを選択します。
-
[ 名前の変更 *] を選択します。
-
セッションタブの新しい名前を入力し、タブ名の外側をクリックして新しい名前を設定します。
CloudShellセッションタブに新しい名前が表示されます。
CloudShellセッションタブの複製
CloudShellセッションタブを複製して、同じ名前、クレデンシャル、およびリージョンを持つ新しいセッションを作成できます。元のタブのコードは、複製されたタブでは複製されません。
-
CloudShell セッション タブのアクション メニューを選択します。
-
[複製]*を選択します。
新しいタブが元のタブと同じ名前で表示されます。
CloudShellセッションのタブを閉じる
CloudShellタブを一度に1つずつ閉じたり、作業していない他のタブを閉じたり、すべてのタブを一度に閉じることができます。
-
CloudShell セッション タブのアクション メニューを選択します。
-
次のいずれかを選択します。
-
[CloudShell]タブウィンドウで[X]を選択して、一度に1つのタブを閉じます。
-
作業中のタブを除く、開いている他のすべてのタブを閉じるには、*[他のタブを閉じる]*を選択します。
-
すべてのタブを閉じるには、*すべてのタブを閉じる*を選択します。
-
選択したCloudShellセッションタブが閉じます。
CloudShellセッションタブの分割
CloudShellセッションのタブを分割して、複数のタブを同時に表示できます。
CloudShellウィンドウの上部、下部、左、または右にCloudShellセッションタブをドラッグアンドドロップして、ビューを分割します。
CloudShellセッションの設定の更新
CloudShellセッションのフォントおよび出力タイプの設定を更新できます。
-
CloudShellセッションをデプロイします。
-
[CloudShell]タブで、設定アイコンを選択します。
設定ダイアログが表示されます。
-
必要に応じてフォントサイズと出力タイプを更新します。
エンリッチ化された出力は、JSONオブジェクトとテーブルの書式設定に適用されます。その他の出力はすべてプレーンテキストで表示されます。 -
* 適用 * を選択します。
CloudShell設定が更新されます。