How yashchokhat/vertex-on-edge-cli works
Vertex-on-Edge is a Go CLI that turns a local project into a cloud deployment. The primary workflow selects a project, detects its stack, gathers provider settings, generates container and CI files, provisions infrastructure, then configures GitHub and pushes the source to trigger deployment. The README also describes lifecycle commands and the downstream GitHub Actions → GHCR → EC2 flow. Edges are grounded in the deploy excerpt, source-index references, or README; downstream workflow and unsampled subsystems are documented rather than verified from source.
Main entry points: deploy.go Deploy orchestrator · detector.go Stack detection · repo.go GitHub repository setup · main.go CLI entry
Components 23
CLI workflow
- CLI entry
cmd/vertex-on-edge/main.go - Deploy orchestrator
internal/cli/deploy.go - Lifecycle commands
internal/cli - Cloud and GitHub auth
internal/auth - Dependency installer
internal/dependencies/installer.go - Project and cloud prompts
internal/ui/prompt.go - Provider prompts
internal/ui/cloud_prompt.go
Project preparation
- Stack detection
internal/detector/detector.go - Detection rules
internal/detector/rules.go - Project scanning
internal/detector/filesystem.go - Stack data model
pkg/models/stack.go - Dockerfile generation
internal/docker/generator.go
Cloud provisioning
- Terraform rendering
internal/terraform/renderer.go - AWS EC2 templates
internal/terraform/aws/ec2/embed.go - Terraform execution
internal/terraform/runner.go
GitHub delivery
- Workflow generation
internal/github/actions.go - GitHub repository setup
internal/github/repo.go - SSH host verification
internal/github/ssh.go
Deployed application
- GitHub Actions
- GitHub Container Registry
- AWS EC2
- Deployed application
Other components
- Developer
Connections 22
- Developer → CLI entry: runs CLI
README.md - CLI entry → Deploy orchestrator: dispatches deploy
cmd/vertex-on-edge/main.go - Deploy orchestrator → Dependency installer: checks tools
internal/cli/deploy.go - Deploy orchestrator → Cloud and GitHub auth: authenticates
internal/cli/deploy.go - Deploy orchestrator → Project and cloud prompts: prompts project
internal/cli/deploy.go - Deploy orchestrator → Provider prompts: selects provider
README.md - Deploy orchestrator → Stack detection: detects stack
internal/cli/deploy.go - Stack detection → Detection rules: evaluates rules
- Stack detection → Project scanning: scans files
- Stack detection → Stack data model: returns stack
- Deploy orchestrator → Dockerfile generation: generates Dockerfile
internal/cli/deploy.go - Deploy orchestrator → Workflow generation: generates workflows
README.md - Deploy orchestrator → Terraform rendering: renders templates
README.md - Terraform rendering → AWS EC2 templates: copies templates
internal/terraform/renderer.go - Deploy orchestrator → Terraform execution: applies infrastructure
internal/cli/deploy.go - Deploy orchestrator → GitHub repository setup: configures and pushes
README.md - GitHub repository setup → SSH host verification: verifies SSH host
- GitHub repository setup → GitHub Actions: triggers pipeline
README.md - GitHub Actions → GitHub Container Registry: pushes image
README.md - GitHub Actions → AWS EC2: deploys over SSH
README.md - AWS EC2 → GitHub Container Registry: pulls image
README.md - AWS EC2 → Deployed application: runs container
README.md