Configurar el administrador de VM

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

En Compute Engine puedes administrar los sistemas operativos que se ejecutan en tus máquinas virtuales (VM) mediante VM Manager .

Puede habilitar VM Manager para VM individuales, para un proyecto o para todos los proyectos en una carpeta u organización. Para revisar los pasos necesarios para configurar sus máquinas virtuales para usar VM Manager, consulte Descripción general de la configuración .

Después de configurar VM Manager, puede ver los registros de auditoría de las operaciones de API realizadas con la API de configuración del sistema operativo; consulte Visualización de registros de auditoría de VM Manager .

Antes de comenzar

• Revise las cuotas de configuración del sistema operativo para su proyecto.
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Sistemas operativos compatibles

Para obtener la lista completa de versiones de sistemas operativos compatibles con VM Manager, consulte Detalles del sistema operativo . Si el agente de configuración del sistema operativo no está disponible para un sistema operativo en particular, no puede habilitar VM Manager para una VM que ejecute este sistema operativo.

Habilite VM Manager usando una política de organización

Puede habilitar automáticamente VM Manager para todas las máquinas virtuales nuevas en su organización, carpeta o proyecto mediante la política de organización Requerir configuración del sistema operativo.

Cuando se configura la restricción booleana Requerir configuración del sistema operativo, se aplican las siguientes condiciones:

• enable-osconfig=TRUE se incluye en los metadatos del proyecto para todos los proyectos nuevos.
• Las solicitudes que configuran enable-osconfig en FALSE en metadatos de instancia o proyecto se rechazan para máquinas virtuales y proyectos nuevos y existentes.
• Esta política de organización no cambia el valor de metadatos enable-osconfig a TRUE para las máquinas virtuales o los proyectos que se crearon antes de habilitar la política. Si desea habilitar VM Manager en esas máquinas virtuales o proyectos, le recomendamos que actualice los metadatos. Para obtener más información, consulte Establecer los valores de metadatos .

Cuando la política de organización de OS Config está habilitada, aún puede usar los metadatos osconfig-disabled-features para deshabilitar una o más funciones de VM Manager.

Habilitar la política de organización de configuración del sistema operativo

Para habilitar la política de configuración del sistema operativo, puede establecer la restricción Requerir configuración del sistema operativo en toda la organización, carpetas o proyectos específicos mediante la consola de Google Cloud o la CLI de Google Cloud.

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --folder=folder-id

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --project=project-id

Habilitar VM Manager en un proyecto

Para habilitar VM Manager en su proyecto, tiene dos opciones:

• Habilitación automática: se aplica a todo su proyecto de Google Cloud. Completa la habilitación automática desde la consola de Google Cloud. Es posible que aún tengas que completar algunos pasos manualmente.

• Habilitación manual: se puede realizar por VM o para todo el proyecto de Google Cloud.

Habilite la API del servicio de configuración del sistema operativo

En su proyecto de Google Cloud, habilite la API de configuración del sistema operativo.

gcloud services enable osconfig.googleapis.com

Compruebe si el agente de configuración del sistema operativo está instalado

El agente de configuración del sistema operativo se instala de forma predeterminada en imágenes de CentOS, Container-Optimized OS (COS), Debian, Red Hat Enterprise Linux (RHEL), Rocky Linux, SLES, Ubuntu y Windows Server que tienen una fecha de compilación v20200114 o posterior. Para obtener información sobre las versiones de los sistemas operativos con el agente OS Config instalado, consulte Detalles del sistema operativo . Estos agentes se ejecutan inactivos hasta que habilita los metadatos del agente y habilita la API del servicio .

sudo systemctl status google-osconfig-agent

google-osconfig-agent.service - Google OSConfig Agent
Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset:
Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago
Main PID: 369 (google_osconfig)
 Tasks: 8 (limit: 4374)
Memory: 102.7M
CGroup: /system.slice/google-osconfig-agent.service
        └─369 /usr/bin/google_osconfig_agent

