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

# 콘솔을 사용하여 시작하기
<a name="getting-started-console"></a>

 AWS Management Console을 사용하여 CodeArtifact를 시작하려면 다음 단계를 실행합니다. 이 안내서는 `npm` 패키지 관리자를 사용합니다. 다른 패키지 관리자를 사용하는 경우 다음 단계 중 일부를 수정해야 합니다.

1. AWS Management Console에 로그인하여 [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start)에서 AWS CodeArtifact 콘솔을 엽니다. 자세한 내용은 [with AWS CodeArtifact 설정](get-set-up-for-codeartifact.md) 섹션을 참조하세요.

1.  **리포지토리 생성**을 선택합니다.

1.  **리포지토리 이름**에서 **my-repo**를 입력합니다.

1.  (선택 사항) **리포지토리 설명**에는 이 리포지토리에 대한 설명(선택 사항)을 입력합니다.

1. **퍼블릭 업스트림 리포지토리**에서 **npm-store**를 선택하여 `my-repo` 리포지토리의 업스트림인 **npmjs**에 연결된 리포지토리를 생성합니다.

   CodeArtifact는 사용자를 대신하여 이 리포지토리에 이름 `npm-store`를 할당합니다. 업스트림 리포지토리 `npm-store`에서 사용할 수 있는 모든 패키지를 다운스트림 리포지토리 `my-repo`에서도 사용할 수 있습니다.

1.  **다음**을 선택합니다.

1.  **AWS 계정**에서 **이 AWS 계정**을 선택합니다.

1.  **도메인 이름**에 **my-domain**을 입력합니다.

1.  **추가 구성**을 확장합니다.

1.  AWS KMS key(KMS 키)를 사용하여 도메인의 모든 자산을 암호화해야 합니다. 관리하는 AWS 관리형 키 또는 KMS 키를 사용할 수 있습니다.
   +  기본 AWS 관리형 키를 사용하려면 **AWS 관리형 키**를 선택합니다.
   +  관리하는 KMS 키를 사용하려면 **고객 관리형 키**를 선택합니다. 관리하는 KMS 키를 사용하려면 **고객 관리형 키 ARN**에서 KMS 키를 검색하여 선택합니다.

    자세한 내용은 **AWS Key Management Service 개발자 안내서의 [AWS 관리형 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) 및 [고객 관리형 키](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk)를 참조하세요.

1.  **다음**을 선택합니다.

1.  **검토 및 생성**에서 CodeArtifact가 무엇을 생성하고 있는지 검토하세요.
   +  **패키지 흐름**은 `my-domain`, `my-repo` 및 `npm-store`가 어떻게 관련되어 있는지를 보여줍니다.
   +  **1단계: 리포지토리 생성**에는 `my-repo` 및 `npm-store`에 관한 세부 정보가 표시됩니다.
   +  **2단계: 도메인 선택**에서는 `my-domain`에 관한 세부 정보가 표시됩니다.

    준비가 되었으면 **리포지토리 생성**을 선택합니다.

1.  **my-repo** 페이지에서 **연결 지침 보기**를 선택한 다음 **npm**을 선택합니다.

1.  AWS CLI를 사용하여 **이 AWS CLI CodeArtifact 명령을 사용하여 npm 클라이언트 구성** 아래에 표시된 `login` 명령을 실행합니다.

   ```
   aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333
   ```

   로그인이 성공했음을 확인하는 출력 화면이 표시될 것입니다.

   ```
   Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
   Login expires in 12 hours at 2020-10-08 02:45:33-04:00
   ```

   `Could not connect to the endpoint URL` 오류가 표시되는 경우 AWS CLI가 구성되어 있고 **기본 지역 이름**이 리포지토리를 생성한 리전과 동일한 리전으로 설정되어 있는지 확인합니다. [AWS Command Line Interface 구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)을 참조합니다.

   자세한 내용은 [CodeArtifact로 npm 구성 및 사용](npm-auth.md)을 참조합니다.

1.  npm CLI를 사용하여 npm 패키지를 설치합니다. 예를 들어, 인기 있는 npm 패키지 `lodash`를 설치하려면 다음 명령을 실행합니다.

   ```
   npm install lodash
   ```

1.  CodeArtifact 콘솔로 돌아갑니다. **my-repo** 리포지토리가 열려 있는 경우 페이지 새로 고침을 실행합니다. 아니면 탐색 창에서 **리포지토리**를 선택한 다음 **my-repo**를 선택합니다.

    설치한 npm 라이브러리 또는 패키지가 **패키지** 아래로 표시될 것입니다. 패키지 이름을 선택하여 패키지의 버전과 상태를 볼 수 있습니다. 최신 버전을 선택하여 종속성, 자산 등과 같은 패키지 세부 정보를 볼 수 있습니다.
**참고**  
 패키지를 설치하는 시점과 리포지토리에 수집되는 시점 간에 지연이 발생할 수 있습니다.

1.  추가 AWS 요금이 부과되지 않도록 하려면 이 자습서에서 사용한 리소스를 삭제하세요.
**참고**  
리포지토리가 포함된 도메인은 삭제할 수 없으므로 `my-domain`을 삭제하기 전에 먼저 `my-repo`와 `npm-store`를 삭제해야 합니다.

   1.  탐색 창에서 **리포지토리**를 선택합니다.

   1.  **npm-store**를 선택하고 **삭제**를 선택한 다음, 단계에 따라 리포지토리를 삭제합니다.

   1.  **my-repo**를 선택하고 **삭제**를 선택한 다음, 단계에 따라 리포지토리를 삭제합니다.

   1.  탐색 창에서 **도메인**을 선택합니다.

   1.  **my-domain**을 선택하고 **삭제**를 선택한 다음, 단계에 따라 도메인을 삭제합니다.