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

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

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

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

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

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

まず、「」の説明に従って AWS CLI、 で使用する AWS 認証情報を設定しますCodeArtifact の開始方法。次に、 login コマンドを使用して CodeArtifact認証情報を取得し、それら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して オプションで指定されたリポジトリに設定 CodeArtifact することでindex-url、 で使用するpipように を設定します--repository

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と認証情報を設定します。以下のコマンドは、現在の環境設定ファイルのみを更新します。システム全体の設定ファイルを更新するには、siteglobal に置き換えます。

    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 コマンドを実行するには、 pipで を設定する必要があります CodeArtifact。詳細については、次のドキュメントを参照してください。

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

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

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

pip install requests

-i オプションを使用して、 CodeArtifact リポジトリの代わりに https://pypi.org からのパッケージのインストールを一時的に元に戻します。

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