PowerShell Get-Service google_osconfig_agent

Status   Name               DisplayName
------   ----               -----------
Running  google_osconfig... Google OSConfig Agent

Instalar el agente de configuración del sistema operativo

Antes de seguir estos pasos para instalar el agente, verifique si el agente ya se está ejecutando en su VM .

En cada VM, instale el agente de configuración del sistema operativo. Puede instalar el agente de configuración del sistema operativo utilizando una de las siguientes opciones:

• Instale el agente manualmente usando la terminal.
• Utilice un script de inicio en sus máquinas virtuales.
• Automatice la instalación de OS Config en varias máquinas virtuales mediante una política de agente de Google Cloud Observability .

Instalar el agente manualmente

Utilice esta opción para instalar el agente de configuración del sistema operativo en una máquina virtual existente.

Para instalar el agente, complete los siguientes pasos:

1. Conéctese a la máquina virtual en la que desea instalar el agente de configuración del sistema operativo.

2. Instale el agente de configuración del sistema operativo.

   Servidor Windows

   Para instalar el agente de configuración del sistema operativo en un servidor Windows, ejecute el siguiente comando:

   googet -noconfirm install google-osconfig-agent
   

   ubuntu

   Para instalar el agente de configuración del sistema operativo en una máquina virtual Ubuntu, ejecute los siguientes comandos:

   1. Configure el repositorio de Ubuntu.

      • Para Ubuntu 20.04 y versiones posteriores, ejecute los siguientes comandos:

        1. Agrega el repositorio de Ubuntu.

           sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-focal-stable main' > \
           /etc/apt/sources.list.d/google-compute-engine.list"
           

        2. Importar el Google Cloud clave pública.

           curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
           sudo apt-key add -
           

      • Para Ubuntu 18.04 y versiones posteriores, ejecute los siguientes comandos:

        1. Agrega el repositorio de Ubuntu.

           sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-bionic-stable main' > \
           /etc/apt/sources.list.d/google-compute-engine.list"
           

        2. Importar el Google Cloud clave pública.

           curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
           sudo apt-key add -
           

      • Para Ubuntu 16.04, ejecute los siguientes comandos:

        1. Agrega el repositorio de Ubuntu.

           sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-xenial-stable main'> \
           /etc/apt/sources.list.d/google-compute-engine.list"
           

        2. Importar el Google Cloud clave pública.

           curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
           sudo apt-key add -
           

   2. Instale el agente de configuración del sistema operativo.

      sudo apt update
      sudo apt -y install google-osconfig-agent
      

   Debian

   Para instalar el agente de configuración del sistema operativo en una máquina virtual Debian, ejecute los siguientes comandos:

   sudo apt update
   sudo apt -y install google-osconfig-agent
   

   Añadiendo el Google Cloud repositorio y clave pública

   Si está utilizando una instancia de VM que no se creó a partir de una imagen proporcionada por Google o recibió un mensaje de error "no se puede localizar el paquete", complete los siguientes pasos para agregar el Google Cloudrepositorio e importe la clave pública.

   Después de agregar el repositorio e importar la clave, puede ejecutar los comandos para instalar el agente de configuración del sistema operativo.

   • Para Debian 9 (Stretch), ejecute los siguientes comandos:

     1. Agregue el repositorio de Debian.

        sudo su -c "echo 'deb http://packages.cloud.google.com/apt \
        google-compute-engine-stretch-stable main'> /etc/apt/sources.list.d/google-compute-engine.list"
        

     2. Importar el Google Cloud clave pública.

        curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
        sudo apt-key add -
        

   • Para Debian 10 (Buster), ejecute los siguientes comandos:

     1. Agregue el repositorio de Debian.

        sudo su -c "echo 'deb http://packages.cloud.google.com/apt \
        google-compute-engine-buster-stable main'> /etc/apt/sources.list.d/google-compute-engine.list"
        

     2. Importar el Google Cloud clave pública.

        curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
        sudo apt-key add -
        

   RHEL/CentOS/Rocky

   Para instalar el agente de configuración del sistema operativo en una máquina virtual RHEL 7/8, CentOS 7/8 o Rocky Linux 8/9, ejecute el siguiente comando:

   sudo yum -y install google-osconfig-agent
   

   SLES/openSUSE

   Para instalar el agente de configuración del sistema operativo en una máquina virtual SLES o openSUSE, ejecute los siguientes comandos:

   1. Configure el repositorio SLES.

      • Para SLES 12, ejecute el siguiente comando:

        sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM
        [google-compute-engine]
        name=Google Compute Engine
        baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles12-stable
        enabled=1
        gpgcheck=1
        repo_gpgcheck=0
        gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
          https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
        EOM"
        

      • Para SLES 15 y OpenSUSE 15, ejecute el siguiente comando:

        sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM
        [google-compute-engine]
        name=Google Compute Engine
        baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles15-stable
        enabled=1
        gpgcheck=1
        repo_gpgcheck=0
        gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
          https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
        EOM"
        
        

   2. Importe las claves GPG para Google Cloud.

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

   3. Instale el agente de configuración del sistema operativo.

      sudo zypper -n --gpg-auto-import-keys install --from google-compute-engine google-osconfig-agent
      

