Armazene pacotes RPM no Artifact Registry

Armazene pacotes RPM no Artifact Registry

Neste guia de início rápido, mostramos como configurar um repositório particular do Artifact Registry Yum, adicionar um pacote RPM ao repositório e instalar o pacote em uma VM do Compute Engine que executa o sistema operacional CentOS 7. Para saber como configurar repositórios do Yum que usam DNF, consulte Como configurar VMs para instalar pacotes RPM.

Para executar as etapas neste guia de início rápido, use o Cloud Shell e o shell na VM criada.

Para saber mais sobre como gerenciar pacotes RPM, consulte Como trabalhar com pacotes RPM.

Antes de começar

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

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative a API Artifact Registry.

   Ative a API

5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

6. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

7. Ative a API Artifact Registry.

   Ative a API

Iniciar o Cloud Shell

O Cloud Shell vem pré-instalado com a Google Cloud CLI. A CLI gcloud fornece a interface de linha de comando principal do Google Cloud.

Inicie o Cloud Shell:

1. Acesse o Console do Google Cloud.

   Console do Google Cloud

2. 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. Você usará esse shell na execução dos comandos gcloud para criar uma VM e um repositório.

Criar um repositório

Crie o repositório para seus artefatos.

1. Crie o repositório:

   Console

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

      Abrir a página Repositórios

   2. Clique em Criar repositório.

   3. Especifique quickstart-yum-repo como o nome do repositório.

   4. Selecione Yum como o formato.

   5. Em Tipo de local, selecione Região e escolha o local us-central1.

   6. Clique em Criar.

   O repositório é adicionado à lista de repositórios.

   gcloud

   1. No Cloud Shell, execute o seguinte comando para criar um novo repositório Yum no projeto atual chamado quickstart-yum-repo no local us-central1.

      gcloud artifacts repositories create quickstart-yum-repo \
          --repository-format=yum \
          --location=us-central1 \
          --description="Yum repository"
      

   2. Execute o seguinte comando para verificar se o repositório foi criado:

      gcloud artifacts repositories list
      

Agora é possível adicionar um pacote ao repositório.

Adicionar um pacote ao repositório

É possível fazer upload de um pacote para um repositório usando a Google Cloud CLI ou importar um pacote armazenado no Cloud Storage. Se você criar pacotes usando o Cloud Build, o build poderá armazenar os pacotes no Cloud Storage para importação.

Para este guia de início rápido, faça o upload de um arquivo de amostra usando o comando gcloud artifacts yum upload.

1. No Cloud Shell, faça o download do editor de texto nano com o comando:

   sudo yum install --downloaddir=. --downloadonly nano
   

   O Yum faz o download da versão mais recente do pacote disponível nos repositórios CentOS configurados.

   Loaded plugins: fastestmirror
   Loading mirror speeds from cached hostfile
    * base: mirror.dal.nexril.net
    * epel: ord.mirror.rackspace.com
    * extras: centos.mirror.lstn.net
    * updates: ftpmirror.your.org
   Resolving Dependencies
   --> Running transaction check
   ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
   --> Finished Dependency Resolution
   
   Dependencies Resolved
   
   ================================================================================
    Package        Arch             Version                   Repository      Size
   ================================================================================
   Installing:
    nano           x86_64           2.3.1-10.el7              base           440 k
   
   Transaction Summary
   ================================================================================
   Install  1 Package
   
   Total download size: 440 k
   Installed size: 1.6 M
   Background downloading packages, then exiting:
   nano-2.3.1-10.el7.x86_64.rpm                               | 440 kB   00:00
   exiting because "Download Only" specified
   

   Execute ls para saber o nome do arquivo do pacote. O nome do arquivo é semelhante a nano-2.3.1-10.el7.x86_64.rpm.

2. Para simplificar os comandos gcloud, defina o repositório padrão como quickstart-yum-repo e o local padrão como us-central1. Depois que os valores forem definidos, não será necessário especificá-los nos comandos gcloud que exigem um repositório ou local.

   Para definir o repositório, execute o comando:

   gcloud config set artifacts/repository quickstart-yum-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.

3. Execute gcloud artifacts yum upload para fazer upload do pacote para o repositório:

   gcloud artifacts yum upload quickstart-yum-repo \
       --source=FILE_NAME
   

   Substitua FILE_NAME pelo caminho para o pacote nano.

