DeployVeraDocs

TECHNICAL REFERENCE

带数据库和 worker 的应用

在 DeployVera 上同时运行 Web 应用、PostgreSQL 和后台 worker:可复制的分步示例。

Last reviewed: Markdown

支持什么

支持:托管 PostgreSQL、后台 worker 和 Web 应用可以在同一个服务中一起运行。面板默认不运行 Docker Compose 多服务部署,每个服务都是一个独立的应用。

价格和配额请查看实时套餐:https://deployvera.com/docker。免费套餐包含 1 个应用名额;Web 应用和 worker 是两个应用,因此至少需要 2 个名额。数据库计入单独的配额。

  • Web 应用:对外公开的应用(访问模式“公开”)。
  • Worker:第二个应用,访问模式为“仅内部网络”。同一服务中的应用和数据库可通过 http://dv-xxxx:PORT 这样的内部地址访问它。Worker 从数据库的表中领取任务,因此不需要外部地址。
  • 数据库:在“数据库”页面创建托管 PostgreSQL,并在面板中复制其连接地址。
  • 环境变量按应用分别设置,所以 DATABASE_URL 要加到两个应用中。
  • 日志在各应用页面的“容器日志”部分分别查看。

仓库:package.json

Web 和 worker 放在同一个仓库中。本指南中的所有文件都位于仓库根目录(package.json、Dockerfile、src/)。

{
  "name": "web-worker-example",
  "private": true,
  "type": "module",
  "dependencies": { "pg": "^8.13.0" }
}

仓库:src/db.js

连接池以及基于数据表的任务队列结构。两个应用启动时都会调用它,表不存在时自动创建。

import pg from "pg";

export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL, max: 5 });
export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

// Web and worker both call this at startup; the advisory lock makes it safe to run concurrently.
export async function migrate() {
  for (let attempt = 1; ; attempt++) {
    let client;
    try {
      client = await pool.connect();
      await client.query("SELECT pg_advisory_lock(727001)");
      await client.query(`CREATE TABLE IF NOT EXISTS jobs (
        id BIGSERIAL PRIMARY KEY,
        payload JSONB NOT NULL,
        status TEXT NOT NULL DEFAULT 'pending',
        error TEXT,
        created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
        finished_at TIMESTAMPTZ
      )`);
      await client.query("SELECT pg_advisory_unlock(727001)");
      return;
    } catch (error) {
      console.error(`migrate attempt ${attempt} failed: ${error.message}`);
      if (attempt >= 10) throw error;
      await sleep(3000);
    } finally {
      client?.release();
    }
  }
}

仓库:src/web.js

import http from "node:http";
import { pool, migrate } from "./db.js";

await migrate();

const json = (res, status, body) => {
  res.writeHead(status, { "content-type": "application/json" });
  res.end(JSON.stringify(body));
};

const server = http.createServer(async (req, res) => {
  try {
    if (req.method === "POST" && req.url === "/jobs") {
      const { rows } = await pool.query(
        "INSERT INTO jobs (payload) VALUES ($1) RETURNING id",
        [JSON.stringify({ queuedAt: new Date().toISOString() })],
      );
      return json(res, 202, rows[0]);
    }
    if (req.url === "/jobs") {
      const { rows } = await pool.query(
        "SELECT id, status, error, created_at, finished_at FROM jobs ORDER BY id DESC LIMIT 20",
      );
      return json(res, 200, rows);
    }
    json(res, 200, { ok: true });
  } catch (error) {
    console.error(error);
    json(res, 500, { error: "internal" });
  }
});

server.listen(Number(process.env.PORT || 3000), "0.0.0.0", () => console.log("web listening"));
process.on("SIGTERM", () => server.close(() => process.exit(0)));

仓库:src/worker.js

import http from "node:http";
import { pool, migrate, sleep } from "./db.js";

await migrate();

// The panel asks for a port on every application, so the worker answers on it too.
http.createServer((_req, res) => res.end("worker ok"))
  .listen(Number(process.env.PORT || 3000), "0.0.0.0");

let running = true;
process.on("SIGTERM", () => { running = false; });

// SKIP LOCKED lets several worker copies take different jobs without double processing.
async function claim() {
  const { rows } = await pool.query(`UPDATE jobs SET status = 'running'
    WHERE id = (SELECT id FROM jobs WHERE status = 'pending' ORDER BY id FOR UPDATE SKIP LOCKED LIMIT 1)
    RETURNING id, payload`);
  return rows[0];
}