Instale el agente usando un script de inicio

También puede utilizar los comandos de instalación manual para crear un script de inicio que instale el agente de configuración del sistema operativo durante la creación de la VM.

1. Copie los comandos manuales para su sistema operativo.

2. Proporcione el script de inicio a su método de creación de VM.

   Por ejemplo, si usas el comando gcloud compute instances create para crear una máquina virtual Debian 10, tu comando se parecerá al siguiente:

   gcloud compute instances create VM_NAME \
      --image-family=debian-10 --image-project=debian-cloud \
      --metadata startup-script='#! /bin/bash
      apt update
      apt -y install google-osconfig-agent'

   Reemplace VM_NAME con el nombre de su VM.

3. Verifique que se complete el script de inicio. Para verificar si se completa el script de inicio, revise los registros o consulte la consola serie .

Establecer los valores de metadatos

Puede configurar metadatos de instancia en cada VM o metadatos de proyecto que se apliquen a todas las VM de su proyecto.

En su proyecto de Google Cloud o VM, establezca el valor de metadatos enable-osconfig en TRUE . Establecer el valor de metadatos enable-osconfig en TRUE permite lo siguiente:

• Parche
• Políticas del sistema operativo
• Gestión de inventario de SO
  • Para la versión anterior de la gestión de inventario del sistema operativo, también debe establecer el valor de metadatos enable-guest-attributes en TRUE . Si no se establecen ambos valores de metadatos, el panel no data para la VM. Esto no es necesario para la versión posterior. Para obtener información sobre las dos versiones de administración de inventario del sistema operativo, consulte Versiones de administración de inventario del sistema operativo .

Configurar un proxy HTTP

Si utiliza un proxy HTTP para sus máquinas virtuales, ejecute los siguientes comandos para configurar las variables de entorno http_proxy y https_proxy . También debe excluir el servidor de metadatos ( 169.254.169.254 ) configurando la variable de entorno no_proxy para que el agente de configuración del sistema operativo pueda acceder al servidor de metadatos local.

mkdir -p /etc/systemd/system/google-osconfig-agent.service.d
cat >/etc/systemd/system/google-osconfig-agent.service.d/override.conf <<EOF
[Service]
Environment="http_proxy=http://PROXY_IP:PROXY_PORT" \
  "https_proxy=http://PROXY_IP:PROXY_PORT" \
  "no_proxy=169.254.169.254,metadata,metadata.google.internal"
EOF

systemctl daemon-reload
systemctl restart google-osconfig-agent

