Agent skill

fly

Deploy and manage the photography portfolio backend on fly.io. Use when deploying the app, checking logs, checking status, scaling machines, or managing the fly.io deployment.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/fly

SKILL.md

Fly.io Management

This skill helps manage the photography portfolio backend deployment on fly.io.

App Information

  • App name: photography-portfolio-solitary-fire-836
  • Region: sjc (San Jose, California)
  • Backend directory: backend/

Common Commands

Deploy

Deploy the backend to fly.io:

bash
cd backend && fly deploy

For a faster deployment without building (if image is already pushed):

bash
cd backend && fly deploy --no-cache

View Logs

Get real-time logs from the deployed app:

bash
fly logs -a photography-portfolio-solitary-fire-836

Tail logs continuously:

bash
fly logs -a photography-portfolio-solitary-fire-836 -f

Check Status

Check app status and running machines:

bash
fly status -a photography-portfolio-solitary-fire-836

List all machines:

bash
fly machines list -a photography-portfolio-solitary-fire-836

SSH into Machine

Open SSH session to the running machine:

bash
fly ssh console -a photography-portfolio-solitary-fire-836

Execute a single command:

bash
fly ssh console -a photography-portfolio-solitary-fire-836 -C "command here"

Scaling

Scale memory:

bash
fly scale memory 512 -a photography-portfolio-solitary-fire-836

Scale VM count:

bash
fly scale count 1 -a photography-portfolio-solitary-fire-836

Secrets Management

List secrets:

bash
fly secrets list -a photography-portfolio-solitary-fire-836

Set a secret:

bash
fly secrets set SECRET_NAME=value -a photography-portfolio-solitary-fire-836

Troubleshooting

Check recent events:

bash
fly logs -a photography-portfolio-solitary-fire-836 --tail 100

Restart the app:

bash
fly apps restart photography-portfolio-solitary-fire-836

Get machine details:

bash
fly machine status <machine-id> -a photography-portfolio-solitary-fire-836

Deployment Checklist

When deploying:

  1. Ensure you're in the backend/ directory
  2. Check that all secrets are set (if needed)
  3. Run fly deploy
  4. Monitor logs with fly logs -f to verify successful startup
  5. Check status with fly status to confirm machines are running

Notes

  • The app uses auto-stop/auto-start machines (min_machines_running = 0)
  • Backend runs on port 5001
  • Uses CDN mode (USE_CDN = 'true')
  • Photos directory is /app/photos

Didn't find tool you were looking for?

Be as detailed as possible for better results