NuGet Staged Publishingとは?パッケージを非公開で公開前に検証する仕組み
NuGet.orgでは、2026年11月17日にStaged Publishingという新しい公開方法が発表されました。
Staged Publishingを利用すると、NuGetパッケージを一般公開する前にステージング領域へアップロードし、NuGet.orgによる検証や公開前の確認を行えます。
従来の方法では、パッケージをアップロードすると公開処理が始まります。一方、Staged Publishingでは、アップロードと一般公開のタイミングを分けられます。
例えば、CI/CDからパッケージをアップロードしておき、最後に担当者が内容を確認してから公開するといった運用が可能です。
この記事では、NuGet Staged Publishingの仕組みや従来の公開方法との違い、利用する際の注意点について紹介します。
NuGet Staged Publishingとは?
NuGet Staged Publishingは、NuGet.orgにパッケージを一般公開する前に、非公開の状態でステージングできる機能です。
Microsoftは2026年11月17日に、この機能をNuGet.orgのパッケージ公開者向けに発表しました。
ステージングされたパッケージは、NuGet.orgによる検証を受けます。検証が完了した後、公開権限を持つ担当者がPromoteを実行することで、一般公開の処理に進みます。
主な用途として、次のようなケースが挙げられます。
- パッケージを一般公開する前に内容を確認したい
- 複数のNuGetパッケージをまとめてリリースしたい
- セキュリティ修正の公開タイミングを調整したい
- CI/CDによるアップロードと人間による公開承認を分離したい
Staged Publishingでは、パッケージの準備と一般公開のタイミングを分離できることが特徴です。
なお、ここでいう検証はNuGet.org側で行われる検証です。ステージング領域をプライベートフィードとして利用し、自分のアプリケーションからパッケージを復元して動作確認できるわけではありません。
従来のNuGetパッケージ公開との違い
従来の公開方法とStaged Publishingでは、アップロード後の処理が異なります。
| 比較項目 | 通常の公開 | Staged Publishing |
|---|---|---|
| アップロード | 公開処理を開始 | 非公開でステージング |
| NuGet.orgによる検証 | 実施 | 実施 |
| 一般公開までの流れ | 検証・公開処理を経て公開 | 検証後に担当者がPromote |
| 公開前の状態 | 非公開のステージング領域は利用しない | 一般ユーザーから取得できない |
| 公開承認 | 個別のPromote操作は不要 | Promoteが必要 |
通常の公開では、パッケージのアップロード後にNuGet.orgの公開処理が始まります。
一方、Staged Publishingでは、ステージングしたパッケージが一般公開される前に、担当者が内容や検証状況を確認できます。
Unlistとの違い
NuGetには、既に公開されているパッケージを検索結果から非表示にするUnlistという機能もあります。
ただし、UnlistとStaged Publishingは目的が異なります。
| 比較項目 | Unlist | Staged Publishing |
|---|---|---|
| 対象 | 公開済みパッケージ | 公開前のパッケージ |
| 検索結果 | 表示されない | 一般公開前のため表示されない |
| バージョン指定での復元 | 可能 | 不可 |
| 主な用途 | 公開済みバージョンを検索対象から外す | 一般公開前にパッケージを準備する |
Unlistされたパッケージは、検索結果には表示されなくなりますが、バージョンを指定すれば復元できます。
一方、Staged Publishingのパッケージは、Promoteされるまで一般ユーザーが取得できません。
Staged Publishingの仕組み
Staged Publishingでは、主に次の流れでパッケージを公開します。
1. パッケージをステージングする
NuGet.orgのアップロード画面で、Publishing ModeからStagingを選択します。
また、.NET 11 RC2 SDKに対応したCLIを利用して、ステージングアップロードを行うこともできます。
2. NuGet.orgによる検証を受ける
アップロードされたパッケージは、NuGet.orgの検証処理を受けます。
Microsoftが紹介している検証処理には、次のようなものがあります。
- マルウェアスキャン
- 署名の確認
- リポジトリ署名
検証に成功すると、パッケージは公開承認が可能な状態になります。
検証に失敗した場合は、問題を修正したパッケージを再度ステージングする必要があります。
3. パッケージの内容と検証状況を確認する
NuGet.orgのパッケージ管理画面から、ステージングしたパッケージや検証状況を確認できます。
公開する前に、次のような項目を確認しておくことが重要です。
- パッケージID
- バージョン
- 公開する予定のパッケージが揃っているか
- NuGet.orgによる検証状況
4. Promoteで公開する
内容や検証状況に問題がなければ、NuGet.org上でPromoteを実行します。
これによって一般公開の処理が開始されます。
公開承認には、2要素認証を有効にしたアカウントでの認証済みセッションが必要です。
ただし、公開承認のたびに新しい2要素認証の認証チャレンジが必ず発生するという意味ではありません。
また、公開承認はNuGet.orgのWebサイトから行います。CLIからPromoteする機能は、Microsoftの発表時点では提供されていません。
NuGet Staged Publishingの使い方
Staged PublishingはNuGet.orgのWebサイトから利用できます。
1. NuGet.orgにログインする
まず、NuGet.orgにアクセスして、パッケージを管理するアカウントでログインします。
2. パッケージをアップロードする
NuGet.orgのUpload Packageから、公開したいNuGetパッケージを選択します。
Publishing ModeでStagingを選択し、ステージングとしてアップロードします。
3. 検証結果を確認する
アップロード後、NuGet.orgのパッケージ管理画面から検証状況を確認します。
検証が完了し、公開可能な状態になっていることを確認してください。
4. Promoteで公開する
公開するパッケージのIDやバージョン、検証状況を確認したうえでPromoteを実行します。
これにより、ステージング状態のパッケージが一般公開の処理に進みます。
CLIからパッケージをステージングする方法
Staged Publishingは、NuGet.orgのWebサイトだけでなく、CLIからステージングアップロードを行うこともできます。
Microsoftの発表では、.NET 11 RC2 SDKで基本的なステージングアップロードに対応しています。
通常のパッケージをステージングする
以下は、Microsoft公式ブログで紹介されているコマンド例です。
dotnet package stage push ./artifacts/Contoso.Library.1.2.0.nupkg \
--source https://api.nuget.org/v3/index.json \
--api-key "$NUGET_API_KEY"
各引数の意味は次のとおりです。
| 引数 | 説明 |
|---|---|
dotnet package stage push | ステージングアップロードを実行するコマンド |
.nupkg | アップロードするパッケージファイル |
--source | アップロード先のNuGetフィード |
--api-key | 認証に利用するAPIキー |
NUGET_API_KEYには、ステージングアップロードに対応した認証情報を設定します。
APIキーをソースコードに直接記述せず、環境変数やCI/CDのシークレット機能などで管理することが推奨されます。
Staging Groupを指定する
複数のパッケージをまとめて管理したい場合は、--group を指定できます。
dotnet package stage push ./artifacts/Contoso.Library.1.2.0.nupkg \
--source https://api.nuget.org/v3/index.json \
--api-key "$NUGET_API_KEY" \
--group november-release
この例では、november-release というIDのStaging Groupにパッケージをアップロードします。
指定したグループが存在しない場合、NuGet.orgによって自動的に作成されます。
なお、このコマンドはステージングアップロードを行うものです。アップロードが成功しても、NuGet.orgによる検証や一般公開が完了したことを意味しません。
検証状況の確認と公開承認は、NuGet.orgのWebサイトで行います。
Staging Groupとは?
Staging Groupは、複数のNuGetパッケージをまとめて管理するための機能です。
例えば、ライブラリ本体と関連する拡張パッケージ、アナライザーなどを、1つのリリースグループとして管理できます。
November Release
├─ Contoso.Library
├─ Contoso.Library.Extensions
├─ Contoso.Library.Analyzers
└─ Contoso.Library.Integrations
グループを利用すると、個別のパッケージだけでなく、リリース対象全体の検証状況を確認できます。
公開するときは、個別のパッケージをPromoteする方法と、グループ全体をPromoteする方法があります。
ただし、グループ全体をPromoteしても、すべてのパッケージが完全に同時に利用可能になるわけではありません。
NuGet.orgの公開処理はパッケージごとに進むため、復元可能になるタイミングに差が生じる場合があります。
また、Staging Groupにはユーザーまたは組織の所有者が設定されます。別の所有者の管理下にあるグループについては、パッケージの共同所有者であっても、自動的にアクセス権が付与されるわけではありません。
利用する際の注意点
Staged Publishingを利用する際には、次の点に注意が必要です。
ステージング状態ではパッケージを復元できない
ステージング中のパッケージは、一般ユーザー向けのNuGet.orgフィードから取得できません。
また、パッケージの所有者であっても、ステージング領域をプライベートフィードとして利用することはできません。
そのため、公開前にアプリケーションからパッケージを復元して動作確認したい場合は、ローカルフィードや別のプライベートフィードを利用する必要があります。
Staged PublishingによるNuGet.org側の検証と、開発環境での動作確認は別のものとして考えましょう。
グループの公開は完全に同時ではない
Staging Groupを利用すると、複数のパッケージをまとめて公開承認できます。
ただし、グループ内のパッケージが完全に同時に一般公開されるわけではありません。
NuGet.orgの公開処理はパッケージごとに進むため、実際に復元できるようになるタイミングに差が生じる場合があります。
パッケージ間に依存関係がある場合は、公開の順序や利用可能になるまでの時間を考慮する必要があります。
ステージングには有効期限がある
ステージングされたパッケージは、永久に保存されるわけではありません。
Microsoftの発表では、Promoteされないままのステージング内容は期限切れになると説明されています。
長期間のリリース準備を行う場合は、NuGet.org上の期限切れに関する通知を確認してください。
なお、期限の具体的な日数については、公式発表で一律の期間として示されていないため、ここでは記載していません。
APIキーの権限を確認する
NuGet.orgでは、ステージング専用のAPIキーを利用できます。
ステージング専用のAPIキーであれば、CI/CDからパッケージをステージングすることはできますが、通常のPushによって直接一般公開することはできません。
また、NuGet Trusted Publishingのポリシーもステージング用途に制限できます。
CI/CDで自動アップロードを行う場合は、ステージングと一般公開の権限を分離することが重要です。
ただし、ステージング専用の認証情報を使っていても、アップロードされたパッケージの内容が安全であることまで保証されるわけではありません。
NuGet.orgの検証に加えて、パッケージの内容や依存関係についても確認する必要があります。
まとめ
NuGet Staged Publishingは、NuGet.orgにパッケージを一般公開する前に、非公開のステージング領域へアップロードできる機能です。
アップロード後はNuGet.orgによる検証を受け、公開権限を持つ担当者がPromoteすることで一般公開の処理に進みます。
今回の内容をまとめると、次のとおりです。
- NuGet.orgで2026年11月17日に発表された機能
- パッケージを非公開の状態でステージングできる
- NuGet.orgによるマルウェアスキャンや署名関連の検証を受ける
- 公開前にパッケージの内容や検証状況を確認できる
- Staging Groupで複数パッケージを管理できる
- CLIからステージングアップロードができる
- 一般公開の承認はNuGet.orgのWebサイトで行う
- ステージング領域はプライベートフィードとして利用できない
CI/CDによるパッケージの準備と、担当者による最終的な公開判断を分離したい場合に役立つ機能です。