tr '\0' '\n' < /proc/$(systemctl show -p MainPID --value google-osconfig-agent)/environ

  setx http_proxy http://PROXY_IP:PROXY_PORT /m
  setx https_proxy http://PROXY_IP:PROXY_PORT /m
  setx no_proxy 169.254.169.254,metadata,metadata.google.internal /m

Google recomienda excluir *.googleapis.com agregando la variable de entorno no_proxy para evitar problemas de conexión del agente de configuración del sistema operativo. Si desea conectar solo máquinas virtuales específicas al agente de configuración del sistema operativo, prefije la zona en la que se encuentran las máquinas virtuales y use el formato [zone-name]-osconfig.googleapis.com . Por ejemplo, us-central1-f-osconfig.googleapis.com .

Desactiva las funciones que no necesitas

Para las funciones que quizás no necesite, puede desactivarlas configurando los siguientes valores de metadatos: osconfig-disabled-features= FEATURE1 , FEATURE2 .

Reemplace FEATURE1 , FEATURE2 con cualquiera de los siguientes valores:

• Gestión de inventario de SO: osinventory
• Políticas de parches y SO: tasks
• Políticas de invitados del sistema operativo (beta): guestpolicies

Utilice uno de los siguientes métodos para desactivar los valores de metadatos.

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=tasks

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=osinventory,guestpolicies

Requisitos para un agente de configuración del sistema operativo activo

Para que el agente de OS Config se considere activo y facturable, debe cumplir todos los requisitos siguientes:

• Se debe configurar VM Manager.

• La máquina virtual debe estar en estado RUNNING y el agente de OS Config debe comunicarse con el servicio OS Config.

  Si una máquina virtual se detiene, suspende o desconecta de la red, el agente de esa máquina virtual no se cuenta como agente activo.

Verificar la configuración

Después de completar el procedimiento de configuración, puede verificar la configuración .

Ver la configuración de funciones de VM Manager para su proyecto

Para verificar si todas las funciones de VM Manager están habilitadas en su proyecto, haga lo siguiente:

gcloud compute os-config project-feature-settings describe \
    --project PROJECT_ID

name: projects/my-project/locations/global/projectFeatureSettings
patchAndConfigFeatureSet: OSCONFIG_C

   GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings
   

{
 "name": "projects/my-project/locations/global/projectFeatureSettings",
 "patchAndConfigFeatureSet": "OSCONFIG_C"
}

Habilite la funcionalidad completa de VM Manager

Si VM Manager no está habilitado en su proyecto e instala Ops Agent durante la creación de VM , VM Manager está habilitado en el modo limitado. En este modo, VM Manager ofrece un subconjunto de funciones para una cantidad ilimitada de VM sin costo alguno. Por ejemplo, puede ver las asignaciones de políticas del sistema operativo para sus máquinas virtuales en la página de políticas del sistema operativo, pero no puede crear ni editar asignaciones de políticas del sistema operativo.

Para habilitar todas las funciones de VM Manager para estas máquinas virtuales con Ops Agent instalado, haga lo siguiente:

gcloud compute os-config project-feature-settings update \
    --project PROJECT_ID \
    --patch-and-config-feature-set=full

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings
   {
     "name": "projects/PROJECT_ID/locations/global/projectFeatureSettings",
     "patchAndConfigFeatureSet": "OSCONFIG_C"
   }
   

Deshabilite el agente de configuración del sistema operativo

Deshabilitar el agente de configuración del sistema operativo no afecta el comportamiento de su VM. Puede desactivar el agente de la misma manera que detiene otros servicios del sistema operativo.

sudo systemctl stop google-osconfig-agent
sudo systemctl disable google-osconfig-agent

PowerShell Stop-Service google_osconfig_agent [-StartupType disabled]

¿Qué sigue?

• Cree una asignación de política de sistema operativo .
• Ver detalles del sistema operativo .
• Crear trabajos de parche .
• Obtenga más información sobre VM Manager .