Conferir imagens do SO da VM para o Batch

Esta página descreve como visualizar as imagens do sistema operacional (SO) disponíveis para as instâncias de máquina virtual (VM) que executam trabalhos em lote.

Especificamente, esta página descreve como conferir uma lista e detalhes das imagens do SO da VM no Batch. Para saber mais sobre as imagens do SO da VM e quais você pode usar com o Batch, consulte Visão geral do ambiente do SO da VM. Para conferir outras imagens do SO da VM, como imagens públicas do Compute Engine ou personalizadas, consulte a documentação de imagens do Compute Engine.

Antes de começar

  1. Se você nunca usou o Batch, consulte Começar a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e usuários.

Conferir uma lista de imagens do SO da VM no Batch

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

gcloud

Para listar todas as imagens do SO da VM com suporte no lote, 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 é necessária para listar imagens do lote.
  • A flag --no-standard-images omite as imagens padrão do Compute Engine.
  • Opcional: se você precisar ver imagens de lote descontinuadas, também inclua 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 (a versão de 2 de agosto de 2023) da família de imagens batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens de imagens em lote 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 de lote baseadas na versão 11 do SO do Debian do Compute Engine.

API

Para listar todas as imagens do SO da VM com suporte no lote, faça a seguinte solicitação para o 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 lote.
  • O parâmetro de consulta ?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22) omite imagens descontinuadas usando a codificação de URL para definir o campo filter como (-deprecated:*) OR (deprecated.state="ACTIVE").
    • Opcional: se você precisar ver imagens descontinuadas do Batch, 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 (a versão de 2 de agosto de 2023) da família de imagens batch-debian-11-official.
  • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, todas as imagens de imagens em lote 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 de lote baseadas na versão 11 do SO do Debian do Compute Engine.

Conferir detalhes de uma imagem do SO da VM no Batch

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

gcloud

Para conferir os detalhes de uma imagem do SO da VM no lote, 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 lote que você quer descrever.

API

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

A seguir