Elastic Compute Service:Cloud Assistant コマンドの実行結果の確認とトラブルシューティング

エラーコード

エラーメッセージ

解決策

InstanceNotRunning

コマンド発行時にインスタンスが実行中ではありませんでした。

インスタンスが実行中状態であることを確認してください。

InstanceRestarted

コマンド実行中にインスタンスが再起動されました。

コマンド実行中にインスタンスを再起動しないでください。

ClientNotRunning

Cloud Assistant エージェントが実行されていません。

Cloud Assistant エージェントが停止しているか、インストールされていません。エージェントを起動またはインストールしてください：

1. Cloud Assistant エージェントのプロセスを確認します：

   • Linux：

     ps -ef |grep aliyun-service

   • Windows：タスクマネージャーで aliyun_assist_service プロセスが存在するかどうかを確認します。

2. プロセスが存在しない場合は、起動します：

   • Linux：

     # systemctl をサポートする Linux システムの場合
     systemctl start aliyun.service
     
     # systemctl をサポートしない Linux システムの場合
     /etc/init.d/aliyun-service start

   • Windows：サービスマネージャーで Aliyun Assist Service を起動します。

ClientNetworkBlocked

インスタンスにネットワーク接続の問題があります。

1. ネットワーク接続を確認します。インスタンス ID が返された場合、ネットワークは接続されています。

   curl https://{region-id}.axt.aliyun.com/luban/api/instance/instance-id

2. インスタンス ID が返されない場合は、セキュリティグループ、ファイアウォール、DNS、およびルートテーブルを確認してください。Cloud Assistant が以下のアドレスに到達できるように、内部ネットワーク経由で TCP ポート 443、TCP ポート 80、および UDP ポート 53 のアウトバウンドトラフィックを許可してください：

   • https://{region-id}.axt.aliyun.com:443/

   • http://100.100.100.200:80/

   • http://aliyun-client-assist-{region-id}.oss-{region-id}-internal.aliyuncs.com

     このドメインの接続をテストすると、「AccessDenied」というレスポンスが返されることがありますが、これは正常です。OSS バケットはプライベートですが、インストールパッケージファイルのみがパブリック読み取り権限を持つためです。このメッセージは接続が成功したことを示します。

SecurityGroupRuleDenied

セキュリティグループのルールが Cloud Assistant サービスへのアクセスを拒否しています。

• ErrorInfo フィールドで拒否されたセキュリティグループ ID と IP を見つけ、アクセスを許可するようにルールを更新してください。

• Cloud Assistant エージェントのネットワーク権限の設定をご参照ください。

ClientNotResponse

Cloud Assistant エージェントが応答しませんでした。

Cloud Assistant エージェントのログを確認します：

1. Cloud Assistant エージェントのログファイルを開きます。デフォルトのパス：

   • Linux： /usr/local/share/aliyun-assist/<Cloud Assistant Agent version>/log/aliyun_assist_main.log

   • Windows： C:\ProgramData\aliyun\assist\<Cloud Assistant Agent version>\log\aliyun_assist_main.log

2. ログでコマンドの InvokeId を検索します：

   • 見つかった場合は、コマンドが終了したか、その結果が報告されたかなど、前後のエントリで例外を確認します。

   • 見つからない場合は、コマンドを再実行します。それでも失敗する場合は、Cloud Assistant エージェントを再起動します：

     • Linux：

       # systemctl をサポートする Linux システムの場合
       systemctl restart aliyun.service
       
       # systemctl をサポートしない Linux システムの場合
       /etc/init.d/aliyun-service restart

     • Windows：サービスマネージャーで Aliyun Assist Service を再起動します。

ClientNeedUpgrade

指定された機能をサポートするには、Cloud Assistant エージェントをアップグレードする必要があります。

• ErrorInfo フィールドで必要な機能と最小バージョンを確認し、Cloud Assistant エージェントをそのバージョン以降にアップグレードしてください。

