Azure Artifacts フィードに接続する (dotnet)

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

Azure Artifacts を使用すると、開発者はフィードの可視性設定に応じて、フィードにパッケージをシームレスに発行し、プライベートまたはパブリックに共有できます。 このガイドでは、プロジェクトを設定し、Azure Artifacts フィードを使用して認証する手順について説明します。

[前提条件]

Azure Artifacts資格情報プロバイダーを設定する

フィードで認証するには、まずAzure資格情報プロバイダーをインストールする必要があります。 dotnet に含まれているツール インストーラーを使用して、次のコマンドを使用して CLI から資格情報プロバイダーをインストールできます。

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool

リポジトリ レベルの nuget.config がAzure Artifactsソースのみを使用するように構成されている場合は、そのディレクトリの外部から install コマンドを実行するか、nuget.org をソースとして明示的に設定します。

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --source https://api.nuget.org/v3/index.json

必要に応じて、ツールをメジャー バージョンにピン留めします (再現性が重要なコンテナー イメージなど)。

dotnet tool install --global Microsoft.Artifacts.CredentialProvider.NuGet.Tool --version 2.* --source https://api.nuget.org/v3/index.json

認証を必要とする操作を初めて実行するときは、次のいずれかを使用して認証する必要があります。

• --interactiveを使用して実行すると、dotnet から認証を求めるメッセージが表示されます。
• environment 変数 (無人シナリオなど) を使用して資格情報を指定します。

対話型承認が使用可能な場合は、プロジェクト ディレクトリに移動して次を実行します。

dotnet restore --interactive

このコマンドはサインインし、トークンを取得します。 サインインが成功したら、トークンの有効期限が切れるまで、 --interactive なしで認証済みコマンドを実行できます。 詳細については、Session トークンキャッシュの場所を参照してください。

フィードに接続する

サービスプリンシパルを使用して認証する

サービス プリンシパルを使用して、Azure Artifacts フィードで認証できます。 これを行うには、次に示すように ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS 環境変数を設定します。

この変数では、フィード URL、サービス プリンシパルのアプリケーション (クライアント) ID、証明書のサブジェクト名または証明書ファイルへのパスを定義する必要があります (これら 2 つのうち 1 つだけが必要です)。

$env:ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS = @'{
    "endpointCredentials": [
        {
            "endpoint": "<FEED_URL>",
            "clientId": "<SERVICE_PRINCIPAL_APPLICATION_(CLIENT)_ID>",
            "clientCertificateSubjectName": "<SERVICE_PRINCIPAL_CERTIFICATE_NAME>",
            "clientCertificateFilePath": "<SERVICE_PRINCIPAL_CERTIFICATE_PATH>"
        }
    ]
}
'@

export ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS='{
    "endpointCredentials": [
        {
            "endpoint": "<FEED_URL>",
            "clientId": "<SERVICE_PRINCIPAL_APPLICATION_(CLIENT)_ID>",
            "clientCertificateSubjectName": "<SERVICE_PRINCIPAL_CERTIFICATE_NAME>",
            "clientCertificateFilePath": "<SERVICE_PRINCIPAL_CERTIFICATE_PATH>"
        }
    ]
}'

関連コンテンツ

• NuGet パッケージの発行 (dotnet)

• NuGet パッケージの復元 (dotnet)

• Azure Pipelines (YAML/クラシック) を使用して NuGet パッケージを発行する