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

# CodeArtifact로 pip 구성 및 사용
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/pip/)는 Python 패키지용 패키지 설치관리자 프로그램입니다. pip를 사용하여 CodeArtifact 리포지토리에서 Python 패키지를 설치하려면 먼저 CodeArtifact 리포지토리 정보와 보안 인증 정보로 pip 클라이언트를 구성해야 합니다.

pip는 Python 패키지를 설치하는 용도로만 사용할 수 있습니다. Python 패키지를 게시하기 위해 [twine](https://pypi.org/project/twine/)을 사용할 수 있습니다. 자세한 내용은 [CodeArtifact로 twine 구성 및 사용](python-configure-twine.md) 단원을 참조하십시오.

## `login` 명령으로 pip 구성
<a name="python-configure-pip-login"></a>

먼저에 설명된 AWS CLI대로와 함께 사용할 자격 AWS 증명을 구성합니다[CodeArtifact 시작하기](getting-started.md). 그런 다음 CodeArtifact `login` 명령을 사용하여 보안 인증을 가져오고 해당 인증을 사용하여 `pip`를 구성합니다.

**참고**  
소유한 도메인의 리포지토리에 액세스하는 경우 `--domain-owner`를 포함하지 않아도 됩니다. 자세한 내용은 [크로스 계정 도메인](domain-overview.md#domain-overview-cross-account) 단원을 참조하십시오.

pip를 구성하려면 다음 명령을 실행합니다.

```
aws codeartifact login --tool pip --domain my_domain --domain-owner 111122223333 --repository my_repo
```

 `login`는 AWS 자격 증명을 사용하여 CodeArtifact에서 권한 부여 토큰을 가져옵니다. `login` 명령은 `--repository` 옵션을 통해 지정된 리포지토리로 `index-url`를 설정하도록 `~/.config/pip/pip.conf`를 편집하여 CodeArtifact와 함께 사용할 수 있도록 `pip`를 구성합니다.

`login` 직접 호출 후의 기본 승인 기간은 12시간이며, 토큰을 주기적으로 새로 고치려면 `login`을 직접적으로 호출해야 합니다. `login` 명령으로 만든 인증 토큰에 관한 자세한 내용은 [`login` 명령으로 생성된 토큰](tokens-authentication.md#auth-token-login)을 참조하세요.

## 로그인 명령 없이 pip를 구성하려면
<a name="python-configure-without-pip"></a>

 `login` 명령을 사용하여 `pip`를 구성할 수 없는 경우 `pip config`를 사용할 수 있습니다.

1.  AWS CLI 를 사용하여 새 권한 부여 토큰을 가져옵니다.
**참고**  
소유한 도메인의 리포지토리에 액세스하는 경우 `--domain-owner`를 포함하지 않아도 됩니다. 자세한 내용은 [크로스 계정 도메인](domain-overview.md#domain-overview-cross-account) 단원을 참조하십시오.

   ```
   CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`
   ```

1. `pip config`를 사용하여 CodeArtifact 레지스트리 URL 및 보안 인증을 설정합니다. 다음 명령은 현재 환경 구성 파일만 업데이트합니다. 시스템 전체 구성 파일을 업데이트하려면 `site`를 `global`로 바꿔야 합니다.

   ```
   pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/
   ```
**참고**  
듀얼 스택 엔드포인트를 사용하려면 `codeartifact.region.on.aws` 엔드포인트를 사용합니다.

**중요**  
레지스트리 URL은 슬래시(/)로 끝나야 합니다. 그렇지 않으면 리포지토리에 연결할 수 없습니다.

**pip 구성 파일 예**

다음은 CodeArtifact 레지스트리 URL 및 보안 인증을 설정한 후의 `pip.conf` 파일 예입니다.

```
[global]
index-url = https://aws:eyJ2ZX...@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/pypi/my_repo/simple/
```

## pip 실행
<a name="python-run-pip"></a>

`pip` 명령을 실행하려면 CodeArtifact를 사용하여 `pip`를 구성해야 합니다. 자세한 내용은 다음 문서를 참조하세요.

1. [with AWS CodeArtifact 설정](get-set-up-for-codeartifact.md) 섹션의 단계에 따라 AWS 계정, 도구 및 권한을 구성합니다.

1. [CodeArtifact로 twine 구성 및 사용](python-configure-twine.md)의 단계에 따라 `twine`을 구성합니다.

패키지가 리포지토리 또는 업스트림 리포지토리 중 하나에 있다고 할 경우, `pip install`을 사용하여 패키지를 설치할 수 있습니다. 예를 들어 다음 명령을 사용하여 `requests` 패키지를 설치할 수 있습니다.

```
pip install requests
```

`-i` 옵션을 사용하여 CodeArtifact 리포지토리 대신 [https://pypi.org](https://pypi.org)에서 패키지를 설치하는 것으로 일시적으로 되돌릴 수 있습니다.

```
pip install -i https://pypi.org/simple requests
```