运行时依赖
版本
先决条件
安装命令
点击复制技能文档
类别:服务 Alibaba Cloud DevOps (Yunxiao) 目的 使用Alibaba Cloud DevOps OpenAPI支持: 项目、仓库和流水线库存 工作项和测试资源检查 发布和执行状态检查 元数据驱动的API发现 在生产变更之前
前置条件 配置最小权限的Alibaba Cloud凭证。 安装Python SDK依赖项以用于本地脚本: python3 -m venv .venv . .venv/bin/activate python -m pip install -U alibabacloud_devops20210625 alibabacloud_tea_openapi 首选环境变量: ALICLOUD_ACCESS_KEY_ID ALICLOUD_ACCESS_KEY_SECRET 可选ALICLOUD_REGION_ID AccessKey优先级 环境变量:ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID 共享凭证文件:~/.alibabacloud/credentials 如果区域/环境不明确,应在修改操作之前与用户确认。
工作流程 确认目标组织/项目范围和变更窗口。 运行API发现并确认确切的API名称和所需参数。 首先执行只读API(List / Get / Query)。 仅在回滚和所有者确认后运行修改API。 将输出和证据保存到output/aliyun-devops-manage/。
API发现 产品代码:devops 默认API版本:2021-06-25 元数据源:https://api.aliyun.com/meta/v1/products/devops/versions/2021-06-25/api-docs.json 最小可执行快速入门 python skills/platform/devops/aliyun-devops-manage/scripts/list_openapi_meta_apis.py 可选参数: python skills/platform/devops/aliyun-devops-manage/scripts/list_openapi_meta_apis.py \ --product-code devops \ --version 2021-06-25 \ --output-dir output/aliyun-devops-manage 列出项目(只读): python skills/platform/devops/aliyun-devops-manage/scripts/list_projects.py \ --organization-id \ --region cn-hangzhou \ --max-results 20 \ --output output/aliyun-devops-manage/projects.txt 列出仓库(只读): python skills/platform/devops/aliyun-devops-manage/scripts/list_repositories.py \ --organization-id \ --region cn-hangzhou \ --page 1 \ --per-page 20 \ --output output/aliyun-devops-manage/repositories.txt 列出流水线(只读): python skills/platform/devops/aliyun-devops-manage/scripts/list_pipelines.py \ --organization-id \ --region cn-hangzhou \ --max-results 20 \ --output output/aliyun-devops-manage/pipelines.txt
公共操作映射 项目和成员:CreateProject, GetProject, ListProjectMembers, UpdateProject 代码仓库:CreateRepository, GetRepository, ListRepositories, CreateMergeRequest 流水线和发布:CreatePipeline, GetPipeline, ListPipelines, RunPipeline 工作项和测试:CreateWorkitem, GetWorkitemDetail, ListTestCase, CreateTestCase 请参阅references/api_quick_map.md以获取分组API。
脚本目录 scripts/list_openapi_meta_apis.py:获取元数据并生成API库存文件。 scripts/list_projects.py:列出一个组织中的项目。 scripts/list_repositories.py:列出一个组织中的仓库。 scripts/list_pipelines.py:列出一个组织中的流水线。
验证 mkdir -p output/aliyun-devops-manage for f in skills/platform/devops/aliyun-devops-manage/scripts/.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/aliyun-devops-manage/validate.txt 通过标准:命令退出0并生成output/aliyun-devops-manage/validate.txt。
输出和证据 将工件、命令输出和API响应摘要保存在output/aliyun-devops-manage/下。 在证据文件中包含关键参数(区域/资源ID/时间范围)以实现可复现性。
参考 源列表:references/sources.md API快速映射:references/api_quick_map.md 操作模板:references/templates.md