Create a new project
Create project folder
bash scripts/create-project.sh my-project
Add a playbook + create its env file
cd projects/my-project
echo "ec2-deploy" >> PLAYBOOKS
cp ../../playbooks/ec2-deploy/.env.example .env.ec2-deploy
# edit .env.ec2-deploy
Run a playbook for a project
cd playbooks/ec2-deploy
./run.sh --extra-vars "projects=my-project"
postgres-dump-restore (example)
cd playbooks/postgres-dump-restore
./run.sh --project my-project --tags dump
Most playbooks use ./run.sh --project <project>. ec2-deploy uses --extra-vars "projects=...".
Create a new playbook
cp -r playbooks/.template playbooks/my-new-playbook
Edit the new playbook
cd playbooks/my-new-playbook
# edit README.md, playbook.yml, inventory.yml, run.sh, .env.example
Template run.sh already supports central projects/ env loading.
Dashboard / auditing
Start local dashboard server (WSL)
./tools/local-ui/run-server.sh
Export report.json (WSL)
bash scripts/export-local-ui-data.sh
Audit projects (missing envs / unknown playbooks)
bash scripts/audit-projects.sh