문제: run-in-system-container.sh는 `docker run -d` 직후 docker exec로
systemd 부팅을 기다린다. systemd는 시작할 때 root cgroup의 프로세스를
init.scope로 옮긴 뒤 root에 제어기를 켜는데, 그 사이에 닿은 exec는 root
cgroup에 들어간다. cgroup v2는 프로세스가 있는 cgroup에 자식용 제어기를
켜지 못하게 하므로 systemd는 cpu·memory·pids를 user manager까지 넘기지
못하고, 그 뒤 exec도 계속 root cgroup에 들어가 회차 내내 그대로다. 그
컨테이너의 provider scope에는 memory.max가 없어 cgroup 강제 게이트가
모든 provider를 exit 125로 멈춘다(ci-artifact-contract 671줄부터 18개,
desktop 4회 중 1회).
고른 방법: 컨테이너의 첫 프로세스가 root cgroup의 프로세스를 전부
init.scope로 옮기고 root에 쓸 수 있는 제어기를 켠 뒤 /sbin/init를
exec한다. moby의 hack/dind가 같은 방법을 쓴다. 그 뒤로 exec는 root
cgroup에 들어갈 수 없고 PID 1의 cgroup(init.scope)에 들어간다. 옮기는
사이에 들어온 프로세스 때문에 쓰기가 실패하면 0.1초 간격으로 50번까지
다시 한다. 끝내 못 켜면 그 사실을 컨테이너 로그에 쓰고, 래퍼가 어떤 끝에서든
컨테이너를 지우기 전에 그 줄을 stderr로 옮긴다. 빠진 제어기는 test:system 사전 점검이 이름으로 댄다.
버린 대안: 첫 exec 전에 정한 시간 기다리기는 시간 가정이고 창을 줄일
뿐이다. is-system-running을 --wait 없이 짧게 묻기도 짧은 exec가 그
순간에 걸리면 같다. Dockerfile CMD에 넣기는 동작이 같지만 이미지를 다시
만들어야 하고, 경합을 만드는 쪽은 exec를 부르는 이 스크립트다.
위험·한계: privileged·cgroupns=private·cgroup v2를 가정한다(전과 같은
가정). cgroup v2가 아니면 옮기기를 건너뛰고 전처럼 부팅한다. 쓸 수 있는
제어기를 모두 켜고, systemd가 쓰지 않는 것(cpuset, io)은 systemd가 끈다.
root에 들어갈 수 없을 때 runc가 exec를 PID 1의 cgroup에 넣는 동작에
기댄다. desktop runc 1.3.6에서 봤고, runner에서도 통과한 run은 같은
상태에서 exec가 됐다. CPU를 소모하는 부하 아래 반복은 하지 않았다
(runner가 같은 desktop에서 돈다). 고침이 시간 창이 아니라 순서를
보장해 부하와 상관없다.
검증: desktop에서 컨테이너를 띄우자마자 docker exec 15개를 세우는
탐침이 옛 부팅으로 6/6 root 제어기 없음·scope memory.max 없음(RED),
새 부팅으로 6/6 root에 cpu memory pids 포함·exec가 init.scope·
memory.max=1073741824(GREEN). 고친 부팅으로 ci-artifact-contract 파일
전체를 새 컨테이너마다 16회 돌려 16/16 통과(exit=125 0회), 회차마다
root subtree_control에 cpu memory pids가 있고 exec는 init.scope였다.
문제: merge job 셋은 runner의 새 컨테이너에서 매번 Node(GitHub
다운로드), corepack의 pnpm, 패키지 404개를 내려받고, pnpm 11은 lockfile
542개 항목의 공급망 정책을 레지스트리에 물어 검증한다. run 169에서 job마다
setup-node 11~18초, 설치 12~29초였고 설치 시간의 대부분은 정책 검증의
메타데이터 요청이었다(10.1~27.9초). FE-GATE-013의 시스템 컨테이너는 같은
설치를 한 번 더 한다. merge 25분 목표에 0.8분 모자랐다.
고친 것(권하는 안으로 정함 2026-11-13, 총괄):
- job 단계 `dependency-cache`를 더한다. setup-node 앞에서 Node toolcache와
`/tmp/fe-dependency-cache`(corepack, pnpm store, pnpm 메타데이터 캐시)를
`.nvmrc`·`pnpm-lock.yaml` 해시 키로 복원한다. main run은 actions/cache로
복원·저장하고, 그 밖의 ref는 actions/cache/restore로 복원만 한다. pin은
짝 백엔드의 JDK·Gradle·Trivy 캐시와 같다(v4.3.0).
- 생성기가 그 job에 `COREPACK_HOME`·`PNPM_CONFIG_STORE_DIR`·
`PNPM_CONFIG_CACHE_DIR`를 주어 job의 모든 pnpm 호출이 같은 곳을 본다.
frozen install 단계는 그대로이고 캐시와 관계없이 돈다.
- PR run은 main이 저장한 항목을 같은 키로 읽기만 한다. 저장할 수 있는
actions/cache 단계는 `refs/heads/main` 조건 아래에만 있고, 그 밖의 ref가
타는 actions/cache/restore에는 저장하는 post 단계가 없다(시험으로 고정).
- 계약: merge job 셋만 이 단계를 가진다(release·promotion·provider·main
job은 거절, 단계 순서 고정에 반영). 그 env를 job이 따로 묶으면 거절한다.
키 입력은 `config/repository-layout.json`의 새 집합
`dependency-cache-key`(`.nvmrc`, `pnpm-lock.yaml`)에서 고른다.
- `scripts/run-in-system-container.sh`가 그 env가 있으면 store와 메타데이터
캐시를 같은 경로로 컨테이너에 넘긴다. 없으면(desktop) 지금과 같다.
- 결정 색인, ci-quality-gates.md, O1 출처 문구를 총괄이 정한 말로 맞춘다.
버린 대안:
- CI 이미지에 의존성 굽기: 레지스트리 쓰기 토큰이 든다.
- 브랜치 run도 저장하기: 캐시 항목은 다음 run이 믿는 입력이다. pnpm은
같은 lockfile의 공급망 검증 기록이 캐시에 있으면 다시 검증하지 않으므로,
브랜치가 쓴 항목이 main의 검증을 건너뛰게 할 수 있다.
- `cache-hit`일 때 설치를 건너뛰기: 결과가 캐시 상태에 달린다.
- apt 글꼴 캐시: 캐시가 없을 때 새 패키지 버전이 깔려 시각 결과가 달라질
수 있다.
위험·한계:
- PR run은 main이 같은 키(또는 restore-keys로 앞 항목)를 저장한 뒤에야
hit한다. 이 PR 자신의 run은 비어서 시작한다.
- runner 캐시 저장소(5GB)는 짝 백엔드와 같이 쓴다. 항목 하나는 Node·store·
메타데이터로 압축 전 약 0.7GB다. lockfile이 바뀔 때마다 새 항목이 생긴다.
- Node toolcache 경로(`/opt/hostedtoolcache`)가 job 이미지와 다르면 그
부분만 효과가 없고 setup-node가 내려받는다.
검증(desktop):
- 설치 실험(같은 lockfile, 새 폴더): 빈 캐시 13.9·17.2초, 캐시 있음 1.6초,
store 파일 40개·메타데이터 40개를 망가뜨린 캐시 3.6초(27개만 다시 받음).
다섯 번 모두 node_modules 트리 해시가 같다. pnpm 11은 대문자
`PNPM_CONFIG_STORE_DIR`·`PNPM_CONFIG_CACHE_DIR`를 읽는다.
- FE-GATE-013 흐름을 캐시 env로 재현: 빈 캐시 설치 13.7초, 캐시 설치
2.6초, 시스템 컨테이너 안 설치 1.5초(`Recreating node_modules` 없음, 지금은
31.3초). 그 실행의 FE-GATE-013은 provider 묶음 시험 하나가 손 timeout
30초에 걸려 실패했다(캐시와 무관, PR #39가 고치는 문제).
- RED: 계약·생성기를 둔 채 gates.json에서 캐시 단계를 빼면 새 시험 6개
실패. 키 입력을 코드에 직접 적은 첫 판은 repository-layout R2 시험이
잡았다. GREEN: repository-layout·ci-workflow-generation 456개 통과,
check:ci·check:types·eslint rc=0, verify:documentation rc=0, 노트북
`scripts/verify.sh docs` OK.
문제: FE-GATE-013의 test:system은 provider sandbox를 실제로 띄운다.
systemd user manager(systemd-run --user --scope)와 cgroup v2 위임,
bubblewrap(--unshare-net 등)이 필요하다. runner의 job 컨테이너는
entrypoint가 sleep이라 systemd가 없고 bwrap도 없어 사전 점검에서 실패한다
(run 56·80·81). desktop 호스트는 다 있지만 Ubuntu 24.04의
apparmor_restrict_unprivileged_userns=1이 비특권 bwrap을 막는다.
그래서 이 게이트는 runner와 desktop 어디서도 초록인 적이 없다.
고른 방법(소유자 결정 2026-11-11 5절 e: 조건이 되는 실행 환경을 찾는다):
- config/ci/system-container.Dockerfile: Ubuntu 24.04(digest 고정) +
systemd PID 1 + root linger + bubblewrap 등 hostRequirements의 도구.
- scripts/run-in-system-container.sh: 이미지(Dockerfile 해시 태그)가 없으면
만들고, privileged·자체 cgroup namespace로 띄워 systemd와 root user
manager를 기다린 뒤, 작업 트리·git 이력·호출한 쪽의 node와 corepack을
복사해 명령을 root로 돌리고 artifacts/를 되가져온 다음 지운다. root는
호스트의 userns 제한을 받지 않는다.
- gates.json 게이트 필드 hostEnvironment: "system-container"(FE-GATE-013).
생성기는 그 게이트의 run 줄에 래퍼를 붙이고, 실행 검사
(workflowGateExecutionFailures)는 계약이 정한 접두어로 돈 줄만 센다.
scripts/verify.sh gate·parts·stage도 같은 래퍼로 돌린다.
- CI에서는 runner의 Docker proxy로 안쪽 dind daemon을 쓴다(platform-core
gitea-runner README가 「남은 위험」으로 적은 길: proxy가 privileged
컨테이너를 막지 않는다).
- 버린 대안: 전용 VM runner(문서 조건을 그대로 만족하지만 platform-core
변경과 VM 자원·runner 등록이 필요), 호스트 AppArmor profile(호스트
userns 제한을 푸는 보안 설정 변경, 소유자 sudo).
위험·한계:
- root로 돌아 「비특권 runner에서 bwrap userns」 조건 자체는 증명하지
않는다. release 단계 provider job 둘은 아직 job 컨테이너에서 돈다(범위
밖, 같은 래퍼나 VM runner가 필요).
- runner가 rootless dind로 바뀌면 privileged 컨테이너를 못 띄워 깨진다.
- 래퍼 준비(이미지 확인·기동·복사)에 desktop에서 50~60초가 든다.
검증(desktop): 래퍼로 check-system-test-prerequisites → PASS(root),
tests/system/ci-runner/provider-process-group.test.ts 1개 통과.
python3 -m unittest scripts.tests.test_verify 통과, check:ci PASS(게이트 28),
ci-workflow-generation 시험 통과. 게이트 전체(test:system 116개 포함)는 이
브랜치 끝의 merge 단계에서 돈다.