Fly.io Deployment Patterns

Fly.io déploie des containers Docker dans 35+ régions à travers le monde via des micro-VMs (Fly Machines). Idéal pour les backends latency-sensitive ou multi-region.

1. Setup initial

# Install CLI
curl -L https://fly.io/install.sh | sh

# Login
fly auth login

# Launch un projet (interactive, crée fly.toml)
cd my-app
fly launch

fly.toml

app = "my-app"
primary_region = "cdg"

[build]

[env]
  PORT = "8080"
  NODE_ENV = "production"

[http_service]
  internal_port = 8080
  force_https = true
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 1
  processes = ["app"]

[[services]]
  protocol = "tcp"
  internal_port = 8080

  [[services.ports]]
    port = 80
    handlers = ["http"]
    force_https = true

  [[services.ports]]
    port = 443
    handlers = ["tls", "http"]

[[vm]]
  cpu_kind = "shared"
  cpus = 1
  memory_mb = 512

2. Dockerfile optimisé

FROM node:20-alpine AS base

FROM base AS deps
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile --prod

FROM base AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build

FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=deps /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/package.json ./package.json
EXPOSE 8080
CMD ["node", "dist/index.js"]

Multi-stage build = image finale plus petite = cold start plus rapide.

3. Multi-region deployment

# Ajouter des régions
fly regions add fra sjc syd

# Scale une app sur N machines par région
fly scale count 2 --region cdg
fly scale count 1 --region sjc

Fly répartit automatiquement le traffic vers la région la plus proche de chaque user via anycast.

4. Fly Postgres (managed HA cluster)

# Créer un cluster Postgres
fly postgres create --name my-app-db --region cdg --initial-cluster-size 2

# Attacher à l'app
fly postgres attach my-app-db --app my-app
# Injecte DATABASE_URL automatiquement

Fly Postgres est basé sur stolon pour la HA. Inclut :

• Primary + replicas automatiques
• Backups snapshot
• Failover automatique
• Read replicas en multi-region

5. Fly Volumes

# Créer un volume NVMe
fly volumes create data --region cdg --size 10

# Mount dans fly.toml
[mounts]
  source = "data"
  destination = "/data"

Limite : un volume = une machine. Pour du shared storage, utiliser Fly Object Storage (compatible S3) ou R2.

6. Private networking (6PN)

Tous les services d'une même org Fly sont sur un réseau privé IPv6 (.internal DNS).

// Depuis une app
const redis = 'redis://my-redis.internal:6379'
const db = 'postgres://my-app-db.internal:5432/db'

7. Secrets

# Ajouter un secret (chiffré)
fly secrets set STRIPE_SECRET_KEY=sk_live_xxx

# Liste
fly secrets list

# Remove
fly secrets unset OLD_KEY

Secrets injectés comme env vars au runtime, jamais en clair dans les logs.

8. Custom domains

# Ajouter un domaine
fly certs add example.com

# Instructions DNS affichées — ajouter un A/AAAA record
# SSL provisionné automatiquement via Let's Encrypt

9. Health checks

[[services.http_checks]]
  interval = "30s"
  timeout = "5s"
  grace_period = "10s"
  method = "GET"
  path = "/health"
  protocol = "http"
  restart_limit = 0

Endpoint /health minimal :

app.get('/health', async (req, res) => {
  // Vérif DB
  try {
    await db.raw('SELECT 1')
  } catch {
    return res.status(503).json({ status: 'db down' })
  }
  res.json({ status: 'ok', uptime: process.uptime() })
})

10. Release commands

Exécuter une commande une fois avant chaque déploiement (ex. migrations) :

[deploy]
  release_command = "node dist/scripts/migrate.js"

Fly lance une machine temporaire qui exécute le command, et n'active le deploy que si exit 0.

11. Scaling

Horizontal (plus de machines)

fly scale count 4 --region cdg
fly scale count 2 --region fra

Vertical (plus de CPU/RAM)

fly scale vm performance-2x  # 2 CPU, 4 GB RAM
fly scale memory 2048         # augmenter juste la RAM

Liste des VMs disponibles : fly platform vm-sizes

Anti-patterns

1. Region unique sans raison → utiliser au moins 2 régions pour l'HA
2. Secrets dans fly.toml → toujours via fly secrets set
3. Dockerfile non multi-stage → images trop grosses, cold start lent
4. Health check sur / → touche des routes lourdes, timeout facile
5. Pas de auto_stop_machines sur les apps à faible trafic → facture cher
6. Volumes non backupés → snapshot Fly uniquement, pas de cross-region
7. Postgres single-instance en prod → perte de données possible, toujours cluster de ≥ 2

Pricing

• Trial : $5/mo de crédit
• Pay-as-you-go à la seconde : CPU + RAM + storage + network egress
• Un budget typique app Node.js + Postgres : ~10-30 $/mo

Checklist deploy Fly

• fly.toml committé
• Dockerfile multi-stage
• primary_region défini + régions supplémentaires si multi-region
• Fly Postgres provisionné en cluster (≥ 2 instances)
• Secrets via fly secrets set
• Health check sur endpoint dédié
• Release command pour les migrations
• Custom domain + SSL
• Scaling ajusté à la charge (auto_stop si faible trafic)
• Monitoring via Fly Metrics ou Prometheus

Quand déléguer

• Frontend simple → deploy-vercel
• Backend simple sans Docker → deploy-railway
• Edge computing → deploy-cloudflare
• Docker registries → deploy-docker-registries

Ressources

• https://fly.io/docs/
• https://fly.io/docs/reference/configuration/
• https://fly.io/docs/postgres/
• https://fly.io/docs/apps/volume-storage/