Maven Central 배포 준비 메모: 계정·POM·GPG 서명
Maven Central 배포를 준비하면서 참고했던 자료를 정리한 메모입니다. 사내 저장소에 파일을 올리는 것과 달리, 공개 저장소에서는 배포 권한과 패키지 정보, 서명도 준비해야 했습니다.
이 메모를 작성한 2019년에는 OSSRH 계정을 만들고 승인을 받는 절차를 사용했습니다. OSSRH는 2025년 6월 30일 종료됐으므로, 새 배포를 준비한다면 Sonatype의 Central Publisher Portal 안내 를 기준으로 진행해야 합니다.
당시 준비 항목
당시 메모에는 OSSRH 계정 승인과 GPG 키, Maven의 settings.xml이나 Gradle의 gradle.properties를 이용한 설정이 남아 있습니다. Bintray를 통해 JCenter나 Central에 동기화하는 방법도 참고했습니다.
이 자료들은 당시 배포 절차를 살펴보기 위한 기록입니다. 지금 사용할 인증 정보나 업로드 주소는 현재 배포 도구의 안내와 맞춰야 합니다.
GPG 서명 설정
서명은 배포 파일과 함께 제공하는 서명 파일을 만드는 과정입니다. Gradle에서는 Signing Plugin으로 설정할 수 있습니다. 키를 어떤 형식으로 전달할지는 사용하는 Gradle 버전과 실행 환경에 맞춰 확인해야 합니다.
gradle.properties에 값을 적는 것 자체가 암호화는 아닙니다. 개인 키와 암호를 저장소에 포함하지 않고, 로컬 설정이나 CI의 비밀 값 관리 기능으로 전달해야 합니다. 현재 Gradle은 파일로 된 키링 외에 메모리에서 키를 사용하는 설정 도 설명합니다.
POM과 배포 설정
공개 라이브러리는 사용하는 사람이 출처와 라이선스를 확인할 수 있어야 합니다. 배포 파일 외에 프로젝트 설명, 라이선스, 개발자와 소스 저장소 정보도 함께 준비할 항목입니다.
Gradle에서 배포 파일과 POM을 구성하는 방법은 Publishing 문서 를, 서명 설정은 Signing Plugin 문서 를 참고할 수 있습니다. 저장소 업로드 인증과 파일 서명 설정은 서로 다른 역할이므로 나눠 확인하는 편이 좋습니다.