Configure VMs para instalar pacotes Debian

Esta página descreve a configuração de VMs para instalar pacotes Debian a partir de um repositório Apt do Artifact Registry.

Antes de começar

Prepare uma VM para aceder a um repositório Apt

Configure uma VM para aceder a um repositório Apt padrão

Configure uma VM para aceder a um repositório Apt:

1. Execute o comando gcloud beta artifacts print-settings apt para gerar o comando de configuração da VM:

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

   Substitua o seguinte:

   • LOCATION é a localização regional ou multirregional do repositório.
   • REPOSITORY é o nome do repositório do Artifact Registry.

   O resultado é semelhante ao 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 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 obter pacotes do seu repositório através do comando echo a partir do resultado do comando print-settings.

   Por exemplo, para instalar pacotes do repositório público my-repo no projeto my-project e na localização 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
   

O APT já pode estabelecer ligação ao repositório.

Se criar repositórios Apt adicionais, pode adicioná-los ao ficheiro artifact-registry.list e, em seguida, executar novamente sudo apt update para atualizar as origens dos repositórios.

Configure uma VM para aceder a um repositório Apt remoto

Para configurar uma VM para usar apenas um repositório Apt remoto em vez de um repositório Apt upstream padrão, substitua o repositório padrão pelo seu repositório remoto no ficheiro /etc/apt/sources.list da VM.

1. Conceda autorizações de escrita do Artifact Registry ao nível do projeto à conta de serviço do Compute Engine predefinida:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/artifactregistry.writer
   

2. Aceda à página de instâncias de VM.

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

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

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

5. Elimine 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 o seguinte:

   • LOCATION com a localização regional ou multirregional do repositório remoto.
   • PROJECT_ID com o ID do projeto da VM.
   • REMOTE_REPOSITORY_NAME com o nome que deu ao seu repositório remoto.
   • UPSTREAM_REPOSITORY_NAME com o nome do repositório a montante do seu repositório remoto.
   • COMPONENTS com uma lista de nomes de componentes separados por espaços em branco.

   Por exemplo, a seguinte configuração configura a VM para obter pacotes do repositório my-repo no projeto my-project na localização us-east1 usando buster como o repositório a montante para os componentes main, contrib e non-free.

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

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

   sudo apt update
   

   O APT já pode estabelecer ligação ao repositório.

Use um repositório Apt remoto como alternativa

Se quiser manter o upstream padrão como a primeira opção e adicionar o repositório remoto como uma opção alternativa, pode manter o upstream padrão no ficheiro sources.list e anexar o repositório remoto ao final do ficheiro sources.list ou criar uma nova lista na pasta sources.list.d.

Para criar um novo ficheiro 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 o seguinte:

• LOCATION é a localização regional ou multirregional do repositório.
• PROJECT_ID com o ID do projeto da VM.
• REMOTE_REPOSITORY_NAME com o nome que deu ao seu repositório remoto.
• UPSTREAM_REPOSITORY_NAME com o nome do repositório a montante do seu comando.
• COMPONENTS com uma lista de nomes de componentes separados por espaços em branco.

Se criar repositórios Apt adicionais, pode adicioná-los ao ficheiro artifact-registry.list ou sources.list e, em seguida, executar novamente sudo apt update para atualizar as origens do repositório.

Configure o acesso HTTP a um repositório Apt

Se usar ferramentas de cliente mais antigas que não suportam a encriptação SSL, pode configurar o acesso público ao seu repositório Apt e aceder ao mesmo através de HTTP. Os pedidos enviados para repositórios legíveis publicamente através de HTTP são rejeitados se for apresentado um token de autenticação com o pedido.

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

2. Para configurar o Apt para obter pacotes do seu repositório através de 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 o seguinte:

   • LOCATION é a localização 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 na localização us-west1 através de 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
   

O APT já pode estabelecer ligação ao repositório.

Se criar repositórios Apt adicionais, pode adicioná-los ao ficheiro artifact-registry.list e, em seguida, executar novamente sudo apt update para atualizar as origens dos repositórios.

O que se segue?

• Saiba como gerir pacotes Debian