Ambiente para convidado

Neste documento, apresentamos uma visão geral do ambiente de convidado, que contém scripts, daemons e binários necessários para que as instâncias sejam executadas no Compute Engine.

O ambiente convidado se comunica com o servidor de metadados, que é um servidor HTTP por instância executado ao lado de cada instância do Compute Engine. O servidor de metadados fornece à instância dados operacionais e de configuração essenciais. Para mais informações sobre os tipos de metadados armazenados no servidor de metadados, consulte Metadados da VM.

O ambiente de convidado é instalado automaticamente em instâncias do Compute Engine criadas usando a maioria das imagens de sistema operacional (SO) públicas fornecidas pelo Google. Cada imagem do SO requer pacotes de ambiente de convidado específicos. Esses pacotes são criados pelo Google ou pelo distribuidor do sistema operacional. As atualizações dos pacotes do ambiente de convidado são lançadas região por região. Essas atualizações podem levar até duas semanas para chegar a todos os locais do mundo. Para mais informações, consulte Lançamentos de repositório de pacotes do ambiente convidado.

Para uma lista completa de imagens de SO que incluem o ambiente de convidado, consulte Detalhes do sistema operacional.

Componentes do ambiente de convidado

A seção a seguir descreve os pacotes e serviços que permitem que uma instância se comunique com o Compute Engine.

O agente convidado

O componente central do ambiente convidado é o agente convidado, que processa tarefas como gerenciamento de contas, integração do login do SO e gerenciamento de interfaces de rede. O agente convidado está disponível para sistemas operacionais Linux e Windows, com os seguintes nomes de pacotes:

  • Linux: google-guest-agent
  • Windows: google-compute-engine-windows

Para informações detalhadas sobre o agente convidado, incluindo recursos, arquitetura e como gerenciar o agente, consulte Agente convidado.

Componentes do Linux

Os componentes básicos de um ambiente de convidado do Linux são pacotes deb ou rpm. O Compute Engine cria esses pacotes com as configurações adequadas para a distribuição compatível. Para conferir a lista de pacotes instalados na sua instância do Linux, conecte-se a ela e execute o comando fornecido para sua versão do SO na tabela Pacotes instalados por versão do sistema operacional.

O ambiente de convidado do Linux inclui os seguintes pacotes principais:

Nome do pacote Descrição Interações principais Link para o código-fonte no GitHub
google-guest-agent

Esse pacote é o agente de convidado para o ambiente Linux.

O agente convidado do Linux contém os scripts executados no SO convidado para oferecer suporte aos recursos do Compute Engine. Para informações detalhadas sobre o agente convidado, incluindo recursos, arquitetura e como gerenciar o agente, consulte Agente convidado.

 guest-agent
google-compute-engine

Contém os scripts e arquivos necessários para a inicialização e configuração do sistema.

Este pacote contém o seguinte:

  • Scripts de inicialização do sistema para systemd
  • Configurações do sistema, como regras de udev, sysctl, rsyslog e dhcp, usadas para definir o nome do host.
  • Scripts Bash executados durante a inicialização da instância
  • Um arquivo gce-resolved.conf, lançado em outubro de 2024, que garante que as pesquisas de domínio para domínios do Cloud DNS .local sejam encaminhadas para o servidor de metadados. Sem esse arquivo, as pesquisas de domínio são encaminhadas pelo systemd-resolved, o que geralmente falha.

    Se o ambiente não usar domínios .local, remova o arquivo gce-resolved.conf se ele entrar em conflito com as configurações atuais.

 Funciona com os seguintes pacotes para configurar instâncias.
  • google-guest-agent
  • google-compute-engine-oslogin
 guest-configs
google-compute-engine-oslogin Contém os binários, módulos e scripts necessários para gerenciar o acesso à instância usando o login do SO. O Login do SO permite gerenciar o acesso a instâncias usando papéis do IAM. Para mais informações sobre o Login do SO, consulte Login do SO.

Este pacote contém o seguinte:

  • Comando de chaves autorizadas: um comando que usa as chaves públicas SSH para autenticar usuários no login.
  • Módulos do comutador de serviço de nomes (NSS): um serviço que fornece ao sistema as informações de usuário e grupo do login do SO.
  • Módulos de autenticação conectáveis (PAM): um módulo que oferece suporte à autorização (e autenticação se o suporte a dois fatores estiver ativado). Esse módulo permite que o sistema use permissões do IAM Google Cloud para controlar se ele pode fazer login em uma instância ou realizar operações como raiz (com sudo).
  • google_oslogin_nss_cache: um utilitário para atualizar o cache local de usuários e grupos.
  • selinux: um pacote que contém arquivos de definição de política do SELinux e um pacote de política compilado para configurar o SELinux para oferecer suporte ao login do SO.
