eve-project-bootstrap

Eve Project Bootstrap

Use this flow to connect an existing repo to Eve and get the first deploy running.

Set the API Target

• Get the staging API URL from your admin.
• Create and use a profile:

eve profile create staging --api-url https://api.eve.example.com
eve profile use staging

Create Org and Project

eve org ensure my-org --slug myorg
eve project ensure --name "My App" --slug my-app --repo-url [email protected]: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:

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.

First Deploy

# 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)
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:
eve env deploy staging --ref main --repo-dir . --direct

Verify

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}.