MEO Codebase Management(MEO 代码库管理)是一个面向 MEO(Multi-site Enterprise Operations)订阅的技能,平台限定为 MEO 订阅,用于对订阅下的代码库进行管理。
【用途】 适用于以下场景:列出或查看某个订阅的代码库;浏览代码库中可用的 git 分支和标签(引用);为订阅创建新的代码库;管理代码库上的域名路由模式(domain patterns)。
【使用方式】 所有命令均使用 acli api:v3:*. 形式。可运行 acli list api:v3:codebases 查看当前所有代码库命令。
列出代码库:
- 某订阅下的代码库:acli api:v3:subscriptions:list-codebases <subscriptionId>
- 你有权访问的所有代码库:acli api:v3:codebases:list
获取代码库详情: acli api:v3:codebases:find <codebaseId> 返回 id、label、region、vcs_url、status 以及关联的订阅。
创建代码库: acli api:v3:subscriptions:create-codebase <subscriptionId> <codebase_id> <label> <region> 参数说明:subscriptionId(必填)为订阅的 UUID;codebase_id(必填)为新代码库的客户端提供的 UUID;label(必填)为人类可读名称;region(必填)为 AWS 区域(例如 us-east-1)。
更新代码库: acli api:v3:codebases:update <codebaseId> --label="New Label" --description="..."
删除代码库: acli api:v3:codebases:delete <codebaseId> 注意:这是破坏性操作,需要显式批准。会永久删除该代码库;所有引用该代码库的站点必须先删除;此操作不可撤销,执行前需与用户确认。
列出代码库的环境: acli api:v3:codebases:list-environments <codebaseId> 返回所有使用该代码库构建站点实例的环境。
列出代码库的站点: acli api:v3:codebases:list-sites <codebaseId>
浏览 Git 引用(分支与标签):
- 列出所有分支与标签:acli api:v3:codebases:list-references <codebaseId>
- 获取特定引用的详情:acli api:v3:codebases:find-reference <codebaseId> <referenceName> referenceName 示例:refs/heads/main、refs/tags/1.2.0。
域名模式(Domain Patterns): 域名模式定义该代码库中站点的 URL 路由规则。
- 列出:acli api:v3:codebases:list-domain-patterns <codebaseId>
- 创建:acli api:v3:codebases:create-domain-pattern <codebaseId> ...
- 更新:acli api:v3:codebases:update-domain-pattern <codebaseId> <patternId> ...
- 获取特定模式:acli api:v3:codebases:find-domain-pattern <codebaseId> <patternId>
- 删除:acli api:v3:codebases:delete-domain-pattern <codebaseId> <patternId> 删除域名模式属于破坏性操作,需要显式批准;删除会移除 URL 路由规则,可能中断站点访问,执行前需与用户确认。
【典型工作流】 检查代码库及其 git 分支:
- 查找代码库:acli api:v3:subscriptions:list-codebases <subscriptionId>
- 浏览可用分支:acli api:v3:codebases:list-references <codebaseId>
- 确认要部署的分支存在:acli api:v3:codebases:find-reference <codebaseId> refs/heads/main
配置新代码库:
- 生成 UUID(或使用你自己的):CODEBASE_UUID=$(python3 -c "import uuid; print(uuid.uuid4())")
- 执行:acli api:v3:subscriptions:create-codebase <subscriptionId> "$CODEBASE_UUID" "My Codebase" us-east-1
【发现更多命令】 acli list api:v3:codebases acli list api:v3:subscriptions acli api:v3:codebases:list-references --help
【相关主题】 MEO 概览(ACE 与 MEO、数据模型)、MEO 站点(引用该代码库的站点)、MEO 环境(该代码库中代码运行的位置)、MEO 部署(从此代码库部署分支)。
【限制】 该技能仅适用于 MEO 订阅。删除代码库与删除域名模式均为破坏性操作,需要显式批准并确认。删除代码库前必须先删除所有引用它的站点,且不可撤销。除资料所述之外的功能、收费、价格、平台、效果或使用步骤暂未提供。