Nesta página, descrevemos como ver as imagens de sistema operacional (SO) disponíveis para as instâncias de máquina virtual (VM) que executam jobs do Batch.
Especificamente, esta página descreve como visualizar uma lista e detalhes de imagens do SO de VM no Batch. Para saber mais sobre as imagens do SO da VM e quais imagens do SO da VM podem ser usadas com o Batch, consulte Visão geral do ambiente do SO da VM. Se você quiser ver outras imagens do SO da VM, como imagens públicas do Compute Engine ou imagens personalizadas, consulte a documentação de imagens do Compute Engine.
Antes de começar
- Se você nunca usou o Batch, leia os Primeiros passos com o Batch e ative-o com os pré-requisitos para projetos e usuários.
Consulte uma lista de imagens de SO da VM do Batch
É possível visualizar uma lista de todas as imagens de SO da VM do Batch usando a CLI gcloud ou a API Batch.
gcloud
Para listar todas as imagens de SO da VM com suporte no Batch, use o seguinte comando gcloud compute images list
:
gcloud compute images list \
--project=batch-custom-image \
--no-standard-images
- A sinalização
--project=batch-custom-image
é necessária para listar imagens do Batch. - A sinalização
--no-standard-images
omite as imagens padrão do Compute Engine. - Opcional: se você precisar ver imagens em lote descontinuadas, inclua também a sinalização
--show-deprecated
.
A saída de 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 imagembatch-debian-11-official-20230802-00-p00
representa a versão-20230802-00-p00
(a versão de 2 de agosto de 2023) para a família de imagensbatch-debian-11-official
.IMAGE_PROJECT_ID
: o ID do projeto que contém a imagem. Por exemplo, todas as imagens de imagens do Batch estão no projetobatch-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 imagensbatch-debian-11-official
contém imagens em lote com base na versão 11 do Debian.
API
Para listar todas as imagens de SO da VM com suporte no Batch, 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 Batch. - 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 campofilter
como(-deprecated:*) OR (deprecated.state="ACTIVE")
.- Opcional: se você precisar ver imagens de lote descontinuadas, remova o parâmetro de consulta
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22)
.
- Opcional: se você precisar ver imagens de lote descontinuadas, remova o parâmetro de consulta
A saída de 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 imagembatch-debian-11-official-20230802-00-p00
representa a versão-20230802-00-p00
(a versão de 2 de agosto de 2023) para a família de imagensbatch-debian-11-official
.IMAGE_PROJECT_ID
: o ID do projeto que contém a imagem. Por exemplo, todas as imagens de imagens do Batch estão no projetobatch-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 imagensbatch-debian-11-official
contém imagens em lote com base na versão 11 do Debian.
Mais detalhes de uma imagem do SO da VM no Batch
É possível visualizar todos os detalhes de uma imagem do SO da VM usando a CLI gcloud ou a API Batch.
gcloud
Para ver os detalhes de uma imagem do SO da VM no 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 você quer descrever.
API
Para ver os detalhes de uma imagem do SO da 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
- Saiba mais sobre as imagens do SO da VM para lote: