

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configura y usa pip con CodeArtifact
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/pip/) es el instalador de paquetes para los paquetes de Python. Para usar pip para instalar paquetes de Python desde su CodeArtifact repositorio, primero debe configurar el cliente pip con la información y las credenciales de su CodeArtifact repositorio.

pip solo se puede usar para instalar paquetes de Python. Para publicar paquetes de Python, puede usar [twine](https://pypi.org/project/twine/). Para obtener más información, consulte [Configura y usa twine con CodeArtifact](python-configure-twine.md).

## Configure pip con el comando `login`
<a name="python-configure-pip-login"></a>

En primer lugar, configure sus AWS credenciales para usarlas con AWS CLI, tal y como se describe en. [Introducción a CodeArtifact](getting-started.md) A continuación, utilice el CodeArtifact `login` comando para obtener las credenciales y configurarlas `pip` con ellas.

**nota**  
Si va a acceder a un repositorio de un dominio de su propiedad, no tiene que incluir `--domain-owner`. Para obtener más información, consulte [Dominios entre cuentas](domain-overview.md#domain-overview-cross-account).

Ejecute el siguiente comando para configurar pip.

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

 `login`obtiene un token de autorización mediante el CodeArtifact uso de sus credenciales. AWS El `login` comando se configurará `pip` para su uso con CodeArtifact él `~/.config/pip/pip.conf` editándolo para `index-url` establecerlo en el repositorio especificado por la `--repository` opción.

El período de autorización predeterminado después de una llamada `login` es de 12 horas y `login` debe invocarse para actualizar periódicamente el token. Para obtener más información sobre el token de autorización creado con el comando `login`, consulte [Tokens creados con el comando `login`](tokens-authentication.md#auth-token-login).

## Configurar pip sin el comando login
<a name="python-configure-without-pip"></a>

 Si no puede usar el comando `login` para configurar `pip`, puede usar `pip config`.

1. Use el AWS CLI para obtener un nuevo token de autorización.
**nota**  
Si va a acceder a un repositorio de un dominio de su propiedad, no tiene que incluir el `--domain-owner`. Para obtener más información, consulte [Dominios entre cuentas](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. Se usa `pip config` para configurar la URL y las credenciales CodeArtifact del registro. El siguiente comando actualizará únicamente el archivo de configuración del entorno actual. Para actualizar el archivo de configuración de todo el sistema, sustituya `site` por `global`.

   ```
   pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/
   ```
**nota**  
Si quiere utilizar un punto de conexión de pila doble, use el punto de conexión `codeartifact.region.on.aws`.

**importante**  
La dirección URL del registro debe terminar con una barra diagonal (/). De lo contrario, no puede conectarse al repositorio.

**Ejemplo de archivo de configuración de pip**

El siguiente es un ejemplo de un `pip.conf` archivo después de configurar la URL y las credenciales CodeArtifact del registro.

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

## Ejecutar pip
<a name="python-run-pip"></a>

Para ejecutar `pip` comandos, debe configurarlos `pip` con CodeArtifact. Para obtener más información, consulte la documentación siguiente.

1. Siga los pasos de la [Configuración con AWS CodeArtifact](get-set-up-for-codeartifact.md) sección para configurar la AWS cuenta, las herramientas y los permisos.

1. Configure `twine` siguiendo los pasos que se describen en [Configura y usa twine con CodeArtifact](python-configure-twine.md).

Suponiendo que un paquete esté presente en su repositorio o en uno de sus repositorios ascendentes, puede instalarlo con `pip install`. Por ejemplo, utilice el siguiente comando para instalar el paquete `requests`.

```
pip install requests
```

Utilice la `-i` opción para volver temporalmente a instalar paquetes desde [https://pypi.org](https://pypi.org) en lugar de desde su CodeArtifact repositorio.

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