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. 03发现 API 操作及参数
  4. 04先查询再执行变更
  5. 05保存操作结果和错误记录

适用场景

  1. 01检查 `aliyun` CLI 版本并按需更新
  2. 02查询 ECS 地域或实例
  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: 工具

阿里云通用 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 执行阿里云 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。
  • 如果资源范围不明确，先查询再进行变更。
  • 删除／覆盖操作前，先输出目标资源列表。
  • 批量操作时，先在小范围内验证一个项目。

参考资料

  • 官方来源列表：references/sources.md

前提条件

  • 执行前配置遵循最小权限原则的阿里云凭证。
  • 优先使用环境变量：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET，以及可选的 ALIBABACLOUD_REGION_ID。
  • 如果地域不明确，运行变更操作前先询问用户。

工作流

  1. 确认用户意图、地域、标识符，以及操作是只读还是变更操作。
  2. 先运行一项最小化的只读查询，以验证连接和权限。
  3. 使用明确参数和有限范围执行目标操作。
  4. 验证结果并保存输出／证据文件。

评论

支持 Markdown