Como gerenciar pacotes do Python

Nesta página, você verá como adicionar, visualizar e excluir pacotes do Python e versões de pacote.

O gerenciamento de pacotes está em Alfa. Ele só está disponível para usuários Alfa e pode não incluir todos os recursos disponíveis para o gerenciamento de contêineres. Para se inscrever no Alfa, preencha o formulário de inscrição. Para mais informações, consulte Requisitos para acessar recursos Alfa.

Antes de começar

  1. Verifique se você ativou a API Artifact Registry e instalou o SDK do Cloud. Para instruções, consulte Como ativar e desativar o serviço.

    A versão 329.0.0 da ferramenta de linha de comando gcloud é necessária para executar comandos em repositórios PyPI. Verifique a versão com o comando:

    gcloud version
    
  2. Se o repositório de destino não existir, crie um novo repositório PyPI.

  3. Verifique se o Python 3 está instalado. Para instruções de instalação, consulte o tutorial para configurar o Python do Google Cloud.

  4. (Opcional) Configure padrões para comandos gcloud.

  5. Se você estiver usando a autenticação de keyring com credenciais do gcloud, faça login no SDK do Cloud com sua conta de usuário ou de serviço.

Como adicionar pacotes

Permissões necessárias: gravador do Artifact Registry

Quando você cria um projeto do Python, os arquivos de distribuição são salvos em um subdiretório dist no projeto. Em seguida, use o Twine para fazer upload de pacotes para o repositório. Recomendamos usar nomes exclusivos para os pacotes privados que não correspondam a nomes de pacotes em pypi.org, especialmente se a configuração do pip incluir vários índices de pacotes.

  1. Instale o Twine (em inglês).

    pip install twine
    
  2. Mude para o diretório do projeto Python.

  3. Faça o upload dos arquivos de distribuição para o repositório do subdiretório dist do projeto. Execute este comando:

    twine upload dist/*
    

    É possível especificar um repositório específico com a sinalização --repository-url.

    twine upload --repository-url https://LOCATION-pypi.pkg.dev/PROJECT/REPOSITORY/ dist/*
    

Como visualizar pacotes e versões

Permissões necessárias: leitor do Artifact Registry

Para visualizar pacotes e versões de pacotes usando o Console do Google Cloud ou gcloud:

Console

  1. Abra a página Repositórios no Console do Google Cloud.

    Abrir a página Repositórios

  2. Na lista de repositórios, clique no repositório apropriado.

    A página Pacotes lista os pacotes no repositório.

  3. Clique em um pacote para visualizar as versões dele.

gcloud

Para listar pacotes em um repositório, execute o seguinte comando:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Onde

  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, você pode omitir essa sinalização para usar o padrão.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.

Para ver as versões de um pacote, execute o seguinte comando:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Onde

  • PACKAGE é o ID do pacote ou o identificador totalmente qualificado do pacote.
  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, você pode omitir essa sinalização para usar o padrão.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.

Como excluir pacotes e versões

Permissões necessárias: administrador de repositórios do Artifact Registry

Para excluir um pacote:

Console

  1. Abra a página Repositórios no Console do Google Cloud.

    Abrir a página Repositórios

  2. Na lista de repositórios, clique no repositório apropriado.

    A página Pacotes lista os pacotes no repositório.

  3. Selecione o pacote que você quer excluir.

  4. Clique em EXCLUIR.

  5. Na caixa de diálogo de confirmação, clique em Excluir.

gcloud

Execute este comando:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Onde

  • PACKAGE é o nome do pacote no repositório.
  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, você pode omitir essa sinalização para usar o padrão.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.
  • --async Retorna imediatamente, sem aguardar a conclusão da operação em andamento.

Para excluir versões de um pacote:

Console

  1. Abra a página Repositórios no Console do Google Cloud.

    Abrir a página Repositórios

  2. Na lista de repositórios, clique no repositório apropriado.

    A página Pacotes lista os pacotes no repositório.

  3. Clique em um pacote para visualizar as versões dele.

  4. Selecione as versões que você quer excluir.

  5. Clique em EXCLUIR.

  6. Na caixa de diálogo de confirmação, clique em Excluir.

gcloud

Execute este comando:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Onde

  • PACKAGE é o nome do pacote no repositório.
  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, você pode omitir essa sinalização para usar o padrão.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.
  • --async retorna imediatamente, sem aguardar a conclusão da operação em andamento.

Fazendo o download de pacotes

Permissões necessárias: leitor do Artifact Registry

Use o comando pip para instalar pacotes do repositório.

Execute este comando:

pip install PACKAGE

Se você não especificar um repositório, sua configuração de pip no pip.conf determinará como o pip pesquisará o pacote.

  • Se você configurou o repositório Artifact Registry com a configuração index-url e nenhum outro índice de pacote está configurado, o pip só pesquisa o repositório do Artifact Registry para o pacote.
  • Se você configurou o repositório com a configuração extra-index-url ou configurou vários índices de pacotes, o pip pesquisa pypi.org e quaisquer outros índices de pacotes configurados e escolhe o versão mais recente do pacote.

Também é possível especificar o repositório para pesquisa adicionando a sinalização --index-url ao comando.

pip install --index-url https://LOCATION-pypi.pkg.dev/PROJECT/REPOSITORY/simple/ PACKAGE

A seguir