139 lines
4.2 KiB
JavaScript
139 lines
4.2 KiB
JavaScript
import { createReadStream, createWriteStream } from "node:fs";
|
|
import { readdir, rename, rm, stat } from "node:fs/promises";
|
|
import path from "node:path";
|
|
import { spawn, spawnSync } from "node:child_process";
|
|
|
|
const DAY_MS = 24 * 60 * 60 * 1000;
|
|
const SCHEDULED_BACKUP = /^scheduled-\d{8}T\d{6}Z-\d+\.dump$/;
|
|
|
|
/**
|
|
* 定时备份文件名包含 UTC 秒级时间和进程号,避免同一秒内重复执行时覆盖已有备份。
|
|
*/
|
|
export function scheduledBackupName(date = new Date(), pid = process.pid) {
|
|
const stamp = date
|
|
.toISOString()
|
|
.replace(/[-:]/g, "")
|
|
.replace(/\.\d{3}Z$/, "Z");
|
|
if (!/^\d{8}T\d{6}Z$/.test(stamp)) throw new Error("Invalid backup timestamp");
|
|
return `scheduled-${stamp}-${pid}.dump`;
|
|
}
|
|
|
|
/**
|
|
* 保留策略:
|
|
* - 发布前备份按文件名保留最近 7 份,保持原有发布回滚能力;
|
|
* - 定时备份按修改时间保留最近 retentionDays 天;
|
|
* - 同名临时文件由 pruneBackups 统一清理。
|
|
*/
|
|
export function selectExpiredBackups(
|
|
entries,
|
|
{ now = Date.now(), retentionDays = 14, keepReleaseBackups = 7 } = {},
|
|
) {
|
|
if (!Number.isInteger(retentionDays) || retentionDays < 1) {
|
|
throw new Error("retentionDays must be a positive integer");
|
|
}
|
|
if (!Number.isInteger(keepReleaseBackups) || keepReleaseBackups < 1) {
|
|
throw new Error("keepReleaseBackups must be a positive integer");
|
|
}
|
|
|
|
const cutoff = now - retentionDays * DAY_MS;
|
|
const expired = [];
|
|
const releaseBackups = entries
|
|
.filter((entry) => entry.name.endsWith(".dump") && !SCHEDULED_BACKUP.test(entry.name))
|
|
.sort((left, right) => right.name.localeCompare(left.name));
|
|
|
|
for (const entry of releaseBackups.slice(keepReleaseBackups)) expired.push(entry.name);
|
|
for (const entry of entries) {
|
|
if (SCHEDULED_BACKUP.test(entry.name) && entry.mtimeMs < cutoff) expired.push(entry.name);
|
|
}
|
|
|
|
return [...new Set(expired)];
|
|
}
|
|
|
|
export async function backupPostgresDatabase({
|
|
container,
|
|
destination,
|
|
docker = "docker",
|
|
env = process.env,
|
|
}) {
|
|
const temporary = destination + ".tmp";
|
|
const child = spawn(
|
|
docker,
|
|
["exec", container, "sh", "-c", 'exec pg_dump -Fc -U "$POSTGRES_USER" -d "$POSTGRES_DB"'],
|
|
{ stdio: ["ignore", "pipe", "inherit"], env },
|
|
);
|
|
const output = createWriteStream(temporary, { flags: "wx", mode: 0o600 });
|
|
child.stdout.pipe(output);
|
|
try {
|
|
await Promise.all([
|
|
new Promise((resolve, reject) => {
|
|
child.on("error", reject);
|
|
child.on("exit", (code) =>
|
|
code === 0 ? resolve() : reject(new Error("Database backup failed")),
|
|
);
|
|
}),
|
|
new Promise((resolve, reject) => {
|
|
output.on("finish", resolve);
|
|
output.on("error", reject);
|
|
}),
|
|
]);
|
|
await rename(temporary, destination);
|
|
} catch (error) {
|
|
child.kill("SIGTERM");
|
|
output.destroy();
|
|
await rm(temporary, { force: true });
|
|
throw error;
|
|
}
|
|
}
|
|
|
|
export async function verifyPostgresBackup({
|
|
container,
|
|
file,
|
|
docker = "docker",
|
|
env = process.env,
|
|
}) {
|
|
const child = spawn(docker, ["exec", "-i", container, "pg_restore", "-l"], {
|
|
stdio: ["pipe", "ignore", "pipe"],
|
|
env,
|
|
});
|
|
const input = createReadStream(file);
|
|
let stderr = "";
|
|
child.stderr.setEncoding("utf8");
|
|
child.stderr.on("data", (chunk) => {
|
|
stderr += chunk;
|
|
});
|
|
input.pipe(child.stdin);
|
|
|
|
try {
|
|
await new Promise((resolve, reject) => {
|
|
child.on("error", reject);
|
|
input.on("error", reject);
|
|
child.stdin.on("error", (error) => {
|
|
if (error.code !== "EPIPE") reject(error);
|
|
});
|
|
child.on("exit", (code) => {
|
|
if (code === 0) resolve();
|
|
else reject(new Error(`Backup is not readable: ${stderr.trim() || "pg_restore failed"}`));
|
|
});
|
|
});
|
|
} finally {
|
|
input.destroy();
|
|
}
|
|
}
|
|
|
|
export async function pruneBackups(directory, options = {}) {
|
|
const entries = await readdir(directory);
|
|
const withStats = [];
|
|
for (const name of entries) {
|
|
const info = await stat(path.join(directory, name));
|
|
if (!info.isFile()) continue;
|
|
withStats.push({ name, mtimeMs: info.mtimeMs });
|
|
}
|
|
|
|
for (const name of selectExpiredBackups(withStats, options)) {
|
|
await rm(path.join(directory, name));
|
|
}
|
|
for (const name of entries) {
|
|
if (name.endsWith(".dump.tmp")) await rm(path.join(directory, name), { force: true });
|
|
}
|
|
}
|