Añadir un disco persistente a tu máquina virtual

En este documento se proporcionan instrucciones para conectar un disco persistente de máquina virtual (VM) a una instancia de Google Distributed Cloud (GDC) aislado.

Conecta discos que no sean de arranque a tu máquina virtual para cumplir los requisitos específicos de tu carga de trabajo. Al desacoplar el almacenamiento de la instancia de VM, tus datos críticos se conservan independientemente del ciclo de vida de la VM, mientras que el rendimiento y la capacidad se escalan automáticamente para adaptarse a las demandas de tu carga de trabajo.

Este documento está dirigido a desarrolladores de grupos de administradores de plataformas u operadores de aplicaciones que añaden y configuran discos de máquinas virtuales en un entorno de Distributed Cloud. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.

Antes de empezar

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 gdcloud o kubectl y requieren un entorno de sistema operativo (SO).

Obtener la ruta del archivo kubeconfig

Para ejecutar comandos en el servidor de la API Management, asegúrate de que tienes los siguientes recursos:

  1. Inicia sesión y genera el archivo kubeconfig para el servidor de la API Management si no tienes uno.

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

Solicitar roles de gestión de identidades y accesos

Ponte en contacto con el administrador de proyectos de gestión de identidades y accesos para solicitar los siguientes roles en tu proyecto:

  • Administrador de proyectos de máquinas virtuales (project-vm-admin): crea, modifica, muestra y elimina máquinas virtuales en el espacio de nombres del proyecto.

  • Lector de proyectos (project-viewer): permite ver todos los recursos 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.

Adjuntar un disco a una VM

Crea y adjunta discos que no sean de arranque a tu VM. Cada disco adicional puede especificar una imagen personalizada o un disco en blanco. Puedes añadir varios discos a la vez a una VM.

Consola

  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 detalles.

  3. Haz clic en Añadir nuevo disco.

  4. En el cuadro de diálogo de confirmación, haz clic en Detener para detener la VM.

  5. Espera unos minutos a que se detenga la VM.

  6. Haz clic en Renovar.

  7. Cuando la VM esté detenida, vuelve a hacer clic en Añadir nuevo disco.

  8. En el cuadro de diálogo Añadir disco, elige un disco nuevo o uno que ya tengas.

    • Para aprovisionar un disco nuevo, haz clic en la pestaña Nuevo disco.

      1. En el campo Nombre del disco, introduce un nombre de disco nuevo que sea único en el proyecto.
      2. En el campo Tamaño, introduce un tamaño de disco de entre 10 y 65.536 GiB. Por ejemplo, 10 GiB.
      3. En la sección Regla de eliminación, haz clic en Conservar disco o en Eliminar disco.
    • Para elegir un disco disponible, haz clic en la pestaña Disco disponible.

      1. En la lista Disco, selecciona un disco.
      2. En la sección Regla de eliminación, haz clic en Conservar disco o en Eliminar disco.
  9. Haz clic en Guardar. El disco aparecerá en la lista de discos de la VM.

  10. Reinicia la máquina virtual.

API

  1. Crear un objeto VirtualMachineDisk:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      apply -f - <<EOF
    apiVersion: virtualmachine.gdc.goog/v1
    kind: VirtualMachineDisk
    metadata:
      name: NON_BOOT_BLANK_DISK
    spec:
      size: NON_BOOT_BLANK_DISK_SIZE
    EOF
    
  2. Detén la VM.

  3. Añade el VirtualMachineDisk al VirtualMachine spec.disks:

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

    Edita lo siguiente en tu editor de texto:

    # …
    disks:
    - virtualMachineDiskRef:
        name: VM_BOOT_DISK_NAME
      boot: true
    - virtualMachineDiskRef:
        name: NON_BOOT_BLANK_DISK
      autoDelete: false
    # …
    

    Sustituye las variables usando las siguientes definiciones.

    VariableDefinición
    MANAGEMENT_API_SERVER El archivo kubeconfig del servidor de la API Management.
    PROJECT El proyecto de Google Distributed Cloud air-gapped (GDC) en el que se creará la VM.
    VM_NAMEEl nombre de la nueva VM.
    VM_BOOT_DISK_NAMEEl nombre del disco de arranque de la nueva VM.
    NON_BOOT_BLANK_DISKEl nombre de tu disco adicional.
    NON_BOOT_BLANK_DISK_SIZEEl tamaño de tus discos adicionales, como 20G.
  4. Inicia la VM.

