mcpField
A
aliyun-pts-manage

aliyun-pts-manage

github.com/cinience测试与质量39656 次安装11 周前更新
代码仓库

关于 aliyun-pts-manage

用于通过 Alibaba Cloud PTS OpenAPI 检查和管理压力测试场景的技能，面向测试规划、执行与故障排查。它涵盖场景生命周期控制以及报告和运行指标检索，并要求变更前先检查现状。

主要功能

  1. 01发现 PTS API 元数据
  2. 02分页列出测试场景
  3. 03创建、修改和删除场景
  4. 04启动或停止压力测试
  5. 05检索报告、状态与运行数据

适用场景

  1. 01盘点并检查已有测试场景
  2. 02启动场景并跟踪运行状态
  3. 03停止测试或调试场景
  4. 04检索报告以验证测试结果

MCP 相关

未说明与 MCP 的关系。

安装

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

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

安装后在 Claude Code 中输入/aliyun-pts-manage确认已加载。

包含的文件

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

agents/
openai.yaml
references/
api_quick_map.md
sources.md
templates.md
scripts/
_pts_client.py
list_openapi_meta_apis.py
list_pts_scenes.py
start_pts_scene.py
stop_pts_scene.py

详细介绍

Category: 服务

阿里云性能测试服务（PTS）

用途

使用阿里云 PTS OpenAPI 支持：

  • 测试场景清单与检查
  • 压测规划与生命周期自动化
  • 报告和指标获取，用于验证和故障排查

前提条件

  • 配置遵循最小权限原则的阿里云凭证。
  • 安装 Python SDK（建议使用虚拟环境）：
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_pts20201020 alibabacloud_tea_openapi
  • 优先使用环境变量：
    • ALIBABACLOUD_ACCESS_KEY_ID
    • ALIBABACLOUD_ACCESS_KEY_SECRET
    • 可选：ALIBABACLOUD_REGION_ID
  • 执行变更操作前，先进行只读 API 探查并检查当前状态。

AccessKey 优先级

  1. 环境变量：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID
  2. 共享凭证文件：~/.alibabacloud/credentials

如果区域或环境不明确，请在执行变更操作前向用户确认。

工作流

  1. 确定目标区域、测试场景标识符和操作范围。
  2. 执行 API 探查，确认 API 名称和必需参数。
  3. 优先执行只读 API（List* / Get* / Describe*）。
  4. 仅在确认回滚方案和变更时段后执行变更操作。
  5. 将输出和证据保存到 output/aliyun-pts-manage/。

API 探查

  • 产品代码：PTS
  • 默认 API 版本：2020-10-20
  • 元数据来源：https://api.aliyun.com/meta/v1/products/PTS/versions/2020-10-20/api-docs.json

最小可执行快速入门

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py

可选参数：

python skills/observability/pts/aliyun-pts-manage/scripts/list_openapi_meta_apis.py \
  --product-code PTS \
  --version 2020-10-20 \
  --output-dir output/aliyun-pts-manage

列出场景（只读）：

python skills/observability/pts/aliyun-pts-manage/scripts/list_pts_scenes.py \
  --region cn-hangzhou \
  --page-number 1 \
  --page-size 10 \
  --output output/aliyun-pts-manage/scenes.txt

启动一个场景（变更操作）：

python skills/observability/pts/aliyun-pts-manage/scripts/start_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/start-result.json

停止一个场景（变更操作）：

python skills/observability/pts/aliyun-pts-manage/scripts/stop_pts_scene.py \
  --region cn-hangzhou \
  --scene-id <scene-id> \
  --wait \
  --output output/aliyun-pts-manage/stop-result.json

常见操作对照表

  • 场景清单：ListPtsScene、GetPtsScene、ListOpenJMeterScenes、GetOpenJMeterScene
  • 场景生命周期：CreatePtsScene、SavePtsScene、ModifyPtsScene、DeletePtsScene、DeletePtsScenes
  • 测试执行控制：StartPtsScene、StopPtsScene、StartTestingJMeterScene、StopTestingJMeterScene
  • 调试控制：StartDebugPtsScene、StopDebugPtsScene、StartDebuggingJMeterScene、StopDebuggingJMeterScene
  • 报告/指标：ListPtsReports、GetPtsReportDetails、GetPtsSceneRunningData、GetPtsSceneRunningStatus

分组 API 列表请参阅 references/api_quick_map.md。

脚本目录

  • scripts/list_openapi_meta_apis.py：获取元数据并生成 API 清单文件。
  • scripts/list_pts_scenes.py：分页列出 PTS 场景。
  • scripts/start_pts_scene.py：启动场景，并可选择轮询运行状态。
  • scripts/stop_pts_scene.py：停止场景，并可选择轮询直至其不再运行。

输出策略

将生成的文件和执行证据写入： output/aliyun-pts-manage/

验证

mkdir -p output/aliyun-pts-manage
for f in skills/observability/pts/aliyun-pts-manage/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-pts-manage/validate.txt

通过标准：命令以 0 退出，并生成 output/aliyun-pts-manage/validate.txt。

输出与证据

  • 将制品、命令输出和 API 响应摘要保存到 output/aliyun-pts-manage/ 下。
  • 在证据文件中包含关键参数（区域/资源 ID/时间范围），以便复现。

参考资料

  • 来源列表：references/sources.md
  • API 快速对照表：references/api_quick_map.md
  • 请求/响应模板：references/templates.md

评论

支持 Markdown