NuGet staged publishing: 패키지 업로드와 공개 승인을 분리하기
NuGet.org 스테이징의 비공개 검증, staging-only 권한과 그룹 배포의 비원자성을 구분하고 릴리스 점검 절차를 정리한다.
빌드 성공과 공개 배포는 서로 다른 결정이다. 여러 패키지를 함께 내보낼 때는 특히 그렇다. 업로드가 곧 공개라면 누락된 의존성이나 잘못된 버전을 발견했을 때 이미 소비자가 받아 갔을 수 있다.
패키지 준비와 공개 사이의 승인 경계를 표현한 생성형 개념 이미지다. NuGet 실제 화면이 아니다.
업로드 뒤 멈출 수 있는 지점
Microsoft는 November 17, 2026 NuGet.org의 staged publishing을 모든 패키지 게시자에게 제공한다고 발표했다. 선택적으로 사용하는 기능이며 기존 push 흐름은 유지된다.
스테이징된 패키지는 검증을 거쳐도 승인 전까지 공개되지 않는다. unlist는 정확한 버전으로 복원할 수 있지만 스테이징은 다르다. 소유자에게도 비공개 restore 피드를 제공하지 않으므로 실제 패키지 테스트는 로컬·사설 피드에서 먼저 해야 한다. 공식 발표
그룹 승인도 동시 배포는 아니다
관련 패키지를 staging group으로 묶을 수 있다. 그러나 그룹 공개는 원자적이지 않다. 개별 패키지의 배포 시점이 달라질 수 있어 승인 버튼 하나를 “모두 복원 가능”의 증거로 쓰면 안 된다.
승격은 2FA가 활성화된 권한 있는 사용자가 NuGet.org 웹사이트에서 수행한다. 매번 새로운 2FA 인증을 요구한다는 뜻은 아니다. staging-only 권한을 사용하면 파이프라인 자격증명으로 일반 공개 push를 하는 경로도 제한할 수 있다.
발표에 명시된 .NET 11 RC2의 기본 업로드 예시는 다음 형태다. 실행 결과가 아닌 문서 기반 예시다.
키는 안전하게 주입해야 한다. 업로드 접수와 검증 완료는 다르다. 목록·그룹 관리 CLI는 발표 시점 로드맵이며, 공개 승격을 CLI 명령으로 가정하면 안 된다. 미승격 콘텐츠에는 만료도 있다. 지원 범위와 제한
짧은 자격증명과 공개 승인은 별개다
Trusted Publishing은 CI의 신원을 확인하고 장기 키 대신 단기 자격증명을 발급하는 방식이다. NuGet 정책과 저장소·워크플로 정보가 맞아야 한다. 공식 문서상 임시 키는 1시간 유효하므로 업로드 직전에 받아야 한다.
이는 자격증명의 노출 기간을 줄이는 장치다. staging은 공개 시점을 분리하는 장치다. 두 기능을 결합하더라도 빌드 산출물 자체가 안전하다는 보장은 생기지 않는다. Trusted Publishing 문서
팀에 적용할 작은 점검표
다음은 기능 설명을 바탕으로 제안하는 운영 절차다. 실제 배포 리허설 결과는 아니다.
- 준비 단계에서 패키지 ID, 버전, 파일 해시, 소스 커밋을 하나의 릴리스 목록으로 고정한다.
- 로컬·사설 피드에서 소비자 프로젝트를 복원하고 테스트한다. 빌드 성공만으로 끝내지 않는다.
- 업로드 후 예상 목록과 실제 스테이징 목록을 대조한다. 누락뿐 아니라 예상하지 못한 추가 파일도 확인한다.
- 승인 담당자는 검증 상태, 의존성, 공개 시각, 만료 여부를 확인한다.
- 승격 후에는 깨끗한 소비자 환경에서 필요한 버전을 모두 복원할 수 있는지 점검한 뒤 발표한다.
예를 들어 Core와 Adapter를 같이 배포한다면, Core만 보이는 구간에도 설치가 가능한지와 Adapter가 요구하는 최소 버전이 맞는지를 별도로 확인해야 한다. 이 사례의 핵심은 업로드 재시도가 아니라 배포 완료의 판정 기준이다.
도입 효과는 버튼 수가 줄어드는 데 있지 않다. 자동화가 준비한 결과를 사람이 공개하기 전에 점검할 수 있다는 데 있다. 다만 그 점검이 형식적이면 승인 경계의 실익도 작아진다.
November 18, 2026 공식 자료 기준으로 작성했다. 패키지 업로드·승격, 인증정보 생성, 설정 변경은 수행하지 않았다.