호스트 확인 step이 /proc/filesystems에서 nfsd만 보고 안내도 nfsd만 올린다. 서버 이미지(erichough/nfs-server 2.2.1, entrypoint init_runtime_assertions)는 nfs·nfsd 둘 다 요구하고, nfsd를 올려도 nfs는 따라오지 않는다. 안내대로 한 호스트는 확인 step을 지나 compose에서 exited (1)로 빨강이 된다(CI-BE-0007).
그 이유는 서버 컨테이너 로그에만 있는데 job에 로그 step이 없고, if: always() 정리 step이 down -v로 컨테이너를 지운다(run 52·63에서 서버 출력 줄 0)(CI-BE-0007).
시험 step에 --rerun이 없다. FILESERVER_NFS_TESTS는 실행 중에 읽는 env라 태스크 입력이 아니어서, fileserver 입력이 같은 두 번째 run은 FROM-CACHE로 NFS 없이 초록일 수 있다(CI-BE-0007).
job이 -f로 띄우는 compose/nfs/compose.yml의 privileged 이미지 둘이 digest 없는 tag다. dind는 캐시된 tag를 다시 받지 않아 runner마다 다른 client가 뜰 수 있고, 서버는 제3자 개인 계정 이미지다. 또 repositoryContractTest 입력에 src/adapter/outbound/*/compose/**가 없어 이 compose만 바꾼 PR은 그 lane이 FROM-CACHE가 된다(CI-BE-0008).
커밋 둘, 카드마다 하나다. 커밋 1(CI-BE-0007)만으로도 lane이 초록이다.
고른 방법과 버린 대안
커밋 1 ci(main): 확인 step이 for module in nfs nfsd로 둘 다 보고, 빠진 모듈 이름과 printf 'nfs\nnfsd\n' | sudo tee /etc/modules-load.d/nfsd.conf && sudo modprobe -a nfs nfsd를 찍는다(-a가 없으면 둘째가 첫째의 모듈 인자가 된다). 시험 step에 --rerun. if: failure() step이 down보다 앞에서 compose logs --no-color --timestamps. storage-certification.md 「네트워크 파일 시스템」에 모듈 줄과 --rerun 이유.
커밋 2 build(compose): 두 이미지를 tag@sha256:<digest>로, repositoryContractInputs에 src/adapter/outbound/*/compose/**. digest는 2026-11-21T17:29:04+09:00 desktop에서 읽었다.
docker buildx imagetools inspect eclipse-temurin:21-jdk → OCI index sha256:8ad118b146aa92da815b576441acd6b42b38236797ad0b6edc8c200b85bb0734
client tag는 그대로 두었다(-noble은 OS가 24.04로 바뀐다).
DeveloperExperienceContractTest에 시험 넷(tag repository-contract). step 번호나 Gradle을 어디서 부르는지에 기대지 않는다.
확인 step의 모듈 목록, 안내 명령의 modprobe -a 목록, 부팅 목록(printf … | sudo tee /etc/modules-load.d/)이 셋 다 정확히 nfs·nfsd.
이 job에서 NFS 시험을 Gradle로 부르는 step마다 --rerun(낱말 경계로 찾아 bash -c "… --rerun"도 맞는다).
compose logs를 부르는 failure() step이 down보다 앞.
.gitea/workflows/*·.gitea/actions/*/action.yml step run의 docker compose 전역 옵션 -f/--file이 가리키는 파일마다 모든 image:가 @sha256: 64자로 끝난다. 백슬래시 줄 이음을 먼저 잇는다. 그런 파일이 없으면 실패(빈 범위로 초록이 되지 않게).
버린 안: 확인 step을 지우고 이미지 메시지에 맡기기(첫 step이 몇 초 만에 정확한 명령을 주는 편이 낫다). 확인을 scripts/ci/ 스크립트로 빼고 fixture로 시험(파일 둘이 늘고, 총괄이 고르지 않음). digest를 두지 않기(제3자 privileged 이미지라 실행 뒤 digest를 남기는 행렬 예외에 맞지 않는다). Renovate 같은 자동 갱신(이 repo에 장치가 없다).
위험과 영향
job이 실제로 초록이 되는지, 고친 확인 step이 모듈을 올린 호스트에서 통과하는지, 실패 run에서 로그 step이 서버의 ----> ERROR: 줄을 남기는지, 두 번째 초록 run이 FROM-CACHE가 아닌지, pull 줄에 digest가 붙는지는 소유자가 호스트에 모듈을 넣은 뒤 nightly에서만 보인다. 아래 「확인하지 않은 것」.
--rerun으로 nightly가 이 시험을 매번 돈다. 이 job 하나라 시간은 시험 실행만큼 는다.
digest는 사람이 올린다. 스크립트가 띄우는 compose(redis 행렬), 루트 compose.yaml, compose-lanes의 tag는 시험 범위 밖이다.
운영·데이터·API 영향은 없다(workflow job 하나, nightly compose 하나, 문서 절 하나, 계약 시험).
검증
탐침은 desktop 공유 잠금 아래 detached worktree에서 돌렸다(gnfs-probe2.sh, GRADLE_OPTS=-Dorg.gradle.daemon=false, --no-daemon --console=plain). 로그 desktop ~/lane-g-gnfs-logs2/(summary.txt와 run마다 <이름>.log). 「class」는 --tests 'dev.caskeleton.bootstrap.contract.DeveloperExperienceContractTest'.
RED: base 3bfefe69(main, 트리 dfae7dc4592a9c47e6848ca15f81ed278f9b16bb) + 새 시험 파일만(트리 fee22e628c54b3eae5ac6279fb89e58886997acf). ./gradlew :app-bootstrap:repositoryContractTest class --no-build-cache: rc=1, 20개 중 새 시험 4개 실패.
CI-BE-0007 셋: 확인 step에 for … in …; do 모듈 목록이 없음(grep -qw nfsd /proc/filesystems), Gradle step에 --rerun 없음, compose 순서에 logs가 없음.
노트북 scripts/verify.sh docs: rc=0(문서 검사 걸림 0, 193개 통과, repo layout OK).
main merge: 검증 뒤 origin/main(1376d41b)을 merge했다(rebase 아님). 3bfefe69..1376d41b는 scripts/ 셋·persistence-mongo 시험 둘·notification-platform 시험 둘이고 이 PR 파일 다섯과 겹치지 않는다. git diff --numstat 3bfefe69 2b1b1626과 git diff --numstat 1376d41b b40f1a78이 같다. 합친 트리는 이 PR run이 본다.
확인하지 않은 것(소유자가 호스트에 nfs·nfsd를 넣은 뒤 nightly에서 ci 허브가 본다):
CI-BE-0007 C5: fileserver 입력이 같은 두 번째 초록 run의 > Task :adapter:outbound:fileserver:test에 FROM-CACHE가 없음.
CI-BE-0008 C4: nightly compose step의 pull 줄 이미지 참조에 @sha256:.
digest 값은 17:29에 desktop에서 읽은 값이고, 리뷰는 sandbox라 레지스트리를 다시 보지 못했다.
리뷰 반영
종류 B, 리뷰 1회(reviewer, 렌즈 be-build-ci·be-testing·be-security, 세션 기본 모델). 발견 High 0·Medium 0·Low 3·Minor 3, 모두 반영. 확인 리뷰 0회(변이로 증명).
Low: --rerun을 shell 낱말로만 봐서 bash -c "… --rerun"(QA-BE-0001이 시험을 client 안으로 옮길 때)에서 거짓 실패 → run 전체에서 (?<![\w-])--rerun(?![\w-]). 변이 m6a 통과·m6b 실패.
Low: docker compose \ 줄 이음 뒤 -f를 놓침 → 백슬래시-줄바꿈을 먼저 잇는 helper를 compose 단계 둘에 씀. 변이 m7 실패.
Low: 안내의 부팅 목록(printf … | sudo tee /etc/modules-load.d/)을 안 봄 → 단언 추가, 모듈 목록 셋 다 containsExactlyInAnyOrder. 변이 m5 실패.
Minor: then이 given 값을 단언 → when에서 조건을 만든다.
Minor: DisplayName 문구.
Minor: build.gradle 주석 문구.
리뷰어가 볼 곳
.gitea/workflows/main.ymlfileserver-nfs-ambiguity job — 확인 step, --rerun, failure() logs step의 자리.
DeveloperExperienceContractTest 새 시험 넷 — 특히 compose -f 파일을 찾는 부분.
src/bootstrap/app/build.gradlerepositoryContractInputs 한 줄.
넘길 것
diff 밖, QA-BE-0001 몫: src/adapter/outbound/fileserver/compose/nfs/compose.yml:10-11 머리 주석의 같은 명령에 --rerun이 없다.
리뷰가 넘긴 것(be-build-ci 함정 11): lane 입력 glob이 src/adapter/outbound/*/compose/**뿐이라, workflow가 그 밖 compose(예 src/adapter/inbound/*/compose/)를 -f로 부르면 그 파일만 바꾼 PR이 FROM-CACHE다. 지금 그런 파일은 없다.
관련
Refs: CI-BE-0007(now), CI-BE-0008(batch nfs-nightly). 소유자 명령 정본: ci 허브 owner-actions 2026-11-21-nfsd.md 2절.
## 무엇을, 왜
nightly `fileserver-nfs-ambiguity` job에 빈틈이 넷 있다.
- 호스트 확인 step이 `/proc/filesystems`에서 `nfsd`만 보고 안내도 `nfsd`만 올린다. 서버 이미지(erichough/nfs-server 2.2.1, entrypoint `init_runtime_assertions`)는 `nfs`·`nfsd` 둘 다 요구하고, `nfsd`를 올려도 `nfs`는 따라오지 않는다. 안내대로 한 호스트는 확인 step을 지나 compose에서 `exited (1)`로 빨강이 된다(CI-BE-0007).
- 그 이유는 서버 컨테이너 로그에만 있는데 job에 로그 step이 없고, `if: always()` 정리 step이 `down -v`로 컨테이너를 지운다(run 52·63에서 서버 출력 줄 0)(CI-BE-0007).
- 시험 step에 `--rerun`이 없다. `FILESERVER_NFS_TESTS`는 실행 중에 읽는 env라 태스크 입력이 아니어서, fileserver 입력이 같은 두 번째 run은 `FROM-CACHE`로 NFS 없이 초록일 수 있다(CI-BE-0007).
- job이 `-f`로 띄우는 `compose/nfs/compose.yml`의 privileged 이미지 둘이 digest 없는 tag다. dind는 캐시된 tag를 다시 받지 않아 runner마다 다른 client가 뜰 수 있고, 서버는 제3자 개인 계정 이미지다. 또 `repositoryContractTest` 입력에 `src/adapter/outbound/*/compose/**`가 없어 이 compose만 바꾼 PR은 그 lane이 FROM-CACHE가 된다(CI-BE-0008).
커밋 둘, 카드마다 하나다. 커밋 1(CI-BE-0007)만으로도 lane이 초록이다.
## 고른 방법과 버린 대안
- 커밋 1 `ci(main)`: 확인 step이 `for module in nfs nfsd`로 둘 다 보고, 빠진 모듈 이름과 `printf 'nfs\nnfsd\n' | sudo tee /etc/modules-load.d/nfsd.conf && sudo modprobe -a nfs nfsd`를 찍는다(`-a`가 없으면 둘째가 첫째의 모듈 인자가 된다). 시험 step에 `--rerun`. `if: failure()` step이 `down`보다 앞에서 `compose logs --no-color --timestamps`. `storage-certification.md` 「네트워크 파일 시스템」에 모듈 줄과 `--rerun` 이유.
- 커밋 2 `build(compose)`: 두 이미지를 `tag@sha256:<digest>`로, `repositoryContractInputs`에 `src/adapter/outbound/*/compose/**`. digest는 2026-11-21T17:29:04+09:00 desktop에서 읽었다.
- `docker buildx imagetools inspect erichough/nfs-server:2.2.1` → manifest v2 `sha256:1efd4ece380c5ba27479417585224ef857006daa46ab84560a28c1224bc71e9e`
- `docker buildx imagetools inspect eclipse-temurin:21-jdk` → OCI index `sha256:8ad118b146aa92da815b576441acd6b42b38236797ad0b6edc8c200b85bb0734`
- client tag는 그대로 두었다(`-noble`은 OS가 24.04로 바뀐다).
- `DeveloperExperienceContractTest`에 시험 넷(tag `repository-contract`). step 번호나 Gradle을 어디서 부르는지에 기대지 않는다.
- 확인 step의 모듈 목록, 안내 명령의 `modprobe -a` 목록, 부팅 목록(`printf … | sudo tee /etc/modules-load.d/`)이 셋 다 정확히 `nfs`·`nfsd`.
- 이 job에서 NFS 시험을 Gradle로 부르는 step마다 `--rerun`(낱말 경계로 찾아 `bash -c "… --rerun"`도 맞는다).
- compose `logs`를 부르는 `failure()` step이 `down`보다 앞.
- `.gitea/workflows/*`·`.gitea/actions/*/action.yml` step `run`의 `docker compose` 전역 옵션 `-f`/`--file`이 가리키는 파일마다 모든 `image:`가 `@sha256:` 64자로 끝난다. 백슬래시 줄 이음을 먼저 잇는다. 그런 파일이 없으면 실패(빈 범위로 초록이 되지 않게).
- 버린 안: 확인 step을 지우고 이미지 메시지에 맡기기(첫 step이 몇 초 만에 정확한 명령을 주는 편이 낫다). 확인을 `scripts/ci/` 스크립트로 빼고 fixture로 시험(파일 둘이 늘고, 총괄이 고르지 않음). digest를 두지 않기(제3자 privileged 이미지라 실행 뒤 digest를 남기는 행렬 예외에 맞지 않는다). Renovate 같은 자동 갱신(이 repo에 장치가 없다).
## 위험과 영향
- job이 실제로 초록이 되는지, 고친 확인 step이 모듈을 올린 호스트에서 통과하는지, 실패 run에서 로그 step이 서버의 `----> ERROR:` 줄을 남기는지, 두 번째 초록 run이 FROM-CACHE가 아닌지, pull 줄에 digest가 붙는지는 소유자가 호스트에 모듈을 넣은 뒤 nightly에서만 보인다. 아래 「확인하지 않은 것」.
- `--rerun`으로 nightly가 이 시험을 매번 돈다. 이 job 하나라 시간은 시험 실행만큼 는다.
- digest는 사람이 올린다. 스크립트가 띄우는 compose(redis 행렬), 루트 `compose.yaml`, compose-lanes의 tag는 시험 범위 밖이다.
- 운영·데이터·API 영향은 없다(workflow job 하나, nightly compose 하나, 문서 절 하나, 계약 시험).
## 검증
탐침은 desktop 공유 잠금 아래 detached worktree에서 돌렸다(`gnfs-probe2.sh`, `GRADLE_OPTS=-Dorg.gradle.daemon=false`, `--no-daemon --console=plain`). 로그 desktop `~/lane-g-gnfs-logs2/`(summary.txt와 run마다 `<이름>.log`). 「class」는 `--tests 'dev.caskeleton.bootstrap.contract.DeveloperExperienceContractTest'`.
- RED: base 3bfefe69(main, 트리 `dfae7dc4592a9c47e6848ca15f81ed278f9b16bb`) + 새 시험 파일만(트리 `fee22e628c54b3eae5ac6279fb89e58886997acf`). `./gradlew :app-bootstrap:repositoryContractTest` class `--no-build-cache`: rc=1, 20개 중 새 시험 4개 실패.
- CI-BE-0007 셋: 확인 step에 `for … in …; do` 모듈 목록이 없음(`grep -qw nfsd /proc/filesystems`), Gradle step에 `--rerun` 없음, compose 순서에 `logs`가 없음.
- CI-BE-0008 하나: `src/adapter/outbound/fileserver/compose/nfs/compose.yml`의 `19: image: erichough/nfs-server:2.2.1`·`39: image: eclipse-temurin:21-jdk`.
- 커밋 1만(트리 `85daf7dc38e41c3d137ef339a3718cc01024683f`): `:app-bootstrap:repositoryContractTest --no-build-cache` rc=0, 64개·skip 1.
- GREEN(트리 `d8fc8e09a1e61efcbdc266e34a5b3d7af1bb459c` = 두 커밋): 같은 lane rc=0, 65개·skip 1. `:app-bootstrap:testQualityCheck --no-build-cache` rc=0.
- 변이(GREEN 트리, class `--rerun --no-build-cache`, 변이마다 되돌림):
| 변이 | rc | 실패한 시험 |
|---|---|---|
| m1 확인 step `for module in nfsd` | 1 | 호스트 확인(모듈 `["nfsd"]`) |
| m2 Gradle step `--rerun` 지움 | 1 | `--rerun` |
| m3 logs step을 `down` 뒤로 | 1 | logs가 down보다 앞 |
| m4 안내 `sudo modprobe nfsd` | 1 | 호스트 확인(`modprobe -a` 목록) |
| m5 부팅 목록 `echo nfsd \| sudo tee` | 1 | 호스트 확인(`printf` 목록) |
| m6a `exec -T nfs-client bash -c "… --rerun"` | 0 | 없음(거짓 실패 없음) |
| m6b `bash -c "…"`(`--rerun` 없음) | 1 | `--rerun` |
| m7 compose step에 줄 이음 `\` + `-f compose.yaml` | 1 | digest(`compose.yaml` `78: image: caskeleton:…` 등) |
- CI-BE-0008 C3(빌드 캐시 켬, `--build-cache`): GREEN 트리 lane rc=0(캐시 채움) → client 줄의 `@sha256:…`만 지운 트리 `1b54681bd9c0b47bc473ba86c13c973c505988d3`: `> Task :app-bootstrap:repositoryContractTest` 실행 후 `FAILED` rc=1, 실패 `{"…/nfs/compose.yml"=["39: image: eclipse-temurin:21-jdk"]}`. 대조(include 한 줄을 뺀 트리 `75ef2298…` → digest 지운 `98a06c8e…`): `repositoryContractTest UP-TO-DATE` rc=0.
- 문서 주장(트리 d8fc8e09): `./gradlew :adapter:outbound:fileserver:test --tests '*NfsAmbiguityIntegrationTest'` rc=0(3개·skip 3) → `env FILESERVER_NFS_TESTS=true` 같은 명령: `:adapter:outbound:fileserver:test UP-TO-DATE` rc=0.
- verify(깨끗한 detached worktree, 트리 d8fc8e09, 첫 줄 「HEAD 트리와 같음」)
- desktop `scripts/verify.sh leaf :app-bootstrap --no-cache`: rc=0, tests=334 failures=0 errors=0 skipped=5. 로그 desktop `~/gnfs-v-leaf-logs/leaf.log`.
- desktop `scripts/verify.sh pr --no-cache`: rc=0, tests=7343 failures=0 errors=0 skipped=35. 로그 desktop `~/gnfs-v-pr-logs/pr.log`.
- 노트북 `scripts/verify.sh docs`: rc=0(문서 검사 걸림 0, 193개 통과, repo layout OK).
- main merge: 검증 뒤 origin/main(1376d41b)을 merge했다(rebase 아님). 3bfefe69..1376d41b는 `scripts/` 셋·`persistence-mongo` 시험 둘·`notification-platform` 시험 둘이고 이 PR 파일 다섯과 겹치지 않는다. `git diff --numstat 3bfefe69 2b1b1626`과 `git diff --numstat 1376d41b b40f1a78`이 같다. 합친 트리는 이 PR run이 본다.
확인하지 않은 것(소유자가 호스트에 `nfs`·`nfsd`를 넣은 뒤 nightly에서 ci 허브가 본다):
- CI-BE-0007 C4: compose step이 서버 종료로 실패하는 run에서 job 로그에 `fileserver-nfs-server` 접두의 `----> ERROR:` 줄.
- CI-BE-0007 C5: fileserver 입력이 같은 두 번째 초록 run의 `> Task :adapter:outbound:fileserver:test`에 `FROM-CACHE`가 없음.
- CI-BE-0008 C4: nightly compose step의 pull 줄 이미지 참조에 `@sha256:`.
- digest 값은 17:29에 desktop에서 읽은 값이고, 리뷰는 sandbox라 레지스트리를 다시 보지 못했다.
## 리뷰 반영
종류 B, 리뷰 1회(reviewer, 렌즈 be-build-ci·be-testing·be-security, 세션 기본 모델). 발견 High 0·Medium 0·Low 3·Minor 3, 모두 반영. 확인 리뷰 0회(변이로 증명).
- Low: `--rerun`을 shell 낱말로만 봐서 `bash -c "… --rerun"`(QA-BE-0001이 시험을 client 안으로 옮길 때)에서 거짓 실패 → run 전체에서 `(?<![\w-])--rerun(?![\w-])`. 변이 m6a 통과·m6b 실패.
- Low: `docker compose \` 줄 이음 뒤 `-f`를 놓침 → 백슬래시-줄바꿈을 먼저 잇는 helper를 compose 단계 둘에 씀. 변이 m7 실패.
- Low: 안내의 부팅 목록(`printf … | sudo tee /etc/modules-load.d/`)을 안 봄 → 단언 추가, 모듈 목록 셋 다 `containsExactlyInAnyOrder`. 변이 m5 실패.
- Minor: then이 given 값을 단언 → when에서 조건을 만든다.
- Minor: DisplayName 문구.
- Minor: `build.gradle` 주석 문구.
## 리뷰어가 볼 곳
- `.gitea/workflows/main.yml` `fileserver-nfs-ambiguity` job — 확인 step, `--rerun`, `failure()` logs step의 자리.
- `DeveloperExperienceContractTest` 새 시험 넷 — 특히 compose `-f` 파일을 찾는 부분.
- `src/bootstrap/app/build.gradle` `repositoryContractInputs` 한 줄.
## 넘길 것
- diff 밖, QA-BE-0001 몫: `src/adapter/outbound/fileserver/compose/nfs/compose.yml:10-11` 머리 주석의 같은 명령에 `--rerun`이 없다.
- 리뷰가 넘긴 것(be-build-ci 함정 11): lane 입력 glob이 `src/adapter/outbound/*/compose/**`뿐이라, workflow가 그 밖 compose(예 `src/adapter/inbound/*/compose/`)를 `-f`로 부르면 그 파일만 바꾼 PR이 FROM-CACHE다. 지금 그런 파일은 없다.
## 관련
- Refs: CI-BE-0007(now), CI-BE-0008(batch `nfs-nightly`). 소유자 명령 정본: ci 허브 owner-actions `2026-11-21-nfsd.md` 2절.
문제: nightly `fileserver-nfs-ambiguity`의 호스트 확인 step은
`/proc/filesystems`에서 `nfsd`만 보고, 실패 안내도 `nfsd`만 올린다.
서버 이미지 erichough/nfs-server 2.2.1의 entrypoint
(`init_runtime_assertions`)는 `nfs`와 `nfsd`를 둘 다 요구하고, `nfsd`를
올려도 `nfs`는 따라오지 않는다. 그래서 안내대로 한 호스트는 확인 step을
지나 compose에서 `exited (1)`로 빨강이 된다. 그 이유는 서버 컨테이너
로그에만 있는데, job에는 로그 step이 없고 `if: always()` 정리 step이
`down -v`로 컨테이너를 지운다(run 52·63에서 서버 출력 줄 0). 시험 step은
`--rerun` 없이 빌드 캐시를 쓰는데, `FILESERVER_NFS_TESTS`는 Java가 실행
중에 읽는 env라 태스크 입력이 아니다. fileserver 입력이 같은 두 번째
run은 `FROM-CACHE`로 NFS 없이 초록일 수 있다.
고친 것:
- 확인 step이 `for module in nfs nfsd`로 둘 다 보고, 빠진 모듈 이름과
`modprobe -a nfs nfsd`(둘을 주려면 `-a`가 있어야 한다. 없으면 둘째가
첫째의 모듈 인자가 된다) 명령을 찍는다. 주석도 같은 명령.
- 시험 step에 `--rerun`.
- `if: failure()` step이 `down`보다 앞에서 compose 로그를 찍는다.
- `docs/fileserver/storage-certification.md` 「네트워크 파일 시스템」에
호스트 모듈 줄과 `--rerun`(이유 한 줄).
- `DeveloperExperienceContractTest`에 시험 셋(tag `repository-contract`,
`.gitea/**`는 이미 이 lane의 입력이다): 확인 step의 모듈 목록과 안내
명령의 모듈 목록이 정확히 `nfs`·`nfsd`, 이 job의 Gradle step마다
`--rerun`, compose `logs`를 부르는 `failure()` step이 `down`보다 앞.
step 번호나 Gradle을 어디서 부르는지에 기대지 않게 썼다.
버린 안: 확인 step을 지우고 이미지 메시지에 맡기기(로그 step이 생겨도
첫 step이 몇 초 만에 정확한 명령을 주는 편이 낫다). 확인을 scripts/ci/
스크립트로 빼고 fixture로 시험하기(파일 둘이 늘고, 총괄이 고르지 않음).
위험·한계: job이 실제로 초록이 되는지, 고친 확인 step이 모듈을 올린
호스트에서 통과하는지는 소유자가 호스트에 모듈을 넣은 뒤 nightly에서만
볼 수 있다. compose.yml 머리 주석(11행)의 같은 명령에 `--rerun`이 없지만
그 주석은 QA-BE-0001 몫이라 두었다.
리뷰 반영(종류 B 1회, 렌즈 be-build-ci·be-testing·be-security):
- `--rerun`을 shell 낱말로만 봐서 `bash -c "… --rerun"`에서 거짓
실패 → run 전체에서 `(?<![\w-])--rerun(?![\w-])`로 찾는다.
- `docker compose \` 줄 이음 뒤 `-f`를 놓침 → 백슬래시-줄바꿈을 먼저
잇는 `scriptWords`를 compose 단계 helper에 쓴다.
- 안내의 부팅 목록(`printf … | sudo tee /etc/modules-load.d/`)을 안 봄
→ 단언을 더하고 모듈 목록 셋 다 `containsExactlyInAnyOrder`.
- then이 given 값을 단언 → when에서 logs step 조건을 만든다.
- `--rerun` 시험 DisplayName 문구.
검증(desktop 공유 잠금, detached worktree, `--no-build-cache`):
- RED: base 3bfefe69(트리 dfae7dc4) + 새 시험 파일(트리 fee22e62)에서
`./gradlew :app-bootstrap:repositoryContractTest --tests
'dev.caskeleton.bootstrap.contract.DeveloperExperienceContractTest'`
rc=1. 이 커밋의 시험 셋이 모듈 목록 없음·`--rerun` 없음·logs step
없음으로 실패(다음 커밋 시험 포함 4개 실패).
- 이 커밋 트리 85daf7dc에서 `:app-bootstrap:repositoryContractTest`
rc=0(64개, skip 1).
- 변이(두 커밋 트리 d8fc8e09, 이 시험 class): 확인 step
`for module in nfsd` rc=1, gradle step `--rerun` 지움 rc=1, logs
step을 `down` 뒤로 rc=1, 안내 `modprobe nfsd` rc=1, 부팅 목록
`echo nfsd | sudo tee` rc=1, `bash -c "… --rerun"` rc=0,
`bash -c "…"`(`--rerun` 없음) rc=1.
- 문서 주장: env 없이 fileserver 시험을 돈 뒤 `FILESERVER_NFS_TESTS=true`로
다시 돌면 `:adapter:outbound:fileserver:test UP-TO-DATE`.
- 트리 d8fc8e09: desktop `scripts/verify.sh leaf :app-bootstrap
--no-cache` rc=0(334개), `scripts/verify.sh pr --no-cache` rc=0
(7343개, 실패 0, skip 35), 노트북 `scripts/verify.sh docs` rc=0.
Refs: CI-BE-0007
문제: nightly `fileserver-nfs-ambiguity`가 `docker compose -f`로 띄우는
`src/adapter/outbound/fileserver/compose/nfs/compose.yml`의 이미지 둘이
digest 없는 tag다(`erichough/nfs-server:2.2.1`, `eclipse-temurin:21-jdk`).
둘 다 `privileged: true`다. runner dind는 캐시에 있는 tag를 다시 받지
않아서, 같은 commit에서도 캐시가 남은 runner와 새 runner가 다른 client를
띄운다(desktop dind의 21-jdk는 10-29 빌드, 레지스트리는 11-20 빌드).
nfs-server는 제3자 개인 계정 이미지라 tag가 다시 push되면 캐시가 빈 뒤
첫 run에서 바뀐 이미지가 privileged로 뜬다. 또 `repositoryContractTest`의
입력에 `src/adapter/outbound/*/compose/**`가 없어서, 이 compose만 바꾼
PR은 그 lane이 main 캐시로 FROM-CACHE가 되어 시험이 돌지 않는다.
고친 것:
- 두 이미지를 `tag@sha256:<digest>`로. 값은 레지스트리에서 읽었다
(2026-11-21 17:29 KST, desktop `docker buildx imagetools inspect`):
nfs-server:2.2.1 `1efd4ece…`(manifest v2, 2020-02-07 뒤 그대로),
21-jdk `8ad118b1…`(OCI index). client는 tag를 바꾸지 않았다
(`-noble`은 OS가 24.04로 바뀐다).
- `repositoryContractInputs`에 `src/adapter/outbound/*/compose/**`.
- `DeveloperExperienceContractTest`에 시험 하나(tag
`repository-contract`): `.gitea/workflows/*`·`.gitea/actions/*/action.yml`
의 step `run`에서 `docker compose`의 전역 옵션 `-f`/`--file`이 가리키는
파일마다 모든 `image:` 줄이 `@sha256:` 64자로 끝난다. 그런 파일이
하나도 없으면 실패한다(빈 범위로 초록이 되지 않게).
버린 안: 그대로 두기(제3자 privileged 이미지라 실행 뒤 digest를 남기는
행렬 예외에 맞지 않는다). Renovate 같은 자동 갱신(이 repo에 장치가 없다).
위험·한계: digest를 올리는 일은 사람이 한다. 스크립트가 띄우는
compose(redis 행렬), 루트 `compose.yaml`, compose-lanes의 tag는 이 시험
범위 밖이다. client 이미지를 `nfs-common`이 든 것으로 바꾸는 일은
QA-BE-0001 몫이고, 그때도 이 시험이 그 이미지에 digest를 요구한다.
리뷰 반영(종류 B 1회, 렌즈 be-build-ci·be-testing·be-security):
- `docker compose \` 줄 이음 뒤 `-f`를 놓침 → compose 파일을 찾을 때도
백슬래시-줄바꿈을 먼저 잇는다.
- `build.gradle` 주석 문구.
검증(desktop 공유 잠금, detached worktree):
- RED: base 3bfefe69(트리 dfae7dc4) + 새 시험 파일(트리 fee22e62)에서
`./gradlew :app-bootstrap:repositoryContractTest --tests
'dev.caskeleton.bootstrap.contract.DeveloperExperienceContractTest'
--no-build-cache` rc=1. digest 시험이 `19: image:
erichough/nfs-server:2.2.1`·`39: image: eclipse-temurin:21-jdk`로 실패.
- GREEN 트리 d8fc8e09: `:app-bootstrap:repositoryContractTest
--no-build-cache` rc=0(65개, skip 1), `:app-bootstrap:testQualityCheck`
rc=0.
- 변이: `-f` 뒤에 줄 이음으로 `-f compose.yaml`을 더하면 rc=1(시험이
`compose.yaml`의 tag 이미지를 든다).
- 빌드 캐시를 켜고(`--build-cache`) 이 트리로 lane을 한 번 돌려 채운 뒤
client 줄의 `@sha256:…`만 지우면 태스크가 실행되고 FAILED rc=1. 대조:
include 한 줄을 뺀 트리에서 같은 순서면 `UP-TO-DATE` rc=0.
- 트리 d8fc8e09: desktop `scripts/verify.sh leaf :app-bootstrap
--no-cache` rc=0(334개), `scripts/verify.sh pr --no-cache` rc=0
(7343개, 실패 0, skip 35), 노트북 `scripts/verify.sh docs` rc=0.
Refs: CI-BE-0008
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
nightly
fileserver-nfs-ambiguityjob에 빈틈이 넷 있다./proc/filesystems에서nfsd만 보고 안내도nfsd만 올린다. 서버 이미지(erichough/nfs-server 2.2.1, entrypointinit_runtime_assertions)는nfs·nfsd둘 다 요구하고,nfsd를 올려도nfs는 따라오지 않는다. 안내대로 한 호스트는 확인 step을 지나 compose에서exited (1)로 빨강이 된다(CI-BE-0007).if: always()정리 step이down -v로 컨테이너를 지운다(run 52·63에서 서버 출력 줄 0)(CI-BE-0007).--rerun이 없다.FILESERVER_NFS_TESTS는 실행 중에 읽는 env라 태스크 입력이 아니어서, fileserver 입력이 같은 두 번째 run은FROM-CACHE로 NFS 없이 초록일 수 있다(CI-BE-0007).-f로 띄우는compose/nfs/compose.yml의 privileged 이미지 둘이 digest 없는 tag다. dind는 캐시된 tag를 다시 받지 않아 runner마다 다른 client가 뜰 수 있고, 서버는 제3자 개인 계정 이미지다. 또repositoryContractTest입력에src/adapter/outbound/*/compose/**가 없어 이 compose만 바꾼 PR은 그 lane이 FROM-CACHE가 된다(CI-BE-0008).커밋 둘, 카드마다 하나다. 커밋 1(CI-BE-0007)만으로도 lane이 초록이다.
고른 방법과 버린 대안
ci(main): 확인 step이for module in nfs nfsd로 둘 다 보고, 빠진 모듈 이름과printf 'nfs\nnfsd\n' | sudo tee /etc/modules-load.d/nfsd.conf && sudo modprobe -a nfs nfsd를 찍는다(-a가 없으면 둘째가 첫째의 모듈 인자가 된다). 시험 step에--rerun.if: failure()step이down보다 앞에서compose logs --no-color --timestamps.storage-certification.md「네트워크 파일 시스템」에 모듈 줄과--rerun이유.build(compose): 두 이미지를tag@sha256:<digest>로,repositoryContractInputs에src/adapter/outbound/*/compose/**. digest는 2026-11-21T17:29:04+09:00 desktop에서 읽었다.docker buildx imagetools inspect erichough/nfs-server:2.2.1→ manifest v2sha256:1efd4ece380c5ba27479417585224ef857006daa46ab84560a28c1224bc71e9edocker buildx imagetools inspect eclipse-temurin:21-jdk→ OCI indexsha256:8ad118b146aa92da815b576441acd6b42b38236797ad0b6edc8c200b85bb0734-noble은 OS가 24.04로 바뀐다).DeveloperExperienceContractTest에 시험 넷(tagrepository-contract). step 번호나 Gradle을 어디서 부르는지에 기대지 않는다.modprobe -a목록, 부팅 목록(printf … | sudo tee /etc/modules-load.d/)이 셋 다 정확히nfs·nfsd.--rerun(낱말 경계로 찾아bash -c "… --rerun"도 맞는다).logs를 부르는failure()step이down보다 앞..gitea/workflows/*·.gitea/actions/*/action.ymlsteprun의docker compose전역 옵션-f/--file이 가리키는 파일마다 모든image:가@sha256:64자로 끝난다. 백슬래시 줄 이음을 먼저 잇는다. 그런 파일이 없으면 실패(빈 범위로 초록이 되지 않게).scripts/ci/스크립트로 빼고 fixture로 시험(파일 둘이 늘고, 총괄이 고르지 않음). digest를 두지 않기(제3자 privileged 이미지라 실행 뒤 digest를 남기는 행렬 예외에 맞지 않는다). Renovate 같은 자동 갱신(이 repo에 장치가 없다).위험과 영향
----> ERROR:줄을 남기는지, 두 번째 초록 run이 FROM-CACHE가 아닌지, pull 줄에 digest가 붙는지는 소유자가 호스트에 모듈을 넣은 뒤 nightly에서만 보인다. 아래 「확인하지 않은 것」.--rerun으로 nightly가 이 시험을 매번 돈다. 이 job 하나라 시간은 시험 실행만큼 는다.compose.yaml, compose-lanes의 tag는 시험 범위 밖이다.검증
탐침은 desktop 공유 잠금 아래 detached worktree에서 돌렸다(
gnfs-probe2.sh,GRADLE_OPTS=-Dorg.gradle.daemon=false,--no-daemon --console=plain). 로그 desktop~/lane-g-gnfs-logs2/(summary.txt와 run마다<이름>.log). 「class」는--tests 'dev.caskeleton.bootstrap.contract.DeveloperExperienceContractTest'.RED: base 3bfefe69(main, 트리
dfae7dc4592a9c47e6848ca15f81ed278f9b16bb) + 새 시험 파일만(트리fee22e628c54b3eae5ac6279fb89e58886997acf)../gradlew :app-bootstrap:repositoryContractTestclass--no-build-cache: rc=1, 20개 중 새 시험 4개 실패.for … in …; do모듈 목록이 없음(grep -qw nfsd /proc/filesystems), Gradle step에--rerun없음, compose 순서에logs가 없음.src/adapter/outbound/fileserver/compose/nfs/compose.yml의19: image: erichough/nfs-server:2.2.1·39: image: eclipse-temurin:21-jdk.커밋 1만(트리
85daf7dc38e41c3d137ef339a3718cc01024683f)::app-bootstrap:repositoryContractTest --no-build-cacherc=0, 64개·skip 1.GREEN(트리
d8fc8e09a1e61efcbdc266e34a5b3d7af1bb459c= 두 커밋): 같은 lane rc=0, 65개·skip 1.:app-bootstrap:testQualityCheck --no-build-cacherc=0.변이(GREEN 트리, class
--rerun --no-build-cache, 변이마다 되돌림):for module in nfsd["nfsd"])--rerun지움--rerundown뒤로sudo modprobe nfsdmodprobe -a목록)echo nfsd | sudo teeprintf목록)exec -T nfs-client bash -c "… --rerun"bash -c "…"(--rerun없음)--rerun\+-f compose.yamlcompose.yaml78: image: caskeleton:…등)CI-BE-0008 C3(빌드 캐시 켬,
--build-cache): GREEN 트리 lane rc=0(캐시 채움) → client 줄의@sha256:…만 지운 트리1b54681bd9c0b47bc473ba86c13c973c505988d3:> Task :app-bootstrap:repositoryContractTest실행 후FAILEDrc=1, 실패{"…/nfs/compose.yml"=["39: image: eclipse-temurin:21-jdk"]}. 대조(include 한 줄을 뺀 트리75ef2298…→ digest 지운98a06c8e…):repositoryContractTest UP-TO-DATErc=0.문서 주장(트리
d8fc8e09):./gradlew :adapter:outbound:fileserver:test --tests '*NfsAmbiguityIntegrationTest'rc=0(3개·skip 3) →env FILESERVER_NFS_TESTS=true같은 명령::adapter:outbound:fileserver:test UP-TO-DATErc=0.verify(깨끗한 detached worktree, 트리
d8fc8e09, 첫 줄 「HEAD 트리와 같음」)scripts/verify.sh leaf :app-bootstrap --no-cache: rc=0, tests=334 failures=0 errors=0 skipped=5. 로그 desktop~/gnfs-v-leaf-logs/leaf.log.scripts/verify.sh pr --no-cache: rc=0, tests=7343 failures=0 errors=0 skipped=35. 로그 desktop~/gnfs-v-pr-logs/pr.log.scripts/verify.sh docs: rc=0(문서 검사 걸림 0, 193개 통과, repo layout OK).main merge: 검증 뒤 origin/main(
1376d41b)을 merge했다(rebase 아님). 3bfefe69..1376d41b는scripts/셋·persistence-mongo시험 둘·notification-platform시험 둘이고 이 PR 파일 다섯과 겹치지 않는다.git diff --numstat 3bfefe69 2b1b1626과git diff --numstat 1376d41b b40f1a78이 같다. 합친 트리는 이 PR run이 본다.확인하지 않은 것(소유자가 호스트에
nfs·nfsd를 넣은 뒤 nightly에서 ci 허브가 본다):fileserver-nfs-server접두의----> ERROR:줄.> Task :adapter:outbound:fileserver:test에FROM-CACHE가 없음.@sha256:.리뷰 반영
종류 B, 리뷰 1회(reviewer, 렌즈 be-build-ci·be-testing·be-security, 세션 기본 모델). 발견 High 0·Medium 0·Low 3·Minor 3, 모두 반영. 확인 리뷰 0회(변이로 증명).
--rerun을 shell 낱말로만 봐서bash -c "… --rerun"(QA-BE-0001이 시험을 client 안으로 옮길 때)에서 거짓 실패 → run 전체에서(?<![\w-])--rerun(?![\w-]). 변이 m6a 통과·m6b 실패.docker compose \줄 이음 뒤-f를 놓침 → 백슬래시-줄바꿈을 먼저 잇는 helper를 compose 단계 둘에 씀. 변이 m7 실패.printf … | sudo tee /etc/modules-load.d/)을 안 봄 → 단언 추가, 모듈 목록 셋 다containsExactlyInAnyOrder. 변이 m5 실패.build.gradle주석 문구.리뷰어가 볼 곳
.gitea/workflows/main.ymlfileserver-nfs-ambiguityjob — 확인 step,--rerun,failure()logs step의 자리.DeveloperExperienceContractTest새 시험 넷 — 특히 compose-f파일을 찾는 부분.src/bootstrap/app/build.gradlerepositoryContractInputs한 줄.넘길 것
src/adapter/outbound/fileserver/compose/nfs/compose.yml:10-11머리 주석의 같은 명령에--rerun이 없다.src/adapter/outbound/*/compose/**뿐이라, workflow가 그 밖 compose(예src/adapter/inbound/*/compose/)를-f로 부르면 그 파일만 바꾼 PR이 FROM-CACHE다. 지금 그런 파일은 없다.관련
nfs-nightly). 소유자 명령 정본: ci 허브 owner-actions2026-11-21-nfsd.md2절.