mcpField
A
alibabacloud-ecs-install-extension

alibabacloud-ecs-install-extension

github.com/aliyunクラウド・DevOps281186 回インストール1 日前に更新
リポジトリ

alibabacloud-ecs-install-extension について

Alibaba Cloud の Agent スキルで、OOS を通じて ECS 拡張パッケージを検索・インストールします。クラウド運用担当者向けに、利用可能なパッケージや対応状況を確認し、設定を確認したうえで ECS インスタンスへ導入します。

主な機能

  1. 01利用可能な拡張パッケージの一覧
  2. 02指定拡張の対応状況確認
  3. 03ECS インスタンスへの拡張導入
  4. 04単一または複数インスタンスへの導入
  5. 05入力値と導入パラメーターの検証

活用シーン

  1. 01利用可能な ECS 拡張の確認
  2. 02指定した拡張の対応状況の確認
  3. 03ECS への開発環境の導入
  4. 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.md
ram-policies.md
related-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)があることを確認してください。

有効なプロファイルがない場合は、ここで停止してください。

  1. Alibaba Cloud Console から認証情報を取得します
  2. このセッション外で認証情報を設定します(ターミナルで aliyun configure を実行するか、シェルのプロファイルで環境変数を設定)
  3. aliyun configure list に有効なプロファイルが表示されたら、戻って再実行します

エンドポイントに関する注意(プラグインモード):プラグインモードでは、通常 --endpoint フラグは不要です。OOS プラグインは --biz-region-id に基づいてエンドポイントを自動的に解決します。エンドポイントの解決に失敗する場合は、--biz-region-id の値が有効な Alibaba Cloud リージョン ID(例:cn-hangzhou)であることを確認してください。


AI モードとプラグインの更新

[MUST] このワークフローで aliyun CLI コマンドを実行する前に、次の初期化コマンドを実行してください。

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 を読んでください。

主なルール:

  • すべての aliyun CLI コマンドでは、操作名とフラグの両方にプラグインモード(小文字とハイフンを使用)を指定する必要があります。これは 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 呼び出しが権限エラーで失敗した場合は、次の手順に従ってください。

  1. この SKILL に必要な権限の一覧を確認するため、references/ram-policies.md を読んでください
  2. ram-permission-diagnose スキルを使って、必要な権限を申請できるようユーザーを案内してください
  3. 必要な権限が付与されたことをユーザーが確認するまで、一時停止して待ってください

パラメーターの確認

重要:パラメーターの確認 — インストールコマンドを実行する前に、 ユーザーが変更できるすべてのパラメーターをユーザーに確認する必要があります。明示的な承認なしに、値を推測したり既定値を使用したりしないでください。

パラメーター名必須/任意説明既定値
RegionId必須対象インスタンスが配置されているリージョンN/A
InstanceId必須拡張機能をインストールする 1 つ以上の ECS インスタンス IDN/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 件。—

特殊文字のエスケープ: 検証後、すべてのユーザー指定文字列値を --Parameters JSON 文字列に埋め込む前に、適切に 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 やその他のテンプレート内容からパラメーターを推測してはいけません。スクリプト内のシェル変数は内部実装の詳細であり、ユーザーが設定できるパラメーターではありません。

一般的なパラメーターの例:

ParameterTypeDescription
versionStringソフトウェアのバージョン番号(例:Node.js の場合は v22.13.1)
packageVersionString拡張機能パッケージのバージョン(例:v27)

注: パラメーター値を捏造してはいけません。ユーザーから取得するか、テンプレートのデフォルト値を使用する必要があります。

ステップ 4:すべてのパラメーターを確認

[MUST] インストールを実行する前に、以下のすべての項目を含むパラメーター確認表を必ずユーザーに提示し、**「インストールを進める前に、上記のパラメーターが正しいことをご確認ください。」**と明確に尋ねてください。ユーザーが肯定的な返答をするまで、ステップ 5 に進んではいけません。ユーザーが最初のリクエストですでにすべてのパラメーターを提示している場合でも、確認手順は必須です。

ItemValue
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 を持つ実行中の実行が見つかった場合:

  1. 既存の実行があることをユーザーに伝えます
  2. その実行の完了を待つか、新しい実行を作成するかユーザーに確認します
  3. ユーザーから応答がない場合、または続行を確認された場合でも、新しい実行を作成するために 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 つの場合のみです。

  1. 実行が終了ステータス(Success、Failed、Cancelled)になった場合
  2. 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] 次のいずれかの条件を満たす場合にのみ、このレポートを生成してください。

  1. 実行が終了ステータス(Success、Failed、Cancelled)になった場合
  2. 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)
=======================================================================

ベストプラクティス

  1. インストール前にパラメーターを確認する — 拡張機能のインストールによってインスタンス環境が変更されるため、実行前にすべてのパラメーターをユーザーに確認する必要があります
  2. インスタンスのステータスを確認する — インストール前に、対象インスタンスが Running 状態であることを確認します
  3. 適切なバージョンを選択する — バージョンパラメーターは拡張機能ごとに異なるため、ユーザーから正しいバージョン番号を取得します
  4. 複数のインスタンスに対応 — ResourceIds は配列をサポートしており、同じ拡張機能を複数のインスタンスに一度にインストールできます
  5. セキュリティに注意する — コマンドやレポートで AK/SK を決して公開しないでください

参照リンク

ドキュメント説明
関連コマンドCLI コマンドの標準と全コマンドのリファレンス
RAM ポリシー必要な RAM 権限の一覧
CLI インストールガイドAliyun CLI のインストール手順

注意事項

  1. 拡張機能のインストールには数分かかる場合があります。時間に余裕を持ち、実行ステータスを定期的に照会してください
  2. API エラーが発生した場合は、エラーメッセージを読み、権限を確認してから再試行してください
  3. 機密情報(AccessKey、パスワード)をレポートやコマンドに含めてはいけません
  4. 一部の拡張機能では、特定のオペレーティングシステムのバージョンが必要です。get-template のレスポンスで OS の互換性を確認してください
  5. 拡張機能のインストール失敗は通常、インスタンスが起動していないこと、ネットワークの問題、OS バージョンの非互換性、またはディスク容量の不足が原因です

コメント