Especificar a imagem do SO da VM para um job

Esta página descreve como especificar a imagem do sistema operacional (SO) para as instâncias de máquina virtual (VM) em que um job é executado. Se você também quiser personalizar outras propriedades dos discos de inicialização do job, consulte Criar e executar um job que usa discos de inicialização personalizados como alternativa.

Para saber mais sobre as imagens do SO da VM e quais delas você pode usar, consulte Visão geral do ambiente do SO da VM.

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.

  2. Para receber as permissões necessárias para criar um job, peça ao administrador para conceder a você os seguintes papéis do IAM:

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Criar e executar um job que usa uma imagem específica do SO da VM

Especifique a imagem do SO da VM ao criar um job selecionando um dos seguintes métodos:

  • Use um modelo de instância do Compute Engine que especifique uma imagem do SO da VM. Se você quiser usar um modelo de instância de VM durante a criação desse job, especifique a imagem do SO da VM no modelo de instância. Para mais instruções, consulte Definir recursos de job usando um modelo de instância de VM.

  • Use o campo de imagem do SO da VM. Como explicado nas instruções a seguir, é possível especificar a imagem do SO da VM Campo image usando a CLI gcloud ou a API Batch.

gcloud

  1. Crie um arquivo JSON que especifique os detalhes de configuração do job. Para especificar a imagem do SO da VM para o job, inclua o campo image.

    Por exemplo, para criar um job de script básico que usa uma imagem do SO da VM específica, crie um arquivo JSON com o seguinte conteúdo:

    {
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI"
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

    Substitua VM_OS_IMAGE_URI por uma nome de recurso relativo da imagem do SO da VM. Use uma das seguintes opções:

    • Especificar um prefixo do SO do Batch. Para usar a imagem mais recente de um SO de lote específico, use o seguinte formato:

      BATCH_OS_PREFIX

      Substitua BATCH_OS_PREFIX por um dos prefixos de imagem do SO da VM de lote. Por exemplo, batch-debian é o prefixo do SO Debian de lote.

    • Especifique uma família de imagens. Para usar a imagem mais recente de uma família de imagens específica, use o seguinte formato:

      projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

      Substitua:

      • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, para todos os Imagens em lote, especifique batch-custom-image.
      • IMAGE_FAMILY: a família de imagens, que inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, para ver todas as famílias de imagens do SO da VM da Lote, veja uma lista de imagens do SO da VM.

    • Especifique uma versão da imagem. Para usar uma versão específica de um SO de VM use o seguinte formato:

      projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

      Substitua:

      • IMAGE_PROJECT_ID: o ID do projeto que contém a imagem. Por exemplo, para todas as imagens em lote, especifique batch-custom-image.
      • IMAGE_NAME: o nome da imagem, que representa uma versão específica de uma imagem do SO da VM. Por exemplo, para conferir todas as versões da imagem do SO da VM no lote, confira uma lista de imagens do SO da VM.

  2. Para criar o job, execute o seguinte Comando gcloud batch jobs submit:

    gcloud batch jobs submit JOB_NAME \
    --location LOCATION \
    --config JSON_CONFIGURATION_FILE

    Substitua:

    • JOB_NAME: o nome do job.
    • LOCATION: o location do job.
    • JSON_CONFIGURATION_FILE: o caminho para o Arquivo JSON com os detalhes de configuração do job.

API

Para criar um job usando a API Batch, use o Método jobs.create e especifique os detalhes de configuração dele. Para especificar a imagem do SO da VM para o job, inclua o campo image. Por exemplo, para criar um job de script básico que use uma imagem do SO da VM específica, faça a seguinte solicitação POST:

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI"
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Substitua:

  • PROJECT_ID: o ID do projeto do seu projeto.
  • LOCATION: o local do job.
  • JOB_NAME: o nome do job.

  • VM_OS_IMAGE_URI: um nome de recurso relativo da imagem do SO da VM. Use uma das seguintes opções:

    • Especificar um prefixo do SO do Batch. Para usar a versão mais recente imagem de um SO do Batch específico, use o formato:
    BATCH_OS_PREFIX

    Substitua BATCH_OS_PREFIX por um dos prefixos de imagem do SO da VM de lote. Por exemplo, batch-debian é o prefixo do SO Debian de lote.

    • Especifique uma família de imagens. Para usar a imagem mais recente de uma família de imagens específica, use o seguinte formato:

      projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

      Substitua:

      • IMAGE_PROJECT_ID: o ID do projeto do projeto que contém a imagem. Por exemplo, para todas as imagens em lote, especifique batch-custom-image.
      • IMAGE_FAMILY: a família de imagens, que inclui uma ou mais imagens específicas e representa o tipo e a versão principal do SO. Por exemplo, para conferir todas as famílias de imagens do SO da VM no lote, confira uma lista de imagens do SO da VM.

    • Especifique uma versão da imagem. Para usar uma versão específica de uma imagem do SO da VM, use o seguinte formato:

      projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

      Substitua:

      • IMAGE_PROJECT_ID: o ID do projeto do projeto que contém a imagem. Por exemplo, para todas as imagens em lote, especifique batch-custom-image.
      • IMAGE_NAME: o nome da imagem, que representa uma versão específica de uma imagem do SO da VM. Por exemplo, para ver todas as versões de imagem do SO da VM da Lote, veja uma lista de imagens do SO da VM.

A seguir