Files
pages/tools/ci/release-images.mjs
T
Anya Tokugawa b90aef79d0
Build and publish container images / images (push) Successful in 11m37s
Release container images / release (push) Successful in 22s
feat: add browser upload queue and trusted sessions with bounded projections
2026-11-08 20:27:04 +09:00

100 lines
5.0 KiB
JavaScript

import {spawnSync} from 'node:child_process';
import {pathToFileURL} from 'node:url';
export const images = ['pageswiki-app', 'pageswiki-adaptor-gateway', 'pageswiki-excalidraw-viewer', 'pageswiki-gecko-relay'];
// SemVer 2.0.0: numeric prerelease identifiers cannot have leading zeroes.
const number = '(0|[1-9][0-9]*)';
const identifier = '(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)';
const semver = new RegExp(`^${number}\\.${number}\\.${number}(?:-${identifier}(?:\\.${identifier})*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$`);
export function imageTag(ref) {
if (!ref.startsWith('refs/tags/v')) throw new Error('Release must run on a refs/tags/v… Git tag');
const tag = ref.slice('refs/tags/'.length);
if (!semver.test(tag.slice(1)) || /\s/.test(tag)) throw new Error(`Invalid SemVer 2.0.0 tag: ${tag}`);
// Gitea stores container tags case-insensitively; reject instead of silently
// collapsing distinct SemVer identifiers. '+' is not a Docker tag character.
if (/[A-Z]/.test(tag)) throw new Error('Release identifiers must be lowercase for the Gitea registry');
const result = tag.replace('+', '_');
if (result.length > 128) throw new Error('Container release tag exceeds 128 characters');
return result;
}
function run(command, args) {
const result = spawnSync(command, args, {encoding: 'utf8', timeout: 120000, maxBuffer: 4 * 1024 * 1024});
if (result.error) throw result.error;
if (result.status !== 0) throw new Error(`${command} failed: ${result.stderr.trim()}`);
return result.stdout.trim();
}
export function dockerClient(execute = run) {
function inspect(ref, field, optional = false) {
try {
return JSON.parse(execute('docker', ['buildx', 'imagetools', 'inspect', '--format', `{{json .${field}}}`, ref]));
} catch (error) {
// Only an explicit missing manifest is absence, never auth/TLS/timeouts.
if (optional && (error.message.endsWith(`ERROR: ${ref}: not found`) || /\bmanifest unknown\b/i.test(error.message))) return null;
throw error;
}
}
return {
digest(ref, optional = false) {
const manifest = inspect(ref, 'Manifest', optional);
if (manifest === null) return null;
if (!/^sha256:[0-9a-f]{64}$/.test(manifest.digest)) throw new Error(`Invalid registry digest: ${ref}`);
return manifest.digest;
},
revision(ref) {
const config = inspect(ref, 'Image');
if (config.os !== 'linux' || config.architecture !== 'amd64') throw new Error(`Expected linux/amd64 source: ${ref}`);
return config.config?.Labels?.['org.opencontainers.image.revision'];
},
copy(source, destination) {
execute('docker', ['buildx', 'imagetools', 'create', '--prefer-index=false', '--tag', destination, source]);
},
};
}
export function promote({ref, revision, prefix}, client = dockerClient(), log = console.log) {
const tag = imageTag(ref);
if (!/^[0-9a-f]{40}$/.test(revision)) throw new Error('Expected the release commit SHA');
if (!/^[a-z0-9][a-z0-9.-]*(?::[0-9]+)?\/[a-z0-9][a-z0-9_-]*$/.test(prefix)) throw new Error('Invalid registry/owner prefix');
// Resolve every source to a digest and check every destination before writes.
const plan = images.map(image => {
const repository = `${prefix}/${image}`;
const digest = client.digest(`${repository}:sha-${revision}`);
const source = `${repository}@${digest}`;
if (client.revision(source) !== revision) throw new Error(`Image revision does not match Git tag: ${image}`);
const destination = `${repository}:${tag}`;
const existing = client.digest(destination, true);
if (existing !== null && existing !== digest) throw new Error(`Refusing to overwrite released image: ${destination}`);
return {source, destination, digest};
});
for (const item of plan) {
// Recheck before writing. Registry tag protection/serialized releases are
// still required: the registry does not offer a portable compare-and-swap.
const existing = client.digest(item.destination, true);
if (existing !== null && existing !== item.digest) throw new Error(`Release changed concurrently: ${item.destination}`);
if (existing === null) client.copy(item.source, item.destination);
if (client.digest(item.destination) !== item.digest) throw new Error(`Promoted digest mismatch: ${item.destination}`);
log(`${item.destination} -> ${item.digest}`);
}
return plan;
}
if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
try {
const ref = process.env.RELEASE_REF || '';
const tag = imageTag(ref);
if (process.argv[2] === '--validate') {
console.log(`Release ${ref.slice('refs/tags/'.length)}; container tag ${tag}`);
} else if (process.argv.length !== 2) {
throw new Error('Usage: node tools/ci/release-images.mjs [--validate]');
} else {
promote({ref, revision: run('git', ['rev-parse', 'HEAD^{commit}']), prefix: `${process.env.REGISTRY}/${process.env.IMAGE_OWNER}`});
}
} catch (error) {
console.error(error.message);
process.exitCode = 1;
}
}