Esta página descreve como exibir as imagens do sistema operacional (SO) disponíveis para instâncias de máquina virtual (VM) que executam jobs em lote;
Especificamente, esta página descreve como acessar uma lista e detalhes das imagens do SO da VM do Batch. Para saber mais sobre as imagens do SO de VM Imagens do SO da VM que podem ser usadas com o Batch. Consulte Visão geral do ambiente do SO da VM. Para acessar outras imagens do SO da VM, como imagens imagens do Compute Engine ou personalizadas, consulte a Documentação de imagens do Compute Engine.
Antes de começar
- Se você nunca usou o Batch antes, revise Introdução ao Batch e ativar o Batch. pré-requisitos para projetos e usuários.
Conferir uma lista de imagens do SO da VM do Batch
É possível ver uma lista de todas as imagens de SO da VM no Batch usando a CLI gcloud ou a API Batch.
gcloud
Para listar todas as imagens de SO de VM compatíveis no 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
é necessária para listar imagens do Batch. - A sinalização
--no-standard-images
omite as imagens padrão no Compute Engine. - Opcional: se você precisar ver o Batch descontinuado
de imagem, também incluem 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 de imagem-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 do projeto que contém a imagem. Por exemplo, todas as imagens de As imagens em lote 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 tipo e versão principal do SO. Por exemplo, a família de imagensbatch-debian-11-official
contém imagens em lote baseadas na versão 11 do SO do Debian do Compute Engine
API
Para listar todas as imagens de SO de VM compatíveis no Batch, faça o
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 em lote. - O
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%3D%22ACTIVE%22)
o parâmetro de consulta omite imagens descontinuadas usando Codificação para o URL para definir o campofilter
como(-deprecated:*) OR (deprecated.state="ACTIVE")
.- Opcional: se você precisar ver o Batch descontinuado
imagens, remova o
?filter=(-deprecated%3A*)%20OR%20(deprecated.state%20%3D%20%22ACTIVE%22)
parâmetro de consulta.
- Opcional: se você precisar ver o Batch descontinuado
imagens, remova o
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 de imagem-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 do projeto que contém a imagem. Por exemplo, todas as imagens de As imagens em lote 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 tipo e versão principal do SO. Por exemplo, a família de imagensbatch-debian-11-official
contém imagens em lote baseadas na versão 11 do SO do Debian do Compute Engine
Mais detalhes de uma imagem do SO da VM do Batch
É possível conferir todos os detalhes de uma imagem do SO da VM usando a CLI gcloud ou a API Batch.
gcloud
Para exibir os detalhes de uma imagem do SO da VM no Batch, use o
Comando gcloud compute images describe
e especificar batch-custom-image
como o projeto de imagem:
gcloud compute images describe IMAGE_NAME --project=batch-custom-image
Substitua IMAGE_NAME
pelo nome do
Imagem do SO da VM do Batch que você quer descrever.
API
Para visualizar os detalhes de uma imagem do SO da VM no Batch, faça uma
ao
Método images.get
e especificar 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 do
Imagem do SO da VM do Batch que você quer descrever.
A seguir
- Saiba mais sobre as imagens do SO da VM para o Batch: