Eve Deploy Debugging

This walks you through deploying and troubleshooting apps on Eve's staging infrastructure using their CLI. You get the full deploy flow (create env, push with SHA refs, poll pipeline runs), a three-terminal debugging setup for watching jobs in real time, and structured diagnostics when things break. The infrastructure change policy is clear: never touch kubectl or helm directly, everything goes through Terraform and the Eve CLI. Most useful when a deploy hangs or fails and you need to know whether it's a blocked job, a missing secret, a registry auth issue, or just waiting on a health check. The custom domain ownership model and cost sentinel alerts are nice touches for multi-environment projects.

skills.sh installs: 307
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add incept5/eve-skillpacks --skill eve-deploy-debugging --agent claude-code

Installs into .claude/skills of the current project.

Files

Eve Deploy and Debug

Use these steps to deploy and diagnose app issues quickly.

Environment Setup

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

Infrastructure Change Policy

Never run kubectl apply, helm install, or any direct Kubernetes resource creation against shared infrastructure. All infrastructure changes go through Terraform. Use the Eve CLI (eve env, eve env deploy) to manage application deployments — the platform handles the underlying k8s resources.

Deploy Flow (Staging)

# Create env 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 .

# When environment has a pipeline configured, the above triggers the pipeline.
# Use --direct to bypass pipeline and deploy directly:
eve env deploy staging --ref main --repo-dir . --direct

# Pass inputs to pipeline:
eve env deploy staging --ref main --repo-dir . --inputs '{"key":"value"}'