Ver o pacote no repositório

Verifique se o pacote foi adicionado ao repositório.

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 quickstart-yum-repo.

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

gcloud

Para listar os pacotes no repositório quickstart-yum-repo, execute o comando:

 gcloud artifacts packages list

Para ver as versões de um pacote em quickstart-yum-repo, execute o comando:

gcloud artifacts versions list --package=nano

criar uma VM

Crie uma nova VM do Compute Engine em que você instalará o pacote de amostra.

No Cloud Shell, execute o seguinte comando para criar uma instância de VM chamada quickstart-yum-vm.

gcloud compute instances create quickstart-yum-vm \
    --image-family=centos-7 \
    --image-project=centos-cloud \
    --scopes=cloud-platform

Por padrão, a VM não tem os escopos de acesso necessários para trabalhar com o repositório. A sinalização --scopes define o escopo de acesso da VM como cloud-platform.

Configurar o gerenciador de pacotes

Para instalar um pacote na VM, adicione o repositório criado ao arquivo Yum que define os repositórios de pacotes.

Observação: a VM criada neste guia de início rápido usa uma imagem de SO criada pelo Google, que é pré-configurada com algumas configurações para acessar os repositórios do Artifact Registry. Se você quiser configurar uma VM que usa uma imagem do SO que não foi criada pelo Google ou uma VM fora do Google Cloud, consulte as instruções de configuração de VM.

1. Acesse a página "Instâncias de VM".

   Abrir a página "Instâncias de VM"

2. Na linha da sua VM, clique em SSH. Uma nova janela é aberta com uma sessão de terminal na VM.

3. Atualize o Yum:

   sudo yum makecache
   

4. Instale o auxiliar de credencial do Yum na VM para permitir que o Yum realize autenticação, usando o seguinte comando:

   sudo yum install yum-plugin-artifact-registry
   

5. Configure sua VM para acessar pacotes do Artifact Registry usando o seguinte comando:

   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
   [yum-quickstart]
   name=My Repository
   baseurl=https://us-central1-yum.pkg.dev/projects/PROJECT/quickstart-yum-repo
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOF
   

   Substitua PROJECT pelo ID do projeto do Google Cloud.

Instale o pacote

Instale o pacote adicionado ao repositório.

1. Atualize a lista de pacotes disponíveis:

   sudo yum makecache
   

2. Instale o pacote no repositório.

   sudo yum --enablerepo=yum-quickstart install nano
   

   Digite y quando solicitado.

   As informações de instalação retornadas são semelhantes ao exemplo a seguir:

   Loaded plugins: fastestmirror
   Loading mirror speeds from cached hostfile
    * base: mirrors.cmich.edu
    * epel: ord.mirror.rackspace.com
    * extras: mirror.team-cymru.com
    * updates: mirror.us-midwest-1.nexcess.net
   quickstart-yum-repo                                      | 1.3 kB     00:00
   Resolving Dependencies
   --> Running transaction check
   ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
   --> Finished Dependency Resolution
   
   Dependencies Resolved
   
   ================================================================================
    Package        Arch             Version                   Repository      Size
   ================================================================================
   Installing:
    nano           x86_64           2.3.1-10.el7              base           440 k
   
   Transaction Summary
   ================================================================================
   Install  1 Package
   
   Total size: 440 k
   Installed size: 1.6 M
   Is this ok [y/d/N]: y
   Downloading packages:
   Running transaction check
   Running transaction test
   Transaction test succeeded
   Running transaction
     Installing : nano-2.3.1-10.el7.x86_64                                     1/1
     Verifying  : nano-2.3.1-10.el7.x86_64                                     1/1
   
   Installed:
     nano.x86_64 0:2.3.1-10.el7
   
   Complete!
   

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:

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, selecione o repositório quickstart-yum-repo.

3. Clique em Excluir.

gcloud

1. Para excluir o repositório quickstart-yum-repo, execute o seguinte comando:

   gcloud artifacts repositories delete quickstart-yum-repo
   

2. Se quiser remover as configurações padrão de repositório e localização que definiu como configuração ativa gcloud, execute os seguintes comandos:

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

Para excluir a VM criada, execute o seguinte comando:

gcloud compute instances delete quickstart-yum-vm

A seguir

• Saiba como trabalhar com pacotes RPM.
• Leia nossos recursos sobre DevOps e conheça nosso programa de pesquisa.