Establecer la versión de la imagen en una familia de imágenes

Utilice familias de imágenes para simplificar el control de versiones de imágenes. Agregue una imagen a una familia de imágenes para configurarla como la versión de imagen más reciente. Si determina que debe revertir la familia de imágenes a una versión de imagen anterior, desactive la imagen más reciente de la familia.

Para conocer las mejores prácticas al trabajar con familias de imágenes, consulte Mejores prácticas de familias de imágenes .

Opcionalmente, puedes especificar la ubicación de almacenamiento de la imagen mediante la consola de Google Cloud, el comando gcloud compute images create con la marca --storage-location o el método images().insert .

Antes de comenzar

  • Lea el documento de Imágenes .
  • 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.

      3. 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 .

Establecer la versión de la imagen en una familia de imágenes

Consola

  1. En la consola de Google Cloud, vaya a la página Crear una imagen .

    Ir a Crear una imagen

  2. Especifique el nombre de su imagen. Por ejemplo, image-v1 .

  3. Especifique la Fuente desde la cual desea crear una imagen. Puede ser un disco persistente, una instantánea, otra imagen o un archivo disk.raw en Cloud Storage.

  4. Si está creando una imagen desde un disco conectado a una máquina virtual en ejecución, marque Mantener la instancia en ejecución para confirmar que desea crear la imagen mientras la máquina virtual se está ejecutando. Puede preparar su VM antes de crear la imagen.

  5. En la lista desplegable Según la ubicación del disco de origen (predeterminada) , especifique la ubicación para almacenar la imagen. Por ejemplo, especifique us para almacenar la imagen en la región múltiple us ., o us-central1 para almacenarla en la región us-central1 . Si no realiza una selección, Compute Engine almacena la imagen en la región múltiple más cercana a la ubicación de origen de su imagen.

  6. Especifique la familia de imágenes para la nueva imagen. Por ejemplo, agregue my-image-family para organizar la imagen como parte de una familia de imágenes .

  7. Opcional: especifique otras propiedades de la imagen:

    • Descripción : una descripción para su imagen personalizada.
    • Etiqueta : una etiqueta para agrupar recursos.

  8. Especifique la clave de cifrado. Puedes elegir entre un Google-owned and Google-managed encryption key, una clave de Cloud Key Management Service (Cloud KMS) o una clave de cifrado proporcionada por el cliente (CSEK) . Si no se especifica ninguna clave de cifrado, las imágenes se cifran utilizando una Google-owned and Google-managed encryption key.

  9. Haga clic en Crear para crear la imagen.

nube de gcloud 

gcloud compute images create image-v1 \
    --source-disk disk-1 \
    --source-disk-zone us-central1-f \
    --family my-image-family

La familia de imágenes apunta a image-v1 . Añade una segunda imagen a la familia:

gcloud compute images create image-v2 \
    --source-disk disk-2 \
    --source-disk-zone us-central1-f \
    --family my-image-family

DESCANSAR

Realice una solicitud POST al método images().insert . Especifique la familia de imágenes en el cuerpo de la solicitud.

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

{
  "name": "image-v2",
  "sourceDisk": "/zones/us-central1-f/disks/disk-2",
  "family":"my-image-family",

}

La familia de imágenes apunta a image-v2 porque es la imagen más reciente que agregó a la familia de imágenes.

nube de gcloud

Puedes ver a qué imagen apunta una familia ejecutando el comando gcloud compute images describe-from-family .

Por ejemplo:

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '8904691942610171306'
kind: compute#image
name: image-v2
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v2
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v2
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY

DESCANSAR

Realice una solicitud GET al método images().getFromFamily . Especifique la familia de imágenes en el cuerpo de la solicitud.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/family

{
  "resourceId":"my-image-family",

}

Si determina que debe revertir la familia de imágenes para que ya no apunte a image-v2 , desapruebe image-v2 y la familia volverá a apuntar a image-v1 .

gcloud compute images deprecate image-v2 \
    --state DEPRECATED \
    --replacement image-v1

Verifique para asegurarse de que la familia de imágenes apunte a image-v1 .

gcloud compute images describe-from-family my-image-family

family: my-image-family
id: '2741732787056801255'
kind: compute#image
name: image-v1
selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/global/images/image-v1
sourceDisk: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-f/disks/disk-v1
sourceDiskId: '1677449456001963379'
sourceType: RAW
status: READY