Elastic Compute Service:Cloud Assistant の概要

クラウドアシスタントでサポートされている機能

最小エージェントバージョン (Linux インスタンス)

最小エージェントバージョン (Windows インスタンス)

Cloud Assistant のハートビートを報告する

1.0.2.458

1.0.0.149

ファイルの送信

1.0.2.569

1.0.0.149

コマンドを実行するユーザー名を指定する

2.2.0.106

2.1.0.50

インスタンスの次回起動時に実行するコマンドを設定する

2.2.0.46

2.1.0.50

インスタンスの起動ごとに実行するコマンドを設定する

Session Manager のサポート

2.2.3.196

2.1.3.196

スケジュールされたタスクの実行スケジュールで rate 式と at 式を使用する

2.2.3.282

2.1.3.282

スケジュールされたタスクの cron 式で年またはタイムゾーンを指定する

2.2.3.282

2.1.3.282

組み込み環境パラメーターのサポート

2.2.3.309

2.1.3.309

インスタンス名を組み込み環境パラメーターとして使用する

2.2.3.344

2.1.3.344

特別な終了コードを使用してインスタンスを停止または再起動する

2.2.3.317

2.1.3.317

コンテナー名を指定してコンテナー内でコマンドを実行する

2.2.3.344

2.1.3.344

コンテナー ID を指定してコンテナー内でコマンドを実行する

2.2.3.344

2.1.3.344

ホストリソース

Linux オペレーティングシステム

Windows オペレーティングシステム

CPU

平均 CPU 使用率は 1% 未満です。

物理メモリ

約 20 MB

約 30 MB

ディスク I/O

安定した操作中のディスク I/O は最小限です。アップグレード パッケージのダウンロードやコマンド スクリプトの保存などのシナリオでのみ発生します。

ネットワーク I/O

安定した操作中のネットワーク I/O は最小限です。主に、ハートビートのレポートなどのタスクに使用されます。

用語

説明

クラウドアシスタント

ツールの正式名称。ECS インスタンスおよび ECS ベアメタルインスタンスで定期的なメンテナンスタスクを自動的かつリモートで実行するのに役立ちます。Cloud Assistant は、すべての Alibaba Cloud リージョンで利用できます。

Cloud Assistant エージェント

ECS インスタンスにインストールされる軽量プラグイン。すべてのコマンドは、Cloud Assistant エージェントを介してインスタンスで実行されます。

• Windows オペレーティングシステムでは、プロセス名は aliyun_assist_service です。

• Linux オペレーティングシステムでは、プロセス名は aliyun-service です。

クラウドアシスタントデーモンプロセス

Cloud Assistant エージェントのリソース消費を監視し、Cloud Assistant エージェントの実行ステータスを報告し、Cloud Assistant エージェントがクラッシュしたときに Cloud Assistant エージェントを再起動するために使用されます。

• サービス名: AssistDaemon

• パス: /usr/local/share/assist-daemon/assist_daemon

タスク実行パス

コマンド

インスタンスで実行される特定の操作 (Shell スクリプトや PowerShell スクリプトなど)。

カスタムパラメーター

コマンドで {{key}} 形式で定義する変数。コマンドを実行するときに、{{"key":"value"}} 形式でカスタムパラメーターの値を設定できます。クォータは、リージョンに持つことができる Cloud Assistant コマンドの数を制限します。コマンドをより柔軟にし、複数のシナリオに適用できるように、カスタムパラメーターを設定することをお勧めします。組み込み環境パラメーターをカスタムパラメーターとして指定することもできます。コマンドを実行するときに、パラメーターに手動で値を割り当てる必要はありません。Cloud Assistant は、環境からの対応する値に自動的に置き換えます。

1 回限りの実行

1 つ以上のインスタンスでのコマンドの実行。これは呼び出し (Invocation) とも呼ばれます。

スケジュールされた実行

1 つ以上のインスタンスでコマンドを実行する場合、スケジュールまたは間隔を指定してコマンドプロセスを実行できます。

API ステータス

ステータス

説明

Pending

システムがコマンドを検証または送信しています

