Configurar e usar o pip com o CodeArtifact - CodeArtifact
Configure o pip com o comando loginConfigurar o pip sem o comando loginExecutar o pip

Configurar e usar o pip com o CodeArtifact

pip é o instalador de pacotes para pacotes Python. Para usar o pip para instalar pacotes Python do seu repositório do CodeArtifact, primeiro você deve configurar o cliente pip com as informações e credenciais do repositório do CodeArtifact.

O pip só pode ser usado para instalar pacotes Python. Para publicar pacotes Python, você pode usar o twine. Para obter mais informações, consulte Configurar e usar o twine com o CodeArtifact.

Configure o pip com o comando login

Primeiro, configure suas credenciais AWS para uso com o AWS CLI, conforme descrito em Conceitos básicos do CodeArtifact. Em seguida, use o comando login do CodeArtifact para buscar as credenciais e configurar o 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.

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 do CodeArtifact usando suas credenciais da AWS. O comando login configurará pip para uso com o CodeArtifact editando ~/.config/pip/pip.conf para definir o index-url para o repositório especificado pela opção --repository.

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.

Configurar o pip sem o comando login

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.

    CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`

  2. Use pip config para definir o URL e as credenciais do registro do CodeArtifact. 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 arquivo pip.conf após definir o URL e as credenciais do registro do CodeArtifact.

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

Executar o pip

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

  1. Siga as etapas na seção Configuração do AWS CodeArtifact para configurar sua conta da AWS, ferramentas e permissões.

  2. Configure o twine seguindo as etapas em Configurar e usar o twine com o CodeArtifact.

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 opção -i para reverter temporariamente a instalação de pacotes de https://pypi.org em vez do seu repositório do CodeArtifact.

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