SuperAPI AI 工具集

eve-project-bootstrap

部署与运维

查看项目

更新于 10-15 12:07

技能介绍

Eve Project Bootstrap 是一套用于把已有代码仓库连接到 Eve 并让首次部署跑起来的操作流程。它主要面向需要通过 Eve CLI 完成项目初始化的开发者,核心目标是建立组织、项目、环境与仓库之间的关联,并触发第一次部署。

用途 该流程用于将现有仓库接入 Eve,完成从配置 API 目标到首次部署验证的完整引导。

主要能力

  1. 设置 API 目标:从管理员处获取 staging API URL,并通过 eve profile create 创建 profile,再用 eve profile use 切换使用。
  2. 创建组织与项目:使用 eve org ensure 创建组织,使用 eve project ensure 创建项目并关联仓库 URL 与分支。
  3. 设置默认值:通过 eve profile set 指定默认的 org 与 project。
  4. 添加清单:确保 .eve/manifest.yaml 存在并使用 schema: eve/compose/v1。
  5. 首次部署:创建环境(如需要),然后执行 eve env deploy,可指定 --ref 与 --repo-dir;若环境配置了 pipeline,会触发 pipeline,也可用 --direct 绕过 pipeline 直接部署。
  6. 验证:通过 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 技能。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。