devops/deploy-render

Render 部署

适用场景

• 全栈 Web 应用：Node.js、Python、Go、Ruby、Rust 后端 + 数据库
• 静态站点：前端 SPA、文档站点
• 后台 Worker：异步任务处理、定时任务
• Docker 化应用：通过 Dockerfile 部署任意语言应用
• 需要托管 PostgreSQL/Redis 的场景

前置条件

1. Render 账号：https://render.com
2. 安装 Render CLI（可选，主要通过 render.yaml 蓝图管理）
3. 项目代码托管在 GitHub/GitLab/Bitbucket（Render 通过 Git 集成部署）

部署方式

Render 支持两种部署方式：

1. render.yaml 蓝图（推荐）：基础设施即代码，一键创建所有服务和数据库
2. Dashboard 手动创建：通过 Web 界面逐个创建服务

一、render.yaml 蓝图

render.yaml 放在项目根目录，定义所有基础设施。

完整示例（全栈应用）

services:
  # 前端静态站点
  - type: web
    name: my-frontend
    env: static
    buildCommand: npm ci && npm run build
    staticPublishPath: dist
    routes:
      - type: rewrite
        source: /*
        destination: /index.html

  # 后端 API 服务
  - type: web
    name: my-api
    env: node
    buildCommand: npm ci && npm run build
    startCommand: npm start
    healthCheckPath: /health
    envVars:
      - key: NODE_ENV
        value: production
      - key: DATABASE_URL
        fromDatabase:
          name: my-db
          property: connectionString
      - key: API_KEY
        sync: false # 需要在 Dashboard 手动设置

  # 后台 Worker
  - type: worker
    name: my-worker
    env: node
    buildCommand: npm ci
    startCommand: npm run worker
    envVars:
      - key: DATABASE_URL
        fromDatabase:
          name: my-db
          property: connectionString

databases:
  - name: my-db
    databaseName: myapp
    user: myapp
    plan: free # free | starter | standard | pro
    ipAllowList:
      - source: 0.0.0.0/0
        description: allow all (仅开发环境)

各类型服务配置

1. 静态站点

services:
  - type: web
    name: my-site
    env: static
    buildCommand: npm run build
    staticPublishPath: dist
    headers:
      - path: /*
        name: X-Frame-Options
        value: DENY

2. Node.js Web 服务

services:
  - type: web
    name: my-api
    env: node
    plan: standard
    buildCommand: npm ci && npm run build
    startCommand: node dist/server.js
    healthCheckPath: /health
    autoDeploy: true
    branch: main
    numInstances: 1