用途:在 Eve Horizon 平台上从零设计或迁移全栈应用,规划服务拓扑、数据库策略、构建与部署流水线,并判断现有架构是否充分利用平台能力。适合设计新应用、迁移旧应用、规划服务与数据库、决定托管或外部服务时使用。CLI 操作细节需配合 eve-manifest-authoring、eve-deploy-debugging、eve-auth-and-secrets、eve-pipelines-workflows 等技能。
主要能力:以 .eve/manifest.yaml 作为应用形态的唯一事实来源,声明服务拓扑(services)、基础设施(services[].x-eve,如托管数据库、ingress、角色)、构建策略(build 与 registry)、发布流水线(pipelines)、环境(environments)、智能体配置(x-eve.agents、x-eve.chat)与运行时默认值(x-eve.defaults)。常见拓扑为 API+数据库、API+Worker+数据库、多服务(web/api/worker/db/redis)。设计规则包括:每个服务单一职责;Postgres 用 x-eve.role: managed_db 由平台注入凭据;外部服务标 x-eve.external: true 并配 connection_url;一次性任务用 x-eve.role: job;仅需外部 HTTP 的服务才开 x-eve.ingress.public: true;主机名策略可先用平台生成 URL,再加 alias 或自定义域名(环境级、先绑定者优先)。需要固定出网 IP 的服务可声明稳定 egress。对象存储可在 manifest 声明 buckets,但自动开通尚未接通;云 FS 可挂载 Google Drive。平台注入 EVE_API_URL、EVE_PUBLIC_API_URL、EVE_PROJECT_ID、EVE_ORG_ID、EVE_ENV_NAME。
参考架构:nginx 前端 SPA 反向代理 /api/ 到内部 API 服务,配合托管 Postgres 与 eve-migrate 任务;API 无公网 ingress,避免 CORS 与硬编码主机名。数据库用带时间戳前缀的纯 SQL 迁移,由 eve-migrate 执行,不建议用 TypeORM、Knex 或 Flyway。多租户建议从一开始设计 RLS,表含 org_id,通过 DatabaseService 在事务内 set_config 设置上下文。
限制:资料未提供收费、价格、平台支持范围与效果数据;对象存储自动开通状态未完成;部分内容在原文中被截断。