mcpField
A
aliyun-cli-manage

aliyun-cli-manage

github.com/cinienceクラウド・DevOps39672 回インストール11 週間前に更新
リポジトリ

aliyun-cli-manage について

aliyun-cli-manage は、公式 `aliyun` CLI で Alibaba Cloud OpenAPI を実行するスキルです。クラウドリソースの操作に向けて、CLI の導入、認証情報の設定、API の確認、実行と検証の手順を示します。

主な機能

  1. 01公式 CLI の確認とインストール
  2. 02認証情報とデフォルトリージョンの設定
  3. 03API 操作とパラメーターの確認
  4. 04変更前の読み取りクエリ
  5. 05結果とエラーログの保存

活用シーン

  1. 01`aliyun` CLI のバージョン確認と必要に応じた更新
  2. 02ECS のリージョンやインスタンスの照会
  3. 03削除前に対象リソースを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-cli-manage

インストール後、Claude Code で/aliyun-cli-manageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
sources.md
scripts/
ensure_aliyun_cli.py

詳細

Category: tool

Alibaba Cloud Generic CLI (aliyun) スキル

検証

mkdir -p output/aliyun-cli-manage
python skills/platform/cli/aliyun-cli-manage/scripts/ensure_aliyun_cli.py --help > output/aliyun-cli-manage/validate-help.txt

合格基準：コマンドが終了コード 0 で終了し、output/aliyun-cli-manage/validate-help.txt が生成されます。

出力とエビデンス

  • CLI のバージョン確認、API の出力、エラーログは output/aliyun-cli-manage/ に保存します。
  • 変更を伴う操作ごとに、リクエストパラメーターと結果の概要を記録します。

目標

  • 公式の aliyun CLI を使用して、Alibaba Cloud OpenAPI の操作を実行します。
  • インストール、設定、API の検出、実行、トラブルシューティングの標準的な手順を提供します。

クイックフロー

  1. 最初にバージョンガードスクリプトを実行します（まず確認し、その後アップグレードするか判断します）。
  2. インストールされていない場合、または確認間隔に達した場合、スクリプトが最新の公式パッケージをダウンロードしてインストールします。
  3. 認証情報とデフォルトリージョンを設定します（default プロファイルを推奨します）。
  4. aliyun <product> --help ／ aliyun <product> <ApiName> --help を使用して、パラメーターを確認します。
  5. まず読み取り専用のクエリを実行し、その後、変更を伴う操作を行います。

バージョンガード（実用）

毎回不要なダウンロードが発生しないよう、同梱のスクリプトを使用してください。

python skills/platform/cli/aliyun-cli-manage/scripts/ensure_aliyun_cli.py

デフォルトの動作：

  • 確認間隔：24 時間（環境変数で設定可能）。
  • 間隔内で、バージョンが要件を満たしている場合：ダウンロードをスキップします。
  • 間隔超過／未インストール／最小バージョン未満の場合：最新の公式パッケージを自動でダウンロードしてインストールします。

任意の制御（環境変数）：

  • ALIYUN_CLI_CHECK_INTERVAL_HOURS=24：確認間隔。
  • ALIYUN_CLI_FORCE_UPDATE=1：強制更新（確認間隔を無視）。
  • ALIYUN_CLI_MIN_VERSION=3.2.9：許容する最小バージョン。
  • ALIYUN_CLI_INSTALL_DIR=~/.local/bin：インストールディレクトリ。

手動パラメーターの例：

python skills/platform/cli/aliyun-cli-manage/scripts/ensure_aliyun_cli.py \
  --interval-hours 24 \
  --min-version 3.2.9

インストール（Linux の例）

curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz
mkdir -p ~/.local/bin
tar -xzf /tmp/aliyun-cli.tgz -C /tmp
mv /tmp/aliyun ~/.local/bin/aliyun
chmod +x ~/.local/bin/aliyun
~/.local/bin/aliyun version

認証情報の設定

aliyun configure set \
  --profile default \
  --mode AK \
  --access-key-id <AK> \
  --access-key-secret <SK> \
  --region cn-hangzhou

設定済みプロファイルを表示します：

aliyun configure list

コマンド構造

  • 汎用形式：aliyun <product> <ApiName> --Param1 value1 --Param2 value2
  • REST 形式：aliyun <product> [GET|POST|PUT|DELETE] <PathPattern> --body '...json...'

API の検出とパラメーターの検証

aliyun help
aliyun ecs --help
aliyun ecs DescribeRegions --help

よく使う読み取り専用の例

# ECS: list regions
aliyun ecs DescribeRegions

# ECS: list instances by region
aliyun ecs DescribeInstances --RegionId cn-hangzhou

# SLS: list projects by endpoint
aliyun sls ListProject --endpoint cn-hangzhou.log.aliyuncs.com --size 100

よくある問題

  • InvalidAccessKeyId.NotFound ／ SignatureDoesNotMatch：AK／SK とプロファイルを確認します。
  • MissingRegionId：--region を追加するか、プロファイルでデフォルトリージョンを設定します。
  • SLS エンドポイントのエラーが発生する場合は、--endpoint <region>.log.aliyuncs.com を明示的に指定します。

実行時の推奨事項

  • タスクを開始する前に ensure_aliyun_cli.py を実行します。
  • リソースの範囲が不明な場合は、変更を加える前にクエリを実行します。
  • 削除／上書き操作の前に、対象リソースの一覧を出力します。
  • 一括操作では、まず狭い範囲で 1 項目を検証します。

参考資料

  • 公式ソースの一覧：references/sources.md

前提条件

  • 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
  • 環境変数の使用を推奨します：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、任意で ALIBABACLOUD_REGION_ID。
  • リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認します。

ワークフロー

  1. ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うものかを確認します。
  2. 接続と権限を検証するため、最小限の読み取り専用クエリを 1 つ実行します。
  3. 明示的なパラメーターと限定した範囲で、対象の操作を実行します。
  4. 結果を検証し、出力／エビデンスファイルを保存します。

コメント

Markdown 対応