Armazene pacotes Python no Artifact Registry
Neste guia de início rápido, mostramos como configurar um repositório Python do Artifact Registry, fazer upload de um pacote e instalá-lo.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative a API Artifact Registry.
-
No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative a API Artifact Registry.
Iniciar o Cloud Shell
Neste guia de início rápido, você usará o Cloud Shell, que é um ambiente shell para gerenciar recursos hospedados no Google Cloud.
O Cloud Shell vem pré-instalado com a Google Cloud CLI e o Python. A CLI gcloud fornece a interface de linha de comando principal do Google Cloud.
Inicie o Cloud Shell:
Acesse o Console do Google Cloud.
Na barra de ferramentas do console do Google Cloud, clique em Ativar o Cloud Shell:
Uma sessão do Cloud Shell é aberta dentro de um quadro inferior no console.
Use esse shell para executar comandos gcloud
.
Instalar os pacotes necessários
O Twine é uma ferramenta para publicar pacotes do Python. Você vai usar o Twine para fazer upload de um pacote para o Artifact Registry.
Neste guia de início rápido, você usará a instalação do Python incluída no Cloud Shell. Essa instalação padrão inclui o back-end do keyring do Artifact Registry para lidar com a autenticação com o Artifact Registry. Se você criar um ambiente virtual ou configurar o Python fora do Cloud Shell, instale o back-end do keyring para autenticação. Saiba mais em Como autenticar com o keyring.
Para instalar o Twine, execute o comando:
pip install twine
Agora está tudo pronto para configurar o Artifact Registry.
Criar um repositório
Crie o repositório para seus pacotes.
Execute o seguinte comando para criar um novo repositório de pacotes Python no projeto atual chamado
quickstart-python-repo
no localus-central1
.gcloud artifacts repositories create quickstart-python-repo \ --repository-format=python \ --location=us-central1 \ --description="Python package repository"
Execute o seguinte comando para verificar se o repositório foi criado:
gcloud artifacts repositories list
Para simplificar os comandos
gcloud
, defina o repositório padrão comoquickstart-python-repo
e o local padrão comous-central1
. Depois que os valores forem definidos, não será necessário especificá-los nos comandosgcloud
que exigem um repositório ou local.Para definir o repositório, execute o comando:
gcloud config set artifacts/repository quickstart-python-repo
Para definir o local, execute o comando:
gcloud config set artifacts/location us-central1
Saiba mais sobre esses comandos na documentação do gcloud config set.
Configurar a autenticação
O back-end do keyring do Artifact Registry encontra suas credenciais usando o Application Default Credentials (ADC), uma estratégia que procura credenciais no seu ambiente.
Neste guia de início rápido, você vai:
- Gerar credenciais de usuário para o ADC. Em um ambiente de produção, use uma conta de serviço e forneça credenciais com a variável de ambiente
GOOGLE_APPLICATION_CREDENTIALS
. - Inclua o URL do repositório do Artifact Registry nos comandos
pip
etwine
para não precisar configurar o pip e o Twine com o URL do repositório.
Para gerar credenciais para o ADC, execute o seguinte comando:
gcloud auth application-default login
Para mais detalhes sobre métodos de autenticação e como adicionar repositórios à configuração do pip e do Twine, consulte Como configurar a autenticação em repositórios de pacotes do Python.
Receber um pacote de exemplo
Ao criar um projeto Python, os arquivos de distribuição são salvos em um subdiretório dist
no seu projeto Python. Para simplificar este guia de início rápido, faça o download de arquivos de pacotes pré-criados.
Crie uma pasta de projeto Python chamada
python-quickstart
.mkdir python-quickstart
Crie um subdiretório chamado
dist
e mude para o diretório.mkdir python-quickstart/dist cd python-quickstart/dist
Faça o download dos pacotes Python de amostra usados no tutorial Como empacotar projetos do Python do guia do usuário do Python.
pip download sampleproject
O comando faz o download do pacote
sampleproject
e da dependência dele,peppercorn
.
Faça upload do pacote para o repositório.
Use o Twine para fazer upload dos pacotes para o repositório.
No diretório
dist
, mude para o diretório paipython-quickstart
.cd ..
Faça upload dos pacotes para o repositório a partir do diretório
dist
.python3 -m twine upload --repository-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/ dist/*
Quando você executa o comando com
python3 -m
, o Python localiza o twine e executa o comando. Se o comandotwine
estiver no caminho do sistema, ele poderá ser executado sempython3 -m
.
O Twine faz o upload de sampleproject
e peppercorn
para seu repositório.
Ver o pacote no repositório
Para verificar se o pacote foi adicionado, liste-os no
repositório quickstart-python-repo
.
Execute este comando:
gcloud artifacts packages list --repository=quickstart-python-repo
Para ver as versões de um pacote, execute o seguinte comando:
gcloud artifacts versions list --package=PACKAGE
Em que PACKAGE é o ID do pacote.
Instale o pacote
Execute este comando para instalar o pacote:
pip install --index-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/simple/ sampleproject
Solução de problemas
Por padrão, ferramentas como pip e Twine não retornam mensagens de erro detalhadas.
Se você encontrar um erro, execute novamente o comando com a sinalização --verbose
para
ter uma saída mais detalhada. Consulte
Como solucionar problemas em pacotes Python para mais informações.
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
Antes de remover o repositório, verifique se os pacotes que você quer manter estão disponíveis em outro local.
Para excluir o repositório:
Para excluir o repositório
quickstart-python-repo
, execute o seguinte comando:gcloud artifacts repositories delete quickstart-python-repo
Se você quiser remover as configurações padrão de repositório e localização que definiu para a configuração ativa
gcloud
, execute os seguintes comandos:gcloud config unset artifacts/repository gcloud config unset artifacts/location
A seguir
- Saiba mais sobre como configurar a autenticação
- Saiba mais sobre como gerenciar repositórios
- Saiba mais sobre como gerenciar pacotes
- Leia nossos recursos sobre DevOps e conheça nosso programa de pesquisa.