Configure e use o pip com CodeArtifact - CodeArtifact
Configure o pip com o comando loginConfigurar o pip sem o comando loginExecutar o pip

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

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. Para obter mais informações, consulte Configure e use o twine com CodeArtifact.

Configure o pip com o comando login

Primeiro, configure suas AWS credenciais para uso com o AWS CLI, conforme descrito emComeçando com CodeArtifact. 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.

Para configurar o pip, execute o seguinte comando.

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

loginbusca 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.

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 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

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 seção para configurar sua AWS conta, ferramentas e permissões.

  2. Configure o twine seguindo as etapas em Configure e use o twine com 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 -i opção de reverter temporariamente a instalação de pacotes do https://pypi.org em vez do seu CodeArtifact repositório.

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