從命令列發佈和還原 NuGet 套件 (NuGet.exe)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

使用 Azure Artifacts,您可以將 NuGet 套件發佈至公用和私人摘要,讓您根據摘要的可見度設定與其他人共享它們。 本文將引導您連線到 Azure Artifacts 摘要,以及發佈和還原 NuGet 套件。

必要條件

要摘要的 連線

  1. 登入您的 Azure DevOps 組織,然後瀏覽至您的專案。

  2. 選取 [ 成品],然後從下拉功能表中選取您的摘要。

  3. 選取要摘要 連線,然後從左側瀏覽窗格中選取 [NuGet.exe]。

  4. nuget.config 檔案新增至專案,位於與 .csproj.sln 檔案相同的資料夾中。 將提供的 XML 代碼段貼到您的檔案中。 代碼段看起來應該如下所示:

    • 組織範圍的摘要

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • 專案範圍的摘要

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. 登入您的 Azure DevOps 伺服器,然後流覽至您的專案。

  2. 選取 [ 成品],然後選取您的摘要。

  3. 選取 [連線 至摘要],然後從左側瀏覽窗格中選取 [NuGet.exe]。

  4. 請遵循 [項目設定] 區段中的指示,聯機到您的摘要。

  1. 登入您的 Azure DevOps 伺服器,然後流覽至您的專案。

  2. 選取 [ 成品],然後選取您的摘要。

  3. 選取 [連線 至摘要],然後從左側瀏覽窗格中選取 [NuGet]。

  4. 請遵循提供的指示,將套件來源 URL 新增至 nuget.config 檔案。

發佈套件

執行下列命令,將您的套件發佈至摘要。 將佔位元取代為相關信息:

nuget push <PACKAGE_PATH> -src https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -ApiKey <ANY_STRING>

範例:

nuget push MyPackage.5.0.2.nupkg -src https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ

注意

ApiKey是必要的,但您可以在推送至 Azure Artifacts 摘要時使用任何任意值。

從外部來源發佈套件

  1. 使用封裝讀取和寫入範圍建立個人存取令牌 (PAT)。

  2. 將套件來源新增至 nuget.config 檔案。 這會將您的 PAT 新增至 nuget.config 檔案。 將此檔案儲存在安全的位置,並確定您不會將它簽入原始檔控制。

    nuget sources Add -Name <SOURCE_NAME> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -UserName <USER_NAME> -Password <PERSONAL_ACCESS_TOKEN> -config <PATH_TO_NUGET_CONFIG_FILE>
    
  3. 將您的 NuGet 套件發佈至您的摘要:

    nuget push <PACKAGE_PATH> -src <SOURCE_NAME> -ApiKey <ANY_STRING>
    

範例:

nuget sources Add -Name "MySource" -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -UserName MyUserName -Password YourPersonalAccessToken -config ./nuget.config
nuget push nupkgs/mypackage.1.1.8.nupkg -src MySource -ApiKey AZ

注意

如果您的組織使用防火牆或 Proxy 伺服器,請確定您允許 Azure Artifacts 網域 URL 和 IP 位址

還原套件

在項目目錄中執行下列命令來還原套件:

nuget.exe restore