Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# nuget 또는 dotnet CLI 구성 및 사용
<a name="packages-nuget-cli"></a>

`NuGet` 및 `dotnet`와 같은 CLI 도구를 사용하여 CodeCatalyst에서 패키지를 게시하고 사용할 수 있습니다. 이 문서에서는 CLI 도구를 구성하고 이를 사용하여 패키지를 게시하거나 사용하는 방법에 관한 정보를 제공합니다.

**Contents**
+ [CodeCatalyst를 사용하여 NuGet 구성](#nuget-configure-cli)
+ [CodeCatalyst 리포지토리에서 NuGet 패키지 사용](#nuget-consume-cli)
+ [CodeCatalyst를 통해 NuGet.org에서 NuGet 패키지 사용](#nuget-consume-nuget-gallery)
+ [CodeCatalyst에 NuGet 패키지 게시](#nuget-publish-cli)

## CodeCatalyst를 사용하여 NuGet 구성
<a name="nuget-configure-cli"></a>

CodeCatalyst로 NuGet을 구성하려면 NuGet 구성 파일에 리포지토리 엔드포인트와 개인 액세스 토큰을 추가하여 CodeCatalyst 패키지 리포지토리에 `nuget` 또는 `dotnet`을 연결할 수 있도록 합니다.

**CodeCatalyst 패키지 리포지토리로 NuGet을 구성하려면**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/)에서 CodeCatalyst 콘솔을 엽니다.

1. 프로젝트의 개요 페이지에서 **패키지**를 선택합니다.

1. 패키지 리포지토리 목록에서 패키지 리포지토리를 선택합니다.

1. **리포지토리에 연결**을 선택합니다.

1. **리포지토리에 연결** 대화 상자의 패키지 관리자 클라이언트 목록에서 **NuGet** 또는 **dotnet**을 선택합니다.

1. CodeCatalyst로 NuGet을 인증하려면 개인 액세스 토큰(PAT)이 필요합니다. 이미 토큰이 있으면 그 토큰을 사용하면 됩니다. 없는 경우에는 여기에서 만들 수 있습니다.

   1. **토큰 생성**을 선택합니다.

   1. PAT를 복사하려면 **복사**를 선택합니다.
**주의**  
대화 상자를 닫으면 PAT를 다시 보거나 복사할 수 없습니다.

1. 리포지토리의 NuGet 엔드포인트 및 CodeCatalyst PAT를 사용하도록 `nuget` 또는 `dotnet`을 구성합니다. 다음 값을 교체합니다.
**참고**  
콘솔 지침에서 복사하는 경우 다음 값을 업데이트해야 하며 변경해서는 안 됩니다.
   + *username*을 CodeCatalyst 사용자 이름으로 바꿉니다.
   + *PAT*를 CodeCatalyst PAT로 바꿉니다.
   + *space\$1name*을 CodeCatalyst 스페이스 이름으로 바꿉니다.
   + *proj\$1name*을 CodeCatalyst 프로젝트 이름으로 바꿉니다.
   + *my\$1repo*를 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)할 수 있고 CodeCatalyst 리포지토리로 [NuGet 패키지를 게시](#nuget-publish-cli)할 수 있습니다.

## 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.exe 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>

**NuGet.org**에 대한 업스트림 연결을 통해 리포지토리를 구성하여 CodeCatalyst 리포지토리를 통해 [NuGet.org](https://www.nuget.org/)의 NuGet 패키지를 사용할 수 있습니다. **Nuget.org**에서 사용하는 패키지는 CodeCatalyst 리포지토리로 수집하여 저장됩니다.

**Nuget.org의 패키지를 사용하려면**

1. 아직 구성하지 않았다면 [CodeCatalyst를 사용하여 NuGet 구성](#nuget-configure-cli)의 단계에 따라 CodeCatalyst 패키지 리포지토리로 NuGet 패키지 관리자를 구성합니다.

1. 리포지토리가 **NuGet.org**를 업스트림 연결로 추가했는지 확인합니다. [업스트림 리포지토리 추가](packages-upstream-repositories-add.md)의 지침에 따르고 **NuGet 스토어** 리포지토리를 선택하여, 어떤 업스트림 소스가 추가되었는지 확인하거나 **Nuget.org**를 업스트림 소스로 추가할 수 있습니다.

## CodeCatalyst에 NuGet 패키지 게시
<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
```