Back to Details

eve-project-bootstrap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Eve Project Bootstrap

Eve 项目快速搭建

Use this flow to connect an existing repo to Eve and get the first deploy running.
使用以下流程将现有代码仓库连接到Eve并完成首次部署。

Set the API Target

设置API目标地址

  • Get the staging API URL from your admin.
  • Create and use a profile:
bash
eve profile create staging --api-url https://api.eh1.incept5.dev
eve profile use staging
  • 从管理员处获取预发布环境（staging）的API地址。
  • 创建并使用配置文件：
bash
eve profile create staging --api-url https://api.eh1.incept5.dev
eve profile use staging

Create Org and Project

创建组织与项目

bash
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
URL impact: These slugs determine your deployment URLs and K8s namespaces:
  • URL: 
    {service}.{orgSlug}-{projectSlug}-{env}.{domain}
    (e.g., 
    api.myorg-my-app-staging.eh1.incept5.dev
    )
  • Namespace: 
    eve-{orgSlug}-{projectSlug}-{env}
    (e.g., 
    eve-myorg-my-app-staging
    )
Slugs are immutable — choose short, meaningful values.
Set defaults:
bash
eve profile set --org org_xxx --project proj_xxx
bash
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
URL影响说明： 这些slug将决定你的部署URL和K8s命名空间：
  • URL格式：
    {service}.{orgSlug}-{projectSlug}-{env}.{domain}
    （示例：
    api.myorg-my-app-staging.eh1.incept5.dev
    ）
  • 命名空间格式：
    eve-{orgSlug}-{projectSlug}-{env}
    （示例：
    eve-myorg-my-app-staging
    ）
Slug是不可修改的，请选择简短且有意义的取值。
设置默认值：
bash
eve profile set --org org_xxx --project proj_xxx

Add the Manifest

添加清单文件

  • Ensure 
    .eve/manifest.yaml
    is present and uses 
    schema: eve/compose/v1
    .
  • Use the 
    eve-manifest-authoring
    skill for structure details.
  • 确保
    .eve/manifest.yaml
    文件已存在，且使用
    schema: eve/compose/v1
    。
  • 如需了解结构细节，请使用
    eve-manifest-authoring
    技能。

First Deploy

首次部署

bash
undefined
bash
undefined

Create environment if needed

如需创建环境

eve env create staging --project proj_xxx --type persistent
eve env create staging --project proj_xxx --type persistent

Deploy (requires --ref with 40-char SHA or a ref resolved against --repo-dir)

部署（需要--ref参数指定40位SHA值，或结合--repo-dir参数指定引用）

eve env deploy staging --ref main --repo-dir .
eve env deploy staging --ref main --repo-dir .

If the environment has a pipeline configured, this triggers the pipeline.

如果环境已配置流水线，此命令将触发流水线。

Use --direct to bypass pipeline and deploy directly:

使用--direct参数绕过流水线直接部署：

eve env deploy staging --ref main --repo-dir . --direct
undefined
eve env deploy staging --ref main --repo-dir . --direct
undefined

Verify

验证部署

bash
eve system health
eve job list --phase active
eve job follow <job-id>
eve job result <job-id>
Access apps via 
{service}.{orgSlug}-{projectSlug}-{env}.{domain}
.
bash
eve system health
eve job list --phase active
eve job follow <job-id>
eve job result <job-id>
通过
{service}.{orgSlug}-{projectSlug}-{env}.{domain}
访问应用。