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