Formatear y montar un disco que no sea de arranque

Después de conectar un disco a la VM, sigue los pasos que se indican a continuación para que se pueda acceder a él desde la VM.

Conectar con la VM

Accede a la VM mediante SSH.

Formatear el disco

  1. Enumera los discos conectados a tu instancia por número de serie y localiza el disco que quieras formatear y montar.

    ls -l /dev/disk/by-id/
    

    En este ejemplo de salida, los nombres de los discos se muestran como números de serie:

       total 0
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 ata-QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda
       lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-0QEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-1ATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SATA_QEMU_HARDDISK_agentSADisk -> ../../sdc
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot -> ../../sda
       lrwxrwxrwx 1 root root 10 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part1 -> ../../sda1
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part14 -> ../../sda14
       lrwxrwxrwx 1 root root 11 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-boot-part15 -> ../../sda15
       lrwxrwxrwx 1 root root  9 Sep 13 23:51 scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb
    

    La información que aparece después de la flecha, ->, en cada línea indica el nombre del dispositivo de disco. Por ejemplo, en scsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb, el número de serie es scsi-SQEMU_QEMU_HARDDISK_vm-disk-data y el nombre del dispositivo es sdb.

  2. Identifica el número de serie de tu disco en esta lista.

    Comportamiento importante de las funciones de situación que puede afectar a la lista de números de serie:

    • Si el valor de virtualMachineDiskRef.name tiene más de 20 caracteres, solo se usarán los 20 primeros como número de serie.
    • Si hay dos discos con los mismos 20 primeros caracteres, solo el primer disco tendrá un número de serie.
  3. Formatea el disco:

   sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/disk/by-id/DISK_ID
  • Sustituye DISK_ID por el número de serie del disco que vas a formatear.
  • En este ejemplo, especifica scsi-SQEMU_QEMU_HARDDISK_vm-disk-data para formatear todo el disco sin una tabla de particiones.

Para maximizar el rendimiento del disco, usa las opciones de formato recomendadas en la marca -E. Como no necesitas reservar espacio para el volumen raíz en el disco secundario, especifica -m 0 para usar todo el espacio en disco disponible.

Montar el disco

  1. Crea un directorio que sirva como punto de montaje para el nuevo disco. Puedes usar cualquier directorio. En el siguiente ejemplo se crea un directorio en /mnt/disks/:

    sudo mkdir -p /mnt/disks/MOUNT_DIR
    

    Sustituye MOUNT_DIR por el directorio donde quieras montar el disco.

  2. Monta el disco en la instancia y habilita la opción de descarte:

    sudo mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR
    

    Haz los cambios siguientes:

    • DISK_ID con el número de serie del disco que se va a montar.
    • MOUNT_DIR con el directorio en el que quieras montar el disco.
  3. Opcional: Configura los permisos de lectura y escritura en el disco. El siguiente comando concede acceso de escritura, a+w, al disco para todos los usuarios.

    sudo chmod a+w /mnt/disks/MOUNT_DIR
    
  4. Opcional: Configura el montaje automático al reiniciar la VM mediante el identificador único universal (UUID) o la secuencia de comandos de inicio.

Configurar el montaje automático al reiniciar la VM: UUID del disco

