Configurar VMs para instalar pacotes do Debian

Os repositórios Apt do Artifact Registry permitem controlar quais versões de pacotes do Debian suas máquinas virtuais (VMs) instalam. É possível configurar instâncias do Compute Engine ou VMs externas para instalar pacotes de repositórios particulares ou públicos.

Antes de começar

Se o repositório Apt de destino não existir, crie um repositório padrão ou remoto. É possível criar um repositório particular ou um repositório público que não exija autenticação.

Preparar uma VM para acessar um repositório Apt

Repositório particular

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

   • Para VMs do Compute Engine, pode ser a conta de serviço padrão. O Artifact Registry recupera automaticamente as credenciais da conta de serviço da 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 visualizar e criar chaves para contas atuais 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

   VM do Debian

   1. Atribua escopos de acesso à 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 Apt usando o seguinte comando:

      sudo apt update
      

   3. Instale o pacote apt-transport-artifact-registry na VM:

      sudo apt install apt-transport-artifact-registry
      

   VM do Ubuntu

   1. Instale as chaves de assinatura do repositório do Apt usando o seguinte comando:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      Substitua LOCATION pelo local regional ou multirregional do repositório.

   2. Atribua escopos de acesso à 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.

   3. Configure a VM para acessar os pacotes do Artifact Registry usando o seguinte comando:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      

   4. Atualize o Apt usando o seguinte comando:

      sudo apt update
      

   5. Instale o pacote apt-transport-artifact-registry na VM:

      sudo apt install apt-transport-artifact-registry
      

   Outra VM

   1. Instale as chaves de assinatura do repositório do Apt usando o seguinte comando:

      curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/google-cloud-sdk.gpg
      

      Substitua LOCATION pelo local regional ou multirregional do repositório.

   2. Configure a VM para acessar os pacotes do Artifact Registry usando o seguinte comando:

      echo 'deb http://packages.cloud.google.com/apt apt-transport-artifact-registry-stable main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
      

   3. Atualize o Apt usando o seguinte comando:

      sudo apt update
      

   4. Instale o pacote apt-transport-artifact-registry na VM:

      sudo apt install apt-transport-artifact-registry
      

   5. Encontre a linha #Service-Account-JSON "/path/to/creds.json"; no arquivo /etc/apt/apt.conf.d/90artifact-registry, remova a marca de comentário da linha e adicione o caminho da chave da conta de serviço.

      Entrada do arquivo de configuração:

      Service-Account-JSON  "PATH_TO_SERVICE_ACCOUNT_KEY";
      

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

Repositório público

1. Configure o acesso público ao repositório.

2. Se você estiver configurando uma VM fora do Google Cloud, prepare sua máquina para acessar o repositório. Se você estiver configurando uma VM do Compute Engine, prossiga para a próxima etapa.

   Instale a chave pública de verificação de assinatura usando o seguinte comando:

   curl https://LOCATION-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/artifact-registry.gpg
   

   Substitua LOCATION pelo local regional ou multirregional do repositório.

3. Atualize o Apt usando o seguinte comando:

   sudo apt update
   

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

Configure uma VM para acessar um repositório do Apt:

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

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

   Substitua:

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

   O resultado será o seguinte:

   # To configure your package manager with this repository:
   
   # Update Apt:
   sudo apt update
   
   # Install the Apt credential helper:
   sudo apt install apt-transport-artifact-registry
   
   # Configure your VM to access Artifact Registry packages using the following
   # command:
   
   echo "deb [signed-by=/etc/apt/trusted.gpg.d/artifact-registry.gpg] ar+https://LOCATION-apt.pkg.dev/projects/PROJECT REPOSITORY main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   
   # Update Apt:
   sudo apt update
   

2. Configure o Apt para buscar pacotes do repositório usando o comando echo da saída do comando print-settings.

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

   echo 'deb ar+https://us-west1-apt.pkg.dev/projects/my-project my-repo main'
   

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

   sudo apt update
   

