Azure Artifacts によるパッケージ管理

ラボの要件

このラボには、Microsoft Edge または Azure DevOps 対応ブラウザーが必要です。
Azure DevOps 組織を設定する: このラボで使える Azure DevOps 組織がまだない場合は、AZ-400 ラボの前提条件に関するページの手順に従って作成してください。
サンプルの eShopOnWeb プロジェクトを設定する: このラボで使用できるサンプルの eShopOnWeb プロジェクトがまだない場合は、AZ-400 ラボの前提条件に関するページに記載されている手順に従って作成してください。
Visual Studio 2022 Community Edition (Visual Studio のダウンロードページから入手可能)。 Visual Studio 2022 のインストールには、**ASP.NET および Web 開発**、**Azure 開発**、 **.NET Core クロスプラットフォーム開発**のワークロードを含める必要があります。
.NET Core SDK:.NET Core SDK (2.1.400 以降) をダウンロードしてインストールします
Azure Artifacts 資格情報プロバイダー:資格情報プロバイダーをダウンロードしてインストールします。

ラボの概要

Azure Artifacts は、Azure DevOps での NuGet、npm、Maven パッケージの検出、インストール、公開を容易にします。ビルドなどの他の Azure DevOps 機能と緊密に統合されているため、パッケージ管理は既存のワークフローのシームレスな部分になります。

目標

このラボを完了すると、次のことができるようになります。

フィードを作成して接続する。
NuGet パッケージを作成して公開する。
NuGet パッケージをインポートする。
NuGet パッケージを更新する。

推定時間:35 分

手順

演習 0:ラボの前提条件の構成

この演習では、ラボの前提条件を設定します。

タスク 1: (完了している場合はスキップしてください) チームプロジェクトを作成して構成する

このタスクでは、複数のラボで使用される eShopOnWeb Azure DevOps プロジェクトを作成します。

ラボコンピューターのブラウザーウィンドウで、Azure DevOps 組織を開きます。 [新しいプロジェクト] をクリックします。プロジェクトに「eShopOnWeb」という名前を付け、他のフィールドは既定値のままにします。 [作成] をクリックします。

タスク 2: (完了している場合はスキップしてください) eShopOnWeb Git リポジトリをインポートする

このタスクでは、複数のラボで使用される eShopOnWeb Git リポジトリをインポートします。

ラボコンピューターのブラウザーウィンドウで、Azure DevOps 組織と、前に作成した eShopOnWeb プロジェクトを開きます。 [リポジトリ]、[ファイル]、[リポジトリをインポートする] の順にクリックします。 インポート を選択します。 [Git リポジトリをインポートする] ウィンドウで、URL https://github.com/MicrosoftLearning/eShopOnWeb.git を貼り付けて、 [インポート] をクリックします。
リポジトリは次のように編成されています。
- .ado フォルダーには、Azure DevOps の YAML パイプラインが含まれています。
- .devcontainer フォルダーには、コンテナーを使って開発するためのセットアップが含まれています (VS Code でローカルに、または GitHub Codespaces で)。
- infra フォルダーには、一部のラボシナリオで使用される Bicep および ARM のコードとしてのインフラストラクチャテンプレートが含まれています。
- .github フォルダーには、YAML GitHub ワークフローの定義が含まれています。
- src フォルダーには、ラボシナリオで使用される .NET 8 Web サイトが含まれています。

タスク 3: (完了している場合はスキップしてください) メインブランチを既定のブランチとして設定する

[リポジトリ]、[ブランチ] の順に移動します。
main ブランチをポイントし、列の右側に表示される省略記号をクリックします。
[既定のブランチとして設定] をクリックします。

タスク 4:Visual Studio で eShopOnWeb ソリューションを構成する

このタスクでは、ラボの準備をするために Visual Studio を構成します。

Azure DevOps ポータルで eShopOnWeb チームプロジェクトを表示していることを確認します。

注:https://dev.azure.com/<your-Azure-DevOps-account-name>/eShopOnWeb という URL に移動することで、プロジェクトページに直接アクセスできます。<your-Azure-DevOps-account-name> プレースホルダーは、ご自分の Azure DevOps 組織名を表します。
eShopOnWeb ペインの左側にある垂直メニューで、[リポジトリ] をクリックします。
[ファイル] ペインで、 [複製] をクリックし、 [VS Code で複製] の横にあるドロップダウン矢印を選択し、ドロップダウンメニューで [Visual Studio] を選択します。
続行するかどうかを確認するメッセージが表示されたら、 [開く] をクリックします。
プロンプトが表示されたら、Azure DevOps 組織のセットアップに使用したユーザーアカウントでサインインします。
Visual Studio インターフェイス内の Azure DevOps ポップアップウィンドウで、既定のローカルパス (C:\eShopOnWeb) をそのままにして、[クローン] をクリックします。これにより、プロジェクトが Visual Studio に自動的にインポートされます。
ラボで使用するために、Visual Studio ウィンドウを開いたままにします。

