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
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/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](https://pypi.org/project/twine/). Pour de plus amples informations, veuillez consulter [Configurez et utilisez Twine avec CodeArtifact](python-configure-twine.md).

## Configurez pip avec la commande `login`
<a name="python-configure-pip-login"></a>

Tout d'abord, configurez vos AWS informations d'identification à utiliser avec le AWS CLI, comme décrit dans[Commencer avec CodeArtifact](getting-started.md). 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](domain-overview.md#domain-overview-cross-account).

Pour configurer pip, exécutez la commande suivante.

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

 `login`ré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'`--repository`option.

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, consultez[Jetons créés avec la `login` commande](tokens-authentication.md#auth-token-login).

## Configurer pip sans la commande de connexion
<a name="python-configure-without-pip"></a>

 Si vous ne pouvez pas utiliser la `login` commande pour configurer`pip`, vous pouvez utiliser`pip 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](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`À utiliser pour définir l'URL du CodeArtifact registre 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` par`global`.

   ```
   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**  
L'URL du registre 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 l'URL du CodeArtifact registre 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
<a name="python-run-pip"></a>

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](get-set-up-for-codeartifact.md) section pour configurer votre AWS compte, vos outils et vos autorisations.

1. Configurez `twine` en suivant les étapes décrites dans[Configurez et utilisez Twine avec CodeArtifact](python-configure-twine.md).

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 avec`pip 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](https://pypi.org) au lieu de votre CodeArtifact dépôt.

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