Configurer et utiliser pip avec CodeArtifact - CodeArtifact

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer et utiliser pip avec CodeArtifact

pip est l'installateur de packages pour les packages Python. Pour utiliser pip pour installer des packages Python à partir de votre CodeArtifact dépôt, vous devez d'abord configurer le client pip avec les informations et les informations d'identification de votre CodeArtifact référentiel.

pip ne peut être utilisé que pour installer des packages Python. Pour publier des packages Python, vous pouvez utiliser twine. Pour de plus amples informations, veuillez consulter Configurer et utiliser Twine avec CodeArtifact.

Configurez pip avec la commande login

Tout d'abord, configurez vos AWS informations d'identification à utiliser avec le AWS CLI, comme décrit dansDémarrage avec CodeArtifact. Utilisez ensuite la CodeArtifact login commande pour récupérer les informations d'identification et les configurer pip avec elles.

Note

Si vous accédez à un référentiel dans un domaine qui vous appartient, vous n'avez pas besoin de l'inclure--domain-owner. Pour de plus amples informations, veuillez consulter Domaines multi-comptes.

Pour configurer pip, exécutez la commande suivante.

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

loginrécupère un jeton d'autorisation à l' CodeArtifact aide de vos AWS informations d'identification. La login commande sera configurée pip pour être utilisée CodeArtifact en éditant ~/.config/pip/pip.conf index-url pour définir le référentiel spécifié par l'--repositoryoption.

La période d'autorisation par défaut après l'appel login est de 12 heures et login doit être appelée pour actualiser régulièrement le jeton. Pour plus d'informations sur le jeton d'autorisation créé avec la login commande, consultezJetons créés avec la login commande.

Configurer pip sans la commande de connexion

Si vous ne pouvez pas utiliser la login commande pour configurerpip, vous pouvez utiliserpip config.

  1. Utilisez le AWS CLI pour récupérer un nouveau jeton d'autorisation.

    Note

    Si vous accédez à un référentiel dans un domaine qui vous appartient, il n'est pas nécessaire d'inclure le--domain-owner. Pour de plus amples informations, veuillez consulter Domaines multi-comptes.

    CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`
  2. pip configÀ utiliser pour définir le CodeArtifact registre URL et les informations d'identification. La commande suivante ne mettra à jour que le fichier de configuration de l'environnement actuel. Pour mettre à jour le fichier de configuration à l'échelle du système, remplacez-le site parglobal.

    pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/
    Note

    Pour utiliser un point de terminaison à double pile, utilisez le codeartifact.region.on.aws point de terminaison.

Important

Le registre URL doit se terminer par une barre oblique (/). Dans le cas contraire, vous ne pourrez pas vous connecter au référentiel.

Exemple de fichier de configuration pip

Voici un exemple de pip.conf fichier après avoir défini le CodeArtifact registre URL et les informations d'identification.

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

Exécutez pip

Pour exécuter pip des commandes, vous devez configurer pip avec CodeArtifact. Pour plus d’informations, consultez la documentation suivante.

  1. Suivez les étapes décrites dans la Configuration avec AWS CodeArtifact section pour configurer votre AWS compte, vos outils et vos autorisations.

  2. Configurez twine en suivant les étapes décrites dansConfigurer et utiliser Twine avec CodeArtifact.

En supposant qu'un package soit présent dans votre dépôt ou dans l'un de ses référentiels en amont, vous pouvez l'installer avecpip install. Par exemple, utilisez la commande suivante pour installer le requests package.

pip install requests

Utilisez -i cette option pour revenir temporairement à l'installation de packages depuis https://pypi.org au lieu de votre CodeArtifact dépôt.

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