演習 1:Azure Artifacts の操作

この演習では、次の手順を使用して Azure Artifacts を操作する方法を学習します。

フィードを作成して接続する。
NuGet パッケージを作成して公開する。
NuGet パッケージをインポートする。
NuGet パッケージを更新する。

タスク 1:フィードを作成して接続する

このタスクでは、フィードを作成して接続します。

Azure DevOps ポータルでプロジェクト設定を表示している Web ブラウザーウィンドウの垂直ナビゲーションペインで、 [アーティファクト] を選択します。
アーティファクト ハブが表示された状態で、ペインの上部にある [+ フィードの作成] をクリックします。

注:このフィードは、組織内のユーザーが利用できる NuGet パッケージのコレクションであり、ピアとしてパブリック NuGet フィードと並んで配置されます。このラボのシナリオでは、Azure Artifacts を使用するためのワークフローに焦点を当てているため、実際のアーキテクチャと開発の決定は純粋に例示的なものです。このフィードには、この組織のプロジェクト間で共有できる共通の機能が含まれます。
[新しいフィードの作成] ウィンドウの [Name] テキストボックスに「eShopOnWebShared」と入力します。 [可視性] セクションで [特定のユーザー] を選択し、[スコープ] セクションで [Project:eShopOnWeb] オプションを選択し、他の設定を既定値のままにして、[作成] をクリックします。

注:このNuGet フィードに接続するユーザーは、環境を構成する必要があります。
アーティファクト ハブに戻り、 [フィードに接続] をクリックします。
[フィードに接続] ペインの [NuGet] セクションで [Visual Studio] を選択し、 [Visual Studio] ペインでソース URL をコピーします。 https://pkgs.dev.azure.com/Azure-DevOps-Org-Name/_packaging/eShopOnWebShared/nuget/v3/index.json
Visual Studio ウィンドウに戻ります。
Visual Studio ウィンドウで、 [ツール] メニューヘッダーをクリックし、ドロップダウンメニューで [NuGet Package Manager] を選択し、カスケードメニューで [パッケージマネージャー設定] を選択します。
[オプション] ダイアログボックスで、 [パッケージソース] をクリックし、プラス記号をクリックして新しいパッケージソースを追加します。
ダイアログボックスの下部にある [名前] テキストボックスで、[パッケージソース] を eShopOnWebShared に置き換え、[ソース] テキストボックスに、Azure DevOps ポータルでコピーした URL を貼り付けます。
[更新] をクリックし、 [OK] をクリックして追加を完了します。

注:Visual Studio が新しいフィードに接続されました。

タスク 2: 社内で開発された NuGet パッケージを作成して発行する

このタスクでは、社内で開発したカスタム NuGet パッケージを作成して発行します。

新しいパッケージソースの構成に使用した Visual Studio ウィンドウで、メインメニューの [ファイル] をクリックし、ドロップダウンメニューの [新規] をクリックしてから、カスケードメニューの [プロジェクト] をクリックします。

注:NuGet パッケージとして公開される共有アセンブリを作成して、他のチームがプロジェクトソースを直接操作しなくても、アセンブリを統合して最新の状態に保つことができるようにします。
[新しいプロジェクトの作成] ペインの [最近のプロジェクトテンプレート] ページで、検索テキストボックスを使ってクラスライブラリ テンプレートを見つけ、C# 用のテンプレートを選んで [次へ] をクリックします。

[新しいプロジェクトの作成] ペインの [クラスライブラリ] ページで、次の設定を指定して [作成] をクリックします。

設定	[値]
プロジェクト名	eShopOnWeb.Shared
場所	既定値を受け入れる
ソリューション	新しいソリューションの作成
ソリューション名	eShopOnWeb.Shared

[ソリューションとプロジェクトを同じディレクトリに配置する] のチェックボックスをオンにします。