• 自動更新を有効にするか、手動でアップグレードしてください。詳細については、「Cloud Assistant エージェントの自動更新のアップグレードまたは無効化」をご参照ください。

ClientNotOnline

Cloud Assistant エージェントが Cloud Assistant サーバーに接続されていません。

Cloud Assistant Agent を再起動します。詳細については、「Cloud Assistant Agent の停止とアンインストール」をご参照ください。

DeliveryTimeout

Cloud Assistant サーバーが Cloud Assistant エージェントにコマンドを送信できませんでした。

コマンドを再実行してください。

ExecutionTimeout

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

必要に応じてコマンドのタイムアウトを増やしてください。

• コンソールでは、タイムアウト のデフォルト値は 60 秒です。必要に応じて延長してください。

• RunCommand の呼び出しでは、Timeout のデフォルト値は 60 秒です。必要に応じて、より大きい値を設定してください。

• CreateCommand の後に InvokeCommand を使用する場合、デフォルトの Timeout は 60 秒です。作成時にカスタム値を設定するか、後で ModifyCommand を使用して更新できます。

ExecutionException

コマンド実行中に例外が発生しました。

詳細については、ErrorInfo フィールドを確認してください。

ExitCodeNonzero

コマンドはゼロ以外の終了コードで終了しました。

コマンドスクリプトと出力を確認してください。

ClientRestarted

Cloud Assistant エージェントが再起動されたため、コマンドは中断されました。

エージェントの再起動後にコマンドを再実行してください。エージェントのステータスは、Cloud Assistant コンソールで確認するか、DescribeCloudAssistantStatus API を呼び出すことで確認できます。

InstanceReleased

コマンド実行中にインスタンスがリリースされました。

ターゲットインスタンスがリリースされたため、コマンドは失敗しました。

DirectoryNotExists

指定された作業ディレクトリがインスタンスに存在しません。

インスタンスに作業ディレクトリを作成してから、コマンドを再実行してください。

エラーコード

エラーメッセージ

解決策

ClientIsUpgrading

Cloud Assistant エージェントはアップグレード中です。

アップグレード完了後にコマンドを再実行してください。エージェントのステータスは、Cloud Assistant コンソールで確認するか、DescribeCloudAssistantStatus API を呼び出すことで確認できます。

InstanceDeregistered

マネージドインスタンスの登録が解除されました。

マネージドインスタンスの登録が解除されたため、コマンドは失敗しました。

InvalidSystemBuiltInParameter

組み込み環境パラメーターは無効です。

組み込みの環境変数はサポートされていません。サポートされているパラメーターについては、RunCommand の CommandContent パラメーターをご参照ください。

DefaultWorkingDirectoryNotAvailable

インスタンス上のデフォルトの作業ディレクトリは利用できません。

デフォルトの作業ディレクトリを確認します：

• Linux: root ユーザーのホームディレクトリは、デフォルトで /root です。

• Windows: Cloud Assistant エージェントプロセスが存在するディレクトリ、例: C:\Windows\System32。

また、コンソールで、または RunCommand の WorkingDir パラメーターで作業ディレクトリを指定することもできます。

CommandNotApplicable

コマンドタイプは指定されたインスタンスに適用できません。

各コマンドタイプは、次のオペレーティングシステムをサポートします：

• RunBatScript： Windows インスタンス用のバッチ (BAT) コマンド。

• RunPowerShellScript： Windows インスタンス用の PowerShell コマンド。

• RunShellScript： Linux インスタンス用のシェルコマンド。

InvalidCommandText

コマンドコンテンツは無効です。

コマンドコンテンツを確認してください。プレーンテキストまたは Base64 エンコード形式が使用できます。

CommandContentDecodeError

コマンドコンテンツのデコードに失敗しました。

Base64 エンコードされている場合は、エンコーディングが正しいことを確認してください。

AccountNotExists