guest-oslogin
gce-disk-expand Contém os componentes necessários para redimensionar um disco de inicialização. Envia registros para a porta serial gce-disk-expand
google-osconfig-agent Contém o agente de configuração do SO, que o VM Manager usa para gerenciar inventário, patches e políticas do SO. Para mais informações sobre o agente de configuração do SO, consulte VM Manager.

Lê e grava dados nos metadados da VM

Por padrão, o agente de configuração do SO não coleta nem envia informações até que você ative o agente de configuração do SO. Depois de ativar o agente, ele se comunica com o serviço da API OS Config. Para analisar as operações concluídas pelo agente, consulte Registro de auditoria do VM Manager.

 guest-osconfig

Componentes do Windows

Todas as imagens do SO Windows fornecidas pelo Google são pré-configuradas com a ferramenta GooGet e os repositórios Google Cloud . O GooGet instala e mantém o ambiente convidado para instâncias do Windows. Se você precisar instalar o GooGet e configurar repositórios, consulte Empacotamento e distribuição de pacotes no repositório compute-image-windows do GitHub. Para conferir a lista de pacotes instalados na instância do Windows, conecte-se a ela e execute googet installed.

O ambiente convidado do Windows inclui os seguintes pacotes principais:

Nome do pacote Descrição Interações principais Link para o código-fonte no GitHub
google-compute-engine-windows

Este pacote é o agente convidado para o ambiente Windows.

O agente convidado do Windows contém os scripts que são executados no SO convidado para oferecer suporte aos recursos do Compute Engine. Para informações detalhadas sobre o agente convidado, incluindo recursos, arquitetura e como gerenciar o agente, consulte Agente convidado.

 guest-agent
google-compute-engine-sysprep Contém scripts para generalizar uma instância do Windows em preparação para criar uma imagem do SO. O pacote também inclui o script instance_setup.ps1, que é executado na primeira inicialização para configurar a nova instância.
  • Lê e grava dados nos metadados da VM
  • Envia registros para o log de eventos de aplicativos do Windows e a porta serial.
 sysprep
google-compute-engine-metadata-scripts

Contém scripts e binários que executam scripts sysprep-specialize, startup e shutdown.
  • Lê e grava dados nos metadados da VM
  • Lê dados de locais do Cloud Storage quando os sysprep-specialize-script-url e windows-startup-script-url são usados
  • Envia registros para o log de eventos de aplicativos do Windows, porta serial e Cloud Logging.
google_metadata_script_runner
google-compute-engine-powershell Contém um módulo do PowerShell. Esse módulo fornece funções comuns usadas por scripts do PowerShell nos outros scripts de ambiente convidado do Windows. Envia registros para o log de eventos de aplicativos do Windows e a porta serial. PowerShell
google-compute-engine-auto-updater

Contém scripts que atualizam os pacotes do Compute Engine diariamente.

Esse pacote não é instalado por padrão. Essa abordagem permite manter a estabilidade do ambiente controlando o processo de atualização. Se o ambiente puder tolerar atualizações sem interrupção, instale este pacote para garantir que os pacotes do ambiente de convidado sejam atualizados automaticamente.

Para instalar esse pacote, use o seguinte comando: googet -noconfirm install google-compute-engine-auto-updater

  • Lê dados de metadados da VM
  • Chama o agente GooGet para enviar registros ao log de eventos de aplicativos do Windows e ao console.
 auto_updater
google-compute-engine-diagnostics Contém um binário que coleta informações de diagnóstico da instância e salva as informações em um bucket do Cloud Storage. O agente convidado do Windows executa o binário. Salva dados em um bucket do Cloud Storage diagnostics
certgen Contém um binário que cria um certificado na instância. certgen
GooGet Contém um binário que instala e mantém o ambiente convidado para instâncias do Windows. Lê dados dos repositórios Google Cloud localizados em packages.cloud.google.com GooGet
google-compute-engine-vss Instala o agente e o provedor do VSS do Compute Engine, que faz snapshots de disco permanente usando o Serviço de cópias de sombra de volume (VSS) da Microsoft. Se comunica com o serviço de Google Cloud instantâneo. vss
google-osconfig-agent Contém o agente de configuração do SO, que o VM Manager usa para gerenciar inventário, patches e políticas do SO. Para mais informações sobre o agente de configuração do SO, consulte VM Manager.

