Hubungkan ke umpan Artefak Azure (.NET)

Layanan Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020

Dengan menggunakan Azure Artifacts, Anda dapat menerbitkan paket NuGet dengan mulus ke umpan Azure Artifacts sehingga Anda dapat membagikannya dengan orang lain secara privat atau publik berdasarkan pengaturan visibilitas umpan Anda. Panduan ini akan memandu Anda menyiapkan proyek Anda untuk mengautentikasi dengan feed Azure Artifacts Anda menggunakan antarmuka baris perintah dotnet.

Prasyarat

• Organisasi Azure DevOps dan proyek. Buat organisasi atau proyek jika Anda belum melakukannya.

• Saluran Artefak Azure. Buat umpan baru jika Anda belum memilikinya.

• Unduh dan instal penyedia Kredensial .

• Unduh dan instal .NET Core SDK (2.1.400+).

Sambungkan ke umpan

1. Pilih Artefak lalu pilih umpan Anda dari menu dropdown.

2. Pilih Sambungkan ke umpan, lalu pilih dotnet dari bagian NuGet.

   

3. Ikuti instruksi dalam penyiapan Project untuk menyiapkan file nuget.config Anda. Struktur file Anda akan terlihat mirip dengan ini:

   • umpan lingkup proyek:

     XML

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

   • umpan cakupan organisasi :

     XML

     <?xml version="1.0" encoding="utf-8"?>
     <configuration>
       <packageSources>
         <clear />
         <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
       </packageSources>
     </configuration>
     

Mengautentikasi Umpan NuGet dengan Service Principal

Untuk mengautentikasi dengan perwakilan layanan, Anda harus terlebih dahulu menginstal Penyedia Kredensial Artefak .

Atur variabel lingkungan ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS seperti yang ditunjukkan di bawah ini, tentukan URL umpan Anda, ID aplikasi (klien) perwakilan layanan, dan nama subjek atau jalur file sertifikat perwakilan layanan Anda. (Hanya satu yang diperlukan antara nama subjek sertifikat atau jalur file.)

Windows

Di PowerShell, masukkan kode berikut.

PowerShell

$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>"
        }
    ]
}
'@

Di Bash, masukkan kode berikut.

Bash

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>"
        }
    ]
}'

Artikel terkait

• Terbitkan dan pulihkan paket NuGet (NuGet.exe)
• Menerbitkan paket NuGet dengan Azure Pipelines
• Menggunakan paket dari NuGet.org