指定されたユーザーがインスタンスに存在しません。

コマンドを実行する前に、インスタンスにユーザーを作成してください。

• デフォルトでは、コマンドは Linux ECS インスタンス上で root ユーザーとして実行されます。

• デフォルトでは、コマンドは Windows ECS インスタンス上で System ユーザーとして実行されます。

コンソールまたは RunCommand の Username パラメーターを使用して、別のユーザーとしてコマンドを実行することもできます。

エラーコード

エラーメッセージ

解決策

BadCronExpression

cron 式が無効です。

cron 式を修正してください。詳細については、「時間ベースのスケジューリング」をご参照ください。

CronExpressionExpired

cron 式は期限切れです。スケジュールされたタスクは実行されません。

期限切れでない cron 式を指定してください。

InvalidGMTOffsetForTimezone

cron 式に無効な GMT オフセットタイムゾーン形式が含まれています。

GMT オフセットタイムゾーンのフォーマットを確認してください。

サポートされる範囲：GMT-12:59 から GMT+14:59。分： 0-59。時間の先頭のゼロはサポートされていません。

InvalidGMTOffsetHourForTimezone

cron 式の GMT オフセット時が無効です。

GMT オフセットタイムゾーンの時間値を確認してください。

サポートされる範囲：GMT-12:59 から GMT+14:59。時間の先頭のゼロはサポートされていません。

InvalidGMTOffsetMinuteForTimezone

cron 式の GMT オフセット分が無効です。

GMT オフセットタイムゾーンの分値を確認してください。

有効な値： 0 から 59。

TimezoneInformationCorrupt

タイムゾーンファイルが破損しているため、Cloud Assistant エージェントはタイムゾーン情報を解析できません。

• Linux: /usr/share/zoneinfo にあるタイムゾーンファイルを確認します。例: /usr/share/zoneinfo/Asia/Shanghai。

• Windows: たとえば、レジストリの HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones を確認します。

InvalidRateExpression

レート式が無効です。

レート式を修正してください。詳細については、「固定間隔実行」をご参照ください。

RateFrequencyTooLarge

スケジュールされた実行頻度が高すぎます。

実行頻度は 7 日を超えることはできません。

InvalidAtExpression

タイムスタンプ (at 式) が無効です。

タイムスタンプを修正してください。詳細については、「指定した時間に一度だけコマンドを実行する」をご参照ください。

AtExpressionExpired

タイムスタンプ (at 式) は期限切れです。スケジュールされたタスクは実行されません。

期限切れでないタイムスタンプを指定してください。

エラーコード

エラーメッセージ

解決策

InvalidContainerName

コンテナ名が無効です。

名前は文字または数字で始まり、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) のみを含み、255 文字以下である必要があります。

UnsupportedContainerRuntime

コンテナ ID で指定されたコンテナランタイムはサポートされていません。

Docker、containerd、または CRI-O ランタイム上の CRI 仕様を通じて Kubernetes によって管理されるコンテナのみがサポート対象です。

InvalidContainerId

コンテナ ID が無効です。

