Commit Graph
3 Commits
Author SHA1 Message Date
DongHyeonka d237bacc14 ci: JDK 캐시는 main에서만 저장한다
앞 커밋은 pull request만 읽기 전용으로 두고 push·schedule·수동 실행은 어느
브랜치에서든 저장하게 했다. 키가 Temurin 빌드 하나로 고정이고 처음 저장한
항목이 계속 쓰이므로, 쓰기 권한자가 브랜치에서 수동 실행으로 먼저 저장하면
그 뒤 모든 main 실행이 리뷰 없이 그 JDK를 복원한다. setup-gradle과 같은
규칙(main ref만 저장)으로 맞춘다.

위험·한계: 브랜치의 수동 실행에서는 main이 저장하기 전까지 캐시가 비어 있어
효과를 볼 수 없다. 효과는 병합 뒤 첫 main push에서 확인한다.
2026-11-12 01:28:35 +09:00
DongHyeonka 96caf997f8 ci: Gradle job마다 JDK를 내려받지 않고 runner 캐시에서 복원한다
문제: job 컨테이너가 매번 새것이라 setup-java가 빈 tool cache를 보고 Temurin
21.0.11(약 190MB)을 job마다 GitHub에서 받는다. job 하나에 21~23초, nightly
한 번(Gradle job 28개)에 약 9.5분, release 수동 한 번에 약 4분이다. 11-09에는
같은 GitHub 내려받기가 504로 실패한 job도 있었다.

고른 방법: setup-java 앞에서 actions/cache v4.3.0(node20, 커밋 SHA 고정)으로
setup-java가 설치하는 tool cache 폴더를 복원한다. setup-java는 tool cache를
먼저 보므로 복원되면 내려받지 않는다. 키는 Temurin 빌드 하나를 가리키므로
어느 브랜치에서 저장해도 내용이 같다. pull request는 읽기만 한다(검토 중인
코드가 JDK를 바꿔 넣지 못하게). push·schedule·수동 실행은 쓰기 권한자만
시작할 수 있어 저장을 허용한다.

버린 대안: JDK가 든 runner 이미지 쓰기. runner 설정은 다른 저장소(platform-core)다.

위험·한계: runner 캐시 상한은 5GB다. 이 항목은 압축 후 약 150~200MB다.

검증: runner 수동 실행 두 번째 Gradle job부터 「Trying to download」가 없는지,
setup 시간(이 PR 본문에 적는다).
2026-11-12 01:18:24 +09:00
DongHyeonka d46bab9659 ci!: workflow를 pr·main·release 셋으로 접고 단계 job 모양만 검사한다
pr / gradle (pull_request) Successful in 16m42s
pr / vulnerabilities (pull_request) Successful in 37s
pr / done (pull_request) Canceled after 0s
workflow 15개(+ composite action, jq 설치 스크립트)가 모듈 모양으로
나뉘어 있었고, 그것을 읽는 판독기(ShellScript·WorkflowGradleInvocations·
TaskSelectors, 운영 3,283줄과 그 시험 1,814줄)가 리뷰 라운드마다 새 셸
모양으로 결함을 냈다. 그런데 Gitea에서는 Actions가 꺼져 있어 workflow는
한 번도 돌지 않았다(design-docs repo-structure/03-ci.md 2.1·3.4절).

소유자가 정한 B안(같은 문서 7절, 11절 ①~⑧)대로 바꾼다.

- .gitea/workflows/pr.yml: `gradle` job이 `./gradlew :prCheck`와
  `./gradlew :verifyStrictLaneStages --dry-run` 두 줄, `vulnerabilities`
  (trivy), 필수 검사 하나 `done`.
- main.yml: push마다 mainCheck·integrationCheck·build-logic 시험·
  configuration cache·lychee·trivy·http3(권고). nightly·수동 실행에서
  PostgreSQL major·HTTP transport·Redis topology 행렬, NFS, 알림 chaos,
  jpa-next, compose smoke, 마지막에 `needs`로 performanceCheck.
- release.yml: releaseCheck와 기존 release lane, 이미지를 이 Gitea
  레지스트리에 올리고 cosign 키 쌍으로 서명한다. 수동 실행은 push·서명
  앞까지 돈다. upload/download-artifact를 쓰지 않는다. JPA 승격은
  `needs: jpa-release-gate`가 대신한다.
- 새 집계 `prCheck` = ci + verifyDependencyLocks + compose 렌더링 +
  저장소 배치 + 문서 검사(Exec). workflow와 verify.sh가 같은 한 줄을 쓴다.
- verifyStrictLaneStages: 그래프 검사(모든 strict lane이 선언한 단계의
  계획에 있다)는 그대로 두고, workflow 쪽은 고정 문자열 형식 검사로
  바꾼다. 단계마다 workflow·이벤트·필터·job·옵션·조건을 build.gradle에
  선언하고, 그 job의 step이 `run: ./gradlew <단계> <옵션>`을 가지며 다른
  run도 셸 문법 없는 ./gradlew 한 줄이고, 선언 밖의 if:, 조건 없는
  needs:, continue-on-error·shell:·defaults:, 따옴표 키·flow 형식, 다른
  working-directory, 선언 밖의 이벤트 필터가 없는지 본다. PR 단계 job
  하나는 이 검사 자신을 돌려야 한다. 셸 해석 코드와 그 시험을 지운다
  (build-logic 운영 코드 −3,167줄, 시험 −2,231줄). 우회 입력 21가지를
  TestKit 시험으로 둔다.
- scripts/verify.sh <단계>: 사람·세션의 진입점. 무거운 단계는 지금 작업
  트리를 패치로 desktop에 보내 잠금 아래에서 돌린다(operate.md 4.1절의
  손 절차). scripts/ci/는 workflow가 부르는 trivy·Redis topology·포트
  포워더·configuration cache 스크립트다.
- workflow를 읽는 시험(DeveloperExperienceContractTest, JpaRelease
  RenderingTest, FileserverDocumentationCoverageTest)과 입력 선언을
  .gitea로 옮기고, keyless 서명 시험을 키 쌍 서명 시험으로 바꾼다.
- 문서: gates.md·operate.md·docs/ci-cd·AGENTS.md(검증 절)·build-logic
  AGENTS.md(셸 규칙 문단을 세 줄로)·leaf 문서의 workflow 참조,
  docs/upgrade B-57~B-61.

버린 것: workflow 하나에 if:로 단계를 나누기(파일만 보고 단계를 알 수
없다), 레지스트리에서 생성(같은 정보의 셋째 사본), 바뀐 모듈만 돌리기
(결정 30과 충돌). 판독기를 남기고 고치기는 6라운드 13건이 반증했다.

위험: PR이 어댑터 컨테이너 lane과 Redis standalone lane을 더는 막지
않는다(main·nightly에서 빨갛게 된다. 소유자 결정 ②). main push는 ci를
다시 돌리지 않는다. 성능 lane은 매 push가 아니라 nightly에서만 돈다.
`.github/workflows/messaging-certification.yml`은 메시징 분리 작업이
지우므로 남겼다(.gitea가 있으면 Gitea가 읽지 않는다). 서명·push는 secret이
없어 실제 태그로는 돌려 보지 않았다.

BREAKING CHANGE: workflow 파일 위치와 이름, strictLaneStages 문법,
릴리스 레지스트리·서명 방식이 바뀌었다. docs/upgrade/2026-11-maturity-
review.md B-57~B-61을 따른다.
2026-11-08 21:55:43 +09:00