Configurar VMs para instalar pacotes RPM

Esta página descreve como configurar VMs para instalar pacotes RPM de um repositório Yum do Artifact Registry. Os repositórios do Artifact Registry Yum oferecem suporte a clientes yum e dnf.

Antes de começar

Se o repositório de destino do Yum não existir, crie um novo repositório. É possível criar um repositório privado ou público que não exija autenticação.

Preparar uma VM para acessar um repositório Yum

Para preparar uma VM para acessar um repositório Yum, use a ferramenta de cliente yum ou dnf:

Repositório particular

1. Escolha a conta de serviço que você vai usar para conceder acesso.

   • Para VMs do Compute Engine, essa pode ser a conta de serviço padrão. O Artifact Registry recupera automaticamente as credenciais da conta de serviço de VM do Compute Engine para qualquer VM que use uma conta de serviço.
   • Para outras VMs, crie ou escolha uma conta de serviço para agir em nome da VM. Você vai precisar do local do arquivo de chave da conta de serviço para configurar a VM. É possível ver e criar chaves para contas existentes na página Contas de serviço.

2. Conceda permissões de acesso ao repositório à sua conta de serviço.

3. Prepare a VM para acessar o repositório.

   VM do Compute Engine

   1. Atribua escopos de acesso da API cloud-platform à VM. Para informações sobre como definir escopos de acesso, consulte Como alterar a conta de serviço e os escopos de acesso de uma instância.

   2. Atualize o cache do pacote usando o seguinte comando:

      sudo yum makecache
      

   3. Instale o plug-in do Artifact Registry na VM usando o seguinte comando:

      sudo yum install FORMAT-plugin-artifact-registry
      

      Substitua:

      • FORMAT por um destes procedimentos:
        • yum, se o sistema operacional for Enterprise Linux 7 ou anterior
        • dnf, se o sistema operacional for Enterprise Linux 8 ou mais recente

   Outra VM

   1. Instale a chave de assinatura do RPM usando o seguinte comando:

      sudo rpm --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      

   2. Crie um arquivo chamado /etc/yum.repos.d/artifact-registry-plugin.repo com o seguinte conteúdo:

      [ar-plugin]
      name=Artifact Registry Plugin
      baseurl=https://packages.cloud.google.com/yum/repos/FORMAT-plugin-artifact-registry-DISTRO-stable
      enabled=1
      gpgcheck=1
      

      Substitua:

      • FORMAT por um destes procedimentos:
        • yum, se o sistema operacional for Enterprise Linux 7 ou anterior
        • dnf, se o sistema operacional for Enterprise Linux 8 ou mais recente
      • DISTRO com a versão principal do Red Hat Enterprise Linux no formato elX, em que X é a versão da versão. Exemplos de valores válidos de DISTRO são el7 e el8.

   3. Atualize o Yum usando o seguinte comando:

      sudo yum makecache
      

   4. Instale o plug-in do Artifact Registry na VM usando o seguinte comando:

      yum install FORMAT-plugin-artifact-registry
      

      Substitua FORMAT por um dos seguintes:

      • yum, se o sistema operacional for Enterprise Linux 7 ou anterior
      • dnf, se o sistema operacional for Enterprise Linux 8 ou mais recente

   5. Encontre a linha #service_account_json = "/path/to/creds.json" no arquivo artifact-registry.conf, descomente a linha e adicione o caminho da chave da conta de serviço.

      • Para sistemas operacionais Enterprise Linux 7 ou anteriores, o caminho para o arquivo de configuração é /etc/yum/pluginconf.d/artifact-registry.conf.
      • Para sistemas operacionais Enterprise Linux 8 ou mais recentes, o caminho para o arquivo de configuração é /etc/dnf/plugins/artifact-registry.conf.

      Entrada do arquivo de configuração:

      service_account_json = "PATH_TO_SERVICE_ACCOUNT_KEY"
      

      Substitua PATH_TO_SERVICE_ACCOUNT_KEY pelo caminho do arquivo JSON da chave da conta de serviço.

Repositório público

Configure o acesso público ao repositório.

Configurar uma VM para acessar um repositório padrão do Yum

Para configurar uma VM para acessar um repositório Yum, use a ferramenta de cliente yum ou dnf:

1. Gere o comando de configuração da VM executando o comando gcloud beta artifacts print-settings yum:

   gcloud beta artifacts print-settings yum \
       --repository=REPOSITORY \
       --location=LOCATION
   

   Substitua:

   • REPOSITORY é o nome do repositório do Artifact Registry.
   • LOCATION é o local regional ou multirregional do repositório.

   O resultado será assim:

   # To configure your package manager with this repository:
   
   # Update Yum:
   sudo yum makecache
   
   # Install the Yum credential helper:
   sudo yum install yum-plugin-artifact-registry
   
   # Configure your VM to access Artifact Registry packages using the following
   # command:
   
   sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL
   [REPOSITORY]
   name=REPOSITORY
   baseurl=https://LOCATION-yum.pkg.dev/projects/PROJECT/REPOSITORY
   enabled=1
   repo_gpgcheck=0
   gpgcheck=0
   EOL
   
   # Update Yum:
   sudo yum makecache
   

