Usa una imagen de máquina para almacenar la configuración, los metadatos, los permisos y los datos de uno o más discos de una instancia de VM que se ejecuta en Compute Engine. La instancia de VM que usas para crear una imagen de máquina se denomina instancia de origen.
Para obtener información sobre cuándo y cómo usar las imágenes de máquina, consulta Imágenes de máquina.
En este documento, se describen los pasos para crear una imagen de máquina desde una instancia de origen.
Antes de comenzar
- Si deseas usar los ejemplos de línea de comandos en esta guía, haz lo siguiente:
- Instala la herramienta de línea de comandos de gcloud o actualízala a la última versión.
- Configura una región y una zona predeterminadas.
- Si deseas usar los ejemplos de API de esta guía, configura el acceso a la API.
Limitaciones y restricciones
- Puedes compartir una imagen de máquina entre proyectos. Sin embargo, las redes de VPC compartidas no son compatibles.
- Para proteger una imagen de máquina, puedes usar Cloud Key Management Service (Cloud KMS) o una clave de encriptación proporcionada por el cliente (CSEK). La clave de encriptación 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 todas las demás situaciones, los datos del disco se almacenan en las copias diferenciales.
Crea una imagen de máquina a partir de una instancia
Puedes crear imágenes de máquina mediante Google Cloud Console, la herramienta de línea de comandos de gcloud
o la API de Compute Engine.
Para crear una imagen de máquina, necesitas la siguiente información:
- Un nombre para la imagen de máquina que deseas crear
- El nombre de la instancia de origen
- La zona en la que se encuentra la instancia de origen
- Una descripción opcional
- Una
storageLocation
opcional. Si no especificas una ubicación, la ubicación de almacenamiento predeterminada es la ubicación de Cloud Storage multirregional de la instancia de origen - Una clave de encriptación opcional. Puedes elegir entre una clave administrada por Google, una clave de Cloud Key Management Service (Cloud KMS) o una clave de encriptación proporcionada por el cliente (CSEK). Si no se especifica una clave de encriptación, las imágenes de máquina se encriptarán mediante una clave administrada por Google
Si deseas usar una imagen de máquina para clonar y replicar instancias, quita la información del SO y de la app que sea exclusiva antes de generar la imagen de máquina a partir de una instancia. Por ejemplo, en instancias de VM de Windows, usa
GCESysprep
a fin de preparar el sistema para la replicación.
Console
En Google Cloud Console, ve a la página Imágenes de máquina.
Haz clic en Crear imagen de máquina.
Especifica un Nombre para tu imagen de máquina.
Proporciona una Descripción (opcional).
Selecciona la instancia de VM de origen.
Especifica la ubicación en la que se almacenará la imagen de máquina (opcional). Elige entre 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.
Selecciona un método de Encriptación (opcional).
Haga clic en Crear.
gcloud
Usa el comando gcloud beta compute machine-images create
para crear una imagen de máquina a partir de una instancia.
gcloud beta compute machine-images create MACHINE_IMAGE_NAME \ --source-instance SOURCE_INSTANCE_NAME
Reemplaza lo siguiente:
MACHINE_IMAGE_NAME
: nombre de la imagen de máquina que deseas crear.SOURCE_INSTANCE_NAME
: nombre de la instancia de origen desde la que deseas crear la imagen.
Ejemplo
Por ejemplo, puedes usar el siguiente comando de gcloud
para crear una imagen de máquina llamada my-machine-image
desde una instancia de origen llamada my-instance
:
gcloud beta compute machine-images create my-machine-image \ --source-instance my-instance
El proceso toma unos minutos. Cuando se crea la imagen de máquina, obtienes un resultado similar al siguiente:
Created [https://www.googleapis.com/compute/beta/projects/project-12345/global/machineImages/my-machine-image]. NAME STATUS my-machine-image READY
API
En la API, realiza 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/beta/projects/PROJECT_ID/global/machineImages { "name": "MACHINE_IMAGE_NAME", "sourceInstance": "SOURCE_INSTANCE_URL" }
Reemplaza lo siguiente:
PROJECT_ID
: ID del proyectoMACHINE_IMAGE_NAME
: nombre de la imagen de máquina que deseas crear.SOURCE_INSTANCE_URL
: URL completa o parcial de la instancia de origen que deseas usar para crear la imagen de máquina. Por ejemplo, si tienes una instancia de origen llamadamy-instance
en un proyecto llamadomyProject
, las siguientes URL 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
Próximos pasos
- Obtén más información sobre las imágenes de máquina
- Crea instancias de VM a partir de imágenes de máquinas