Mejores prácticas de familias de imágenes

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

Este documento explica las mejores prácticas al usar familias de imágenes en Compute Engine.

Antes de comenzar

• 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:

  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 .

Familias de imágenes públicas

Compute Engine proporciona familias de imágenes para ayudarte a garantizar que tus sistemas de automatización puedan hacer referencia a las imágenes más recientes. Como administrador, puedes agrupar un conjunto de imágenes como una familia de imágenes. Luego, los usuarios de las imágenes solo tienen que realizar un seguimiento del nombre de la familia de la imagen, en lugar del nombre exacto de la imagen. Debido a que los nombres de las imágenes deben ser únicos, las canalizaciones de creación de imágenes a menudo crean nombres de imágenes con información codificada en ellos, como el nombre de la aplicación, la fecha y la versión, por ejemplo, my-application-v3-20210101 . En las herramientas de automatización, puede hacer referencia al nombre de la familia de la imagen en lugar de tener que actualizar el nombre de la imagen a intervalos. El uso de familias de imágenes garantiza que siempre tendrá acceso a la imagen más reciente de la familia, por ejemplo, my-application .

Las imágenes públicas se agrupan en familias de imágenes. Una familia de imágenes públicas siempre apunta a la última versión de una imagen que está disponible en cada zona. Cuando se publican nuevas imágenes a nivel mundial, su disponibilidad inicial en familias de imágenes depende de la zona, lo que mejora la tolerancia a fallas zonales para sus flujos de trabajo durante las actualizaciones de imágenes de Google.

Durante la implementación de la imagen, la última versión de una imagen de una familia de imágenes puede diferir en diferentes zonas. Por ejemplo, la familia de imágenes debian-12 en el proyecto debian-cloud siempre apunta a la imagen de Debian 12 más reciente, pero la imagen de Debian 12 más reciente en la zona us-central1-a y southamerica-east1-b puede ser diferente.

Cuando creas máquinas virtuales a partir de familias de imágenes usando la CLI de Google Cloud, Compute Engine usa la imagen más reciente que está disponible en la zona de tu máquina virtual para tu solicitud. Cuando creas máquinas virtuales usando la consola de Google Cloud, Compute Engine solo muestra las imágenes públicas disponibles en tu zona seleccionada. Si desea crear máquinas virtuales usando la imagen más reciente disponible globalmente, use el comando instances create de la CLI de gcloud y especifique --image-family-scope=global .

Visualización de la última versión de imagen disponible

Puede ver la imagen más reciente disponible globalmente en una familia de imágenes o ver la imagen más reciente que está disponible en una zona en particular.

Globalmente

Para ver la última imagen disponible globalmente en una familia de imágenes, utilice uno de los siguientes métodos:

gcloud compute images describe-from-family IMAGE_FAMILY_NAME  \
   --project=IMAGE_PROJECT

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

Por zona

Para ver la última imagen disponible en una familia de imágenes para una zona específica, utilice uno de los siguientes métodos:

gcloud compute images describe-from-family IMAGE_FAMILY_NAME  \
   --project=IMAGE_PROJECT \
   --zone=ZONE

GET https://compute.googleapis.com/compute/v1/projects/IMAGE_PROJECT/zones/ZONE/imageFamilyViews/IMAGE_FAMILY_NAME

Familias de imágenes personalizadas

Puede crear familias de imágenes personalizadas para sus imágenes personalizadas . La familia de imágenes apunta a la imagen más reciente que utilizó para crear la familia de imágenes. Para revertir una familia de imágenes a una versión de imagen anterior, puede desaprobar la imagen más reciente de esa familia (siempre que la imagen anterior no esté obsoleta). Para obtener más información, consulte Configuración de versiones de imágenes en una familia de imágenes .

Para crear una imagen con una familia de imágenes, o para crear una familia de imágenes si no existe, debe agregar una marca --family adicional al paso de creación de imágenes, por ejemplo:

gcloud compute images create my-application-v3-20210101 \
    --source-disk my-application-disk-1 \
    --source-disk-zone us-central1-f \
    --family my-application

Después de ejecutar este comando, cualquier llamada para ejecutar una instancia basada en la imagen my-application apunta a la imagen recién creada, my-application-v3-20210101 .

Al seleccionar un nombre para su familia de imágenes, consulte Convención de nomenclatura .

Cómo utilizar familias de imágenes

Si bien las familias de imágenes le permiten hacer referencia a la imagen más reciente, la imagen más reciente puede introducir incompatibilidad con su aplicación, lo que puede causar problemas en un entorno de producción si no se valida. Si desea aprovechar los beneficios de las familias de imágenes y al mismo tiempo reducir los riesgos, le recomendamos que pruebe la última imagen referenciada de la familia de imágenes antes de usarla en su entorno de producción.

En resumen, puede considerar el siguiente enfoque:

• Configure un entorno de prueba separado de su entorno de producción.
• En el entorno de prueba, complete los siguientes pasos:
  • Cree una familia de imágenes personalizada a partir de la familia de imágenes de origen.
  • Verifique la estabilidad de la nueva imagen en la familia de imágenes personalizadas frente a sus cargas de trabajo.
• Una vez verificada, mueva esta familia de imágenes personalizadas a un entorno de producción.

Por ejemplo, el proceso podría parecerse al siguiente procedimiento.

1. En su proyecto de prueba, cree una imagen a partir de la familia de imágenes de origen. Esta nueva familia de fuentes de imágenes también debe tener su propia familia de imágenes personalizada a la que hacer referencia en el entorno de prueba. Para crear la imagen con una familia de imágenes personalizada, ejecute el siguiente comando:

   gcloud compute images create test-image-name \
   --source-image-project source-project \
   --source-image-family source-image-family \
   --project test-project \
   --family test-image-family
   

   Reemplace lo siguiente:

   • test-image-name : nombre de su imagen de prueba.
   • source-project : proyecto al que pertenece la familia de imágenes de origen.
   • source-image-family : nombre de la familia de imágenes fuente.
   • test-project : nombre del proyecto de prueba al que desea agregar la familia de imágenes.
   • test-image-family : nombre de su familia de imágenes de prueba.

2. Usando su familia de imágenes personalizada test-image-family , cree una máquina virtual para probar su carga de trabajo. Para crear la VM, ejecute el siguiente comando:

   gcloud compute instances create test-instance-name \
   --image-family your-test-image-family \
   --project test-project
   

   Reemplace lo siguiente:

   • test-instance-name : nombre de su instancia de prueba.
   • test-image-family : nombre de su familia de imágenes de prueba.
   • test-project : nombre de su proyecto de prueba.

3. Cuando haya validado que esta imagen funciona bien para su carga de trabajo, copie la imagen a su entorno de producción.

   gcloud compute images create prod-image-name \
   --source-image-family test-image-family \
   --source-image-project test-project \
   --project prod-project \
   --family prod-image-family
   

   Reemplace lo siguiente:

   • prod-image-name : nombre de su imagen de producción.
   • test-image-family : nombre de su familia de imágenes de prueba.
   • test-project : proyecto al que pertenece la familia de imágenes de prueba.
   • prod-project : nombre de tu proyecto que está en el entorno de producción.
   • prod-image-family : nombre de la familia de imágenes que desea utilizar en su entorno de producción.