翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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` コマンドは、`~/.config/pip/pip.conf` を編集して `--repository` オプションで指定されたリポジトリに `index-url` を設定することで、`pip` を CodeArtifact で使用できるようにします。

`login` を呼び出した後のデフォルトの認可時間は 12 時間であり、トークンを定期的に更新するには、`login` を呼び出す必要があります。`login` コマンドで作成される認可トークンの詳細については、「[`login`コマンドで作成されたトークン](tokens-authentication.md#auth-token-login)」を参照してください。

## ログインコマンドを使用せずにpipを設定する
<a name="python-configure-without-pip"></a>

 `pip`の設定に`login`コマンドを使用できない場合、`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. [AWS CodeArtifact でのセットアップ](get-set-up-for-codeartifact.md) セクションの手順に従って、 AWS アカウント、ツール、アクセス許可を設定します。

1. [CodeArtifact で twine を設定して使用する](python-configure-twine.md)の手順に従って、`twine`を設定します。

パッケージが、リポジトリまたはそのアップストリームリポジトリの1つに存在する場合、`pip install` でインストールすることができます。例えば、`requests`パッケージをインストールするには、次のコマンドを使用します。

```
pip install requests
```

CodeArtifactリポジトリではなく、[https://pypi.org](https://pypi.org) からのパッケージのインストールに一時的に戻すには、`-i` オプションを使います。

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