Fix: 릴리스 검증이 전파 지연을 기다리게 한다

[jjh75607]

Pull Request

Related Issue

• 없음. 0.4.0 을 내면서 겪은 것이다.

Summary

verify-release.yml 이 Central 전파를 기다리지 않고 곧바로 404 로 실패하던 것을 고쳤다.

Details

무엇이 문제였나

Central 은 Publish 를 누른 뒤 repo1.maven.org 로 동기화되기까지 몇 분에서 수십 분 걸린다. 그런데 이 워크플로는 곧바로 받아 보고 없으면 끝냈다.

전파 지연과 진짜 실패가 구분되지 않는다. 나오는 것은 이 한 줄뿐이다.

curl: (22) The requested URL returned error: 404

0.4.0 에서 실제로 그렇게 됐다. Publish 직후에 돌렸더니 실패했고, 포털에서는 아직 처리 중이었다. 릴리스는 정상인데 검증이 실패로 나왔다. 이 상태에서 사람이 할 판단은 "릴리스가 깨졌다" 이고, 그건 틀린 판단이다.

어떻게 고쳤나

최대 15분까지(30회, 30초 간격) 기다려 본 다음 실패시킨다. 받으면 몇 번째에 받았는지 찍는다.

끝까지 없으면 무엇을 확인해야 하는지 함께 낸다.

900초를 기다렸는데 v0.4.0 이 repo1 에 없다. 셋을 확인한다.

  1. Central 포털에서 Publish 를 눌렀는가. 누르기 전에는 올라가 있어도 나가지 않는다
  2. 눌렀다면 그 배포가 PUBLISHED 인가. 아직 처리 중이면 조금 뒤에 이것을 다시 돌린다
  3. 둘 다 맞는데 없으면 좌표나 버전을 확인한다

  https://central.sonatype.com/publishing/deployments

POM 과 jar 둘 다 같은 함수를 쓴다.

문서

CLAUDE.md 의 릴리스 절차에 4번(Publish)과 5번(검증) 사이의 시차를 적었다. 절차만 보고 따라가는 사람이 같은 오독을 하지 않게 하려는 것이다. 수동 실행 명령도 함께 적었다.

확인

• YAML 파싱과 셸 문법 검사 통과. 처음에 heredoc 을 들여쓰지 않아 YAML 블록이 깨졌고, 그래서 echo 로 바꿨다
• 실제 동작은 이 PR 을 머지한 뒤 0.4.0 검증을 다시 돌려서 확인한다. 지금 전파를 기다리는 중이라 마침 그 상황이다

ETC

• 뒤쪽의 서명, sources, javadoc 확인 단계에는 재시도를 넣지 않았다. POM 과 jar 이 도착했으면 나머지도 같이 있다. 그 가정이 깨지면 그때 넣는다