TECHNICAL REFERENCE
带数据库和 worker 的应用
在 DeployVera 上同时运行 Web 应用、PostgreSQL 和后台 worker:可复制的分步示例。
支持什么
支持:托管 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。