Veja imagens do SO de VMs para o Batch

Esta página descreve como ver as imagens do sistema operativo (SO) disponíveis para as instâncias de máquinas virtuais (VMs) que executam tarefas do Batch.

Em concreto, esta página descreve como ver uma lista e os detalhes das imagens do SO da VM do Batch. Para saber mais sobre as imagens do SO de VM e que imagens do SO de VM pode usar com o Batch, consulte o artigo Vista geral do ambiente do SO de VM. Se quiser ver outras imagens de SO de VMs, como imagens públicas do Compute Engine ou imagens personalizadas, consulte a documentação de imagens do Compute Engine.

Antes de começar

  1. Se nunca usou o Batch, reveja o artigo Comece a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e utilizadores.

Veja uma lista de imagens do SO de VMs do Batch

Pode ver uma lista de todas as imagens do SO de VMs do Batch através da CLI gcloud ou da API Batch.

gcloud

Para apresentar uma lista de todas as imagens de SO de VMs suportadas a partir do Batch, use o gcloud compute images list comando seguinte:

gcloud compute images list \
    --project=batch-custom-image \
    --no-standard-images
  • A flag --project=batch-custom-image é necessária para listar imagens do Batch.
  • A flag --no-standard-images omite as imagens padrão do Compute Engine.
  • Opcional: se precisar de ver imagens em lote descontinuadas, inclua também a flag --show-deprecated.

O resultado de cada imagem do SO da VM é semelhante ao seguinte:

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

Esta saída inclui os seguintes valores:

  • IMAGE_NAME: o nome da imagem. Um nome de imagem representa uma versão específica de uma imagem do SO de VM. Por exemplo, o nome da imagem batch-debian-11-official-20230802-00-p00 representa a versão da imagem -20230802-00-p00 (a versão de 2 de agosto de 2023) para a família de imagens batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto do projeto que contém a imagem. Por exemplo, todas as imagens do conjunto de imagens estão no projeto batch-custom-image.
  • IMAGE_FAMILY: a família da imagem. Uma família de imagens inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, a batch-debian-11-officialfamília de imagens contém imagens do Batch baseadas na versão 11 do SO do Debian do Compute Engine.

API

Para listar todas as imagens de SO de VMs suportadas a partir do Batch, faça o seguinte pedido ao 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)
  • O projeto batch-custom-image é necessário para listar imagens do processamento em lote.
  • O parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite imagens descontinuadas através da codificação de URL para definir o campo filter como (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Opcional: se precisar de ver imagens em lote descontinuadas, remova o parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

O resultado de cada imagem do SO da VM é semelhante ao seguinte:

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

Esta saída inclui os seguintes valores:

  • IMAGE_NAME: o nome da imagem. Um nome de imagem representa uma versão específica de uma imagem do SO de VM. Por exemplo, o nome da imagem batch-debian-11-official-20230802-00-p00 representa a versão da imagem -20230802-00-p00 (a versão de 2 de agosto de 2023) para a família de imagens batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto do projeto que contém a imagem. Por exemplo, todas as imagens do conjunto de imagens estão no projeto batch-custom-image.
  • IMAGE_FAMILY: a família da imagem. Uma família de imagens inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, a batch-debian-11-officialfamília de imagens contém imagens do Batch baseadas na versão 11 do SO do Debian do Compute Engine.

Veja os detalhes de uma imagem do SO de VM a partir do Batch

Pode ver todos os detalhes de uma imagem do SO de VM através da CLI gcloud ou da API Batch.

gcloud

Para ver os detalhes de uma imagem do SO de VM a partir do Batch, use o comando gcloud compute images describe e especifique batch-custom-image como o projeto de imagem:

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

Substitua IMAGE_NAME pelo nome da imagem do SO da VM do Batch que quer descrever.

API

Para ver os detalhes de uma imagem do SO de VM do Batch, faça um pedido ao método images.get e especifique batch-custom-image como o projeto de imagem:

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

Substitua IMAGE_NAME pelo nome da imagem do SO da VM do Batch que quer descrever.

O que se segue?