[次へ] をクリックします。 .NET 8 をフレームワークオプションとして受け入れます。
[作成] ボタンを選んで、プロジェクトの作成を確認します。
Visual Studio インターフェイス内の [ソリューションエクスプローラー] ウィンドウで、 [Class1.cs] を右クリックし、右クリックメニューで [削除] を選択し、確認を求められたら [OK] をクリックします。
Ctrl + Shift + B キーを押すか、EShopOnWeb.Shared プロジェクトを右クリックして [ビルド] を選び、プロジェクトをビルドします。
ラボワークステーションから [スタート] メニューを開き、Windows PowerShell を見つけます。次に、カスケードメニューの [Windows PowerShell を管理者として開く] をクリックします。

  **[管理者:Windows PowerShell]** ウィンドウで、次のコマンドを実行して eShopOnWeb.Shared フォルダーに移動します。

   cd c:\eShopOnWeb\eShopOnWeb.Shared

注:eShopOnWeb.Shared フォルダーは、eShopOnWeb.Shared.csproj ファイルの場所です。別の場所またはプロジェクト名を選択した場合は、代わりにその場所に移動します。

次を実行して、プロジェクトから .nupkg ファイルを作成します (XXXXXX プレースホルダーの値を一意の文字列に変更します)。
```
dotnet pack .\eShopOnWeb.Shared.csproj -p:PackageId=eShopOnWeb-XXXXX.Shared
```
注:dotnet pack コマンドは、プロジェクトをビルドし、NuGet パッケージを bin\Release フォルダーに作成します。 [リリース] フォルダーがない場合は、代わりに [デバッグ] フォルダーを使用できます。

注: [管理者:Windows PowerShell] ウィンドウに表示される警告はすべて無視します。

注意: dotnet pack は、プロジェクトから識別できる情報に基づいて最小限のパッケージをビルドします。引数 -p:PackageId=eShopOnWeb-XXXXXX.Shared を使用すると、プロジェクトに含まれている名前を使用する代わりに、特定の名前を持つパッケージを作成できます。たとえば、文字列 12345 を XXXXXX プレースホルダーに置き換えた場合、パッケージの名前は eShopOnWeb-12345.Shared.1.0.0.nupkg になります。バージョン番号は、アセンブリから取得されました。
PowerShell ウィンドウで、次のコマンドを実行して、bin\Release フォルダーを開きます。
```
cd .\bin\Release
```
次を実行して、パッケージを eShopOnWebShared フィードに発行します。ソースを、前に Visual Studio Source URL https://pkgs.dev.azure.com/Azure-DevOps-Org-Name/_packaging/eShopOnWebShared/nuget/v3/index.jsonからコピーした URL に置き換えます。
```
dotnet nuget push --source "https://pkgs.dev.azure.com/Azure-DevOps-Org-Name/_packaging/eShopOnWebShared/nuget/v3/index.json" --api-key az "eShopOnWeb.Shared.1.0.0.nupkg"
```
重要: Azure DevOps で認証できるようにするには、オペレーティングシステムの資格情報プロバイダーをインストールする必要があります。インストール手順については、「Azure Artifacts 資格情報プロバイダー」を参照してください。 PowerShell ウィンドウで次のコマンドを実行することでインストールできます: iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

注:API キーを指定する必要があります。これは、空でない文字列にすることができます。ここでは az を使用しています。プロンプトが表示されたら、Azure DevOps 組織にサインインします。

注: プロンプトが表示されない場合、または警告警告が表示される場合: プラグイン資格情報プロバイダーは資格情報を取得できませんでした。認証には手動による操作が必要な場合があります。dotnetの場合は –interactive、MSBuild の場合は /p:NuGetInteractive=true を指定してコマンドを再実行するか、NuGet” の -NonInteractive スイッチを削除することを検討してください。–interactive パラメーターをコマンドに追加できます。
パッケージプッシュ操作の成功の確認を待ちます。
Azure DevOps ポータルを表示する Web ブラウザーウィンドウに切り替え、垂直ナビゲーションペインで [アーティファクト] を選択します。
[成果物] ハブペインで、左上隅のドロップダウンリストをクリックし、フィードのリストで eShopOnWebShared エントリを選びます。

注:eShopOnWebShared フィードには、新しく発行された NuGet パッケージが含まれているはずです。
NuGet パッケージをクリックして、詳細を表示します。

タスク 3: オープンソース NuGet パッケージを Azure DevOps パッケージフィードにインポートする

