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 パッケージを更新する。

推定時間:40 分

Instructions

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

この演習では、ラボの前提条件の検証、Azure DevOps 組織の準備が整っていること、および eShopOnWeb プロジェクトを作成したことについてもう一度確認してください。詳細については上記の手順を参照してください。

タスク 1: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 を使用するためのワークフローに焦点を当てているため、実際のアーキテクチャと開発の決定は純粋に例示的なものです。このフィードには、この組織のプロジェクト間で共有できる共通の機能が含まれます。
[新しいフィードの作成] ペインの [名前] テキストボックスに「eShopOnWebShared」と入力し、[スコープ] セクションで [組織] オプションを選び、他の設定を既定値のままにして、[作成] をクリックします。

注:この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 ファイルを作成します。
```
 dotnet pack .\eShopOnWeb.Shared.csproj
```
注:dotnet pack コマンドは、プロジェクトをビルドし、NuGet パッケージを bin\Release フォルダーに作成します。

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

注意: dotnet pack は、プロジェクトから識別できる情報に基づいて最小限のパッケージをビルドします。たとえば、名前が eShopOnWeb.Shared.1.0.0.nupkg となることに注意してください。そのバージョン番号は、アセンブリから取得されました。
PowerShell ウィンドウで、次のコマンドを実行して、bin\Release フォルダーを開きます。
```
 cd .\bin\Release
```
次を実行して、パッケージを eShopOnWebShared フィードに発行します。

重要: Azure DevOps で認証できるようにするには、オペレーティングシステムの資格情報プロバイダーをインストールする必要があります。インストール手順については、「Azure Artifacts 資格情報プロバイダー」を参照してください。 PowerShell ウィンドウで次のコマンドを実行することでインストールできます: iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

注:API キーを指定する必要があります。これは、空でない文字列にすることができます。ここでは az を使用しています。プロンプトが表示されたら、Azure DevOps 組織にサインインします。
```
 dotnet nuget push --source "eShopOnWebShared" --api-key az eShopOnWeb.Shared.1.0.0.nupkg
```
注:プロンプトが表示されない場合は、–interactive パラメータをコマンドに追加できます。
パッケージプッシュ操作の成功の確認を待ちます。
Azure DevOps ポータルを表示する Web ブラウザーウィンドウに切り替え、垂直ナビゲーションペインで [アーティファクト] を選択します。
[成果物] ハブペインで、左上隅のドロップダウンリストをクリックし、フィードのリストで eShopOnWebShared エントリを選びます。

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

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

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

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

同じ PowerShell ウィンドウで、eShopOnWeb.Shared フォルダーに移動し、次の 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 に注目します。 [パッケージ] の左側にある小さな矢印をクリックして、フォルダーとファイルの一覧を開きます。

タスク 4: オープンソースの NuGet パッケージを Azure Artifacts にアップロードする

このパッケージを、前に作成した Azure Artifacts パッケージフィードにアップロードすることで、DevOps チームが再利用するための “承認済み” のパッケージであると考えてみましょう。

Visual Studio で新しい Newtonsoft.Json パッケージを右クリックし、コンテキストメニューから [エクスプローラーでフォルダーを開く] を選択します。拡張機能 .nupkg を含む新しい Newtonsoft.Json パッケージが表示されます。
エクスプローラーウィンドウのアドレスバーから完全なパスをコピーします。

PowerShell ウィンドウで、パスをコピーしたものに置き換えて、次のコマンドを実行します。

 dotnet nuget push --source "eShopOnWebShared" --api-key az C:\eShopOnWeb\eShopOnWeb.Shared\Newtonsoft.Json\newtonsoft.json.13.0.3.nupkg

注: これにより、エラーメッセージが表示されます。

 Response status code does not indicate success: 409 (Conflict - 'Newtonsoft.Json 1.3.0.17' cannot be published to the feed because it exists in at least one of the feed's upstream sources. Publishing this copy would prevent you from using 'Newtonsoft.Json 1.3.0.17' from 'NuGet Gallery'. For more information, see https://go.microsoft.com/fwlink/?linkid=864880 (DevOps Activity ID: AE08BE89-C2FA-4FF7-89B7-90805C88972C)).

Azure DevOps Artifacts パッケージフィードを作成すると、設計上、dotnet の例の nuget.org などのアップストリームソースに対応します。ただし、DevOps チームが “内部専用” パッケージフィードを作成することを妨げるものはありません。

Azure DevOps ポータルに移動し、[成果物] を参照して、eShopOnWebShared フィードを選択します。
[アップストリームソースの検索] をクリックします
[アップストリームパッケージに移動] ウィンドウで、パッケージの種類として [NuGet] を選択し、検索フィールドに「Newtonsoft.Json」と入力します。
[検索] ボタンを選んで確定します。
これにより、すべての Newtonsoft.Json パッケージと使用可能なさまざまなバージョンの一覧が表示されます。
左方向キーを押して eShopOnWebShared フィードに戻ります。
歯車をクリックして [フィードの設定] を開きます。 [フィードの設定] ページで、 [アップストリームソース] を選びます。
さまざまな開発言語用にさまざまなアップストリームパッケージマネージャーがあることに注意してください。一覧から [NuGet ギャラリー] を選択します。 [削除] ボタン、 [保存] ボタンの順に選択します。

これらの保存した変更を使用して、次のコマンドをもう一度実行することで、PowerShell ウィンドウから NuGet.exe を使用して Newtonsoft.Json パッケージをアップロードできます。

  dotnet nuget push --source "eShopOnWebShared" --api-key az C:\eShopOnWeb\eShopOnWeb.Shared\Newtonsoft.Json\newtonsoft.json.13.0.3.nupkg

注:これでアップロードが成功します。

 Pushing newtonsoft.json.13.0.3.nupkg to 'https://pkgs.dev.azure.com/<AZURE_DEVOPS_ORGANIZATION>/_packaging/5faffb6c-018b-4452-a4d6-72c6bffe79db/nuget/v2/'...
 PUT https://pkgs.dev.azure.com/<AZURE_DEVOPS_ORGANIZATION>/_packaging/5faffb6c-018b-4452-a4d6-72c6bffe79db/nuget/v2/
 Accepted https://pkgs.dev.azure.com/<AZURE_DEVOPS_ORGANIZATION>/_packaging/5faffb6c-018b-4452-a4d6-72c6bffe79db/nuget/v2/ 3160ms
 Your package was pushed.

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

確認

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

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