alibabacloud-ecs-install-extension について
Alibaba Cloud の Agent スキルで、OOS を通じて ECS 拡張パッケージを検索・インストールします。クラウド運用担当者向けに、利用可能なパッケージや対応状況を確認し、設定を確認したうえで ECS インスタンスへ導入します。
主な機能
- 01利用可能な拡張パッケージの一覧
- 02指定拡張の対応状況確認
- 03ECS インスタンスへの拡張導入
- 04単一または複数インスタンスへの導入
- 05入力値と導入パラメーターの検証
活用シーン
- 01利用可能な ECS 拡張の確認
- 02指定した拡張の対応状況の確認
- 03ECS への開発環境の導入
- 04ECS インスタンスへの管理パネルの展開
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aliyun/ alibabacloud-aiops-skills --skill alibabacloud-ecs-install-extensionインストール後、Claude Code で/alibabacloud-ecs-install-extensionを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/cli-installation-guide.mdram-policies.mdrelated-commands.md詳細
ECS 拡張機能インストールスキル
Alibaba Cloud ECS 拡張機能(OOS パッケージ)の照会、確認、インストールを支援するクラウド運用アシスタントです。シナリオベースのワークフローに厳密に従ってください。
シナリオの説明
このスキルでは、Alibaba Cloud OOS(Operation Orchestration Service)を通じて、ECS 拡張プログラムの照会およびインストール機能を提供します。ユーザーは、利用可能な拡張機能の閲覧、特定の拡張機能がサポートされているかの確認、1 台または複数台の ECS インスタンスへの拡張機能のワンクリックインストールを行えます。
アーキテクチャ:ECS + OOS(Operation Orchestration Service)+ Cloud Assistant
ユースケース:
- 利用可能な拡張機能の照会(BT Panel、OpenClaw、Node.js、Python など)
- 特定の拡張機能がサポートされているかの確認
- 1 台または複数台の ECS インスタンスへの拡張機能のインストール
- 開発環境のデプロイ(Python、Node.js、Java など)
- サーバー管理パネルのインストール(BT Panel など)
前提条件
事前確認:Aliyun CLI >= 3.3.1 が必要です
aliyun versionを実行して、バージョンが 3.3.1 以上であることを確認してください。インストールされていない場合、またはバージョンが古い場合は、references/cli-installation-guide.mdを参照してインストールしてください。 次に、aliyun configure set --auto-plugin-install trueを実行して自動プラグインインストールを有効にする必要があります。プラグインのインストールに失敗した場合の対応: 自動プラグインインストールに失敗した場合(
connect: bad file descriptorのようなネットワークエラーなど)は、OOS プラグインを手動でインストールしてください。# oos プラグインがインストールされているか確認 aliyun plugin list # 一覧にない場合は、ダウンロードして手動でインストール: # 1. https://github.com/aliyun/alibaba-cloud-cli/releases にアクセスし、oos プラグインパッケージを探す # 2. お使いのプラットフォーム用の .tar.gz をダウンロード # 3. インストール:aliyun plugin install --file <path-to-downloaded-plugin.tar.gz> # 4. 確認:aliyun plugin list(oos プラグインが表示されること)
事前確認:Alibaba Cloud の認証情報が必要です
セキュリティルール:
- AK/SK の値を読み取ったり、エコーしたり、出力したりしないでください(例:
echo $ALIBABA_CLOUD_ACCESS_KEY_IDは禁止です)- 会話やコマンドラインで AK/SK を直接入力するようユーザーに求めないでください
- リテラルの認証情報を指定して
aliyun configure setを使用しないでください- 認証情報の状態確認には
aliyun configure listのみを使用してくださいaliyun configure list出力を確認し、有効なプロファイル(AK、STS、または OAuth ID)があることを確認してください。
有効なプロファイルがない場合は、ここで停止してください。
- Alibaba Cloud Console から認証情報を取得します
- このセッション外で認証情報を設定します(ターミナルで
aliyun configureを実行するか、シェルのプロファイルで環境変数を設定)aliyun configure listに有効なプロファイルが表示されたら、戻って再実行します
エンドポイントに関する注意(プラグインモード):プラグインモードでは、通常
--endpointフラグは不要です。OOS プラグインは--biz-region-idに基づいてエンドポイントを自動的に解決します。エンドポイントの解決に失敗する場合は、--biz-region-idの値が有効な Alibaba Cloud リージョン ID(例:cn-hangzhou)であることを確認してください。
AI モードとプラグインの更新
[MUST] このワークフローで
aliyunCLI コマンドを実行する前に、次の初期化コマンドを実行してください。aliyun configure ai-mode enable aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension" aliyun plugin updateワークフロー全体が完了した後(すべてのシナリオが終了した後)、AI モードを無効にしてください。
aliyun configure ai-mode disable
CLI コマンドの標準
[MUST] CLI コマンドを実行する前に、コマンド形式の標準を確認するため、
references/related-commands.mdを読んでください。主なルール:
- すべての
aliyunCLI コマンドでは、操作名とフラグの両方にプラグインモード(小文字とハイフンを使用)を指定する必要があります。これは OOS だけでなく、すべてのクラウドサービスに適用されます。小文字とハイフンを使用した形式のみ使用できます。それ以外の形式では、unknown flagまたはunknown commandエラーが発生します。- OOS コマンド:
list-templates、get-template、start-execution、list-executions。フラグは--biz-region-id、--template-type、--template-nameなどです。- ECS コマンド:
describe-instances、describe-regions、run-command、describe-invocations、describe-invocation-results、describe-cloud-assistant-status。フラグは--region-id、--instance-id、--command-contentなどです。[RECOMMENDED] フラグの確認:
aliyun <service> <action> --help(例:aliyun ecs run-command --help)を実行し、インストール済みのプラグインバージョンでサポートされている正確なフラグを確認してください。
必要な権限
このスキルには、以下の RAM 権限が必要です。
bss:DescribeOrderDetail(課金確認のための注文詳細の照会)ecs:DescribeCloudAssistantStatus(Cloud Assistant のステータス確認)ecs:DescribeInstances(インスタンス情報の確認)ecs:DescribeInvocations(Cloud Assistant コマンドの呼び出し一覧)ecs:DescribeInvocationResults(コマンド実行結果の表示)ecs:RunCommand(インストール時の Cloud Assistant コマンド実行)oos:GetApplicationGroup(OOS アプリケーショングループ情報の取得)oos:GetTemplate(OOS テンプレート詳細の取得)oos:ListInstancePackageStates(インスタンス拡張パッケージのステータス照会)oos:ListTemplates(利用可能な拡張パッケージの一覧表示)oos:StartExecution(インストールのための OOS 実行開始)oos:UpdateInstancePackageState(インスタンスのパッケージステータスの更新)oss:GetObject(OSS からの拡張パッケージファイルのダウンロード)
詳細なポリシー設定については、references/ram-policies.md を参照してください。
[MUST] 権限エラーへの対応: 実行中のいずれかの時点で、コマンドまたは API 呼び出しが権限エラーで失敗した場合は、次の手順に従ってください。
- この SKILL に必要な権限の一覧を確認するため、
references/ram-policies.mdを読んでくださいram-permission-diagnoseスキルを使って、必要な権限を申請できるようユーザーを案内してください- 必要な権限が付与されたことをユーザーが確認するまで、一時停止して待ってください
パラメーターの確認
重要:パラメーターの確認 — インストールコマンドを実行する前に、 ユーザーが変更できるすべてのパラメーターをユーザーに確認する必要があります。明示的な承認なしに、値を推測したり既定値を使用したりしないでください。
| パラメーター名 | 必須/任意 | 説明 | 既定値 |
|---|---|---|---|
RegionId | 必須 | 対象インスタンスが配置されているリージョン | N/A |
InstanceId | 必須 | 拡張機能をインストールする 1 つ以上の ECS インスタンス ID | N/A |
PackageName | 必須 | 拡張パッケージ名(例:ACS-Extension-BaoTaPanelFree-One-Click-1853370294850618) | N/A |
Parameters | 任意 | 拡張機能固有のインストールパラメーター(バージョンなど) | テンプレートにより決定 |
入力検証ルール
[MUST] CLI コマンドを組み立てる前に、ユーザーが指定したすべての入力値を検証してください。無効な入力は直ちに拒否し、修正するようユーザーに求めてください。検証されていないユーザー入力をシェルコマンド文字列に渡してはいけません。
| パラメーター | 検証ルール | 例 |
|---|---|---|
InstanceId | 正規表現 ^i-[a-zA-Z0-9]{10,30}$ に一致する必要があります。配列内の各 ID が検証に合格する必要があります。 | i-bp12z30vh0xxxxxxxxxx |
RegionId | 有効な Alibaba Cloud リージョン ID である必要があります。aliyun ecs describe-regions を呼び出し、返されたリージョン一覧と照合して検証してください。 | cn-hangzhou、us-east-1 |
PackageName | 正規表現 ^[a-zA-Z0-9][a-zA-Z0-9\-]*$ に一致する必要があります(英数字とハイフンのみ使用でき、英数字で始まる必要があります)。 | ACS-Extension-node-1853370294850618 |
ResourceIds 配列 | 最大長:1 回の実行につきインスタンス 50 件。 | — |
特殊文字のエスケープ: 検証後、すべてのユーザー指定文字列値を
--ParametersJSON 文字列に埋め込む前に、適切に JSON エスケープしてください(引用符やバックスラッシュなど)。可能な場合は、文字列を手動で連結するのではなく、jqなどのツールを使って JSON ペイロードをプログラムで構築してください。
シナリオ別の振り分け
IMPORTANT: インストールを開始する前に、ユーザーの意図を特定し、適切なワークフローに従ってください。
ユーザーのリクエストに基づいて、適切なシナリオに振り分けてください。
| ユーザーの意図 | トリガーキーワード | 対応方法 |
|---|---|---|
| 利用可能な拡張機能を照会する | 「どんな拡張機能」「一覧」「利用可能な拡張機能」「表示して」 | シナリオ 1 を実行 |
| 拡張機能のサポート状況を照会する | 「インストールできますか」「サポートされていますか」「ありますか」「サポート」 | シナリオ 2 を実行 |
| 拡張機能をインストールする | 「インストール」「デプロイ」「ワンクリックインストール」「セットアップ」 | シナリオ 3 を実行 |
シナリオ 1:利用可能な拡張機能の一覧を照会する
ユーザーから「利用可能な拡張機能は何ですか?」などと尋ねられた場合は、以下の手順に従ってください。
手順 1:テンプレートを一覧表示する
list-templates を呼び出して、利用可能なすべてのパブリック拡張機能パッケージを取得します。
aliyun oos list-templates \
--biz-region-id cn-hangzhou \
--template-type Package \
--share-type Public \
--max-results 100 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension
手順 2:結果を解析して表示する
レスポンスを解析し、ユーザーに表形式で結果を提示します。
| 拡張機能名 | 説明 | カテゴリー |
|---|---|---|
(TemplateName から取得し、解析した Description JSON の name-zh-cn を優先) | (解析した Description JSON の zh-cn または en から取得) | (解析した Description JSON の categories から取得) |
注:
Descriptionフィールドは、メタデータを含む JSON 文字列です。解析して、以下の項目を抽出してください。
name-zh-cn:中国語の表示名(表示に優先して使用)name-en:英語の表示名zh-cn:中国語の説明en:英語の説明categories:カテゴリータグの配列doc-zh-cn:中国語のドキュメントリンクdoc-en:英語のドキュメントリンクimage:アイコン URL
Descriptionの値の例:"Description": "{\"categories\":[\"application\"],\"en\":\"BaoTa Panel free edition one-click installation\",\"zh-cn\":\"BaoTa Panel free edition one-click installation\",\"name-en\":\"BaoTaPanelFree-One-Click\",\"name-zh-cn\":\"BaoTaPanelFree-One-Click\",\"image\":\"https://oos-public-template.oss-cn-beijing.aliyuncs.com/BaoTaPanelFree/icon.png\"}"
注: コマンド内の
--biz-region-idは、API エンドポイントのルーティングに使用されます。返されるパブリックテンプレートは、すべてのリージョンで利用できます。
シナリオ 2:特定の拡張機能がサポートされているか照会する
ユーザーから「XXX をインストールできますか?」などと尋ねられた場合は、以下の手順に従ってください。
手順 1:一覧表示して検索する
list-templates を呼び出し(シナリオ 1 と同じ)、キーワードで拡張機能を検索します。
aliyun oos list-templates \
--biz-region-id cn-hangzhou \
--template-type Package \
--share-type Public \
--max-results 100 \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension
ステップ 2:検索結果
- 該当する場合:拡張機能の詳細(名前、説明、対応 OS など)を返します
- 該当しない場合:その拡張機能は現在サポートされていないことをユーザーに伝え、類似の代替案または全リストを確認するためのシナリオ 1 を提案します
シナリオ 3:拡張機能のインストール
これは主要なワークフローです。以下の手順を厳密な順序で実行してください。
ステップ 1:拡張機能名の確認
インストールする拡張機能の正確な名前を確認します。
- ユーザーがはっきりしない場合は、まず シナリオ 1 または シナリオ 2 を実行し、適切な拡張機能を見つけられるようにします。
- ユーザーが曖昧な名前(例:「BT Panel」)を提示した場合は、検索して正確な
TemplateName(例:ACS-Extension-BaoTaPanelFree-One-Click-1853370294850618)を確認します。
ステップ 2:テンプレートの詳細を取得
get-template を呼び出して、拡張機能テンプレートの詳細を取得します。ターミナルでの出力の切り詰めを防ぐため、出力を一時ファイルにリダイレクトしてください(Content フィールドは通常非常に大きくなります)。
aliyun oos get-template \
--biz-region-id cn-hangzhou \
--template-name "【Extension-Name】" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension > /tmp/oos-template.json
次に、テンプレートの内容から Parameters を抽出します。
jq -r '(.Content | fromjson | .Parameters)' /tmp/oos-template.json
[IMPORTANT] 出力の切り詰めに関する警告:
get-templateは通常非常に大きなContentフィールド(インストールスクリプト全体を含む)を返します。必ず最初にコマンドの出力を一時ファイル(> /tmp/oos-template.json)にリダイレクトし、その後jqまたはファイル読み取りツールを使って解析してください。ターミナルに直接出力された内容に頼らないでください。JSON が切り詰められると、解析エラーが発生します。
Content フィールド(JSON 文字列)には、以下が含まれます。
Parameters:必要なインストールパラメーターを定義します(例:バージョン番号、インストールパスなど)Description:拡張機能の説明TemplateVersion:テンプレートのバージョン
Content.Parameters を解析し、必須パラメーターと任意パラメーターをすべて抽出します。
ステップ 3:パラメーターの入力をユーザーに案内
ステップ 2 で解析した Parameters に基づき、必要な値を入力するようユーザーに案内します。
- 必須パラメーター:ユーザーからの入力を取得する必要があります
- 任意パラメーター:デフォルト値をユーザーに伝えます。ユーザーから指定がない場合は、デフォルト値を使用します
[IMPORTANT]
Content.Parametersからのみパラメーターを抽出してください。InstallScriptやその他のテンプレート内容からパラメーターを推測してはいけません。スクリプト内のシェル変数は内部実装の詳細であり、ユーザーが設定できるパラメーターではありません。
一般的なパラメーターの例:
| Parameter | Type | Description |
|---|---|---|
version | String | ソフトウェアのバージョン番号(例:Node.js の場合は v22.13.1) |
packageVersion | String | 拡張機能パッケージのバージョン(例:v27) |
注: パラメーター値を捏造してはいけません。ユーザーから取得するか、テンプレートのデフォルト値を使用する必要があります。
ステップ 4:すべてのパラメーターを確認
[MUST] インストールを実行する前に、以下のすべての項目を含むパラメーター確認表を必ずユーザーに提示し、**「インストールを進める前に、上記のパラメーターが正しいことをご確認ください。」**と明確に尋ねてください。ユーザーが肯定的な返答をするまで、ステップ 5 に進んではいけません。ユーザーが最初のリクエストですでにすべてのパラメーターを提示している場合でも、確認手順は必須です。
| Item | Value |
|---|---|
| RegionId | (ユーザーから提示) |
| InstanceId(s) | (ユーザーから提示。複数指定可) |
| Extension Name (PackageName) | (ステップ 1 で確認) |
| Installation Parameters | (ステップ 2/3 の内容。バージョンと使用するデフォルト値を含む) |
[MUST] インスタンス数の確認: InstanceId の数がユーザーのリクエストと一致することを確認してください。ユーザーが N 個のインスタンスに言及しているのに、提示された ID が不足している場合は、先に不足しているインスタンス ID を尋ねてください。
[MUST] インストール操作はインスタンスの状態を変更します。実行前にユーザーから明示的な確認を得る必要があります。いかなる場合も、この手順を省略してはいけません。
ステップ 5:インストールの実行
[MUST] 冪等性の確認: 実行前に、同じ拡張機能と対象インスタンスに対して実行中の実行がすでに存在するかどうかを確認してください。
aliyun oos list-executions \ --biz-region-id "【User-Provided-Region】" \ --template-name "ACS-ECS-BulkyConfigureOOSPackageWithTemporaryURL" \ --status Running \ --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension同じ
packageNameとtargetsを持つ実行中の実行が見つかった場合:
- 既存の実行があることをユーザーに伝えます
- その実行の完了を待つか、新しい実行を作成するかユーザーに確認します
- ユーザーから応答がない場合、または続行を確認された場合でも、新しい実行を作成するために
start-executionを必ず呼び出してください。いかなる場合もstart-executionを省略しないでください
start-executionの呼び出しは、このステップで必須の中核アクションです。ユーザーが既存の実行を待つよう明示的に求めた場合を除き、必ず実行してください。[RECOMMENDED] ClientToken: 再試行による重複送信を防ぐため、決定論的な
ClientTokenを生成してください。ClientTokenは 1~64 文字の ASCII 文字列である必要があります。# 決定論的な ClientToken を生成して、再利用できるよう保存します CLIENT_TOKEN="${regionId}-${packageName}-$(date +%Y%m%d%H%M)" # 冪等性を確保するため、以降の再試行では同じトークンを再利用します aliyun oos start-execution \ ... \ --client-token "$CLIENT_TOKEN"これにより、コマンドを何度再試行しても、同じインストールの意図が常に同じトークンに対応します。
[MUST] インストールタスクを実行するために start-execution を呼び出してください(この呼び出しを省略してはなりません)。
[MUST] パラメーターの記録: start-execution を実行する前に、完全な --parameters JSON を追跡可能なようにファイルへ保存し、コマンドではそのファイルの内容を使用してください。
# Save parameters to file for traceability
cat > /tmp/oos-start-params.json << 'PARAMS_EOF'
{"regionId":"【User-Provided-Region】","OOSAssumeRole":"","targets":{"ResourceIds":["【User-Provided-InstanceId】"],"RegionId":"【User-Provided-Region】","Type":"ResourceIds"},"rateControl":{"Mode":"Concurrency","Concurrency":1,"MaxErrors":0},"action":"install","packageName":"【User-Specified-Package】","parameters":【User-Provided-Parameters】}
PARAMS_EOF
# Execute with parameters from file
aliyun oos start-execution \
--biz-region-id "【User-Provided-Region】" \
--template-name "ACS-ECS-BulkyConfigureOOSPackageWithTemporaryURL" \
--mode "Automatic" \
--tags "{}" \
--parameters "$(cat /tmp/oos-start-params.json)" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension
[MUST] 実行後、渡した主要なパラメーター値を記録してください。
Parameters passed to OOS:
- packageName: <actual value>
- packageVersion: <actual value, if applicable>
- parameters.version: <actual value, if applicable>
- targets.ResourceIds: <actual value>
/tmp/oos-start-params.json の完全なパラメーター JSON を、インストールレポートの「インストールパラメーター」フィールドに含めてください。
パラメーターの説明:
| パラメーター | 説明 |
|---|---|
regionId | --biz-region-id と一致している必要があります |
targets.ResourceIds | インストール対象のインスタンス ID の配列 |
targets.RegionId | --biz-region-id と一致している必要があります |
targets.Type | 固定値 ResourceIds |
rateControl.Concurrency | 同時インストール数。デフォルトは 1 |
rateControl.MaxErrors | 許容される最大エラー数。デフォルトは 0 |
action | 固定値 install |
packageName | 拡張機能パッケージ名 |
parameters | 拡張機能固有のインストールパラメーター(JSON オブジェクト) |
例:
aliyun oos start-execution \
--biz-region-id cn-hangzhou \
--template-name "ACS-ECS-BulkyConfigureOOSPackageWithTemporaryURL" \
--mode "Automatic" \
--tags "{}" \
--parameters "{\"regionId\":\"cn-hangzhou\",\"OOSAssumeRole\":\"\",\"targets\":{\"ResourceIds\":[\"i-bp12z30vh0xxxxxxxxxx\"],\"RegionId\":\"cn-hangzhou\",\"Type\":\"ResourceIds\"},\"rateControl\":{\"Mode\":\"Concurrency\",\"Concurrency\":1,\"MaxErrors\":0},\"action\":\"install\",\"packageName\":\"ACS-Extension-node-1853370294850618\",\"packageVersion\":\"v27\",\"parameters\":{\"version\":\"v22.13.1\"}}" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension
ステップ 6:実行結果の確認と検証
コマンドの実行後、レスポンスから ExecutionId を取得し、実行ステータスをポーリングします。
aliyun oos list-executions \
--biz-region-id "【User-Provided-Region】" \
--execution-id "【ExecutionId-from-Response】" \
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension
ポーリング戦略:実行ステータスを20 秒ごとに確認します。ステータスがまだ
Runningの場合は、20 秒待ってから再度確認します。最大待機時間は 20 分(60 回の確認)です。[MUST] 終了ステータスの要件: 実行が終了ステータス(
Success、Failed、Cancelled)になるまで、必ずポーリングを続けてください。ステータスがRunningの間は、インストールレポートを生成することは絶対に禁止されています。ポーリングを停止してレポートを生成できるのは、次の 2 つの場合のみです。
- 実行が終了ステータス(
Success、Failed、Cancelled)になった場合- 20 分間(20 秒間隔で 60 回)ポーリングしてもステータスが
Runningの場合。この場合は、実行ステータスをPending (timed out after 20 minutes)に設定した保留中レポートを出力し、結果の詳細に「インストールはまだ進行中で、最大待機時間の 20 分を超過しました。次のコマンドを使用して、ステータスを手動で確認してください:aliyun oos list-executions --biz-region-id <region> --execution-id <exec-id> --user-agent AlibabaCloud-Agent-Skills/alibabacloud-ecs-install-extension」と記載してください。その他の状況(例:ステータスがまだ
Runningの状態で、ポーリング回数が 60 回未満の場合)では、レポートの生成は絶対に禁止されています。ポーリングを続けてください。
インストールステータスの説明:
| ステータス | 説明 |
|---|---|
Running | インストールは進行中です。20 秒待ってから再度確認してください。まだレポートを出力しないでください。 |
Success | インストールに成功しました。レポートの生成に進んでください |
Failed | インストールに失敗しました。エラーの詳細を確認するために Outputs または Tasks を表示してから、レポートを生成してください |
Cancelled | インストールがキャンセルされました。レポートを生成してください |
インストールレポートの出力形式
[MUST] 次のいずれかの条件を満たす場合にのみ、このレポートを生成してください。
- 実行が終了ステータス(
Success、Failed、Cancelled)になった場合- 20 分間(60 回)ポーリングしてもステータスが
Runningの場合(Pending (timed out after 20 minutes)としてレポートします)ポーリング回数が 60 回に達しておらず、ステータスが
Runningの場合、このレポートを生成することは絶対に禁止されています。ポーリングを続けてください。
================== ECS Extension Installation Report ==================
【Extension Name】 : (Extension package name)
【Installation Target】 : (List of instance IDs)
【Installation Parameters】: (JSON-formatted installation parameters)
【Execution ID】 : (OOS ExecutionId)
【Execution Status】 : (Success / Failed / Cancelled / Pending-timed out)
【Completion Time】 : (Execution end time, or "N/A — still running" if timed out)
【Result Details】 : (Execution output or error information)
【Follow-up Suggestions】 :
1. (Suggestion 1, e.g., verify service status)
2. (Suggestion 2, e.g., security group port opening)
3. (Suggestion 3, e.g., check installation logs)
=======================================================================
ベストプラクティス
- インストール前にパラメーターを確認する — 拡張機能のインストールによってインスタンス環境が変更されるため、実行前にすべてのパラメーターをユーザーに確認する必要があります
- インスタンスのステータスを確認する — インストール前に、対象インスタンスが
Running状態であることを確認します - 適切なバージョンを選択する — バージョンパラメーターは拡張機能ごとに異なるため、ユーザーから正しいバージョン番号を取得します
- 複数のインスタンスに対応 —
ResourceIdsは配列をサポートしており、同じ拡張機能を複数のインスタンスに一度にインストールできます - セキュリティに注意する — コマンドやレポートで AK/SK を決して公開しないでください
参照リンク
| ドキュメント | 説明 |
|---|---|
| 関連コマンド | CLI コマンドの標準と全コマンドのリファレンス |
| RAM ポリシー | 必要な RAM 権限の一覧 |
| CLI インストールガイド | Aliyun CLI のインストール手順 |
注意事項
- 拡張機能のインストールには数分かかる場合があります。時間に余裕を持ち、実行ステータスを定期的に照会してください
- API エラーが発生した場合は、エラーメッセージを読み、権限を確認してから再試行してください
- 機密情報(AccessKey、パスワード)をレポートやコマンドに含めてはいけません
- 一部の拡張機能では、特定のオペレーティングシステムのバージョンが必要です。
get-templateのレスポンスで OS の互換性を確認してください - 拡張機能のインストール失敗は通常、インスタンスが起動していないこと、ネットワークの問題、OS バージョンの非互換性、またはディスク容量の不足が原因です