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:
Inicia sesión y genera el archivo kubeconfig para el servidor de la API Management si no tienes uno.
Usa la ruta al archivo kubeconfig del servidor de la API Management para sustituir
MANAGEMENT_API_SERVERen 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
En el menú de navegación, haz clic en Máquinas virtuales > Instancias.
En la lista de VMs, haz clic en el nombre de una VM para ver sus detalles.
Haz clic en Añadir nuevo disco.
En el cuadro de diálogo de confirmación, haz clic en Detener para detener la VM.
Espera unos minutos a que se detenga la VM.
Haz clic en Renovar.
Cuando la VM esté detenida, vuelve a hacer clic en Añadir nuevo disco.
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.
- En el campo Nombre del disco, introduce un nombre de disco nuevo que sea único en el proyecto.
- En el campo Tamaño, introduce un tamaño de disco de entre 10 y 65.536 GiB. Por ejemplo, 10 GiB.
- 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.
- En la lista Disco, selecciona un disco.
- En la sección Regla de eliminación, haz clic en Conservar disco o en Eliminar disco.
Haz clic en Guardar. El disco aparecerá en la lista de discos de la VM.
API
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 EOFAñade el
VirtualMachineDiskalVirtualMachinespec.disks:kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdita 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.
Variable Definición MANAGEMENT_API_SERVEREl archivo kubeconfig del servidor de la API Management. PROJECTEl 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.
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
Formatear el disco
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 -> ../../sdbLa información que aparece después de la flecha,
->, en cada línea indica el nombre del dispositivo de disco. Por ejemplo, enscsi-SQEMU_QEMU_HARDDISK_vm-disk-data -> ../../sdb, el número de serie esscsi-SQEMU_QEMU_HARDDISK_vm-disk-datay el nombre del dispositivo essdb.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.nametiene 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.
- Si el valor de
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_IDpor el número de serie del disco que vas a formatear. - En este ejemplo, especifica
scsi-SQEMU_QEMU_HARDDISK_vm-disk-datapara 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
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_DIRSustituye
MOUNT_DIRpor el directorio donde quieras montar el disco.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_DIRHaz los cambios siguientes:
DISK_IDcon el número de serie del disco que se va a montar.MOUNT_DIRcon el directorio en el que quieras montar el disco.
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_DIROpcional: 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.
Crea una copia de seguridad de tu archivo
/etc/fstabactual:sudo cp /etc/fstab /etc/fstab.backupEnumera el UUID del disco:
sudo blkid /dev/DEVICE_NAMEEn el resultado de ejemplo se muestra el UUID de
accc19c5-d0d6-4157-9672-37d4e1d48eb5del disco./dev/sdb: UUID="accc19c5-d0d6-4157-9672-37d4e1d48eb5" TYPE="ext4"DEVICE_NAMEes 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, sisdbes el nombre del dispositivo de disco y quieres montar la partición 1,DEVICE_NAMEse convierte ensdb1.Abre el archivo
/etc/fstaben 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 2Haz los cambios siguientes:
UUID_VALUEcon el discoUUID, que aparece como resultado del comando Mostrar el UUID.MOUNT_DIRpor el directorio en el que has montado el disco.MOUNT_OPTIONcon el valorMOUNT_OPTIONpara tu SO, que especifica lo que hace el SO si no puede montar el disco en el momento del arranque.
Comprueba que tus entradas de
/etc/fstabsean correctas:El siguiente comando verifica las entradas de
/etc/fstabcon los discos y las particiones que ya están conectados a la VM:findmnt --verifyEn 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 warningSi hay errores, comprueba si las entradas de
fstabson 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/fstabA 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 2Asegú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.
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 EOFkubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ create secret generic VM_NAME-mount-script \ --from-file=script=mount-disk-scriptrm mount-disk-scriptAñade la secuencia de comandos de inicio a la VM.
kubectl --kubeconfig MANAGEMENT_API_SERVER \ -n PROJECT \ edit virtualmachines.virtualmachine.gdc.goog VM_NAMEEdita el
spec.startupScriptspara 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.