Actualizar las propiedades de la VM

En este documento, se explica cómo actualizar las propiedades de las instancias de máquina virtual (VM) en Google Distributed Cloud (GDC) aislado.

Puedes actualizar las propiedades de la VM para alinear la infraestructura virtual con las demandas cambiantes de las cargas de trabajo que se ejecutan en una instancia. Puedes aumentar o disminuir las CPU virtuales o la memoria física (RAM) para redistribuir los recursos en otro lugar del proyecto.

En lugar de destruir una VM, volver a compilarla y migrar tus datos, puedes optar por actualizar sus propiedades. Si bien la actualización de las propiedades suele requerir un reinicio rápido, este enfoque puede ahorrarte horas de tiempo de configuración.

Este documento está dirigido a los desarrolladores de grupos de administradores de plataformas o operadores de aplicaciones que ven y actualizan las propiedades de VM en un entorno de Distributed Cloud. Para obtener más información, consulta Públicos de la documentación de Google Distributed Cloud aislado.

Antes de comenzar

Para usar los comandos de la interfaz de línea de comandos (CLI) de gdcloud, asegúrate de haber descargado, instalado, y configurado la CLI de gdcloud. Todos los comandos de Distributed Cloud usan la CLI de gdcloud o kubectl y requieren un entorno de sistema operativo (SO).

Obtén la ruta de acceso del archivo kubeconfig

Para ejecutar comandos en el servidor de la API de administración, asegúrate de tener los siguientes recursos:

  1. Accede y genera el archivo kubeconfig para el servidor de la API de administración si no tienes uno.

  2. Usa la ruta de acceso al archivo kubeconfig del servidor de la API de Management para reemplazar MANAGEMENT_API_SERVER en estas instrucciones.

Solicita roles de IAM

Comunícate con tu administrador de IAM del proyecto para solicitar los siguientes roles en tu proyecto:

  • Administrador del proyecto de máquinas virtuales (project-vm-admin): Crea, modifica, enumera y borra VMs en el espacio de nombres del proyecto.

  • Visualizador del proyecto(project-viewer): Visualiza todos los recursos dentro de los espacios de nombres del proyecto.

Todos los roles de VM deben vincularse al espacio de nombres del proyecto en el que reside la VM. Sigue los pasos para verificar tu acceso.

Propiedades actualizables

Solo puedes cambiar las propiedades que están en la spec de la VM.

Visualiza las propiedades actualizables

Busca las propiedades que deseas cambiar con la consola de GDC o kubectl.

Console

  1. En el menú de navegación, haz clic en Máquinas virtuales > Instancias.

  2. En la lista de VMs, haz clic en el nombre de una VM para ver sus propiedades.

  3. Las propiedades editables tienen un Editar ícono.

kubectl

  1. Visualiza la lista de propiedades de la spec de la VM y los valores válidos correspondientes a cada propiedad:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  explain virtualmachines.virtualmachine.gdc.goog.spec

    El resultado es similar a este:

    KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

RESOURCE: spec <Object>

DESCRIPTION:
     Defines the specification of the Virtual Machine.

FIELDS:
   compute      <Object>
     Specifies the CPU and Memory of the VM. CPU and Memory can be defined
     directly or through the VirtualMachineType. Changes to Compute require a
     reboot to take effect. Compute is immutable when the VM is in `Unknown`
     state.

   disks        <[]Object> -required-
     Specifies the list of disks attached to this vm. There must be exactly one
     boot disk. Changes to disk attachments require a reboot to take effect.

   ...

  2. Visualiza de forma recursiva las subpropiedades de cada propiedad. En estos ejemplos, se muestra el valor de retorno de las subpropiedades compute y vcpus:

    • Este comando de ejemplo muestra los campos de la subpropiedad compute:

      kubectl --kubeconfig MANAGEMENT_API_SERVER \
  explain virtualmachines.virtualmachine.gdc.goog.spec.compute

      El resultado es similar a este:

      KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

RESOURCE: compute <Object>

DESCRIPTION:
     Specifies the CPU and Memory of the VM. CPU and Memory can be defined
     directly or through the VirtualMachineType. Changes to Compute require a
     reboot to take effect. Compute is immutable when the VM is in `Unknown`
     state.

FIELDS:
   memory       <>
     Specifies the amount of physical memory available to the instance. memory
     must have a minimum value of `1G`, and can be up to (including) `400G`.

   vcpus        <integer>
     Specifies the number of VCPUs that are available to the instance. Specify
     `vcpus` as an integer. This value must be a multiple of 2, with 2 as the
     minimum and 128 as the maximum allowed.

   ...

    • Este comando de ejemplo muestra los campos de la subpropiedad vcpus:

      kubectl --kubeconfig MANAGEMENT_API_SERVER \
  explain virtualmachines.virtualmachine.gdc.goog.spec.compute.vcpus

      El resultado es similar a este:

      KIND:     VirtualMachine
VERSION:  virtualmachine.gdc.goog/v1

FIELD:    vcpus <integer>

DESCRIPTION:
     Specifies the number of VCPUs that are available to the instance. Specify
     `vcpus` as an integer. This value must be a multiple of 2, with 2 as the
     minimum and 128 as the maximum allowed.

Todas las propiedades se pueden actualizar en una VM en ejecución, pero, a menudo, requieren que se reinicie la VM para que entren en vigencia.

Estas actualizaciones de propiedades requieren que se reinicie la VM para que los cambios entren en vigencia:

Estas actualizaciones de propiedades entran en vigencia de inmediato:

  • guestEnvironment
  • runningState

Actualizar las propiedades de la VM

Actualiza las propiedades de la VM con la consola de GDC o kubectl.

Console

  1. En el menú de navegación, haz clic en Máquinas virtuales > Instancias.

  2. En la lista de VMs, haz clic en el nombre de una VM para ver sus propiedades.

  3. Haz clic en Editar junto a la propiedad que deseas editar y realiza los cambios.

  4. Si quieres reemplazar el disco de arranque o agregar un disco nuevo, consulta Reemplaza un disco de arranque o Agrega un disco a una VM.

  5. Haz clic en Guardar.

kubectl

  1. Ejecuta el siguiente comando:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
   -n PROJECT \
   edit virtualmachines.virtualmachine.gdc.goog VM_NAME

    Reemplaza las variables como se define en la siguiente tabla.

    VariableDefinición
    MANAGEMENT_API_SERVEREl archivo kubeconfig del servidor de la API de administración.
    VM_NAMEEl nombre de la VM.
    PROJECTEs el nombre del proyecto.

  2. Edita la spec para actualizar los campos y valores obligatorios de las propiedades actualizables.

  3. Guarda el archivo.

  4. Si la actualización de la propiedad requiere que se reinicie la VM, usa las instrucciones para reiniciar una VM para reiniciar la VM.