문제: infra/ 43개 중 12개는 코드·테스트·workflow·스크립트 어디서도
읽지 않는다(httpclient·jpa·messaging·notification의 toxiproxy compose와
README). nginx 설정, Kubernetes PVC 인증 job, DB 역할 SQL 셋은 운영
인프라라 개발 repo에 둘 것이 아니다(소유자 결정 2026-11-07). release.yml
의 fileserver-pvc-certification job은 그 매니페스트 문자열만 grep했다.
고른 방법:
- 15개를 지운다.
- 운영 조건만 그 기능 문서에 한국어로 남긴다.
docs/fileserver/operations.md 「운영 환경이 지켜야 할 조건」(nginx
internal location·alias·X-Accel-Redirect 헤더 제거·스트리밍, PVC
ReadWriteOnce·fsGroup), storage-certification.md(인증 절차),
docs/jpa/security.md 「역할과 권한」·「서버 설정」(역할 SQL과
jpa/postgres README 내용), docs/messaging/security.md(인증서 SAN).
httpclient TLS README 내용은 docs/httpclient/security.md에 이미 있다.
- release.yml job과 needs 줄, fileserver-pr.yml·pr-adapters.yml의 지운
경로 필터를 지운다.
- fileserver 지원 표의 "Kubernetes ReadWriteOnce PVC — Limited" 행은
근거 job이 없어져 「주장하지 않음」으로 옮긴다.
버린 대안: 인프라 파일을 project-infra로 옮기기(설계 Q6). 그 repo는
특정 프로젝트용이라 범용 템플릿 파일을 받을 자리가 없다.
위험·한계: 지원 표에서 PVC 주장이 빠진다. 파생 서비스가 그 파일을
배포에 썼다면 병합이 지운다(B-50). 클러스터 인증은 이제 배포하는 쪽이
문서 절차로 한다.
검증(desktop, 트리 749a3328, ~/t1-layout-logs/):
- :composition:fileserver-platform:check :app-bootstrap:check
:app-bootstrap:documentContractTest rc=0 (repositoryContractTest,
FileserverDocumentationCoverageTest 실행)
- :verifyStrictLaneStages --dry-run rc=0
- scripts/verify-compose-profile-contracts.sh rc=0 (18 lane)
- check-work-docs.py, 상대 링크 검사 rc=0
Refs: design-docs repo-structure/01-backend-layout.md 4.4, 6.3
BREAKING CHANGE: infra/fileserver/nginx, infra/fileserver/kubernetes, infra/jpa, infra/httpclient, infra/messaging, infra/notification/toxiproxy와 release.yml fileserver-pvc-certification job이 없어진다. docs/upgrade/2026-11-maturity-review.md B-50.
111 lines
4.2 KiB
YAML
111 lines
4.2 KiB
YAML
name: fileserver-pr
|
|
|
|
# Every claim in docs/fileserver/support-matrix.md that says "Stable" is backed by a job here.
|
|
# A support level with no job behind it is a marketing claim, not an engineering one, and
|
|
# DocumentationCoverageTest fails the build when the two drift apart.
|
|
|
|
on:
|
|
workflow_dispatch:
|
|
pull_request:
|
|
paths:
|
|
- 'src/application-fileserver/**'
|
|
- 'src/adapter/inbound/web-fileserver/**'
|
|
- 'src/adapter/outbound/fileserver/**'
|
|
- 'src/adapter/outbound/persistence-fileserver/**'
|
|
- 'src/composition/fileserver-platform/**'
|
|
- 'src/adapter/outbound/persistence-jpa/src/**/fileserver/**'
|
|
- 'src/app-bootstrap/src/**/fileserver/**'
|
|
- 'docs/fileserver/**'
|
|
# The capability is not only its Java files. A change to the bound settings, the shipped
|
|
# environment, the registry that documents it, or the container that has to give it a
|
|
# writable volume changes how it behaves at runtime just as surely — and those were the
|
|
# exact files that could previously ship unverified.
|
|
- 'src/app-bootstrap/src/main/resources/application.yml'
|
|
- 'src/.env'
|
|
- 'docs/registries/env-keys.yaml'
|
|
- 'src/Dockerfile'
|
|
- 'docker-compose.yml'
|
|
- 'infra/fileserver/nfs/**'
|
|
- '.github/workflows/fileserver-pr.yml'
|
|
# Every Gradle job here installs its toolchain through this composite action, so a change to
|
|
# it changes what this gate runs.
|
|
- '.github/actions/setup-gradle-java/action.yml'
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
concurrency:
|
|
group: ${{ github.workflow }}-${{ github.ref }}
|
|
cancel-in-progress: true
|
|
|
|
jobs:
|
|
fileserver-unit-and-architecture:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
# The architecture half of this claim is ci-quality-gates.yml's `architectureCheck`, which runs
|
|
# the whole ArchUnit suite on the same pull request; a filtered second run here was the repeat
|
|
# review BUILD-중복-6 removed.
|
|
- name: Run the fileserver application and assembly suites
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:application-fileserver:test
|
|
:composition:fileserver-platform:test
|
|
--stacktrace
|
|
|
|
fileserver-local-ext4-contract:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Certify the local content store against the shared contract
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:adapter:outbound:fileserver:test
|
|
--stacktrace
|
|
|
|
fileserver-http-contract:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Run the servlet transport contracts
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:adapter:inbound:web-fileserver:test
|
|
--stacktrace
|
|
|
|
fileserver-security-suite:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 20
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Run the path, filename, range, and problem-detail hardening suite
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:adapter:inbound:web-fileserver:test --tests '*FileserverHardeningContractTest'
|
|
:adapter:outbound:fileserver:test --tests '*PhysicalPathResolverTest'
|
|
--stacktrace
|
|
|
|
fileserver-bounded-memory:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 20
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Prove transfer cost does not scale with file size
|
|
working-directory: src
|
|
run: >-
|
|
./gradlew
|
|
:adapter:outbound:fileserver:test --tests '*LargeFileBoundedMemoryTest'
|
|
--stacktrace
|