Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 設定和使用 nuget 或 dotnet CLI
<a name="packages-nuget-cli"></a>

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

**Contents**
+ [

## 使用 CodeCatalyst 設定 NuGet
](#nuget-configure-cli)
+ [

## 從 CodeCatalyst 儲存庫取用 NuGet 套件
](#nuget-consume-cli)
+ [

## 透過 CodeCatalyst 從 NuGet.org 取用 NuGet 套件
](#nuget-consume-nuget-gallery)
+ [

## 將 NuGet 套件發佈至 CodeCatalyst
](#nuget-publish-cli)

## 使用 CodeCatalyst 設定 NuGet
<a name="nuget-configure-cli"></a>

若要使用 CodeCatalyst 設定 NuGet，請將儲存庫端點和個人存取字符新增至 NuGet 組態檔案，以允許 `nuget`或 `dotnet` 連線至 CodeCatalyst 套件儲存庫。

**使用 CodeCatalyst 套件儲存庫設定 NuGet**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在專案的概觀頁面上，選擇**套件**。

1. 從套件儲存庫清單中選擇套件儲存庫。

1. 選擇**連線至儲存庫**。

1. 在**連線至儲存庫**對話方塊中，從套件管理員用戶端清單中選擇 **NuGet** 或 **dotnet**。

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

   1. 選擇**建立權杖**。

   1. 選擇**複製**以複製您的 PAT。
**警告**  
關閉對話方塊後，您將無法再次查看或複製 PAT。

1. 設定 `nuget`或 `dotnet`以使用儲存庫的 NuGet 端點和 CodeCatalyst PAT。取代下列值。
**注意**  
如果從主控台指示複製，則應為您更新下列值，且不應變更。
   + 將*使用者名稱*取代為您的 CodeCatalyst 使用者名稱。
   + 將 *PAT* 取代為您的 CodeCatalyst PAT。
   + 以您的 CodeCatalyst 空間名稱取代 *space\$1name*。
   + 將 *proj\$1name* 取代為您的 CodeCatalyst 專案名稱。
   + 將 *repo\$1name* 取代為您的 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"
      ```

   1. 若是 `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-consume-cli)，並將 [ NuGet 套件發佈](#nuget-publish-cli)到您的 CodeCatalyst 儲存庫。 CodeCatalyst 

## 從 CodeCatalyst 儲存庫取用 NuGet 套件
<a name="nuget-consume-cli"></a>

[使用 CodeCatalyst 設定 NuGet ](#nuget-configure-cli)後，您可以使用儲存在 CodeCatalyst 儲存庫或其中一個上游儲存庫中的 NuGet 套件。

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

**使用 安裝套件 `dotnet`**

```
dotnet add packageName --source packageSourceName
```

**使用 安裝套件 `nuget`**

```
nuget install packageName --source packageSourceName
```

如需詳細資訊，請參閱 *Microsoft 文件*中的[使用 nuget CLI 管理套件](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-nuget-cli)，或使用 [dotnet CLI 安裝和管理套件](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli)。

## 透過 CodeCatalyst 從 NuGet.org 取用 NuGet 套件
<a name="nuget-consume-nuget-gallery"></a>

您可以透過 CodeCatalyst 儲存庫從 [NuGet.org](https://www.nuget.org/) 使用 NuGet 套件，方法是設定儲存庫與 **NuGet.org** 的上游連線。從 **NuGet.org** 取用的套件會擷取並儲存在 CodeCatalyst 儲存庫中。

**從 NuGet.org 取用套件**

1. 如果您尚未設定 NuGet 套件管理員與 CodeCatalyst 套件儲存庫，請遵循中的步驟進行設定[使用 CodeCatalyst 設定 NuGet](#nuget-configure-cli)。

1. 請確定您的儲存庫已新增 **NuGet.org** 做為上游連線。您可以依照 中的指示[新增上游儲存庫](packages-upstream-repositories-add.md)並選擇 **NuGet 儲存**庫，來檢查要新增哪些上游來源，或新增 **Nuget.org** 做為上游來源。

## 將 NuGet 套件發佈至 CodeCatalyst
<a name="nuget-publish-cli"></a>

[使用 CodeCatalyst 設定 NuGet ](#nuget-configure-cli)後，您可以使用 `nuget`或 `dotnet`將套件版本發佈至 CodeCatalyst 儲存庫。

若要將套件版本推送至 CodeCatalyst 儲存庫，請在 NuGet 組態`.nupkg`檔案中執行下列命令，其中包含檔案的完整路徑和 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
```