Exportar una imagen personalizada a Cloud Storage

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Si necesitas mover los datos del disco de arranque de Compute Engine fuera de tu proyecto de Compute Engine, puedes exportar una imagen del disco de arranque a Cloud Storage como un archivo tar.gz Si necesitas crear una imagen de disco persistente para usarla al crear nuevos discos persistentes en Compute Engine, lee Cómo crear una imagen personalizada .

Puede hacer una copia de seguridad o compartir una imagen personalizada exportándola a Cloud Storage. Este método es ideal para compartir imágenes individuales con proyectos que no tienen acceso a sus imágenes. Alternativamente, puedes compartir imágenes otorgando el rol de usuario de imágenes de Compute Engine en la imagen o en el proyecto que la contiene.

El siguiente diagrama muestra algunos flujos de trabajo típicos para la creación y reutilización de una imagen personalizada.

Antes de comenzar

• Lea la página de imágenes .
• Si el proyecto desde el que desea exportar la imagen tiene definida una política de imágenes confiable , agregue projects/compute-image-import y projects/compute-image-tools a la lista permitida de editores.
• Para saber cómo cumplir con los requisitos antes de exportar imágenes, consulte Requisitos previos para importar y exportar imágenes de VM .
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Limitaciones y restricciones

Las siguientes limitaciones se aplican al proceso de exportación de imágenes.

Limitaciones generales

Cuando exporta una imagen, se crea una sesión en la máquina desde la que está exportando la imagen. Esta sesión debe permanecer activa hasta que se complete el proceso de exportación. Si la sesión finaliza antes de que se complete el proceso de exportación, es posible que los recursos efímeros, como discos temporales, instancias de VM o depósitos de almacenamiento, no se eliminen. En este caso, deberás eliminar estos recursos efímeros manualmente.

El proceso de exportación utiliza Cloud Build para exportar una imagen. Una sesión de Cloud Build tiene una duración máxima de 24 horas. Si su imagen es muy grande y necesita más de 24 horas para exportarse, puede exportar la imagen manualmente .

Limitaciones de los controles del servicio VPC

Para proyectos protegidos con Controles de servicio de VPC , utilice uno de los siguientes métodos:

• exportar desde el mismo proyecto donde reside la imagen
• exportar la imagen manualmente

Exportar una imagen con un solo comando

Exportar una imagen a Cloud Storage

Puede exportar sus imágenes utilizando la consola de Google Cloud , la CLI de Google Cloud o REST .

gcloud compute images export \
    --destination-uri DESTINATION_URI \
    --image IMAGE_NAME

gcloud compute images export \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --image my-image \
    --project my-project

POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
  "timeout": "7200s",
  "steps":[
    {
      "args":[
        "-timeout=7000s",
        "-source_image=SOURCE_IMAGE",
        "-client_id=api",
        "-format=IMAGE_FORMAT",
        "-destination_uri=DESTINATION_URI"
      ],
      "name":"gcr.io/compute-image-tools/gce_vm_image_export:release",
      "env":[
        "BUILD_ID=$BUILD_ID"
      ]
    }
  ],
  "tags":[
    "gce-daisy",
    "gce-daisy-image-export"
  ]
}