Agora o Apt pode se conectar ao repositório.

Se você criar outros repositórios do Apt, poderá adicioná-los ao arquivo artifact-registry.list e executar novamente sudo apt update para atualizar as origens do repositório.

Configurar uma VM para acessar um repositório remoto do Apt

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de 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 remoto do Apt em vez de um repositório upstream padrão do Apt, substitua o repositório padrão pelo repositório remoto no arquivo /etc/apt/sources.list da VM.

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

1. Conceda permissões de gravação do Artifact Registry em todo o projeto para a conta de serviço padrão do Compute Engine:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:[e-mail] \
      --role=roles/artifactregistry.writer
   

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

3. Na linha com sua VM, clique em SSH.

   Uma nova janela é aberta com uma sessão de terminal na VM.

4. Abra o arquivo /etc/apt/sources.list da VM e localize o repositório padrão que você quer substituir pelo novo repositório remoto.

5. Exclua a linha do repositório padrão e substitua-a pelo seguinte:

   deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS
   

   Substitua:

   • LOCATION pelo local regional ou multirregional do repositório remoto.
   • PROJECT_ID pelo ID do projeto da VM.
   • REMOTE_REPOSITORY_NAME pelo nome que você deu ao repositório remoto.
   • UPSTREAM_REPOSITORY_NAME pelo nome do repositório upstream do seu controle remoto.
   • COMPONENTS por uma lista separada por espaços em branco de nomes de componentes.

   Por exemplo, o comando a seguir configura a VM para buscar pacotes do repositório my-repo no projeto my-project no local us-east1 usando stable como o repositório upstream para os componentes main, contrib e non-free.

   deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo stable main contrib non-free
   

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

   sudo apt update
   

   Agora o Apt pode se conectar ao repositório.

Usar um repositório remoto do Apt como backup

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de 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 substituição, mantenha o upstream padrão no arquivo sources.list e anexe o repositório remoto ao final do arquivo sources.list ou crie uma nova lista na pasta sources.list.d.

Para criar um novo arquivo artifact-registry.list na pasta sources.list.d, execute o seguinte comando:

echo 'deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

Substitua:

• LOCATION é o local regional ou multirregional do repositório.
• PROJECT_ID pelo ID do projeto da VM.
• REMOTE_REPOSITORY_NAME pelo nome que você deu ao repositório remoto.
• UPSTREAM_REPOSITORY_NAME pelo nome do repositório upstream do seu remoto.
• COMPONENTS por uma lista de nomes de componentes separados por espaços em branco.

Se você criar outros repositórios do Apt, poderá adicioná-los ao arquivo artifact-registry.list ou sources.list e executar novamente sudo apt update para atualizar as fontes do repositório.

Configurar o acesso HTTP a um repositório Apt

Se você estiver usando ferramentas de cliente mais antigas que não são compatíveis com a criptografia SSL, configure o acesso público ao repositório do Apt e acesse-o via HTTP. As solicitações enviadas para repositórios públicos legíveis usando HTTP serão rejeitadas se um token de autenticação for apresentado com a solicitação.

1. Configure o acesso público ao repositório.

   Observação: o acesso HTTP só é ativado para repositórios que podem ser lidos publicamente.

2. Para configurar o Apt para buscar pacotes do seu repositório usando HTTP, execute o seguinte comando:

    echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID \
    REPOSITORY main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

   Substitua:

   • LOCATION é o local regional ou multirregional do repositório.
   • PROJECT_ID é o ID do projeto do repositório.
   • REPOSITORY é o nome do repositório.

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

   echo 'deb http://us-west1-apt.pkg.dev/projects/my-project my-repo main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

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

   sudo apt update
   

Agora o Apt pode se conectar ao repositório.

Se você criar outros repositórios do Apt, poderá adicioná-los ao arquivo artifact-registry.list e executar novamente sudo apt update para atualizar as origens do repositório.

A seguir

• Saiba mais sobre como gerenciar pacotes Debian