Files
mtusi2026lab3/scripts/k3s-model.ts

167 lines
4.8 KiB
TypeScript

export function settings(
lab: number,
env: Record<string, string | undefined> = {},
) {
if (lab !== 3 && lab !== 4)
throw new Error("Only labs3 and4 use this runtime");
const cluster = env.VP_CLUSTER ?? `vp-lab${lab}-medvedev`,
port = Number(env.PUBLIC_PORT ?? 28200 + lab);
if (!new RegExp(`^vp-lab${lab}-(medvedev|r-[a-f0-9]{8})$`).test(cluster))
throw new Error("Unapproved cluster name");
if (!Number.isInteger(port) || port < 1024 || port > 65535)
throw new Error("Invalid public port");
return { lab, cluster, port, namespace: "messenger" };
}
export function assertOwned(receipt: any, actual: any, expected: any): void {
if (
!receipt ||
receipt.lab !== expected.lab ||
receipt.cluster !== expected.cluster ||
!receipt.container ||
receipt.container !== actual.container ||
!receipt.namespaceUID ||
receipt.namespaceUID !== actual.namespaceUID
)
throw new Error("Cluster or namespace ownership guard failed");
}
export function guardedOperator(
expected: any,
ports: {
receipt: () => Promise<any>;
actual: () => Promise<any>;
dispatch: (action: string) => Promise<any>;
},
) {
return {
async run(action: string) {
const [receipt, actual] = await Promise.all([
ports.receipt(),
ports.actual(),
]);
assertOwned(receipt, actual, expected);
return ports.dispatch(action);
},
};
}
export function pinnedConfigID(image: any, source: string): string {
const [tagged, digest] = source.split("@");
const repository = tagged.replace(/:[^/:]+$/, "");
if (
!digest ||
!image?.Id ||
!image.RepoDigests?.some(
(ref: string) =>
ref.replace(/^docker\.io\//, "").replace(/^library\//, "") ===
repository + "@" + digest,
)
)
throw new Error("Pinned manifest identity differs");
return image.Id;
}
export function assertScopedArgs(args: string[]): void {
const end = args.indexOf("--"),
flags = end < 0 ? args : args.slice(0, end);
if (end >= 0 && args[0] !== "exec")
throw new Error("Only exec accepts an application command delimiter");
if (
flags.some((x) =>
/^(-A$|-n|-s|--(?:all-namespaces|namespace|context|kubeconfig|server|token|user|cluster|as|as-group|raw)(?:=|$))/.test(
x,
),
)
)
throw new Error("Target override rejected");
const allowed =
/^(pods?|deployments?|deploy|jobs?|services?|svc|persistentvolumeclaims?|pvc|configmaps?|events?)(\/[^,]+)?$/;
if (
![
"get",
"exec",
"logs",
"rollout",
"scale",
"annotate",
"wait",
"top",
].includes(args[0])
)
throw new Error("Unsupported scoped verb");
const resource =
args[0] === "rollout"
? args[2]
: ["wait", "exec"].includes(args[0])
? flags.find((x) => allowed.test(x))
: args[1];
if (!resource || !resource.split(",").every((x) => allowed.test(x)))
throw new Error("Only approved namespaced resources are supported");
if (
flags.some(
(x) =>
(!x.startsWith("-") && x.includes("/") && !allowed.test(x)) ||
/^(?:-f|--filename|-k|--kustomize)(?:=|$)/.test(x),
)
)
throw new Error("Additional resource override rejected");
}
export function assertNoGame(code: number) {
if (code !== 1)
throw new Error(
"Measurement requires an inactive game with confirmed status",
);
}
export function assertPartialClaim(receipt: any, server: any, expected: any) {
if (
receipt?.state !== "claimed" ||
receipt.lab !== expected.lab ||
receipt.cluster !== expected.cluster ||
!receipt.nonce ||
server.owner !== receipt.nonce ||
!server.container ||
(receipt.container && receipt.container !== server.container)
)
throw new Error("Partial cluster claim differs");
}
export function assertNoRunningContainers(
containers: any[],
podUID: string,
): void {
if (containers.some((c) => c.labels?.["io.kubernetes.pod.uid"] === podUID))
throw new Error("A victim Pod process is still running");
}
export async function withCleanup<T>(ports: {
perform: () => Promise<T>;
cleanup: () => Promise<void>;
}): Promise<T> {
let result!: T;
let failure: unknown;
let failed = false;
try {
result = await ports.perform();
} catch (error) {
failure = error;
failed = true;
}
try {
await ports.cleanup();
} catch (error) {
if (failed)
throw new AggregateError(
[failure, error],
(failure instanceof Error ? failure.message : "Operation failed") +
"; cleanup failed",
{ cause: failure },
);
throw error;
}
if (failed) throw failure;
return result;
}
export function assertImageBudget(
lab: number,
mib: number,
soft: string,
): void {
if (lab === 4 && (mib !== 2048 || soft !== "1536MiB"))
throw new Error("Lab4 requires its verified 2Gi/1536MiB decoder budget");
}