| name | fizz-production |
| description | Enables Copilot to SSH into the Fizz EC2 instance and manage Docker containers for the fyzz.dev production app. |
Fizz Production Management Skill
This skill enables you to manage the Fizz lead generation application running on AWS EC2.
Architecture Overview
Fizz is a Next.js application deployed on EC2 with the following components:
- fizz-app: Main Next.js web application (port 3000)
- fizz-postgres: PostgreSQL 16 database
- fizz-redis: Redis for rate limiting and caching
- fizz-caddy: Caddy reverse proxy with automatic HTTPS
- Workers: Background job processors
fizz-worker-discovery: Lead discovery
fizz-worker-screenshots: Website screenshots
fizz-worker-lighthouse: Performance analysis
fizz-worker-vision: AI vision analysis
fizz-worker-sections: Section extraction
fizz-worker-email: Email generation
fizz-worker-followup: Follow-up email handling
Using the FizzAws PowerShell Module
First, import the module:
Import-Module .\FizzAws.psm1
Common Operations
Connect to the server:
Connect-FizzServer
View container status:
Get-FizzContainers
Get-FizzHealth
View logs:
Get-FizzLogs -Container app -Tail 100
Get-FizzLogs -Container worker-discovery -Follow
Watch-FizzLogs # All containers
Debug errors:
Get-FizzErrors
Get-FizzStats
Restart containers:
Restart-FizzContainer -Container app
Invoke-FizzCompose -Action restart
Enter container shell:
Enter-FizzContainer -Container app
Enter-FizzContainer -Container postgres -Shell /bin/bash
Run commands in containers:
Invoke-FizzDocker -Container app -Command "npx prisma studio"
Invoke-FizzDocker -Container postgres -Command "psql -U fizz -d fizz"
Infrastructure Details
- Domain: fyzz.dev (Route53 managed)
- EC2: Ubuntu 22.04, t3.small
- RDS: PostgreSQL on db.t4g.micro
- Region: us-east-1
- SSH User: ubuntu
Debugging Checklist
When investigating production issues:
- Check container health:
Get-FizzHealth
- Look for errors:
Get-FizzErrors
- Check specific container logs:
Get-FizzLogs -Container <name>
- Verify database connectivity:
Test-FizzDatabase
- Check resource usage:
Get-FizzStats
- Review recent deployments in the fizz repository
Environment Variables
The app uses these key environment variables:
DATABASE_URL: PostgreSQL connection string
REDIS_URL: Redis connection string
ANTHROPIC_API_KEY: For AI features
SERPAPI_API_KEY: For search functionality
PAGESPEED_API_KEY: For Lighthouse analysis
AUTH_SECRET: Authentication secret
SMARTLEAD_API_KEY: For email campaigns