少なくとも 1 つのインスタンスでコマンド実行ステータスが Pending の場合、全体的な実行ステータスは Pending です。

Scheduled

スケジュールされたコマンドが送信され、実行を待っています

少なくとも 1 つのインスタンスでコマンド実行ステータスが Scheduled の場合、全体的な実行ステータスは Scheduled です。

Running

コマンドはインスタンスで実行中です

少なくとも 1 つのインスタンスでコマンド実行ステータスが Running の場合、全体的な実行ステータスは Running です。

Success

コマンドは正常に実行されました

すべてのインスタンスでのコマンド実行ステータスが Success または Stopped であり、少なくとも 1 つのインスタンスでのステータスが Success の場合、全体的な実行ステータスは Success です。

• 即時タスクの場合: コマンドの実行が完了し、終了コードは 0 です。

• スケジュールされたタスクの場合: 最後の実行が終了コード 0 で成功し、指定された期間が終了しました。

Failed

コマンドの実行に失敗しました

すべてのインスタンスでのコマンド実行ステータスが Failed または Stopped の場合、全体的な実行ステータスは Failed です。1 つ以上のインスタンスでのステータスが次のいずれかである場合、全体的な実行ステータスは Failed です。

• コマンドの検証に失敗しました (Invalid)。

• コマンドの送信に失敗しました (Aborted)。

• コマンドの実行は完了しましたが、終了コードが 0 ではありません (Failed)。

• コマンドの実行がタイムアウトしました (Timeout)。

• コマンドの実行中に例外が発生しました (Error)。

Stopping

タスクは停止中です

少なくとも 1 つのインスタンスでコマンド実行ステータスが Stopping の場合、全体的な実行ステータスは Stopping です。

Stopped

タスクは停止しました

すべてのインスタンスでのコマンド実行ステータスが Stopped の場合、全体的な実行ステータスは Stopped です。インスタンスでのステータスが次のいずれかである場合、全体的な実行ステータスは Stopped です。

• タスクがキャンセルされました (Cancelled)。

• タスクが終了しました (Terminated)。

PartialFailed

タスクは一部のインスタンスで成功し、他のインスタンスで失敗しました

すべてのインスタンスでコマンドの実行ステータスが Success、Failed、または Stopped のいずれかである場合、全体的な実行ステータスは PartialFailed になります。

シナリオ

参照

関連 API

Cloud Assistant エージェントは、2017 年 12 月 1 日以降にパブリックイメージから作成された ECS インスタンスにデフォルトでプリインストールされています。一部の ECS インスタンスでは、引き続き自分でインストールする必要がある場合があります。

詳細については、「クラウドアシスタントクライアントをインストールする」をご参照ください。

• InstallCloudAssistant

• DescribeCloudAssistantStatus

プログラムから API を呼び出します。

SDK を使用してコマンドを実行する

該当なし

クラウドアシスタントコマンドを作成します。

詳細については、「コマンドを作成する」をご参照ください。

• RunCommand

• CreateCommand

作成したコマンドをターゲット ECS インスタンスで実行します。

詳細については、「コマンドを実行する」をご参照ください。

• RunCommand

• InvokeCommand

コマンドの実行ステータスと結果を表示します。実行結果は、指定された ECS インスタンスでの実際の出力です。

実行結果の表示と一般的な問題のトラブルシューティング

• DescribeInvocations

• DescribeInvocationResults

作成したコマンドを変更します。コマンド名と説明を変更できます。

コマンドを変更する

該当なし

Cloud Assistant コマンドに新しいバージョンを追加します。または、名前、説明、タイプ、内容、実行パス、タイムアウト期間など、コマンドのより多くのプロパティを変更します。

詳細については、「コマンドを複製する」をご参照ください。

該当なし

進行中のコマンドプロセスを停止します。

詳細については、「コマンドを停止する」をご参照ください。

StopInvocation

不要になった Cloud Assistant コマンドを削除します。これにより、コマンドクォータに達するのを防ぎ、新しいコマンドの作成に影響を与えなくなります。

詳細については、「コマンドを削除する」をご参照ください。

DeleteCommand