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
3 Commits
Author SHA1 Message Date
DongHyeonka b40f1a7899 Merge remote-tracking branch 'origin/main' into ci/nfs-nightly-host-check-and-pin
pr / done (pull_request) Successful in 3m23s
2026-11-21 20:12:25 +09:00
DongHyeonka 2b1b162611 build(compose): nightly가 띄우는 NFS compose 이미지를 digest로 고정한다
문제: 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
2026-11-21 20:12:09 +09:00
DongHyeonka 914c320799 ci(main): NFS nightly가 nfs·nfsd 두 모듈을 보고 실패 로그를 남긴다
문제: 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
2026-11-21 20:12:09 +09:00