コンテナ ID は 64 ビットの 16 進文字列である必要があります。オプションで、プレフィックス (docker://、containerd://、または cri-o://) を追加してランタイムを指定できます。

ContainerConnectFailed

コンテナに接続できません。

コンテナが実行中であるかどうかを確認します。kubectl または Cloud Assistant エージェントを使用して、コンテナのステータスを確認します。コンテナは、State が Running の場合に実行中です。詳細については、「Cloud Assistant を使用してコンテナでコマンドを実行する」をご参照ください。

• 実行中の場合は、ランタイムを確認してください。CRI を介して Kubernetes によって管理される Docker、containerd、および CRI-O ランタイムのみがサポートされています。

• ランタイムが準拠している場合は、コマンドが要件を満たしていることを確認してください。詳細については、「制限」をご参照ください。

ContainerStateAbnormal

コンテナのステータスが異常です。

コンテナが実行中であることを確認してください。Cloud Assistant は実行中のコンテナでのみコマンドを実行します。kubectl または Cloud Assistant Agent を使用して確認してください。State が Running の場合、コンテナは実行中です。詳細については、「Cloud Assistant を使用してコンテナでコマンドを実行する」をご参照ください。

ContainerNotFound

コンテナが存在しません。

名前または ID でコンテナが存在することを確認してください。

方法 1： kubectl を使用する

kubectl --namespace <specified namespace> describe pod <specified pod>

方法 2： Cloud Assistant エージェントを使用する

aliyun-service list-containers --source cri --all

詳細については、「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

ContainerNameDuplicated

ノード上の複数のコンテナが同じ名前を共有しているため、ターゲットコンテナを識別できません。

• コンテナ名を指定する場合は、ノード上の他のコンテナが同じ名前を共有していないことを確認してください。

• 代わりにコンテナ ID を使用してください。kubectl または Cloud Assistant エージェントで検索します。詳細については、「Cloud Assistant を使用してコンテナ内でコマンドを実行する」をご参照ください。

ContainerNameAndIdNotMatch

指定されたコンテナ ID とコンテナ名が一致しません。

コンテナ ID と名前が同じコンテナを参照していることを確認してください。

エラーコード

エラーメッセージ

解決策

UserOrPasswordInvalid

ユーザー名またはパスワードが正しくありません。

ユーザー名またはパスワードが正しいことを確認してください。詳細については、「暗号化されたパラメーター」および「Cloud Assistant コマンドを実行するための通常ユーザーの設定」をご参照ください。

QueryParameterStoreFailed

パラメーターストアからパラメーターを取得できませんでした。

パスワードが CloudOps Orchestration Service のパラメーターストアに存在することを確認してください。詳細については、「暗号化されたパラメーター」をご参照ください。

インスタンス RAM ロールに必要な権限があることを確認してください。詳細については、「Windows インスタンスの RAM ロールの設定」をご参照ください。

InstanceRoleInvalid

RAM ロールがインスタンスにアタッチされていません。

DescribeInstanceRamRole API を呼び出して、RAM ロールがインスタンスにアタッチされているかどうかを確認してください。

エラーコード

エラーメッセージ

解決策

TerminationException

タスクの停止に失敗しました。

ErrorInfo フィールドを確認するか、コマンドを再試行してください。

エラーコード

エラーメッセージ

解決策

FileAlreadyExists

宛先パスに同じ名前のファイルが既に存在します。

次のいずれかの方法でこの問題を解決します：

• 宛先パスから既存のファイルを削除します。

• 既存のファイルを上書きします。

  • 上書き で、ファイルをアップロードする際に上書きを有効にします。

  • SendFile API を呼び出すときに、Overwrite パラメーターを true に設定します。

3. ターゲットインスタンス上の宛先パスまたはファイル名を変更します。

FileNameInvalid

ファイル名が無効です。

ファイル名が Windows または Linux の命名規則に従っていることを確認してください。

• ファイル名が有効な名前であることを確認してください。

• SendFile API を呼び出すときに、Name パラメーターが有効であることを確認してください。

FilePathInvalid

ファイルパスが無効です。

ファイルパスが Windows または Linux のパス規則に従っていることを確認してください。

• ターゲットパス で、パスが有効であることを確認します。

• SendFile API を呼び出すときに、TargetDir パラメーターが有効なパスを指定していることを確認してください。

FileAuthorityInvalid

ファイル権限が無効です。

ファイル権限を調整してください。これは Linux インスタンスにのみ適用され、chmod と同じフォーマットを使用します。

UserGroupNotExists

指定されたユーザーグループがインスタンスに存在しません。

デフォルトグループ：root。Linux インスタンスにユーザーグループを作成してください。

コマンド例: groupadd <groupname>。ここで、<groupname> は新しいユーザーグループの名前です。