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

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

背景情報

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

カスタムコマンドとは異なり、共通コマンドは Alibaba Cloud によって管理されます。詳細の表示、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 以外のサーバーです。「マネージドインスタンス」をご参照ください。

説明

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

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

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

実行詳細ページには、終了コードが 0 で、コマンド出力に argusagent start success! が含まれていることが表示され、Cloud Monitor エージェントが正常にインストールされたことを示します。

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

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 describe-commands \
--region 'cn-hangzhou' \
--Provider 'AlibabaCloud'
```
  Linux インスタンスがディスクサイズ変更を必要とするかどうかを診断する ACS-ECS-DiskResize-Diagnostic-for-linux.sh コマンドをクエリする例：
```
aliyun ecs describe-commands \
--region 'cn-hangzhou' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh'
```
Alibaba Cloud CLI で共通コマンドを実行します。

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

Linux インスタンスがディスクサイズ変更を必要とするかどうかを診断する例：
```
aliyun ecs invoke-command --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****) が返されます。describe-invocations または describe-invocation-results を実行して、結果をクエリできます。例：
```
aliyun ecs describe-invocations --RegionId 'cn-hangzhou' \
--InvokeId 't-hz03rj5u0jx****'
```
実行詳細ページで出力を表示して、インスタンスのディスクサイズ変更が必要かどうかを確認することもできます。