ci(nfs): NFS nightly의 호스트 확인·로그·--rerun을 고치고 이미지를 digest로 고정한다 #80

Merged
donghyeon.kang merged 3 commits from ci/nfs-nightly-host-check-and-pin into main 2026-11-21 15:24:55 +00:00
Owner

무엇을, 왜

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` 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절.
donghyeon.kang added 3 commits 2026-11-21 11:13:05 +00:00
문제: 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
donghyeon.kang merged commit b2bfb9bbf0 into main 2026-11-21 15:24:55 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#80