CHORE - DEPLOY: deterministic BIM and Tasker CAD artifacts

This commit is contained in:
Codex
2026-07-29 17:58:11 +03:00
parent a3308c9b3d
commit 9d8638b8d2
2 changed files with 225 additions and 0 deletions
@@ -0,0 +1,120 @@
#!/usr/bin/env node
import { createHash } from "node:crypto";
import { spawnSync } from "node:child_process";
import { cp, lstat, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";
const scriptDir = dirname(fileURLToPath(import.meta.url));
const platformRoot = resolve(scriptDir, "../..");
const bimRoot = resolve(process.env.NODEDC_BIM_VIEWER_ROOT || resolve(platformRoot, "../NODEDC_BIM_VIEWER"));
const taskerRoot = resolve(
process.env.NODEDC_TASKMANAGER_ROOT || resolve(platformRoot, "../../data/dc_taskmanager/NODEDC_TASKMANAGER"),
);
const artifactDir = resolve(process.env.NODEDC_DEPLOY_ARTIFACT_DIR || resolve(scriptDir, "../deploy-artifacts"));
const [release = "20260729-001", ...extra] = process.argv.slice(2);
if (extra.length || !/^\d{8}-\d{3}$/.test(release)) {
throw new Error("usage: build-bim-tasker-cad-ops-artifacts.mjs [YYYYMMDD-NNN]");
}
const descriptors = [
{
artifactBasename: `nodedc-bim-viewer-cad-ops-${release}.tgz`,
component: "bim-viewer",
files: [
"converter/worker.py",
"server/cad-formats.js",
"server/index.js",
],
patchId: `bim-viewer-cad-ops-${release}`,
sourceRoot: bimRoot,
},
{
artifactBasename: `nodedc-tasker-cad-ops-${release}.tgz`,
component: "tasker",
files: [
"plane-src/apps/web/helpers/beam-viewer-config.ts",
"plane-src/apps/web/helpers/beam-viewer.ts",
],
patchId: `tasker-cad-ops-${release}`,
sourceRoot: taskerRoot,
},
];
await mkdir(artifactDir, { recursive: true });
const artifacts = [];
for (const descriptor of descriptors) {
const sourceCommit = gitOutput(descriptor.sourceRoot, ["rev-parse", "HEAD"]);
const sourceStatus = gitOutput(descriptor.sourceRoot, ["status", "--porcelain"]);
if (sourceStatus) throw new Error(`source_worktree_not_clean:${descriptor.component}`);
const stage = await mkdtemp(join(tmpdir(), `nodedc-${descriptor.component}-cad-ops-`));
const payload = join(stage, "payload");
const artifact = join(artifactDir, descriptor.artifactBasename);
try {
await mkdir(payload, { recursive: true });
for (const relativePath of descriptor.files) {
const source = resolve(descriptor.sourceRoot, relativePath);
const sourceStat = await lstat(source);
if (!sourceStat.isFile() || sourceStat.isSymbolicLink()) {
throw new Error(`source_file_rejected:${descriptor.component}:${relativePath}`);
}
const destination = join(payload, relativePath);
await mkdir(dirname(destination), { recursive: true });
await cp(source, destination, { force: true, verbatimSymlinks: true });
}
await writeFile(
join(stage, "manifest.env"),
`id=${descriptor.patchId}\ncomponent=${descriptor.component}\ntype=app-overlay\n`,
"utf8",
);
await writeFile(join(stage, "files.txt"), `${descriptor.files.join("\n")}\n`, "utf8");
const tar = spawnSync("python3", ["-c", canonicalTarScript(), artifact, stage], {
encoding: "utf8",
maxBuffer: 128 * 1024 * 1024,
});
if (tar.status !== 0) throw new Error(`tar_failed:${descriptor.component}:${tar.stderr || tar.stdout}`);
const sha256 = createHash("sha256").update(await readFile(artifact)).digest("hex");
artifacts.push({
artifact,
component: descriptor.component,
files: descriptor.files,
patchId: descriptor.patchId,
sha256,
sourceCommit,
});
} finally {
await rm(stage, { recursive: true, force: true });
}
}
console.log(JSON.stringify({ ok: true, release, artifacts }, null, 2));
function gitOutput(cwd, args) {
const result = spawnSync("git", args, { cwd, encoding: "utf8" });
if (result.status !== 0) throw new Error(`git_failed:${cwd}:${args.join("_")}:${result.stderr || result.stdout}`);
return result.stdout.trim();
}
function canonicalTarScript() {
return [
"import gzip,io,pathlib,sys,tarfile",
"root=pathlib.Path(sys.argv[2])",
"with open(sys.argv[1],'wb') as out:",
" with gzip.GzipFile(filename='',mode='wb',fileobj=out,compresslevel=9,mtime=0) as gz:",
" with tarfile.open(fileobj=gz,mode='w',format=tarfile.PAX_FORMAT) as tar:",
" for top in ('manifest.env','files.txt','payload'):",
" p=root/top; paths=[p]+(sorted(p.rglob('*')) if p.is_dir() else [])",
" for x in paths:",
" info=tar.gettarinfo(str(x),arcname=x.relative_to(root).as_posix())",
" info.uid=info.gid=0; info.uname=info.gname='root'; info.mtime=0; info.mode=0o755 if info.isdir() else 0o644",
" with (open(x,'rb') if info.isfile() else io.BytesIO()) as src: tar.addfile(info,src if info.isfile() else None)",
].join("\n");
}
@@ -0,0 +1,105 @@
#!/usr/bin/env python3
import hashlib
import json
import os
import subprocess
import tarfile
import tempfile
import unittest
from pathlib import Path
SCRIPT_DIR = Path(__file__).resolve().parent
BUILDER = SCRIPT_DIR / "build-bim-tasker-cad-ops-artifacts.mjs"
EXPECTED = {
"bim-viewer": {
"files": [
"converter/worker.py",
"server/cad-formats.js",
"server/index.js",
],
"manifest": (
"id=bim-viewer-cad-ops-20990101-001\n"
"component=bim-viewer\n"
"type=app-overlay\n"
),
},
"tasker": {
"files": [
"plane-src/apps/web/helpers/beam-viewer-config.ts",
"plane-src/apps/web/helpers/beam-viewer.ts",
],
"manifest": (
"id=tasker-cad-ops-20990101-001\n"
"component=tasker\n"
"type=app-overlay\n"
),
},
}
class BimTaskerCadOpsArtifactsTest(unittest.TestCase):
def build(self, artifact_dir: Path) -> dict:
environment = os.environ.copy()
environment["NODEDC_DEPLOY_ARTIFACT_DIR"] = str(artifact_dir)
result = subprocess.run(
["node", str(BUILDER), "20990101-001"],
check=True,
capture_output=True,
text=True,
env=environment,
)
return json.loads(result.stdout)
def test_artifacts_are_exact_deterministic_and_runtime_only(self) -> None:
with (
tempfile.TemporaryDirectory(prefix="nodedc-cad-ops-first-") as first_dir,
tempfile.TemporaryDirectory(prefix="nodedc-cad-ops-second-") as second_dir,
):
first = self.build(Path(first_dir))
second = self.build(Path(second_dir))
first_by_component = {item["component"]: item for item in first["artifacts"]}
second_by_component = {item["component"]: item for item in second["artifacts"]}
self.assertEqual(set(first_by_component), set(EXPECTED))
self.assertEqual(set(second_by_component), set(EXPECTED))
for component, contract in EXPECTED.items():
first_item = first_by_component[component]
second_item = second_by_component[component]
first_bytes = Path(first_item["artifact"]).read_bytes()
second_bytes = Path(second_item["artifact"]).read_bytes()
self.assertEqual(first_bytes, second_bytes)
self.assertEqual(first_item["sha256"], hashlib.sha256(first_bytes).hexdigest())
self.assertEqual(first_item["files"], contract["files"])
self.assertRegex(first_item["sourceCommit"], r"^[0-9a-f]{40}$")
with tarfile.open(first_item["artifact"], "r:gz") as archive:
members = archive.getmembers()
names = [member.name for member in members]
self.assertEqual(
archive.extractfile("manifest.env").read().decode("utf-8"),
contract["manifest"],
)
self.assertEqual(
archive.extractfile("files.txt").read().decode("utf-8").splitlines(),
contract["files"],
)
self.assertEqual(names[:3], ["manifest.env", "files.txt", "payload"])
self.assertTrue(all(member.isfile() or member.isdir() for member in members))
self.assertFalse(any(member.issym() or member.islnk() for member in members))
self.assertFalse(any("test" in name.lower() for name in names))
self.assertFalse(
any(
name.startswith("payload/") and ("/.env" in name or name.endswith(".env"))
for name in names
)
)
self.assertFalse(any(name.startswith("._") or "/._" in name for name in names))
if __name__ == "__main__":
unittest.main()