2. Configure a ferramenta de cliente yum para buscar pacotes do repositório usando o comando tee da saída do comando print-settings.

   Por exemplo, para instalar pacotes do my-repo público no projeto my-project e no local us-west1, use o seguinte comando:

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

   Observação: a validação do GPG no nível do repositório do Yum, usando repo_gpgcheck, não é compatível com os repositórios do Artifact Registry. Os repositórios do Artifact Registry são veiculados por HTTPS (usando certificados SSL), e a veiculação por HTTPS é considerada mais confiável.

3. Atualize as origens do repositório com o seguinte comando:

   sudo yum makecache
   

O Yum agora pode se conectar ao repositório.

Se você criar outros repositórios do Yum, crie um arquivo .repo para cada um em /etc/yum.repos.d/. Execute sudo yum update novamente para atualizar as origens do repositório.

Configurar uma VM para acessar um repositório Yum remoto

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para configurar uma VM para usar apenas um repositório Yum remoto em vez de um repositório Yum padrão, substitua o repositório padrão na lista de repositórios da VM pelo repositório remoto.

Se o repositório padrão for definido no arquivo de configuração em vez de um arquivo de repositório separado (.repo), você poderá excluir a entrada no arquivo de configuração e substituí-la pelo controle remoto ou definir um novo arquivo de repositório no diretório /etc/yum.repos.d/.

Aviso: reordenar e excluir repositórios do arquivo de configuração do Yum pode ter consequências graves. Se você não tiver certeza de que quer remover o repositório padrão, configure o Yum para usar um repositório remoto do Yum como backup.

1. Acesse a página Instâncias de VMs.

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

3. Abra a pasta /etc/yum.repos.d/ da VM e encontre o arquivo de repositório adequado (.repo) que contém o repositório upstream padrão. Às vezes, ele é chamado de repositório base. O repositório base pode ser identificado pelo nome do repositório do Yum que contém [base] ou [baseos].

4. Para substituir o repositório base completamente, remova as configurações padrão em [base] ou [baseos]. Se você quiser manter o repositório padrão upstream e adicionar o repositório remoto como uma opção de fallback, não remova as configurações padrão.

5. Adicione as seguintes configurações em [base] ou [baseos]:

   name=YUM_REPOSITORY_NAME
   baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
   enabled=1
   gpgcheck=1
   

   Substitua:

• YUM_REPOSITORY_NAME com um ID de repositório exclusivo de uma palavra para o repositório remoto do Yum. Esse nome pode corresponder ao nome do repositório upstream se você tiver excluído a configuração padrão do repositório upstream ou se mantiver o repositório upstream padrão. Nesse caso, use um nome diferente para identificá-lo como um repositório remoto.
• LOCATION é o local regional ou multirregional do repositório.
• PROJECT_ID pelo ID do projeto da VM.
• REMOTE_REPOSITORY_NAME com o nome legível por humanos do repositório remoto.

Observação: a validação do GPG no nível do repositório Yum, usando repo_gpgcheck, não é compatível com os repositórios do Artifact Registry. Os repositórios do Artifact Registry são exibidos por HTTPS (usando certificados SSL), e a exibição por HTTPS é considerada mais confiável.

Usar um repositório Yum remoto como backup

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você quiser manter o upstream padrão como a primeira opção e adicionar o repositório remoto como uma opção de fallback, mantenha o upstream padrão no arquivo do repositório e crie um novo arquivo de repositório na pasta /etc/yum.repos.d.

Para criar um novo arquivo de repositório na pasta /etc/yum.repos.d, execute o seguinte comando:

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[YUM_REPOSITORY_NAME]
name=REPOSITORY_NAME
baseurl=https://LOCATION-yum.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME
enabled=1
gpgcheck=1
EOF

Substitua:

• YUM_REPOSITORY_NAME com um ID de repositório exclusivo de uma palavra para seu repositório remoto do Yum.
• REPOSITORY_NAME com o nome legível do repositório.
• LOCATION com o local regional ou multirregional do repositório remoto.
• PROJECT_ID com o ID do projeto da VM.
• REMOTE_REPOSITORY_NAME pelo nome que você deu ao repositório remoto.

Por exemplo, o comando a seguir configura a VM para buscar o repositório my-repo no projeto my-project e no local us-west1 quando o Yum instala o repositório my-repo.

Observação: o YUM_REPOSITORY_NAME e o REMOTE_REPOSITORY_NAME do Artifact Registry podem ser diferentes, mas o YUM_REPOSITORY_NAME é usado em relatórios de erros. Por isso, é útil manter o mesmo nome do repositório.

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
[my-repo]
name=My Repository
baseurl=https://us-west1-yum.pkg.dev/remote/my-project/my-repo
enabled=1
gpgcheck=1
EOF

A seguir

• Saiba mais sobre como gerenciar pacotes