As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configure e use o pip com CodeArtifact
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/pip/) é o instalador de pacotes para pacotes Python. Para usar o pip para instalar pacotes Python do CodeArtifact seu repositório, você deve primeiro configurar o cliente pip com as informações e credenciais do CodeArtifact seu repositório.

O pip só pode ser usado para instalar pacotes Python. Para publicar pacotes Python, você pode usar o [twine](https://pypi.org/project/twine/). Para obter mais informações, consulte [Configure e use o twine com CodeArtifact](python-configure-twine.md).

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

Primeiro, configure suas AWS credenciais para uso com o AWS CLI, conforme descrito em[Conceitos básicos do CodeArtifact](getting-started.md). Em seguida, use o CodeArtifact `login` comando para buscar as credenciais e configurar `pip` com elas.

**nota**  
Se você estiver acessando um repositório em um domínio de sua propriedade, não será necessário incluir `--domain-owner`. Para obter mais informações, consulte [Domínios entre contas](domain-overview.md#domain-overview-cross-account).

Para configurar o pip, execute o seguinte comando.

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

 `login`busca um token de autorização CodeArtifact usando suas AWS credenciais. O `login` comando será CodeArtifact configurado `pip` para uso com `~/.config/pip/pip.conf` a edição para definir o `index-url` para o repositório especificado pela `--repository` opção.

O período de autorização padrão após chamar o `login` é de 12 horas e o `login` deve ser chamado para atualizar o token periodicamente. Para obter mais informações sobre o token de autorização criado com o comando `login`, consulte [Tokens criados com o comando `login`](tokens-authentication.md#auth-token-login).

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

 Se você não puder usar o comando `login` para configurar o `pip`, você pode usar `pip config`.

1. Use o AWS CLI para obter um novo token de autorização.
**nota**  
Se você estiver acessando um repositório em um domínio de sua propriedade, não precisa incluir `--domain-owner`. Para obter mais informações, consulte [Domínios entre contas](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. Use `pip config` para definir o URL e as credenciais do CodeArtifact registro. O comando a seguir atualizará somente o arquivo de configuração do ambiente atual. Para atualizar o arquivo de configuração de todo o sistema, substitua `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**  
Para usar um endpoint de pilha dupla, use o endpoint `codeartifact.region.on.aws`.

**Importante**  
O URL de registro deve terminar com uma barra inclinada (/). Do contrário, você não poderá se conectar ao repositório.

**Exemplo de arquivo de configuração do pip**

Veja a seguir um exemplo de `pip.conf` arquivo após definir o URL e as credenciais CodeArtifact do registro.

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

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

Para executar `pip` comandos, você deve configurar `pip` com CodeArtifact. Para obter mais informações, consulte a documentação a seguir.

1. Siga as etapas na [Configurando com AWS CodeArtifact](get-set-up-for-codeartifact.md) seção para configurar sua AWS conta, ferramentas e permissões.

1. Configure o `twine` seguindo as etapas em [Configure e use o twine com CodeArtifact](python-configure-twine.md).

Supondo que um pacote esteja presente em seu repositório ou em um de seus repositórios upstream, você pode instalá-lo com `pip install`. Por exemplo, use o seguinte comando para instalar o pacote `requests`.

```
pip install requests
```

Use a `-i` opção de reverter temporariamente a instalação de pacotes do [https://pypi.org](https://pypi.org) em vez do seu CodeArtifact repositório.

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