Cloud Assistant の共通コマンドの実行 - Elastic Compute Service

Alibaba Cloud が提供する共通コマンドを使用して、スクリプトを作成せずに、ソフトウェアのインストール、インスタンスの診断、キーのローテーションを実行できます。

背景情報

共通コマンドは、Alibaba Cloud が作成および保守する Cloud Assistant のコマンドです。これらは、サーバー設定、ヘルスチェックとセキュリティチェック、アプリケーションのインストール、ファイル管理、パッチのインストール、サービス管理などのタスクを実行するためのスクリプトまたは Cloud Assistant プラグインで構成されています。

カスタムコマンドとは異なり、共通コマンドは Alibaba Cloud が管理します。詳細の表示、Elastic Compute Service (ECS) インスタンスでの実行、進捗と結果の追跡が可能です。たとえば、ワンクリックで Linux インスタンスの Cloud Assistant Agent のアップグレード、Java のインストール、ディスクのサイズ変更が必要か診断できます。

操作手順

次のいずれかの方法で共通コマンドを表示し、実行します。

ECS コンソール

ECS コンソール - ECS クラウドアシスタントに移動します。
上部メニューで、対象リソースのリージョンとリソースグループを選択します。
[ECS クラウドアシスタント] ページで、共通コマンド タブをクリックします。

このタブには、すべての共通コマンドが一覧表示されます。
対象のコマンドを見つけ、実行をクリックします。

説明
各コマンドの最新バージョンのみが表示されます。以前のバージョンを表示または実行するには、コマンド ID をクリックして詳細ページを開きます。

コマンドを実行 パネルで、パラメーターを設定し、実行をクリックします。

主なパラメーター：

セクション	パラメーター	説明
[コマンド情報]	コマンド内容	コマンド内容の表示をクリックしてコマンドを確認してください。
	実行計画	実行計画を選択します。オプション： [即時実行] [システムの次回の起動後] [各システム起動後] [タイミング実行] 詳細については、「実行計画」をご参照ください。
	実行ユーザー	コマンドの実行に使用するユーザーアカウント (例：[root])。デフォルトでは、コマンドは Linux インスタンスでは `root` ユーザーとして、Windows インスタンスでは `System` ユーザーとして実行されます。
	タイムアウト	コマンド実行のタイムアウト時間 (秒) です。有効値は 10～86,400 (24時間) です。実行時間がこのタイムアウトを超えると、Cloud Assistant はプロセスを強制的に終了します。デフォルト値は、コマンドで定義されたタイムアウトです。
	コマンドパラメーター	[コマンドパラメーター] セクションが表示されている場合は、カスタムパラメーター値を入力します。利用可能なパラメーターはコマンドによって異なります。説明コマンドプロバイダーがパラメーターの説明、デフォルト値、または許容値を指定している場合は、指示に従って値を入力します。コマンドを実行するには、必須パラメーターを入力する必要があります。
[インスタンスの選択]	-	コマンドを実行するインスタンスを 1 つ以上選択します。インスタンスは実行中の状態であり、Cloud Assistant Agent がインストールされている必要があります。
[マネージドインスタンスの選択]	-	コマンドを実行するマネージドインスタンスを選択します。マネージドインスタンスは接続済みの状態であり、Cloud Assistant Agent がインストールされている必要があります。説明マネージドインスタンスは、Cloud Assistant が管理する Alibaba Cloud 以外のサーバーです。詳細については、「マネージドインスタンス」をご参照ください。

説明

すべてのパラメーターの詳細については、「コンソールからのコマンドの実行」をご参照ください。

コマンド実行結果 タブで、実行したコマンドを見つけ、操作列の表示をクリックします。

実行ステータスが 実行成功 の場合、コマンド出力を表示できます。

説明
コマンドが失敗した場合は、エラーメッセージを表示してトラブルシューティングを行ってください。詳細については、「一般的なエラーとトラブルシューティング」をご参照ください。

OpenAPI

共通コマンドの表示

DescribeCommands API を呼び出すと、共通コマンドを表示できます。コマンド名で照会することもできます。

主なパラメーター：
- Name：コマンド名。たとえば、これを ACS-ECS-DiskResize-Diagnostic-for-linux.sh に設定すると、特定のリージョンでそのコマンドを照会できます。
- Provider：コマンドプロバイダー。 AlibabaCloud に設定すると、すべての共通コマンドが返されます。
共通コマンドの実行

手順 1 で返された CommandId に基づいて、InvokeCommand API を呼び出してください。名前で共通コマンドを実行することもできます。コマンド名はリージョン間で一貫しています。

主なパラメーター：

CommandId：コマンド ID。共通コマンドの場合、これをコマンド名に設定できます。例：ACS-ECS-DiskResize-Diagnostic-for-linux.sh。

呼び出しが成功すると、実行 ID である InvokeId (例：t-hz02kwqc9pg****) が返されます。DescribeInvocations または DescribeInvocationResults を呼び出して結果を照会してください。

実行詳細ページで出力を表示して、インスタンスでディスクのサイズ変更が必要かどうかを確認することもできます。

Alibaba Cloud CLI

Alibaba Cloud CLI で共通コマンドを表示します。

describe-commands コマンドを実行して共通コマンドを表示します。
- --provider を AlibabaCloud に設定すると、すべての共通コマンドが返されます。
- プロバイダーを特定の値に設定すると、そのプロバイダーのコマンドが返されます。
  
  中国 (杭州) リージョンですべての共通コマンドを照会します。
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--Provider 'AlibabaCloud'
```
  Linux インスタンスでディスクのサイズ変更が必要かどうかを診断する ACS-ECS-DiskResize-Diagnostic-for-linux.sh コマンドを照会します。
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh'
```
Alibaba Cloud CLI で共通コマンドを実行します。

InvokeCommand コマンドを実行して、1 つ以上の ECS インスタンスで共通コマンドを実行します。

Linux インスタンスでディスクのサイズ変更が必要かどうかを診断します。
```
aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \
--InstanceId.1 'i-bp1f4f6o8lv0wqof****' \
--InstanceId.2 'i-bp137qu6142s3mhm****' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh' \
--Timed 'false'
```
呼び出しが成功すると、実行 ID である InvokeId (例：t-hz03rj5u0jx****) が返されます。DescribeInvocations または DescribeInvocationResults を実行して結果を照会してください。例：
```
aliyun ecs DescribeInvocations --RegionId 'cn-hangzhou' \
--InvokeId 't-hz03rj5u0jx****'
```
実行詳細ページで出力を表示して、インスタンスでディスクのサイズ変更が必要かどうかを確認することもできます。