aws-deploy-cli

Interactive CLI for deploying full-stack applications to AWS — from VPC to running app in minutes.

Guides you step-by-step through provisioning VPC, RDS, ElastiCache, S3, EC2, ALB, Secrets Manager, DNS, and deploying your application. No Terraform or CloudFormation knowledge required.

Install

npm install -g aws-deploy-cli

Or run directly:

npx aws-deploy-cli deploy

Prerequisites

• AWS CLI configured with at least one profile (aws configure)
• bash — native on Linux/macOS, Git Bash or WSL on Windows
• Node.js >= 14

Usage

# Full interactive deployment
aws-deploy deploy

# Quick redeploy (pull latest code, restart app)
aws-deploy redeploy

# Help
aws-deploy help

What deploy Does

Launches an interactive wizard with dependency-aware steps:

| Step | Resource | What it does | |------|----------|--------------| | 0 | Intro | Project name, DB engine, port, git repo | | 1 | VPC | Select or create VPC with subnets | | 2 | RDS | PostgreSQL or MySQL instance | | 3 | ElastiCache | Redis cluster | | 4 | S3 | Bucket creation | | 5 | EC2 | Instance provisioning | | 6 | ALB | Application Load Balancer | | 7 | Secrets | AWS Secrets Manager setup | | 8 | Bastion | SSH bastion host | | 9 | DNS | Route 53 configuration | | 10 | Deploy App | Clone repo, install deps, start app |

You can skip steps — the CLI warns if a dependent step is missing.

What redeploy Does

Uses saved project config to SSH into your EC2 instances, pull latest code, and restart the application. No infrastructure changes.

Configuration

Configs are persisted locally after first deployment:

• aws/.deploy-projects/ — project settings (name, region, instance IDs)
• aws/.deploy-env/ — cached environment variables

Cross-Platform

Both bash (.sh) and PowerShell (.ps1) scripts are included. The CLI uses bash by default — on Windows, use Git Bash or WSL.

License

MIT