Eve Project Bootstrap 是一套用于把已有代码仓库连接到 Eve 并让首次部署跑起来的操作流程。它主要面向需要通过 Eve CLI 完成项目初始化的开发者,核心目标是建立组织、项目、环境与仓库之间的关联,并触发第一次部署。
用途 该流程用于将现有仓库接入 Eve,完成从配置 API 目标到首次部署验证的完整引导。
主要能力
- 设置 API 目标:从管理员处获取 staging API URL,并通过 eve profile create 创建 profile,再用 eve profile use 切换使用。
- 创建组织与项目:使用 eve org ensure 创建组织,使用 eve project ensure 创建项目并关联仓库 URL 与分支。
- 设置默认值:通过 eve profile set 指定默认的 org 与 project。
- 添加清单:确保 .eve/manifest.yaml 存在并使用 schema: eve/compose/v1。
- 首次部署:创建环境(如需要),然后执行 eve env deploy,可指定 --ref 与 --repo-dir;若环境配置了 pipeline,会触发 pipeline,也可用 --direct 绕过 pipeline 直接部署。
- 验证:通过 eve system health、eve job list、eve job follow、eve job result 等命令检查系统健康与任务状态。
使用方式 流程以 Eve CLI 命令为主,典型步骤包括:
- eve profile create staging --api-url https://api.eve.example.com
- eve profile use staging
- eve org ensure my-org --slug myorg
- eve project ensure --name "My App" --slug my-app --repo-url git@github.com:me/my-app.git --branch main
- eve profile set --org org_xxx --project proj_xxx
- eve env create staging --project proj_xxx --type persistent
- eve env deploy staging --ref main --repo-dir .
- eve env deploy staging --ref main --repo-dir . --direct
- eve system health
- eve job list --phase active
- eve job follow <job-id>
- eve job result <job-id>
适用场景 适用于需要将已有仓库接入 Eve 平台、配置组织与项目、并完成首次部署的开发者或团队。
限制与注意事项
- slug 会决定部署 URL 和 Kubernetes 命名空间,格式分别为 {service}.{orgSlug}-{projectSlug}-{env}.{domain} 和 eve-{orgSlug}-{projectSlug}-{env}。
- slug 不可变,应选择简短且有意义的取值。
- 部署命令需要 --ref 为 40 位 SHA,或通过 --repo-dir 解析引用。
- 清单文件结构细节可参考 eve-manifest-authoring 技能。
- 关于收费、价格、平台支持范围等信息,资料中暂未提供。