Conferir imagens do SO da VM para o Batch

Nesta página, descrevemos como ver as imagens do sistema operacional (SO) disponíveis para as instâncias de máquina virtual (VM) que executam jobs em lote.

Especificamente, esta página descreve como ver uma lista e os detalhes das imagens do SO da VM do Batch. Para saber mais sobre imagens do SO de VM e quais imagens do SO de VM podem ser usadas com o Batch, consulte Visão geral do ambiente do SO de VM. Se quiser ver outras imagens de SO de VM, 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 você nunca usou o Batch, leia Começar a usar o Batch e ative o serviço concluindo os pré-requisitos para projetos e usuários.

Ver uma lista de imagens de SO de VM do Batch

É possível conferir uma lista de todas as imagens de SO de VM do Batch usando a CLI gcloud ou a API Batch.

gcloud

Para listar todas as imagens de SO de VM compatíveis do Batch, use o seguinte comando gcloud compute images list:

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

A saída para cada imagem do SO da VM é semelhante a esta:

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 da VM. Por exemplo, o nome da imagem batch-debian-11-official-20230802-00-p00 representa a versão -20230802-00-p00 (de 2 de agosto de 2023) para a família batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens do Batch 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 família de imagens batch-debian-11-official contém imagens do Batch baseadas na versão 11 do SO Debian do Compute Engine.

API

Para listar todas as imagens de SO de VM compatíveis do Batch, faça a seguinte solicitação 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 Batch.
  • O parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite imagens descontinuadas usando codificação de URL para definir o campo filter como (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Opcional: se você precisar ver imagens do Batch descontinuadas, remova o parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22).

A saída para cada imagem do SO da VM é semelhante a esta:

{
  ...
  "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 da VM. Por exemplo, o nome da imagem batch-debian-11-official-20230802-00-p00 representa a versão -20230802-00-p00 (de 2 de agosto de 2023) para a família batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens do Batch 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 família de imagens batch-debian-11-official contém imagens do Batch baseadas na versão 11 do SO Debian do Compute Engine.

Conferir detalhes de uma imagem do SO de VM no Batch

É possível conferir todos os detalhes de uma imagem do SO de VM usando a CLI gcloud ou a API Batch.

gcloud

Para conferir os detalhes de uma imagem do SO de VM do Batch, use o comando gcloud compute images describe e especifique batch-custom-image como o projeto da 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 você quer descrever.

API

Para conferir os detalhes de uma imagem de SO de VM do Batch, faça uma solicitação 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 você quer descrever.

A seguir