while (running) {
  let job;
  try { job = await claim(); } catch (error) { console.error("claim failed:", error.message); }
  if (!job) { await sleep(2000); continue; }
  try {
    console.log(`job ${job.id} started`);
    await sleep(1000); // your real work goes here
    await pool.query("UPDATE jobs SET status = 'done', finished_at = now() WHERE id = $1", [job.id]);
    console.log(`job ${job.id} done`);
  } catch (error) {
    console.error(`job ${job.id} failed:`, error.message);
    await pool.query("UPDATE jobs SET status = 'failed', error = $2, finished_at = now() WHERE id = $1", [job.id, String(error.message)]);
  }
}
process.exit(0);

Dockerfile

FROM node:22-slim
WORKDIR /app
COPY package.json ./
RUN npm install --omit=dev
COPY src ./src
# The web app uses this default; the worker application sets APP_ROLE=worker in its environment variables.
ENV APP_ROLE=web
CMD ["sh", "-c", "exec node src/${APP_ROLE}.js"]

1. 创建数据库

在面板中打开“数据库”页面,选择 PostgreSQL,并为您的服务创建数据库。运行后复制连接地址。地址形如 postgres://user:password@dv-...,是内部地址,只有同一服务中的应用才能访问。

不要把该地址提交到仓库;在后续步骤中把它作为环境变量填写。

2. 部署 Web 应用

在新建应用向导中选择仓库和分支,构建方式选 Dockerfile,端口填 3000,访问模式保持“公开”。

在高级设置中添加环境变量 DATABASE_URL(第 1 步复制的地址)。Dockerfile 默认 APP_ROLE=web,无需其他变量。启动部署;上线后访问 Web 地址的 /jobs 会返回空列表。

如果想用“自动检测(Nixpacks)”代替 Dockerfile,请把 Web 应用的启动命令填为 node src/web.js,worker 填为 node src/worker.js;这时不再需要 Dockerfile 和 APP_ROLE。

3. 把 worker 部署为第二个应用

用同一个仓库创建第二个应用(同一服务、同一分支):构建方式 Dockerfile,端口 3000,访问模式“仅内部网络”。环境变量:相同的 DATABASE_URL 和 APP_ROLE=worker。

如果应用已存在,可在其详情页用“关闭公开访问”切换访问模式;该操作会让运行中的应用短暂重启。

Worker 通过 FOR UPDATE SKIP LOCKED 从 jobs 表领取任务,即使同时运行多个 worker 副本,同一任务也不会被领取两次。无需单独的队列产品。

4. 试用并查看日志

通过您的 Web 地址添加一个任务并列出任务。几秒内状态应从 pending 变为 done。

在各应用的详情页查看日志:Web 应用显示 web listening,worker 显示 job 1 started 和 job 1 done。构建出错时请查看对应应用的构建日志。

curl -X POST https://YOUR-WEB-ADDRESS/jobs
curl https://YOUR-WEB-ADDRESS/jobs

在 Claude Code 中“上线”

连接 DeployVera MCP 服务器后(安装说明:/docs/zh/mcp),可在仓库中发出类似下面的请求。

代理会用 create_project 创建每个应用(该操作总是需要您在浏览器中批准),用 set_env_vars 写入变量,用 deploy 和 get_build 跟踪构建,并用 get_build_logs 读取日志。创建数据库以及把 worker 的访问模式设为“仅内部网络”需要在面板中完成,代理不会代办这两步。

把这个仓库作为两个应用发布到 DeployVera:web 应用对外公开,worker 应用使用 APP_ROLE=worker 运行,两者使用同一个 DATABASE_URL。构建完成后分别读取每个应用的日志。

限制

面板不会原样运行 Docker Compose 文件;每个服务都是单独的应用。

服务器上可能关闭了构建目录和 Dockerfile 路径设置,因此示例使用根目录的单个 Dockerfile 和 APP_ROLE。请不要依赖子目录构建。

把同一仓库部署为两个应用会构建两次;资源由服务内所有应用共享。

这里的队列刻意保持简单:worker 崩溃后停留在 running 的任务,需要您自行加超时把它们改回 pending。

后续步骤

套餐和当前价格:https://deployvera.com/docker。