Ver imágenes de SO de VM para Batch

En esta página se describe cómo ver las imágenes del sistema operativo (SO) disponibles para las instancias de máquina virtual (VM) que ejecutan trabajos de Batch.

En concreto, en esta página se describe cómo ver una lista y los detalles de las imágenes del SO de las VMs de Batch. Para obtener más información sobre las imágenes de SO de VM y las que puedes usar con Batch, consulta la descripción general del entorno de SO de VM. Si quieres ver otras imágenes de SO de máquinas virtuales, como imágenes públicas de Compute Engine o imágenes personalizadas, consulta la documentación sobre imágenes de Compute Engine.

Antes de empezar

  1. Si no has usado Batch antes, consulta el artículo Empezar a usar Batch y habilita Batch completando los requisitos previos para proyectos y usuarios.

Ver una lista de imágenes de SO de VM de Batch

Puedes ver una lista de todas las imágenes de SO de las VMs de Batch mediante la CLI de gcloud o la API de Batch.

gcloud

Para enumerar todas las imágenes de SO de VM admitidas de Batch, usa el siguiente comando gcloud compute images list:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • Es necesario usar la marca --project=batch-custom-image para enumerar las imágenes de Batch.
  • La marca --no-standard-images omite las imágenes estándar de Compute Engine.
  • Opcional: Si necesitas ver las imágenes de Batch obsoletas, incluye también la marca --show-deprecated.

El resultado de cada imagen del SO de la VM es similar al siguiente:

NAME: IMAGE_NAME
PROJECT: IMAGE_PROJECT_ID
FAMILY: IMAGE_FAMILY
...

Esta salida incluye los siguientes valores:

  • IMAGE_NAME: el nombre de la imagen. El nombre de una imagen representa una versión específica de una imagen del SO de una VM. Por ejemplo, el nombre de la imagen batch-debian-11-official-20230802-00-p00 representa la versión -20230802-00-p00 (la versión del 2 de agosto del 2023) de la familia de imágenes batch-debian-11-official.
  • IMAGE_PROJECT_ID: el ID del proyecto del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Imágenes por lotes están en el proyecto batch-custom-image.
  • IMAGE_FAMILY: la familia de la imagen. Una familia de imágenes incluye una o varias imágenes específicas y representa el tipo y la versión principal del SO. Por ejemplo, la familia de imágenes batch-debian-11-official contiene imágenes de Batch basadas en la versión 11 del SO de Debian de Compute Engine.

API

Para enumerar todas las imágenes de SO de VM admitidas de Batch, haz la siguiente solicitud al método images.list:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
  • Se necesita el proyecto batch-custom-image para enumerar las imágenes de Batch.
  • El parámetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite las imágenes obsoletas mediante la codificación de URLs para asignar el valor (-deprecated:*) OR (deprecated.state="ACTIVE") al campo filter.
    • Opcional: Si necesitas ver imágenes de Batch obsoletas, elimina el parámetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

El resultado de cada imagen del SO de la VM es similar al siguiente:

{
  ...
  "name": "IMAGE_NAME",
  ...
  "family": "IMAGE_FAMILY",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME",
  ...
}

Esta salida incluye los siguientes valores:

  • IMAGE_NAME: el nombre de la imagen. El nombre de una imagen representa una versión específica de una imagen del SO de una VM. Por ejemplo, el nombre de la imagen batch-debian-11-official-20230802-00-p00 representa la versión -20230802-00-p00 (la versión del 2 de agosto del 2023) de la familia de imágenes batch-debian-11-official.
  • IMAGE_PROJECT_ID: el ID del proyecto del proyecto que contiene la imagen. Por ejemplo, todas las imágenes de Imágenes por lotes están en el proyecto batch-custom-image.
  • IMAGE_FAMILY: la familia de la imagen. Una familia de imágenes incluye una o varias imágenes específicas y representa el tipo y la versión principal del SO. Por ejemplo, la familia de imágenes batch-debian-11-official contiene imágenes de Batch basadas en la versión 11 del SO de Debian de Compute Engine.

Ver los detalles de una imagen de SO de VM de Batch

Puedes ver todos los detalles de una imagen de SO de VM con la herramienta de línea de comandos gcloud o la API Batch.

gcloud

Para ver los detalles de una imagen de SO de una VM de Batch, usa el comando gcloud compute images describe y especifica batch-custom-image como proyecto de imagen:

gcloud compute images describe IMAGE_NAME --project=batch-custom-image

Sustituye IMAGE_NAME por el nombre de la imagen del SO de la VM de Batch que quieras describir.

API

Para ver los detalles de una imagen del SO de una VM de Batch, haz una solicitud al método images.get y especifica batch-custom-image como proyecto de imagen:

GET https://compute.googleapis.com/compute/v1/projects/batch-custom-image/global/images/IMAGE_NAME

Sustituye IMAGE_NAME por el nombre de la imagen del SO de la VM de Batch que quieras describir.

Siguientes pasos