Lê e grava dados nos metadados da VM

Por padrão, o agente de configuração do SO não coleta nem envia informações até que você ative o agente de configuração do SO. Depois de ativar o agente, ele se comunica com o serviço da API OS Config. Para analisar as operações concluídas pelo agente, consulte Geração de registros de auditoria do VM Manager.

 guest-osconfig
Drivers do Windows do Compute Engine

Contém vários drivers para garantir a funcionalidade e a performance adequadas das instâncias. O gerenciador de pacotes GooGet gerencia esses drivers e os publica em repositórios Google Cloud .

Os seguintes drivers do Compute Engine são mantidos para imagens do SO Windows:

Tipo de driver Nome do pacote do motorista
Adaptador Ethernet google-compute-engine-driver-netkvm
Disco SCSI google-compute-engine-driver-vioscsi
Adaptador de tela google-compute-engine-driver-gga
Gerenciador de falhas google-compute-engine-driver-pvpanic
Driver de balão de memória virtio google-compute-engine-driver-balloon
NIC virtual do Google google-compute-engine-driver-gvnic

Para instalar ou fazer upgrade de um driver específico, execute o seguinte comando: 

        googet install DRIVER_PACKAGE_NAME
compute-windows-drivers

Lançamentos de repositórios de pacotes do ambiente de convidado

A partir de 3 de setembro de 2026, o Compute Engine vai mudar a implantação dos repositórios de pacotes do ambiente para convidado de um lançamento global para um framework de lançamento regional para instâncias de computação Linux e Windows.

Mudanças importantes

  • Estrutura de lançamento regional:as atualizações do canal de repositório estável padrão são disponibilizadas por região, e não globalmente de uma só vez.
  • Janela de entrega por etapas:as atualizações de pacotes podem levar até duas semanas para chegar a todos os locais do mundo.
  • Rastreamento de repositório global:um rastreamento de repositório global dedicado está disponível para cargas de trabalho que exigem consistência de versão em várias regiões. As atualizações de pacotes publicadas no repositório global continuam sendo implantadas simultaneamente em todas as regiões do mundo depois que todos os repositórios regionais são atualizados.

Potencial de impacto

  • Variações de versão:durante as duas semanas de lançamento regional, as implantações de carga de trabalho multirregionais que usam o repositório estável padrão podem ter versões diferentes de pacotes de ambiente convidado em regiões ativas.
  • Ajustes de automação:se você tiver automações, pipelines de CI/CD ou processos de aplicação de patch que precisam de consistência de pacotes multirregional, talvez seja necessário atualizar esses sistemas para usar a faixa do repositório global.

Decidir se você quer usar os lançamentos regionais ou a faixa do repositório global

  • Se suas cargas de trabalho puderem tolerar variações regionais de versão durante as atualizações:nenhuma ação é necessária.
  • Se seus fluxos de trabalho exigirem consistência de pacotes multirregional:atualize a configuração do gerenciador de pacotes (APT, YUM/DNF, Zypper ou GooGet) antes de 3 de setembro de 2026 para apontar para o novo repositório global.

Mudanças na configuração do gerenciador de pacotes

Para mudar o gerenciador de pacotes da faixa regional padrão para a faixa do repositório global, atualize a configuração do repositório do gerenciador de pacotes para apontar para a faixa global (-global).

  • APT (Debian)

    Em /etc/apt/sources.list.d/google-cloud.list, mude o nome do repositório de google-compute-engine-${VERSION_CODENAME}-stable para google-compute-engine-${VERSION_CODENAME}-global:

    deb [signed-by=/etc/apt/keyrings/google-keyring.gpg] http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-global main

  • YUM e DNF (RHEL, CentOS, Rocky Linux)

    No arquivo do repositório (como /etc/yum.repos.d/google-cloud.repo), atualize a entrada para usar o nome da faixa global:

    [google-cloud-compute-global]
name=Google Cloud Compute Engine Global
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-compute-${DISTRO}-${ARCH}-global
enabled=1
gpgcheck=1

  • GooGet (Windows)

    Adicione ou atualize o repositório GooGet para apontar para google-compute-engine-global:

    googet addrepo google-compute-engine-global https://packages.cloud.google.com/yuck/repos/google-compute-engine-global

A seguir