coolify-deploy

默认输出：仅返回结果、阻碍事项和所需证据。省略开场白、过程叙述、重复的上下文、置信度评分和后续跟进提议。除非必需的产物或架构需要更多内容，否则最多使用五个项目符号。

Coolify 部署技能

系统化方法

项目类型

静态网站（Astro、Svelte、Hugo、Jekyll）

Build Command: [your build tool] build
Output Directory: dist (or public, _site, build — check your framework)

应用容器（任意运行时）

Build Command: [install dependencies] && [build]
Start Command: [your runtime] [entry point]
Port: [your app port]

按语言分类的示例：

• Node.js：npm run build / node dist/index.js
• Python：pip install -r requirements.txt / uvicorn app.main:app
• Go：go build -o app / ./app
• Rust：cargo build --release / ./target/release/app

基于 Docker 的应用

Dockerfile: ./Dockerfile
Port: [your container port]

部署检查清单

部署前

• 所有测试均在本地通过
• 已在 Coolify 控制面板中配置环境变量
• 已验证健康检查端点（/health）
• 已检查数据库迁移（如适用）
• 已记录回滚计划

部署期间

• 构建成功且没有错误
• 部署后健康检查通过
• 日志中没有错误激增
• 响应时间处于正常范围

部署后

• 对关键路径进行冒烟测试
• 监控错误率 15 分钟
• 验证数据库迁移已完成
• 更新部署日志

环境变量

在 Coolify 控制面板的 Environment Variables 下设置这些变量：

ENVIRONMENT=production
PORT=3000
DATABASE_URL=postgresql://user:pass@host:5432/dbname
# Add your app-specific variables

健康检查设置

在应用中添加 /health 端点。按语言分类的示例：

Python（Flask）：

@app.route('/health')
def health():
    return jsonify(status='ok', timestamp=datetime.utcnow().isoformat())

Go：

http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
    json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
})

Node.js（Express）：

app.get('/health', (req, res) => {
  res.status(200).json({ status: 'ok' });
});

在 Coolify 中配置：

• 健康检查 URL：/health
• 健康检查间隔：30 秒

Nixpacks 配置

如需自动检测构建配置，请添加 nixpacks.toml。Coolify 会自动检测大多数运行时，但你也可以自定义：

[phases.setup]
nixPkgs = ["<your-runtime-package>"]

[phases.install]
cmds = ["<install-command>"]

[phases.build]
cmds = ["<build-command>"]

[start]
cmd = "<start-command>"

请查阅 Nixpacks 文档，了解特定运行时的相关信息。

回滚

如果部署失败：

1. 在 Coolify 控制面板中，前往 Deployments
2. 找到上一个正常运行的部署
3. 在正常运行的版本上点击“Redeploy”
4. 验证健康检查通过

也可以通过 CLI 操作：

coolify deployments redeploy --applicationUuid "app-uuid" --deploymentUuid "last-good-deployment-uuid"

反合理化对照表

借口	反驳
“我会跳过部署前检查清单，这只是个小改动”	小改动也会导致生产环境故障。检查清单能发现那些假设忽略的问题。
“健康检查是可选的”	没有健康检查，就无法验证部署是否成功。
“我会在部署后配置环境变量”	缺少环境变量会导致启动失败。请在部署前配置好它们。
“回滚太复杂了，如果出问题我会直接修复”	在压力下直接修复，比干净利落地回滚风险更高。
“部署后我不需要监控”	部署后的前 15 分钟最容易暴露问题。请积极监控。