Importar discos virtuales

En este documento, se describen los pasos para importar imágenes de disco de máquinas virtuales (VM) a Google Distributed Cloud (GDC) con aislamiento de aire.

Importa tus discos virtuales existentes, a menudo denominados discos dorados o imágenes doradas, a Distributed Cloud para ahorrar tiempo y usar la imagen resultante para crear máquinas virtuales. La herramienta de importación admite los formatos de imagen RAW y QCOW.

Este documento está dirigido a los desarrolladores de grupos de administradores de plataformas o de operadores de aplicaciones que crean imágenes de VM. Para obtener más información, consulta Públicos de la documentación de Google Distributed Cloud aislado.

Antes de comenzar

Antes de continuar, asegúrate de tener lo siguiente:

  • La CLI de gcloud descargada, instalada y configurada. Todos los comandos de la CLI de GDC usan la CLI de gdcloud o kubectl, y requieren un entorno de sistema operativo (SO).

Solicita permisos y acceso

Para importar imágenes y realizar las operaciones de VM que se indican en esta página, pídele al administrador de IAM del proyecto que te otorgue los siguientes roles de IAM en el espacio de nombres del proyecto en el que reside la VM:

  • Administrador de máquinas virtuales del proyecto (project-vm-admin): Administra las VMs en el espacio de nombres del proyecto.

  • Visualizador del proyecto (project-viewer): Tiene acceso de solo lectura a todos los recursos dentro de un espacio de nombres del proyecto.

Sigue los pasos para verificar tu acceso.

Importar discos virtuales

Puedes importar archivos de discos virtuales directamente desde tu estación de trabajo. La herramienta de importación sube automáticamente el archivo a un bucket de almacenamiento de objetos en tu proyecto.

Para importar tus discos virtuales, usa la CLI de gcloud o la API de Virtual Machine Manager.

gdcloud

El comando import verifica que el disco tenga los paquetes necesarios para configurar las credenciales para conectarse a la instancia con Secure Shell (SSH) y el Protocolo de escritorio remoto (RDP). Esto incluye el entorno invitado.

El comando también instala paquetes para el protocolo de hora de red (NTP) y cloud-init para que la instancia se ejecute correctamente en GDC.

  • Para crear una imagen de arranque, usa el comando gdcloud compute images import:
gdcloud compute images import IMAGE_NAME \
  --source-file=SOURCE_FILE \
  --os=IMAGE_OS \
  --timeout=TIMEOUT

Reemplaza las siguientes variables:

  • IMAGE_NAME: El nombre de la imagen de destino. El nombre no debe tener más de 35 caracteres.
  • SOURCE_FILE: El archivo del disco virtual. Este archivo es un archivo local en tu estación de trabajo. Puedes proporcionar una ruta de acceso absoluta o relativa.
  • IMAGE_OS: Es el SO del disco que se importará.
  • TIMEOUT: Es el tiempo que puede durar una importación antes de que falle con el mensaje "TIMEOUT". Por ejemplo, si especificas 2h, el proceso falla después de 2 horas. El tiempo de espera predeterminado es 1h.

La operación de carga puede tardar un tiempo prolongado según el tamaño del disco virtual y la velocidad de la conexión de red. La importación puede tardar varios minutos en ejecutarse en función del tamaño del disco.

API

Para importar un disco virtual a través de la API, haz lo siguiente:

  1. Crea un objeto VirtualMachineImageImport en el servidor de la API de Management para iniciar el proceso de importación de imágenes:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  apply -f - <<EOF
apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachineImageImport
metadata:
  name: IMAGE_NAME
  namespace: PROJECT_ID
spec:
  source:
    objectStorage:
      bucketRef:
        name: vm-images-bucket
      objectName: SOURCE_FILE
  imageMetadata:
    name: IMAGE_NAME
    operatingSystem: IMAGE_OS
    minimumDiskSize: DISK_SIZE
EOF

    Reemplaza las siguientes variables:

    • IMAGE_NAME: Es el nombre de la imagen que se importará. El nombre no debe tener más de 35 caracteres.
    • PROJECT_ID: Es el ID del proyecto en el que deseas importar la imagen.
    • SOURCE_FILE: Es el nombre del archivo fuente que contiene la carga del disco virtual en el almacenamiento de objetos. Este valor es la sección de la ruta de almacenamiento de objetos después de vm-images-bucket/.
    • IMAGE_OS: Es el SO del disco que se importará.
    • DISK_SIZE: Es el tamaño mínimo que debe tener un disco para crearse con esta imagen. Usa al menos un 20% de búfer sobre el tamaño del sistema de archivos de la imagen original. Por ejemplo, usa al menos 12G para un disco virtual con un tamaño original del sistema de archivos de 10 GB.

  2. Supervisa el progreso de la importación consultando el estado del objeto VirtualMachineImageImport:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
  -n PROJECT_ID \
  get virtualmachineimageimport.virtualmachine.gdc.goog IMAGE_NAME \
  -o jsonpath='{.status}'

Limpia los recursos

El proceso de importación implica subir tu archivo de disco virtual al almacenamiento de objetos. Si usas la CLI de gdcloud, el objeto se limpia cuando finaliza el comando, ya sea que se haya realizado correctamente o no. Si se interrumpe el comando o si importas la imagen con la API, es posible que el archivo de disco virtual permanezca en el bucket de almacenamiento de objetos llamado vm-images-bucket hasta que lo borres de forma manual.

¿Qué sigue?