#!/usr/bin/env bash # Runs one command in a disposable systemd container, for a gate whose host requirements a CI job # container or a developer shell does not meet (config/ci/gates.json `hostEnvironment: "system-container"`, # FE-GATE-013's provider sandbox: bubblewrap, a systemd user manager, delegated cgroup v2). # # scripts/run-in-system-container.sh e.g. corepack pnpm ci:gate -- FE-GATE-013 # # The container is privileged with its own cgroup namespace and boots systemd (config/ci/system-container.Dockerfile). # The command runs as root there, so bubblewrap needs no unprivileged user namespace from the host kernel # (Ubuntu 23.10+ refuses those to unconfined processes). Node and pnpm come from the caller, copied in with the # working tree and its git history; artifacts/ is copied back and the container removed, whatever the result. # Docker: the CI job reaches the runner's own daemon through its Docker proxy # (platform-core infrastructure/ci/gitea-runner); on desktop it is the host daemon. # Environment: SYSTEM_CONTAINER_DOCKER (default docker), SYSTEM_CONTAINER_KEEP=1 keeps the container for debugging. # Exit code: the command's, or 3 when the container could not be prepared. set -euo pipefail [ $# -gt 0 ] || { sed -n '2,13p' "$0" | sed 's/^# \{0,1\}//' >&2; exit 2; } docker=${SYSTEM_CONTAINER_DOCKER:-docker} root=$(git rev-parse --show-toplevel) cd "$root" dockerfile=config/ci/system-container.Dockerfile tag="fe-system-container:$(sha256sum "$dockerfile" | cut -c1-16)" node_root=$(dirname "$(dirname "$(command -v node)")") corepack_home=${COREPACK_HOME:-$HOME/.cache/node/corepack} # The environment the gate reads (scripts/verify.sh ci_env, the workflow's global env). pass_env=(CI VITE_BUILD_ID VITE_COMMIT_SHA RELEASE_ID CI_RUNNER_IMAGE SOURCE_DATE_EPOCH APP_PROFILE RELEASE_TARGET) # A merge job's dependency cache (scripts/contracts/ci-gates.ts DEPENDENCY_CACHE): pnpm's store and metadata # cache go in at the same paths, so the install in here reuses what the job's install fetched. pnpm_dirs=() for name in PNPM_CONFIG_STORE_DIR PNPM_CONFIG_CACHE_DIR; do if [ -n "${!name:-}" ] && [ -d "${!name}" ]; then pass_env+=("$name") pnpm_dirs+=("${!name}") fi done say() { echo "system-container: $*" >&2; } fail() { say "$*"; exit 3; } if ! $docker image inspect "$tag" > /dev/null 2>&1; then say "building $tag" $docker build -q -t "$tag" -f "$dockerfile" config/ci > /dev/null || fail "image build failed" fi cid=$($docker run -d --privileged --cgroupns=private --tmpfs /run --tmpfs /run/lock "$tag") \ || fail "container did not start" cleanup() { if [ "${SYSTEM_CONTAINER_KEEP:-0}" = 1 ]; then say "kept container $cid"; else $docker rm -f "$cid" > /dev/null 2>&1 || :; fi } trap cleanup EXIT # systemd reaches a final state, then root's lingering user manager opens its bus. Until PID 1 has its own # bus up, systemctl cannot connect and answers nothing, so ask again for up to a minute. state="" for _ in $(seq 1 120); do state=$($docker exec "$cid" systemctl is-system-running --wait 2>/dev/null || :) case "$state" in running | degraded) break ;; esac sleep 0.5 done case "$state" in running | degraded) ;; *) fail "systemd did not start (state: ${state:-none})" ;; esac $docker exec "$cid" sh -c 'for i in $(seq 1 120); do [ -S /run/user/0/bus ] && exit 0; sleep 0.5; done; exit 1' \ || fail "the root user manager did not start" # The working tree as it is (node_modules included) and its history. A linked worktree's .git is a file # naming a directory outside the tree, so the history goes in as a bundle of HEAD instead. tar -C "$root" --exclude=./.git --exclude=./.tmp -cf - . | $docker exec -i "$cid" sh -c 'mkdir -p /work && tar -C /work --no-same-owner -xf -' \ || fail "copying the working tree failed" if [ -d .git ]; then tar -C "$root" -cf - .git | $docker exec -i "$cid" tar -C /work --no-same-owner -xf - || fail "copying .git failed" else bundle=$(mktemp) git bundle create -q "$bundle" HEAD $docker exec -i "$cid" sh -c 'cat > /tmp/head.bundle' < "$bundle" rm -f "$bundle" $docker exec -w /work "$cid" sh -c 'git init -q . && git fetch -q /tmp/head.bundle HEAD && git update-ref HEAD FETCH_HEAD && git reset -q' \ || fail "restoring the git history failed" fi tar -C "$node_root" -cf - . | $docker exec -i "$cid" sh -c 'mkdir -p /opt/node && tar -C /opt/node --no-same-owner -xf -' \ || fail "copying node failed" for dir in "${pnpm_dirs[@]}"; do tar -C "$dir" -cf - . | $docker exec -i "$cid" sh -c "mkdir -p '$dir' && tar -C '$dir' --no-same-owner -xf -" \ || fail "copying $dir failed" done if [ -d "$corepack_home" ]; then tar -C "$corepack_home" -cf - . | $docker exec -i "$cid" sh -c 'mkdir -p /opt/corepack && tar -C /opt/corepack --no-same-owner -xf -' \ || fail "copying the corepack cache failed" fi exec_env=(-e PATH=/opt/node/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin -e COREPACK_HOME=/opt/corepack -e HOME=/root -e XDG_RUNTIME_DIR=/run/user/0 -e DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/0/bus) for name in "${pass_env[@]}"; do [ -z "${!name+x}" ] || exec_env+=(-e "$name=${!name}") done rc=0 $docker exec -w /work "${exec_env[@]}" "$cid" "$@" || rc=$? # The gate's log and evidence come back even when it failed. mkdir -p artifacts $docker exec "$cid" sh -c '[ -d /work/artifacts ] && tar -C /work -cf - artifacts' | tar -C "$root" -xf - \ || say "copying artifacts back failed" exit "$rc"