Añade el disco al archivo /etc/fstab para que se vuelva a montar automáticamente cuando se reinicie la máquina virtual. En un sistema operativo, el nombre del dispositivo cambia con cada reinicio, pero el UUID del dispositivo siempre apunta al mismo volumen, incluso cuando mueves discos entre sistemas. Por lo tanto, usa siempre el UUID del dispositivo para configurar el montaje automático al reiniciar la VM.

  1. Crea una copia de seguridad de tu archivo /etc/fstab actual:

      sudo cp /etc/fstab /etc/fstab.backup
    
  2. Enumera el UUID del disco:

      sudo blkid /dev/DEVICE_NAME
    

    En el resultado de ejemplo se muestra el UUID de accc19c5-d0d6-4157-9672-37d4e1d48eb5 del disco.

      /dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"
    

    DEVICE_NAME es el nombre de dispositivo del disco que quieres montar automáticamente. Si has creado una tabla de particiones en el disco, especifica la partición que quieres montar como sufijo del nombre del dispositivo. Por ejemplo, si sdb es el nombre del dispositivo de disco y quieres montar la partición 1, DEVICE_NAME se convierte en sdb1.

  3. Abre el archivo /etc/fstab en un editor de texto y crea una entrada que incluya el UUID:

      UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2
    

    Haz los cambios siguientes:

    • UUID_VALUE con el disco UUID, que aparece como resultado del comando Mostrar el UUID.
    • MOUNT_DIR por el directorio en el que has montado el disco.
    • MOUNT_OPTION con el valor MOUNT_OPTION para tu SO, que especifica lo que hace el SO si no puede montar el disco en el momento del arranque.
  4. Comprueba que tus entradas de /etc/fstab sean correctas:

    El siguiente comando verifica las entradas de /etc/fstab con los discos y las particiones que ya están conectados a la VM:

      findmnt --verify
    

    En el siguiente ejemplo se muestra una verificación correcta. Puedes ignorar la advertencia esperada:

      [W] your fstab has been modified, but systemd still uses the old version;
      use 'systemctl daemon-reload' to reload
    
      0 parse errors, 0 errors, 1 warning
    

    Si hay errores, comprueba si las entradas de fstab son válidas. Un problema habitual es que se añadan caracteres no imprimibles no válidos a la entrada. Puedes ejecutar el siguiente comando para mostrar todos los caracteres especiales del archivo /etc/fstab:

      cat --show-nonprinting /etc/fstab
    

    A continuación se muestra un ejemplo de salida válida:

      LABEL=cloudimg-rootfs /    ext4   defaults    0 1
      LABEL=UEFI    /boot/efi   vfat    umask=0077  0 1
      UUID=UUID_VALUE /mnt/disks/MOUNT_DIR ext4 discard,defaults,MOUNT_OPTION 0 2
    

    Asegúrate de que no haya caracteres inesperados, como caracteres que no se pueden imprimir que empiecen por M- o ^.

Si desvinculas este disco o creas una instantánea del disco de arranque de esta VM, edita el archivo /etc/fstab y elimina la entrada de este disco. Aunque hayas definido MOUNT_OPTION como nofail o nobootwait, mantén el archivo /etc/fstab sincronizado con los dispositivos que se conectan a tu VM. Quita estas entradas antes de crear la captura del disco de arranque o de desmontar el disco.

Configurar el montaje automático al reiniciar la VM: secuencia de comandos de inicio de la VM

También puedes usar una secuencia de comandos de inicio para montar el disco cada vez que se reinicie el sistema. Para ello, añade los comandos de Montar el disco a una secuencia de comandos de inicio. Antes de añadir la secuencia de comandos para montar el disco, formatéalo con los comandos de Formatear el disco.

  1. Crea el secreto de la secuencia de comandos de inicio.

    cat <<EOF >>mount-disk-script
    #!/bin/bash
    mkdir -p /mnt/disks/MOUNT_DIR
    mount -o discard,defaults /dev/disk/by-id/DISK_ID /mnt/disks/MOUNT_DIR
    EOF
    
    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      create secret generic VM_NAME-mount-script \
      --from-file=script=mount-disk-script
    
    rm mount-disk-script
    
  2. Añade la secuencia de comandos de inicio a la VM.

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

    Edita el spec.startupScripts para incluir el nombre del secreto.

    apiVersion: virtualmachine.gdc.goog/v1
    kind: VirtualMachine
    metadata:
     name: VM_NAME
     namespace: PROJECT
    spec:
    # …
    startupScripts:
    - name: mount-script
      scriptSecretRef:
        name: VM_NAME-mount-script
    

Para obtener más información sobre cómo configurar secuencias de comandos de inicio, consulta este artículo.