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.eve.example.com
eve profile use staging

从管理员处获取预发布环境（staging）的API URL。
创建并使用配置文件：

bash

eve profile create staging --api-url https://api.eve.example.com
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.eve.example.com

)

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.eve.example.com

）

命名空间格式：

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

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

部署（需要携带40位SHA的--ref参数，或基于--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}

访问应用。