Cloud Effect CLI
Alibaba Cloud Cloud Effect(云效) DevOps 명령줄 도구입니다. Cloud Effect API의 비자명한 함정과 필수 필드 규칙을 기록하여 한 번에 성공적으로 호출할 수 있도록 돕습니다.
사전 요구 사항
| 도구 | 유형 | 필수 여부 | 설치 방법 |
|---|---|---|---|
| yunxiao MCP | mcp | 아니요 | Claude Code MCP 설정에서 구성 (CLI보다 선호) |
| aliyun CLI | cli | 아니요 | brew install aliyun-cli 후 aliyun configure — 전체 설정은 openapi.md 참조 |
| git | cli | 예 | brew install git 또는 git-scm.com |
| jq | cli | 아니요 | brew install jq (CLI 모드에서 JSON 파싱 용도) |
yunxiao MCP 또는 aliyun CLI 중 하나 이상이 필요합니다. MCP를 권장합니다.
스킬 로드 시 이러한 도구가 있는지 미리 확인하지 마세요. 명령이 도구 누락으로 실패하면 사용자를 직접 설치 및 구성 과정으로 안내하세요.
사용 시기
- MR 생성/관리: codeup.aliyun.com 저장소에서 병합 요청 생성, 설명 업데이트, 목록 보기
- 작업 관리: 작업 상태 조회/생성/업데이트, 댓글 추가
- 릴리스 관리: Cloud Effect API를 통해 태그 생성
도구 선택
| 조건 | 권장 방식 |
|---|---|
MCP 서비스가 연결됨 (mcp__yunxiao__* 도구 사용 가능) | MCP 도구 우선 사용 (MR 작업 포함) |
| MCP 서비스 없음 | aliyun CLI 사용 |
| MCP 도구로 커버되지 않는 작업 (MR 업데이트, 댓글 편집 등) | aliyun CLI 사용 |
⚠️
aliyun devops ListRepositories는SYSTEM_UNAUTHORIZED_ERROR오류가 알려져 있습니다. 저장소 ID를 가져올 때는 MCP 도구를 우선 사용하세요.
자주 사용하는 작업 매핑
| 작업 | MCP 도구 | CLI 대안 |
|---|---|---|
| 저장소 조회 | mcp__yunxiao__list_repositories | aliyun devops ListRepositories (권한 오류 가능) |
| MR 생성 | mcp__yunxiao__create_change_request | aliyun devops CreateMergeRequest |
| MR 조회 | mcp__yunxiao__get_change_request | aliyun devops GetMergeRequest |
| MR 업데이트 | — | aliyun devops UpdateMergeRequest |
| 작업 조회 | mcp__yunxiao__search_workitems | aliyun devops ListWorkitems |
| 작업 상세 조회 | mcp__yunxiao__get_work_item | — |
| 작업 상태 업데이트 | mcp__yunxiao__update_work_item | REST API (openapi.md 참조) |
| 워크플로 조회 | mcp__yunxiao__get_work_item_workflow | aliyun devops ListWorkItemWorkFlowStatus |
| 댓글 추가 | mcp__yunxiao__create_work_item_comment | REST API (openapi.md 참조) |
| 댓글 편집 | — | aliyun devops UpdateWorkitemComment |
| 필드 구성 조회 | mcp__yunxiao__get_work_item_type_field_config | aliyun devops ListWorkItemAllFields |
| 태그 생성 | — | aliyun devops CreateTag |
상위 5가지 함정
가장 자주 실수하는 부분입니다. 전체 규칙은 cheatsheet.md를 참조하세요:
- 저장소 ID 필드는
Id(대문자 I) —jq에서.id를 사용하면null을 반환합니다. - MR 생성 시 반드시 제공해야 함
sourceProjectId,targetProjectId,createFrom: "WEB" - 작업 상태 업데이트는 반드시 REST API 사용 —
aliyun devops POST /organization/.../workitems/updateWorkitemField updateWorkitemPropertyRequest는 반드시 배열[{...}]이어야 하며, 필드명은fieldIdentifier/fieldValue를 사용합니다.- 작업 생성 전에 반드시 필수 필드를 조회해야 함 — 프로젝트마다 다른 커스텀 필수 필드가 있습니다.
상세 가이드
- AI 도우미 필독: cheatsheet.md — 13가지 황금 규칙 + 전체 오류 빠른 참조
- API 완전 참조: openapi.md — 설정 가이드, 모든 API 작업 템플릿, MR/작업/릴리스 전체 워크플로