devops/deploy-flyio

Fly.io 部署

适用场景

• Docker 化后端服务：任意语言（Node.js、Python、Go、Java、Rust、Elixir）
• 全球边缘部署：需要低延迟、靠近用户的后端
• 有状态服务：需要持久化存储（Volumes）
• 托管 PostgreSQL：Fly Postgres
• 后台 Worker / Cron Job：Machines 模式

前置条件

1. 安装 flyctl CLI：

   # macOS
   brew install flyctl
   # Windows（PowerShell）
   iwr https://fly.io/install.ps1 -useb | iex
   # Linux 及其他平台请参考 fly.io 官方文档安装 flyctl
   

2. 登录 Fly.io：fly auth login（需要用户交互完成授权）

3. 验证登录：fly auth whoami

部署流程

1. 准备 Dockerfile

Fly.io 是 Docker 优先的平台，项目必须有 Dockerfile。

多阶段构建示例（Node.js）：

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/package*.json ./
RUN npm ci --omit=dev
ENV NODE_ENV=production
EXPOSE 3000
CMD ["node", "dist/server.js"]

Python 示例：

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Go 示例：

FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o server .

FROM alpine:latest
WORKDIR /app
COPY --from=builder /app/server .
EXPOSE 8080
CMD ["./server"]

2. 初始化 Fly 应用

# 交互式初始化（会生成 fly.toml）
fly launch

# 非交互式初始化
fly launch --name my-api --region iad --no-deploy

fly launch 会自动检测 Dockerfile 并生成 fly.toml 配置。

3. fly.toml 配置

app = "my-api"
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

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

  [http_service.concurrency]
    type = "requests"
    soft_limit = 200
    hard_limit = 400

[[vm]]
  memory = "256mb"
  cpu_kind = "shared"
  cpus = 1

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

# 健康检查
[http_service.checks]
  [http_service.checks.health]
    path = "/health"
    interval = "30s"
    timeout = "5s"
    grace_period = "10s"