{
"name": "operations/build/myproject-12345/operation-1578608233418",
"metadata": {
 "@type": "type.googleapis.com/google.devtools.cloudbuild.v1.BuildOperationMetadata",
 "build": {
  "id": "3a2055bc-ccbd-4101-9434-d376b88b8940",
  "status": "QUEUED",
  "createTime": "2019-10-02T18:59:13.393492020Z",
  "steps": [
   {
    "name": "gcr.io/compute-image-tools/gce_vm_image_export:release",
    "env": [
     "BUILD_ID=3a2055bc-ccbd-4101-9434-d376b88b8940"
    ],
    "args": [
     "-timeout=7056s",
     "-source_image=my-image",
     "-client_id=api",
     "-format=vmdk",
     "-destination_uri=gs://my-bucket/my-exported-image.vmdk"
    ]
   }
  ],
  "timeout": "7200s",
  "projectId": "myproject-12345",
  "logsBucket": "gs://123456.cloudbuild-logs.googleusercontent.com",
  "options": {
   "logging": "LEGACY"
  },
  "logUrl": "https://console.cloud.google.com/cloud-build/builds/3a2055bc-ccbd-4101-9434-d376b88b8940?project=123456"
 }
 }

Exportar una imagen de un proyecto usando una cuenta de servicio personalizada de Compute Engine

Durante la exportación de una imagen, se crea una instancia de máquina virtual (VM) temporal en su proyecto. La herramienta de exportación de imágenes en esta VM temporal debe estar autenticada.

Una cuenta de servicio es una identidad adjunta a una máquina virtual. Se puede acceder a los tokens de acceso a la cuenta de servicio a través del servidor de metadatos de la instancia y usarlos para autenticar la herramienta de exportación de imágenes en la VM.

De forma predeterminada, el proceso de exportación utiliza el Agente de servicio de Compute Engine predeterminado del proyecto. Sin embargo, si la cuenta de servicio predeterminada de Compute Engine está deshabilitada en su proyecto o si desea utilizar una cuenta de servicio de Compute Engine personalizada, deberá crear una cuenta de servicio y especificarla para el proceso de exportación.

Puede exportar sus imágenes utilizando Google Cloud CLI o REST .

gcloud compute images export \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --image my-image \
    --project my-project \
    --compute-service-account image-export-service-account@proj-12345.iam.gserviceaccount.com
    

Exportar una imagen usando VPC compartida

Antes de exportar una imagen que utiliza una VPC compartida, debe agregar el rol compute.networkUser a la cuenta del servicio Cloud Build. Para obtener más información, consulte Otorgar roles requeridos a la cuenta de servicio Cloud Build .

Puede exportar su imagen utilizando Google Cloud CLI o REST .

gcloud compute images export \
    --image IMAGE_NAME \
    --destination-uri DESTINATION_URI \
    --project PROJECT_ID \
    --network NETWORK \
    --subnet SUBNET \
    --zone ZONE

gcloud compute images export \
    --image example-image \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --project my-project \
    --network projects/my-vpc-project/global/networks/my-shared-vpc \
    --subnet projects/my-vpc-project/regions/us-west1/subnetworks/my-custom-subnet \
    --zone us-west1-c
 

Crear y exportar una imagen manualmente

Si los comandos gcloud compute images create y gcloud compute images export no cumplen con tus requisitos, puedes crear y exportar una imagen manualmente desde una instancia de Compute Engine. Este proceso tiene pasos discretos para crear primero una imagen y luego exportarla.

En el siguiente ejemplo, tenga en cuenta que el disco creado se llama disco-imagen .

Para crear y exportar una imagen:

1. Opcional: detenga la instancia a la que está conectado el disco antes de crear la instantánea. Detener la instancia garantiza la integridad del contenido del disco en la instantánea.

2. Cree una instantánea del disco. Nombra la instantánea image-snapshot .

   gcloud compute disks snapshot DISK_NAME \
       --snapshot-names image-snapshot

   Reemplace DISK_NAME con el nombre del disco que desea usar para crear la instantánea. Puede encontrar el nombre del disco enumerando los discos .

3. Utilice la instantánea image-snapshot para crear un nuevo disco llamado image-disk ejecutando el siguiente comando:

   gcloud compute disks create image-disk \
       --source-snapshot image-snapshot

4. Cree un disco temporal llamado temporary-disk para contener su archivo tar y especifique que el SIZE del disco sea al menos un 50% más grande que el disco de imagen.

   Puede desconectar y eliminar el disco después.

   gcloud compute disks create temporary-disk \
       --size SIZE

   donde SIZE es el tamaño, en gigabytes o terabytes, del disco temporal. Por ejemplo, especifique 100GB para crear un disco de 100 gigabytes.

5. Cree una instancia y habilite el alcance storage-rw en la instancia. Además, adjunte el image-disk y el temporary-disk a la instancia como discos secundarios con atributos device-name específicos. Reemplace VM_NAME con el nombre de la instancia a crear.

   gcloud compute instances create VM_NAME \
       --scopes storage-rw \
       --disk name=image-disk,device-name=image-disk \
       --disk name=temporary-disk,device-name=temporary-disk

   Tenga en cuenta que está pasando los alcances de la cuenta de servicio para poder cargar su archivo en Cloud Storage en pasos posteriores.

   Revise los detalles sobre cómo iniciar una nueva instancia si es necesario.

6. Conéctese a su instancia . Reemplace VM_NAME con el nombre de la instancia a la que conectarse.

   gcloud compute ssh VM_NAME

7. Formatee y monte el disco temporal. Al formatear el disco se elimina el contenido del disco temporal.

   sudo mkdir /mnt/tmp

   sudo mkfs.ext4 -F /dev/disk/by-id/google-temporary-disk

   sudo mount -o discard,defaults /dev/disk/by-id/google-temporary-disk /mnt/tmp

8. Opcional: monte el disco de imagen y realice cambios adicionales antes de crear el archivo tar . Por ejemplo, es posible que desee eliminar cualquier archivo existente del directorio /home si no desea que forme parte de su imagen. Monte las particiones del disco que necesita modificar, modifique los archivos en el disco que necesita cambiar y luego desmonte el disco cuando haya terminado.

   1. Cree un directorio donde pueda montar su disco o partición.

      sudo mkdir /mnt/image-disk

   2. Utilice el comando ls para determinar qué disco o partición de disco necesita montar.

      ls /dev/disk/by-id/

      El comando imprime una lista de ID de disco y particiones. Por ejemplo, el siguiente disco tiene una tabla de particiones con una partición. El ID de google-image-disk apunta al disco lleno desde el cual desea crear una imagen. El ID google-image-disk-part1 apunta a la primera partición de este disco. Monte la partición si necesita realizar cambios en el disco, luego cree la imagen a partir del disco completo.

      google-image-disk
      google-image-disk-part1
      

   3. Monte el disco o la partición. Si su disco tiene una tabla de particiones, monte las particiones individuales para su disco. Por ejemplo, monte google-image-disk-part1 .

      sudo mount /dev/disk/by-id/google-image-disk-part1 /mnt/image-disk

      Alternativamente, si su disco tiene formato sin formato y no tiene tabla de particiones, monte el disco google-image-disk completo.

      sudo mount /dev/disk/by-id/google-image-disk /mnt/image-disk

   4. Modifique los archivos en el directorio /mnt/image-disk para configurar los archivos en el disco. Como ejemplo, puede eliminar el archivo /mnt/image-disk/home/[USER]/.ssh/authorized_keys para proteger sus claves SSH para que no se compartan.

   5. Una vez que haya terminado de modificar archivos, desmonte el disco.

      sudo umount /mnt/image-disk/

9. Crea un archivo tar de tu imagen.

   Cuando termine de personalizar los archivos en el disco de imagen, cree un archivo de disco sin formato en su disco temporal. El nombre de la imagen del disco sin formato debe ser 'disk.raw':

    sudo dd if=/dev/disk/by-id/google-image-disk of=/mnt/tmp/disk.raw bs=4096

   Luego crea el archivo tar.gz :

   cd /mnt/tmp

   sudo tar czvf myimage.tar.gz disk.raw

   Este comando crea una imagen de la instancia en la siguiente ubicación:

   /mnt/tmp/myimage.tar.gz

10. Sube la imagen a Cloud Storage.

    Para cargar el archivo tar en Cloud Storage, use la CLI de Google Cloud que viene preinstalada en su instancia.

    1. Crea un depósito con la CLI de gcloud.

       Asegúrese de revisar las pautas de denominación de objetos y depósitos antes de crear su depósito. Luego, crea tu depósito usando el siguiente comando. Reemplace BUCKET_NAME con el nombre del depósito que se creará.

       me@example-instance:~$ 
       gcloud storage buckets create gs://BUCKET_NAME

    2. Copie su archivo a su nuevo depósito. Reemplace BUCKET_NAME con el nombre del depósito al que copiar el archivo.

       me@example-instance:~$ 
       gcloud storage cp /mnt/tmp/myimage.tar.gz gs://BUCKET_NAME

Ha exportado su archivo a Cloud Storage. Ahora puedes compartir la imagen con otras personas o usar el archivo tar para agregar una nueva imagen a un proyecto de consola de Google Cloud.

¿Qué sigue?

• Comparta imágenes utilizando el rol de usuario de imágenes .
• Obtén información sobre los métodos de importación disponibles para Compute Engine.