共通コマンドとは、Alibaba Cloud がすべてのユーザーに提供する Cloud Assistant コマンドです。 これらのコマンドは、ソフトウェアのインストールまたはアンインストール、インスタンスステータスの診断、キーのローテーションなど、さまざまなシナリオに適用できます。 このトピックでは、共通の Cloud Assistant コマンドを表示および実行する方法について説明します。
背景情報
共通コマンドとは、Alibaba Cloud がすべての Alibaba Cloud ユーザーに提供する Cloud Assistant コマンドです。 これらのコマンドには、Cloud Assistant プラグインのインストールに使用されるスクリプトまたは実行可能プログラム、あるいはサーバーの構成、ヘルスチェックまたはセキュリティチェックの実施、アプリケーションとシステムパッチのインストール、ファイルの処理、システム構成の変更、サービスまたはアプリケーションの管理に使用される複雑なスクリプトが含まれています。
カスタムコマンドと比較して、共通コマンドは Alibaba Cloud によって提供、公開、および更新されます。 共通コマンドが公開されると、コマンドの内容を表示し、Elastic Compute Service (ECS) インスタンスでコマンドを実行して特定の操作を実行できます。 たとえば、共通コマンドを実行して Linux インスタンスで クラウドアシスタントクライアント をアップグレードしたり、Linux インスタンスでディスクのサイズ変更を行うかどうかを判断したり、インスタンスに Java をインストールしたりできます。 共通コマンドがインスタンスで実行されると、コマンドの実行の進捗状況と結果を表示できます。 共通コマンドを実行して複雑な構成を簡単かつ迅速に完了できるため、O&M の効率が向上します。
手順
ビジネス要件に基づいて、次のツールのいずれかを使用して、共通コマンドを表示および実行できます。
ECS コンソール
ECS コンソール - ECS Cloud Assistant に移動します。
上部のナビゲーションバーで、管理するリソースのリージョンとリソースグループを選択します。
[ECS クラウドアシスタント] ページで、共通コマンド タブをクリックします。
タブで Alibaba Cloud によって提供される共通コマンドを使用できます。
実行する共通コマンドを見つけ、実行 をクリックします。
説明ECS Cloud Assistant ページには、最新バージョンの共通コマンドのみが表示されます。 以前のバージョンの共通コマンドを表示および実行するには、コマンドの ID をクリックして [コマンドの詳細] パネルに移動します。
実行コマンド パネルで、パラメーターを構成し、[実行] をクリックします。
次の表にパラメーターを示します。
セクション
パラメーター
説明
コマンド情報
コマンドコンテンツ
コマンド内容の表示 をクリックしてコマンドを表示します。
実行タイミング
コマンドの実行タイミングを選択します。 有効値:
即時実行
システムの次回の起動後
各システム起動後
スケジュールに従って実行
このパラメーターの構成方法の詳細については、「コマンドの作成と実行」のコマンドを作成して実行するのパラメーターの説明をご参照ください。
ユーザー名
ECS インスタンスでコマンドを実行するために使用するユーザー名を入力します。 例: root。
デフォルトでは、Cloud Assistant コマンドは Linux インスタンスでは root ユーザー、Windows インスタンスでは System ユーザーによって実行されます。
タイムアウト
10 ～ 86,400 の範囲の正の整数を入力します。 単位: 秒。 86,400 秒は 24 時間に相当します。 指定されたタイムアウト期間が経過すると、コマンドプロセスは強制終了されます。 指定された値は、コマンドのタイムアウト期間として使用されます。
コマンドパラメーター
パネルに [コマンドパラメーター] が表示されている場合は、必須パラメーターごとに有効な値を入力します。
説明パラメーターの説明、デフォルト値、または有効値が提供されている場合は、指示に従って値を入力します。 コマンドを実行するには、必須パラメーターを指定する必要があります。
インスタンスの選択
該当なし
コマンドを実行する 1 つ以上のインスタンスを選択します。 選択したインスタンスは、実行中状態であり、クラウドアシスタントクライアントがインストールされている必要があります。
マネージドインスタンスの選択
該当なし
コマンドを実行する 1 つ以上のマネージドインスタンスを選択します。 選択したマネージドインスタンスは、通常状態であり、クラウドアシスタントクライアントがインストールされている必要があります。
説明マネージドインスタンスとは、Alibaba Cloud によって提供されるのではなく、Cloud Assistant によって管理されるインスタンスです。 詳細については、「Alibaba Cloud マネージドインスタンス」をご参照ください。
説明共通コマンドの実行に必要なパラメーターについては、「コマンドを実行する」トピックの「ECS コンソールでコマンドを実行する」セクションをご参照ください。
コマンド実行結果 タブで、実行されている共通コマンドを見つけ、[アクション] 列の [表示] をクリックします。
実行詳細パネルの [実行ステータス] 列に 成功 と表示されている場合は、共通コマンドの実行結果を表示できます。
説明コマンドの実行に失敗した場合は、エラーメッセージを確認し、問題のトラブルシューティングを行ってください。 詳細については、「実行結果の確認と一般的な問題のトラブルシューティング」をご参照ください。
API
API 操作を呼び出して、共通コマンドをクエリします。
DescribeCommands 操作を呼び出して、すべての共通コマンドをクエリするか、名前で特定の共通コマンドをクエリできます。
共通コマンドをクエリする場合は、次のパラメーターに注意してください。
Name: コマンドの名前。 たとえば、中国 (杭州) リージョンで ACS-ECS-DiskResize-Diagnostic-for-linux.sh 共通コマンドをクエリするには、このパラメーターを ACS-ECS-DiskResize-Diagnostic-for-linux.sh に設定します。
Provider: 共通コマンドのプロバイダー。 このパラメーターを AlibabaCloud に設定すると、Alibaba Cloud によって提供されるすべての共通コマンドがクエリされます。
API 操作を呼び出して、共通コマンドを実行します。
InvokeCommand 操作を呼び出して、クエリされた共通コマンドを実行できます。 リクエストで、
CommandIdパラメーターをステップ 1 で返されたコマンド名またはコマンド ID に設定します。 各共通コマンドの名前は、リージョンによって変わりません。共通コマンドを実行する場合は、次のパラメーターに注意してください。
CommandId: コマンドの ID。 共通コマンドの場合、CommandId をコマンド名に設定できます。 例: ACS-ECS-DiskResize-Diagnostic-for-linux.sh。
操作が呼び出されると、レスポンスで InvokeId の値を取得できます。これは、共通コマンドのタスク ID です。 例:
t-hz02kwqc9pg****。 DescribeInvocationsDescribeInvocationResults または 操作を呼び出して、共通コマンドの実行結果をクエリできます。ECS コンソールの実行詳細パネルでコマンドの実行結果を表示することもできます。 この例では、実行詳細パネルでコマンドの実行結果を表示して、Linux インスタンスでディスクのサイズ変更を行うかどうかを判断します。
Alibaba Cloud CLI
Alibaba Cloud CLI を使用して、共通コマンドをクエリします。
DescribeCommands 操作を呼び出して、共通コマンドをクエリできます。
ProviderパラメーターをAlibabaCloudに設定して、Alibaba Cloud が提供するすべての共通コマンドをクエリできます。このパラメーターを特定のプロバイダーに設定すると、そのプロバイダーによって提供されるすべての共通コマンドがクエリされます。
この例では、操作が呼び出されて、中国 (杭州) リージョンで Alibaba Cloud が提供するすべての共通コマンドがクエリされます。 リクエスト例:
aliyun ecs DescribeCommands \ --region 'cn-hangzhou' \ --RegionId 'cn-hangzhou' \ --Provider 'AlibabaCloud'この例では、操作が呼び出されて、中国 (杭州) リージョンで
ACS-ECS-DiskResize-Diagnostic-for-linux.sh共通コマンドがクエリされます。 このコマンドは、Linux インスタンスでディスクのサイズ変更を行うかどうかを確認するために使用されます。 リクエスト例:aliyun ecs DescribeCommands \ --region 'cn-hangzhou' \ --RegionId 'cn-hangzhou' \ --CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh'
Alibaba Cloud CLI を使用して、共通コマンドを実行します。
InvokeCommand 操作を呼び出して、1 つ以上の ECS インスタンスで共通の Cloud Assistant コマンドを実行します。
この例では、操作が呼び出されて
ACS-ECS-DiskResize-Diagnostic-for-linux.sh共通コマンドが実行されます。 このコマンドは、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'操作が呼び出されると、レスポンスで
InvokeIdの値を取得できます。これは、共通コマンドのタスク ID です。 例:t-hz03rj5u0jx****。 DescribeInvocations または DescribeInvocationResults 操作を呼び出して、コマンドの実行結果をクエリできます。 リクエスト例:aliyun ecs DescribeInvocations --RegionId 'cn-hangzhou' \ --InvokeId 't-hz03rj5u0jx****'ECS コンソールの実行詳細パネルでコマンドの実行結果を表示することもできます。 この例では、実行詳細パネルでコマンドの実行結果を表示して、Linux インスタンスでディスクのサイズ変更を行うかどうかを判断します。