/aliyun-devops-manage

name: aliyun-devops-manage
description: Use when managing Alibaba Cloud DevOps (Yunxiao 2020) via OpenAPI/SDK, including project/repository/pipeline resource discovery, read-only inspection, and safe change planning before mutating operations.
version: 1.0.0

Category: service

Alibaba Cloud DevOps (Yunxiao)

Purpose

Use Alibaba Cloud DevOps OpenAPI to support:

• project, repository, and pipeline inventory
• work item and test resource inspection
• release and execution status checks
• metadata-driven API discovery before production changes

Prerequisites

• Configure least-privilege Alibaba Cloud credentials.
• Install Python SDK dependencies for local scripts:

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U alibabacloud_devops20210625 alibabacloud_tea_openapi

• Prefer environment variables:
• `ALIBABACLOUD_ACCESS_KEY_ID`
• `ALIBABACLOUD_ACCESS_KEY_SECRET`
• optional `ALIBABACLOUD_REGION_ID`

AccessKey Priority

1) Environment variables: `ALIBABACLOUD_ACCESS_KEY_ID` / `ALIBABACLOUD_ACCESS_KEY_SECRET` / `ALIBABACLOUD_REGION_ID` 2) Shared credentials file: `~/.alibabacloud/credentials`

If region/environment is unclear, confirm with user before mutating operations.

Compatibility note: runtime scripts also accept `ALIBABA_CLOUD_*` and `ALICLOUD_*` aliases, but `ALIBABACLOUD_*` is the preferred prefix for new examples and automation.

Workflow

1) Confirm target organization/project scope and change window. 2) Run API discovery and confirm exact API names and required parameters. 3) Execute read-only APIs first (`List*` / `Get*` / `Query*`). 4) Run mutating APIs only after rollback and owner confirmation. 5) Save outputs and evidence to `output/aliyun-devops-manage/`.

API Discovery

• Product code: `devops`
• Default API version: `2021-06-25`
• Metadata source: `https://api.aliyun.com/meta/v1/products/devops/versions/2021-06-25/api-docs.json`

Minimal Executable Quickstart

python skills/platform/devops/aliyun-devops-manage/scripts/list_openapi_meta_apis.py

Optional arguments:

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

List projects (read-only):

python skills/platform/devops/aliyun-devops-manage/scripts/list_projects.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --max-results 20 \
  --output output/aliyun-devops-manage/projects.txt

List repositories (read-only):

python skills/platform/devops/aliyun-devops-manage/scripts/list_repositories.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --page 1 \
  --per-page 20 \
  --output output/aliyun-devops-manage/repositories.txt

List pipelines (read-only):

python skills/platform/devops/aliyun-devops-manage/scripts/list_pipelines.py \
  --organization-id <organization-id> \
  --region cn-hangzhou \
  --max-results 20 \
  --output output/aliyun-devops-manage/pipelines.txt

Common Operation Map

• Project and membership: `CreateProject`, `GetProject`, `ListProjectMembers`, `UpdateProject`
• Code repository: `CreateRepository`, `GetRepository`, `ListRepositories`, `CreateMergeRequest`
• Pipeline and release: `CreatePipeline`, `GetPipeline`, `ListPipelines`, `RunPipeline`
• Work items and test: `CreateWorkitem`, `GetWorkitemDetail`, `ListTestCase`, `CreateTestCase`

See `references/api_quick_map.md` for grouped APIs.

Script Catalog

• `scripts/list_openapi_meta_apis.py`: fetch metadata and generate API inventory files.
• `scripts/list_projects.py`: list projects in one organization.
• `scripts/list_repositories.py`: list repositories in one organization.
• `scripts/list_pipelines.py`: list pipelines in one organization.

Validation

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

Pass criteria: command exits 0 and `output/aliyun-devops-manage/validate.txt` is generated.

Output And Evidence

• Save artifacts, command outputs, and API response summaries under `output/aliyun-devops-manage/`.
• Include key parameters (region/resource id/time range) in evidence files for reproducibility.

References

• Source list: `references/sources.md`
• API quick map: `references/api_quick_map.md`
• Operation templates: `references/templates.md`