Crear imágenes de máquina

Usa una imagen de máquina para almacenar toda la configuración, los metadatos, los permisos y los datos de varios discos de una instancia de VM que se ejecute en Compute Engine. A la instancia de máquina virtual que se utiliza para crear una imagen de máquina se la conoce como instancia de máquina virtual de origen.

Para obtener información sobre cuándo y cómo usar las imágenes de máquina, consulta el artículo Imágenes de máquina.

En este documento se describen los pasos para crear una imagen de máquina a partir de una instancia de VM de origen.

Antes de empezar

  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

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

      Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Limitaciones y restricciones

  • Puedes crear una imagen de máquina de una instancia específica un máximo de 6 veces cada 60 minutos.
  • Puedes proteger una imagen de máquina con Cloud Key Management Service (Cloud KMS) o con una clave de encriptado proporcionada por el cliente (CSEK). La clave de cifrado protege el contenido de los discos. Sin embargo, los metadatos no están protegidos.
  • Si usas una CSEK para proteger tu imagen de máquina, se almacenará una copia completa de todos los datos del disco durante la generación de la imagen de máquina. En el resto de los casos, los datos del disco se almacenan en copias diferenciales.

  • No puedes crear imágenes de máquina a partir de VMs de origen que cumplan las siguientes condiciones:

    • Tener más de 200 TB de discos conectados.
    • No tiene ningún disco conectado.
    • Tener volúmenes de hiperdisco conectados.
    • Usa el tipo de máquina Z3, excepto z3-highmem-192-highlssd-metal.
    • Usa un tipo de máquina C3D, H3 o A3.

    En el caso de las instancias que no admiten la creación de imágenes de máquina, puedes crear una imagen de SO a partir del disco de arranque de la instancia, tal como se describe en el artículo Crear imágenes personalizadas.

Propiedades de instancias y discos no admitidas por la imagen de máquina

Cuando creas imágenes de máquina a partir de instancias de VM o instancias de VM a partir de imágenes de máquina, no se conservan ni se restauran las siguientes propiedades de instancias y discos:

  • disks.architecture
  • disks.description
  • disks.labels
  • disks.locked
  • disks.multiWriter
  • disks.onUpdateAction
  • disks.provisionedIops
  • disks.shieldedInstanceInitialState
  • disks.sourceImage
  • disks.sourceImageEncryptionKey
  • disks.sourceInstantSnapshot
  • disks.sourceSnapshot
  • disks.sourceSnapshotEncryptionKey
  • privateIpv6GoogleAccess
  • resourceManagerTags
  • resourcePolicies
  • secure_tag
  • shieldedInstanceConfig

Crear una imagen de máquina a partir de una VM

Puedes crear imágenes de máquina con la Google Cloud consola, la interfaz de línea de comandos de Google Cloud o REST.

Para crear una imagen de máquina, necesitas la siguiente información:

  • El nombre de la imagen de máquina que quieres crear.
  • Nombre de la instancia de VM de origen.
  • La zona en la que se encuentra la instancia de VM de origen.
  • Una descripción opcional.
  • Se puede añadir un punto (storageLocation). Si no especificas ninguna ubicación, la ubicación de almacenamiento predeterminada será la ubicación multirregional de Cloud Storage de la instancia de VM de origen.
  • Una clave de cifrado opcional. Puedes elegir entre una Google-owned and Google-managed encryption key, una clave de Cloud Key Management Service (Cloud KMS) o una clave de cifrado proporcionado por el cliente (CSEK). Si no se especifica ninguna clave de cifrado, las imágenes de máquina se cifran con una Google-owned and Google-managed encryption key.

  • Si quieres usar una imagen de máquina para clonar instancias y crear snapshots, elimina la información del SO y de la aplicación que sea única de la instancia antes de generar la imagen de máquina a partir de una instancia. Por ejemplo, en el caso de las instancias de VM de Windows, usa GCESysprep para preparar el sistema para la replicación.

Consola

  1. En la Google Cloud consola, ve a la página Imágenes de máquina.

    Ir a Imágenes de máquina

  2. Haz clic en Crear imagen de máquina.

  3. Especifica un nombre para la imagen de la máquina.

  4. Opcional: Proporciona una descripción.

  5. Selecciona la instancia de VM de origen.

  6. Opcional: Especifica dónde quieres almacenar la imagen de máquina. Elige entre el almacenamiento multirregional o regional. Para obtener más información sobre la ubicación, consulta Ubicación de almacenamiento de imágenes de máquina.

  7. Opcional: Selecciona un método de cifrado.

  8. Haz clic en Crear.

gcloud

Usa el comando gcloud compute machine-images create para crear una imagen de máquina a partir de una instancia.

gcloud compute machine-images create MACHINE_IMAGE_NAME \
    --source-instance=SOURCE_VM_NAME

Haz los cambios siguientes:

  • MACHINE_IMAGE_NAME: nombre de la imagen de máquina que quieres crear.
  • SOURCE_VM_NAME: nombre de la instancia de VM de origen a partir de la que quieres crear la imagen.

Ejemplo

Por ejemplo, puedes usar el siguiente comando gcloud para crear una imagen de máquina llamada my-machine-image a partir de una instancia de origen llamada my-instance:

gcloud compute machine-images create my-machine-image  \
    --source-instance=my-instance

El proceso tarda unos minutos. Cuando se crea la imagen de máquina, obtienes un resultado similar al siguiente:

Created [https://www.googleapis.com/compute/v1/projects/project-12345/global/machineImages/my-machine-image].
NAME               STATUS
my-machine-image   READY

REST

En la API, crea una solicitud POST al método machineimages.insert. En el cuerpo de la solicitud, incluye la siguiente solicitud POST:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/machineImages

{
  "name": "MACHINE_IMAGE_NAME",
  "sourceInstance": "SOURCE_INSTANCE_URL"
}

Haz los cambios siguientes:

  • PROJECT_ID: ID de proyecto.
  • MACHINE_IMAGE_NAME: nombre de la imagen de máquina que quieres crear.

  • SOURCE_INSTANCE_URL: URL completa o parcial de la instancia de VM de origen que quiere usar para crear la imagen de máquina. Por ejemplo, si tiene una instancia de origen llamada my-instance en un proyecto llamado myProject. Las siguientes URLs son válidas:

    • https://www.googleapis.com/compute/v1/projects/myProject/global/instances/my-instance
    • projects/myProject/global/instances/my-instance
    • global/instances/my-instance

Siguientes pasos