CodeArtifact で pip を設定して使用する - CodeArtifact
login コマンドで pip を設定します。ログインコマンドを使用せずにpipを設定するpipを実行する

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

CodeArtifact で pip を設定して使用する

pip は Python パッケージのパッケージインストーラーです。pip を使用して CodeArtifact リポジトリから Python パッケージをインストールするには、まず CodeArtifact リポジトリの情報と認証情報を使用して pip クライアントを設定する必要があります。

pip は Python パッケージのインストールにのみ使用できます。Python パッケージを公開するには、twine を使用します。詳細については、「CodeArtifact で twine を設定して使用する」を参照してください。

login コマンドで pip を設定します。

まず、「」の説明に従って AWS CLI、 で使用する AWS 認証情報を設定しますCodeArtifact の開始方法。次に、CodeArtifact login コマンドを使用して認証情報を取得し、この認証情報を使用して pip を設定します。

注記

所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

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コマンドで作成されたトークン」を参照してください。

ログインコマンドを使用せずにpipを設定する

pipの設定にloginコマンドを使用できない場合、pip configが使用できます。

  1. AWS CLI を使用して、新しい認可トークンを取得します。

    注記

    所有しているドメインのリポジトリにアクセスする場合、--domain-ownerを含める必要はありません。詳細については、「クロスアカウントドメイン」を参照してください。

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

  2. 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を実行する

pipコマンドを実行するには、CodeArtifactでpipを設定しなくてはなりません。詳細については、次のドキュメントを参照してください。

  1. AWS CodeArtifact でのセットアップ セクションの手順に従って、 AWS アカウント、ツール、アクセス許可を設定します。

  2. CodeArtifact で twine を設定して使用するの手順に従って、twineを設定します。

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

pip install requests

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

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