独自のパッケージを開発するだけでなく、オープンソースの NuGet (https://www.nuget.org) DotNet パッケージライブラリを使用することもできます。数百万個のパッケージを利用できるので、必ず何かアプリケーションに役立つものがあります。

このタスクでは、汎用の “Newtonsoft.Json” サンプルパッケージを使用しますが、ライブラリ内の他のパッケージにも同じ方法を使用できます。

以前のタスクで使用されたのと同じ PowerShell ウィンドウで、eShopOnWeb.Shared フォルダー (cd..) に移動し、次の dotnet コマンドを実行して、サンプルパッケージをインストールします。
```
dotnet add package Newtonsoft.Json
```

インストールプロセスの出力を確認します。これには、パッケージのダウンロードを試みるさまざまなフィードが示されています。

Feeds used:
  https://api.nuget.org/v3/registration5-gz-semver2/newtonsoft.json/index.json
  https://pkgs.dev.azure.com/<AZURE_DEVOPS_ORGANIZATION>/eShopOnWeb/_packaging/eShopOnWebShared/nuget/v3/index.json

その次に、実際のインストールプロセス自体に関する追加の出力が示されています。

Determining projects to restore...
Writing C:\Users\AppData\Local\Temp\tmpxnq5ql.tmp
info : X.509 certificate chain validation will use the default trust store selected by .NET for code signing.
info : X.509 certificate chain validation will use the default trust store selected by .NET for timestamping.
info : Adding PackageReference for package 'Newtonsoft.Json' into project 'c:\eShopOnWeb\eShopOnWeb.Shared\eShopOnWeb.Shared.csproj'.
info :   GET https://api.nuget.org/v3/registration5-gz-semver2/newtonsoft.json/index.json
info :   OK https://api.nuget.org/v3/registration5-gz-semver2/newtonsoft.json/index.json 124ms
info : Restoring packages for c:\eShopOnWeb\eShopOnWeb.Shared\eShopOnWeb.Shared.csproj...
info :   GET https://api.nuget.org/v3/vulnerabilities/index.json
info :   OK https://api.nuget.org/v3/vulnerabilities/index.json 84ms
info :   GET https://api.nuget.org/v3-vulnerabilities/2024.02.15.23.23.24/vulnerability.base.json
info :   GET https://api.nuget.org/v3-vulnerabilities/2024.02.15.23.23.24/2024.02.17.11.23.35/vulnerability.update.json
info :   OK https://api.nuget.org/v3-vulnerabilities/2024.02.15.23.23.24/vulnerability.base.json 14ms
info :   OK https://api.nuget.org/v3-vulnerabilities/2024.02.15.23.23.24/2024.02.17.11.23.35/vulnerability.update.json 30ms
info : Package 'Newtonsoft.Json' is compatible with all the specified frameworks in project 'c:\eShopOnWeb\eShopOnWeb.Shared\eShopOnWeb.Shared.csproj'.
info : PackageReference for package 'Newtonsoft.Json' version '13.0.3' added to file 'c:\eShopOnWeb\eShopOnWeb.Shared\eShopOnWeb.Shared.csproj'.
info : Writing assets file to disk. Path: c:\eShopOnWeb\eShopOnWeb.Shared\obj\project.assets.json
log  : Restored c:\eShopOnWeb\eShopOnWeb.Shared\eShopOnWeb.Shared.csproj (in 294 ms).

Newtonsoft.Json パッケージが、Newtonsoft.Json として [パッケージ] にインストールされました。 Visual Studio ソリューションエクスプローラーで eShopOnWeb.Shared プロジェクトに移動し、[依存関係] を展開して、[パッケージ] の下にある Newtonsoft.Json に注目します。 [パッケージ] の左側にある小さな矢印をクリックして、フォルダーとファイルの一覧を開きます。

Azure DevOps Artifacts パッケージフィードを作成すると、設計上、アップストリームソース（例えば、dotnet の場合は nuget.org）を許可します。これにより、パッケージがホストされている場所から Newtonsoft.Json パッケージを取り込むことができます。これは、パッケージの重複を回避し、最新バージョンが常に使用されるようにする一般的な方法です。

Azure DevOps ポータルで、成果物パッケージフィードページを更新します。パッケージの一覧に、eShopOnWeb.Shared カスタム開発パッケージと Newtonsoft.Json パブリックソースパッケージの両方が表示されます。
Visual Studio の eShopOnWeb.Shared ソリューションで eShopOnWeb.Shared プロジェクトを右クリックし、コンテキストメニューから [NuGet パッケージの管理] を選択します。
NuGet パッケージマネージャーウィンドウで、[パッケージソース] が eShopOnWebShared に設定されていることを確認します。
[参照] をクリックして、NuGet パッケージの一覧が読み込まれるまで待ちます。
この一覧には、eShopOnWeb.Shared カスタム開発パッケージと Newtonsoft.Json パブリックソースパッケージの両方も表示されます。

確認

このラボでは、次の手順を使用して Azure Artifacts を操作する方法を学習しました：

作成してフィードに接続しました。
NuGet パッケージを作成して公開しました。
カスタム開発 NuGet パッケージをインポートしました。