기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CodeArtifact 시작하기
이 시작하기 자습서에서는 CodeArtifact를 사용하여 다음을 생성합니다.
+ `my-domain`이라는 도메인.
+ `my-domain`에 포함된 `my-repo`라는 이름의 리포지토리.
+ `my-domain`에 포함된 `npm-store`라는 이름의 리포지토리. `npm-store`는 npm 퍼블릭 리포지토리에 대한 외부 연결이 있습니다. 이 연결은 npm 패키지를 `my-repo` 리포지토리로 수집하는 데 사용됩니다.
이 자습서를 시작하기 전에 [AWS CodeArtifact 개념](codeartifact-concepts.md) CodeArtifact를 검토하는 것이 좋습니다.
**참고**
이 자습서에서는 결과적으로 AWS 계정에 요금이 부과될 수 있는 리소스를 생성해야 합니다. 자세한 내용은 [CodeArtifact 요금](https://aws.amazon.com/codeartifact/pricing/)을 참조하세요.
**Topics**
+ [사전 조건](#getting-started-prerequisites)
+ [콘솔을 사용하여 시작하기](getting-started-console.md)
+ [AWS CLI를 사용하여 시작하기](getting-started-cli.md)
## 사전 조건
AWS Management Console 또는 AWS Command Line Interface(AWS CLI)를 사용하여 이 자습서를 완료할 수 있습니다. 이 자습서를 따르려면 다음과 같은 사전 조건부터 먼저 완료해야 합니다.
+ [with AWS CodeArtifact 설정](get-set-up-for-codeartifact.md)의 단계를 수행하세요.
+ npm CLI를 설치합니다. 자세한 내용은 npm 설명서의 [Node.js 및 npm 다운로드 및 설치](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)를 참조합니다.
# 콘솔을 사용하여 시작하기
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**을 선택하고 **삭제**를 선택한 다음, 단계에 따라 도메인을 삭제합니다.
# AWS CLI를 사용하여 시작하기
AWS Command Line Interface(AWS CLI)를 사용하여 CodeArtifact를 시작하려면 다음 단계를 실행합니다. 자세한 내용은 [설치 또는 업그레이드 후 구성 AWS CLI](get-set-up-install-cli.md) 섹션을 참조하세요. 이 안내서는 `npm` 패키지 관리자를 사용합니다. 다른 패키지 관리자를 사용하는 경우 다음 단계 중 일부를 수정해야 합니다.
1. AWS CLI를 사용하여 **create-domain** 명령을 실행합니다.
```
aws codeartifact create-domain --domain my-domain
```
JSON 형식의 데이터는 새 도메인에 관한 세부 정보와 함께 출력에 표시됩니다.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Active",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```
`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)을 참조합니다.
1. **create-repository** 명령을 사용하여 도메인에 리포지토리를 생성합니다.
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
JSON 형식의 데이터는 새 리포지토리에 관한 세부 정보와 함께 출력에 표시됩니다.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [],
"externalConnections": []
}
}
```
1. **create-repository** 명령을 실행하여 `my-repo` 리포지토리의 업스트림 리포지토리를 생성합니다.
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
JSON 형식의 데이터는 새 리포지토리에 관한 세부 정보와 함께 출력에 표시됩니다.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": []
}
}
```
1. **associate-external-connection** 명령을 사용하여 npm 퍼블릭 리포지토리에 대한 외부 연결을 `npm-store` 리포지토리에 추가합니다.
```
aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"
```
JSON 형식의 데이터는 리포지토리와 그것의 새 외부 연결에 관한 세부 정보와 함께 출력 화면에 표시됩니다.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
자세한 내용은 [CodeArtifact 저장소를 공용 저장소에 연결하기](external-connection.md) 섹션을 참조하세요.
1. **update-repository** 명령을 사용하여 `npm-store` 리포지토리를 `my-repo` 리포지토리에 대한 업스트림 리포지토리로 연결합니다.
```
aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store
```
JSON 형식의 데이터는 새 업스트림 리포지토리를 포함해 업데이트된 리포지토리에 관한 세부 정보와 함께 출력 화면에 표시됩니다.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
자세한 내용은 [업스트림 리포지토리 추가 또는 제거(AWS CLI)](repo-upstream-add.md#repo-upstream-add-cli) 섹션을 참조하세요.
1. **login** 명령을 실행하여 `my-repo` 리포지토리와 함께 npm 패키지 관리자를 구성합니다.
```
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
```
자세한 내용은 [CodeArtifact로 npm 구성 및 사용](npm-auth.md) 섹션을 참조하세요.
1. npm CLI를 사용하여 npm 패키지를 설치합니다. 예를 들어, 인기 있는 npm 패키지 `lodash`를 설치하려면 다음 명령을 실행합니다.
```
npm install lodash
```
1. **list-packages** 명령을 실행하면 `my-repo` 리포지토리에 방금 설치한 패키지를 볼 수 있습니다.
**참고**
`npm install` 설치 명령이 완료되는 시점과 패키지가 리포지토리에 표시되는 시점 간에 지연이 발생할 수 있습니다. 퍼블릭 리포지토리에서 패키지를 가져올 때 일반적인 지연 시간에 관한 자세한 내용은 [외부 연결 지연 시간](external-connection-requesting-packages.md#external-connection-latency)를 참조하세요.
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
JSON 형식의 데이터는 설치한 패키지의 형식 및 이름과 함께 출력 화면에 표시됩니다.
```
{
"packages": [
{
"format": "npm",
"package": "lodash"
}
]
}
```
이제 다음과 같이 세 개의 CodeArtifact 리소스가 있습니다.
+ 도메인 `my-domain`.
+ `my-domain`에 포함된 `my-repo`라는 이름의 리포지토리. 이 리포지토리에는 npm 패키지가 있습니다.
+ `my-domain`에 포함된 `npm-store`라는 이름의 리포지토리. 이 리포지토리는 퍼블릭 npm 리포지토리에 대한 외부 연결이 있으며 업스트림 리포지토리로서 `my-repo` 리포지토리와 연결되어 있습니다.
1. 추가 AWS 요금이 부과되지 않도록 하려면 이 자습서에서 사용한 리소스를 삭제하세요.
**참고**
리포지토리가 포함된 도메인은 삭제할 수 없으므로 `my-domain`을 삭제하기 전에 먼저 `my-repo`와 `npm-store`를 삭제해야 합니다.
1. `npm-store` 리포지토리를 삭제하려면 **delete-repository** 명령을 사용합니다.
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
JSON 형식의 데이터는 삭제된 리포지토리에 관한 세부 정보와 함께 출력 화면에 표시됩니다.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
1. `npm-store` 리포지토리를 삭제하려면 **delete-repository** 명령을 사용합니다.
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
JSON 형식의 데이터는 삭제된 리포지토리에 관한 세부 정보와 함께 출력 화면에 표시됩니다.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
1. `my-domain` 리포지토리를 삭제하려면 **delete-domain** 명령을 사용합니다.
```
aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333
```
JSON 형식의 데이터는 삭제된 도메인에 관한 세부 정보와 함께 출력 화면에 표시됩니다.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Deleted",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```