從命令列發佈和還原 NuGet 套件 （dotnet）

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

Azure Artifacts 可讓您根據摘要的可見度設定，在摘要中發佈和還原 NuGet 套件，讓您與其他人共用這些套件。 本指南會逐步引導您使用 dotnet 命令行介面來設定專案以發佈或還原套件。

必要條件

• Azure DevOps 組織和專案。 如果您尚未建立組織或專案。

• Azure Artifacts 摘要。 如果您還沒有摘要，請建立新的摘要 。

• 下載並安裝 Azure Artifacts 認證提供者。

• 下載並安裝 .NET Core SDK （2.1.400+）。

要摘要的 連線

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

2. 選取 連線 來饋送，然後從左側的 [NuGet] 區段選取 dotnet。

3. 在與 csproj 或 sln 檔案相同的資料夾中建立 nuget.config 檔案。 複製下列 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>
  

• 專案範圍的摘要：

  <?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>
  

發佈套件

執行下列命令，將套件發佈至您的摘要。 以適當的資訊取代佔位元：

dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH> 

範例： dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg

注意

api-key僅用於佔位元。

從外部來源發佈套件

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

2. 以 <您的個人存取令牌取代PERSONAL_ACCESS_TOKEN> 佔位符，然後執行下列命令，將您的套件來源新增至 nuget.config 檔案。 這會將您的 PAT 新增至 nuget.config。請務必安全地儲存此檔案，而不會將它簽入原始檔控制中。

   dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>
   

3. 發佈您的套件：

   dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
   

範例： dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.configdotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkgkg

注意

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

還原套件

執行下列命令以還原您的套件。 旗 --interactive 標用來提示使用者輸入認證：

dotnet restore --interactive

相關文章

• 連線 至 Azure Artifacts 摘要 （NuGet.exe）
• 使用 Azure Pipelines 發佈套件 （YAML/傳統）
• 從 NuGet 資源庫使用套件