mcpField
A
alicloud-platform-aliyun-cli

alicloud-platform-aliyun-cli

github.com/cinience云与 DevOps396278 次安装11 周前更新
代码仓库

关于 alicloud-platform-aliyun-cli

alicloud-platform-aliyun-cli 是借助官方 aliyun 命令行工具执行 Alibaba Cloud OpenAPI 操作的技能，面向云资源管理任务。它涵盖安装与版本检查、凭据配置、API 探索、执行和结果核验。

主要功能

  1. 01检查并安装 aliyun CLI
  2. 02配置凭据与默认地域
  3. 03探索 API 及参数
  4. 04先查询再执行变更
  5. 05保存操作输出与证据

适用场景

  1. 01查询 ECS 地域和实例
  2. 02通过 SLS 列出项目
  3. 03在明确范围后执行云资源变更

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/alicloud-platform-aliyun-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

类别：工具

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

参考资料

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

前提条件

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

工作流

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

评论

支持 Markdown