docs: FE-GATE-013이 시스템 컨테이너에서 도는 것을 지침과 운영 문서에 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m49s
frontend-quality-gates / merge / tests (pull_request) Successful in 22m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m54s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped

문제: 작업 매뉴얼·루트 지침·스킬이 「desktop의 FE-GATE-013은 호스트 제약
실패로 적고 merge 가능 여부는 소유자가 정한다(결정 대기 D8)」라고 적고
있다. 1d3eb901 뒤로 workflow와 scripts/verify.sh는 이 게이트를
scripts/run-in-system-container.sh 안에서 돌리고, 다른 게이트처럼 rc로
센다. CHANGELOG에는 이 브랜치의 변경이 없다.

고른 방법:
- gates.md 3절 문단을 「시스템 컨테이너 안에서 돈다」로 바꾸고, AGENTS.md
  ·improve.md·new-feature.md·operate.md·desktop-gates 스킬의 기록법
  문구를 그 절을 가리키게 고친다.
- decisions.md: 소유자 결정(2026-11-11, design-docs template-program
  README 5절 e)을 2.1절 행으로 더하고 열린 결정 대기 D8을 닫는다.
  evidence.md의 근거 행을 새 규칙 이름과 runner 사건으로 고친다.
- docs/operations/ci-quality-gates.md, docs/testing/taxonomy.md,
  README.md에 컨테이너 경로와 그 한계(root라 비특권 userns 조건은 증명하지
  않음, privileged를 막는 runner에서는 깨짐)를 적는다.
- CHANGELOG 미출시 절에 이 브랜치의 변경을 적는다.

위험·한계: desktop·runner에서 FE-GATE-013이 실제로 초록인지는 이 브랜치
끝의 merge 단계 실행으로 확인한다.

검증: 노트북 scripts/verify.sh docs rc=0. desktop verify:documentation
PASS_SCOPED, 문서를 읽는 시험 넷(changelog-review-ids,
documentation-readiness, template-contract-documents,
deletable-history-documents) 29개 통과.
This commit is contained in:
DongHyeonka
2026-11-12 19:52:09 +09:00
parent f90ffb6c9a
commit f6e2560e4d
12 changed files with 56 additions and 12 deletions
+15
View File
@@ -208,6 +208,21 @@ sandbox는 `bwrap --unshare-pid --unshare-ipc --unshare-uts --unshare-net`으로
출력한다. 호스트의 보안 설정을 바꾸는 일이므로 호스트 소유자가 고른다.
호스트를 바꾸는 설정 파일과 명령은 runner를 만드는 쪽의 인프라 repo가 갖는다.
**이 템플릿이 FE-GATE-013을 돌리는 곳.** 호스트 설정을 바꾸지 않고, 게이트를
일회용 privileged systemd 컨테이너 안에서 돌린다. 계약의 FE-GATE-013
`hostEnvironment: "system-container"`를 보고 생성 workflow와
`scripts/verify.sh`가 `scripts/run-in-system-container.sh`로 게이트를 감싼다.
래퍼는 `config/ci/system-container.Dockerfile`(Ubuntu 24.04, systemd PID 1,
root linger, bubblewrap)로 이미지를 만들고, 작업 트리·git 이력·호출한 쪽의
node와 corepack을 복사해 root로 돌린 뒤 `artifacts/`를 되가져온다. CI에서는
runner의 Docker proxy가 안쪽 dind daemon에 컨테이너를 띄운다.
- root는 호스트의 user namespace 제한을 받지 않는다. 그래서 이 길은 「비특권
runner에서 bwrap userns」 조건 자체를 증명하지 않는다. 그 조건이 필요한
release 단계 provider job은 아직 job 컨테이너에서 돈다.
- runner가 privileged 컨테이너를 막는 설정(rootless dind 등)으로 바뀌면 이
길이 깨진다. 그때는 위 조건을 갖춘 전용 runner(VM 등)로 옮긴다.
각 provider는 고유한 collected user scope에서 실행된다. Supervisor는 실행 전에
실제 cgroup membership과 `memory.max=1073741824`, `memory.swap.max=0`,
`pids.max=64`, `cpu.max="100000 100000"`을 확인한다. 내부 process에는 core 0,