alicloud-platform-aliyun-cli

カテゴリ：ツール

Alibaba Cloud 汎用 CLI（aliyun）スキル

検証

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

合格条件：コマンドが終了コード 0 で終了し、output/alicloud-platform-aliyun-cli/validate-help.txt が生成されていること。

出力と証跡

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

目標

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

クイックフロー

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

バージョンガード（実用的な方法）

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

python skills/platform/cli/alicloud-platform-aliyun-cli/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/alicloud-platform-aliyun-cli/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 認証情報を設定します。
• 環境変数の使用を推奨します：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、任意で ALICLOUD_REGION_ID。
• リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認します。

ワークフロー

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