設定和使用 nuget 或 dotnet CLI - Amazon CodeCatalyst

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

設定和使用 nuget 或 dotnet CLI

您可以使用 CLI 工具dotnet,例如 NuGet和 從 CodeCatalyst 發佈和使用套件。本文件提供有關設定 CLI 工具以及使用這些工具來發佈或取用套件的資訊。

使用 CodeCatalyst 設定 NuGet

若要使用 CodeCatalyst 設定 NuGet,請將儲存庫端點和個人存取權杖新增至 NuGet 組態檔案,以允許 nugetdotnet 連線至 CodeCatalyst 套件儲存庫。

使用 CodeCatalyst 套件儲存庫設定 NuGet
  1. 在 https://https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

  2. 在專案的概觀頁面上,選擇套件

  3. 從套件儲存庫清單中選擇您的套件儲存庫。

  4. 選擇連線至儲存庫

  5. 連線至儲存庫對話方塊中,從套件管理員用戶端清單中選擇 NuGetdotnet

  6. 您需要個人存取字符 (PAT) 來使用 CodeCatalyst 驗證 NuGet。如果您已經有,則可以使用它。如果沒有,您可以在這裡建立一個。

    1. 選擇建立權杖

    2. 選擇複製以複製您的 PAT。

      警告

      關閉對話方塊後,您將無法再次查看或複製 PAT。

  7. 設定 nugetdotnet以使用儲存庫的 NuGet 端點和 CodeCatalyst PAT。取代下列值。

    注意

    如果從主控台指示複製,則應為您更新下列值,且不應變更。

    • 使用者名稱取代為您的 CodeCatalyst 使用者名稱。

    • PAT 取代為您的 CodeCatalyst PAT。

    • space_name 取代為您的 CodeCatalyst 空間名稱。

    • proj_name 取代為您的 CodeCatalyst 專案名稱。

    • repo_name 取代為您的 CodeCatalyst 套件儲存庫名稱。

    1. 若是 nuget,則使用 nuget sources add 命令。

      nuget sources add -name "repo_name" -Source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -username "username" -password "PAT"
    2. 若是 dotnet,則使用 dotnet nuget add source 命令。

      Linux 和 macOS 使用者:由於非 Windows 平台不支援加密,您必須將 --store-password-in-clear-text旗標新增至下列命令。請注意,這會將您的密碼以純文字形式存放在您的組態檔案中。

      dotnet nuget add source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -n "proj_name/repo_name" -u "username" -p "PAT" --store-password-in-clear-text

使用 CodeCatalyst 設定 NuGet 後,您可以使用儲存在 CodeCatalyst 儲存庫或其上游儲存庫之一中的 NuGet 套件,並將 NuGet 套件發佈到您的 CodeCatalyst 儲存庫。

從 CodeCatalyst 儲存庫取用 NuGet 套件

使用 CodeCatalyst 設定 NuGet 後,您可以使用儲存在 CodeCatalyst 儲存庫或其中一個上游儲存庫中的 NuGet 套件。

若要使用 CodeCatalyst 儲存庫或其中一個上游儲存庫中的套件版本搭配 nuget 或 dotnet,請執行下列命令。將 packageName 取代為您想要使用的套件名稱,並將 packageSourceName 取代為 NuGet 組態檔案中 CodeCatalyst 套件儲存庫的來源名稱,該名稱應為儲存庫名稱。

使用 安裝套件 dotnet

dotnet add packageName --source packageSourceName

使用 安裝套件 nuget

nuget install packageName --source packageSourceName

如需詳細資訊,請參閱 Microsoft 文件中的使用 nuget CLI 管理套件,或使用 dotnet CLI 安裝和管理套件

您可以透過 CodeCatalyst 儲存庫從 NuGet.org 使用 NuGet 套件,方法是設定儲存庫與 NuGet.org 的上游連線。從 NuGet.org 取用的套件會擷取並儲存在 CodeCatalyst 儲存庫中。

從 NuGet.org 取用套件
  1. 如果您尚未設定 NuGet 套件管理員與 CodeCatalyst 套件儲存庫,請遵循中的步驟進行設定使用 CodeCatalyst 設定 NuGet

  2. 請確定您的儲存庫已新增 NuGet.org 做為上游連線。您可以依照 中的指示新增上游儲存庫並選擇 NuGet 儲存庫,來檢查要新增哪些上游來源,或新增 Nuget.org 做為上游來源。

將 NuGet 套件發佈至 CodeCatalyst

使用 CodeCatalyst 設定 NuGet 後,您可以使用 nugetdotnet將套件版本發佈至 CodeCatalyst 儲存庫。

若要將套件版本推送至 CodeCatalyst 儲存庫,請執行下列命令,其中包含.nupkg檔案的完整路徑,以及 NuGet 組態檔案中 CodeCatalyst 儲存庫的來源名稱。

使用 發佈套件 dotnet

dotnet nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName

使用 發佈套件 nuget

nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName