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:

• ALICLOUD_ACCESS_KEY_ID

• ALICLOUD_ACCESS_KEY_SECRET

• optional ALICLOUD_REGION_ID

AccessKey Priority

• Environment variables: ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID

• Shared credentials file: ~/.alibabacloud/credentials

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

Workflow

• Confirm target organization/project scope and change window.

• Run API discovery and confirm exact API names and required parameters.

• Execute read-only APIs first (List* / Get* / Query* ).

• Run mutating APIs only after rollback and owner confirmation.

• Save outputs and evidence to output/alicloud-platform-devops/ .

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/alicloud-platform-devops/scripts/list_openapi_meta_apis.py

Optional arguments:

python skills/platform/devops/alicloud-platform-devops/scripts/list_openapi_meta_apis.py
--product-code devops
--version 2021-06-25
--output-dir output/alicloud-platform-devops

List projects (read-only):

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

List repositories (read-only):

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

List pipelines (read-only):

python skills/platform/devops/alicloud-platform-devops/scripts/list_pipelines.py
--organization-id <organization-id>
--region cn-hangzhou
--max-results 20
--output output/alicloud-platform-devops/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/alicloud-platform-devops for f in skills/platform/devops/alicloud-platform-devops/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/alicloud-platform-devops/validate.txt

Pass criteria: command exits 0 and output/alicloud-platform-devops/validate.txt is generated.

Output And Evidence

• Save artifacts, command outputs, and API response summaries under output/alicloud-platform-devops/ .

• 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