Criar e executar um job que usa discos de inicialização personalizados

Esta página descreve como personalizar os discos permanentes usados para inicializar cada instância de máquina virtual (VM) em que um job é executado.

Especificamente, é possível personalizar o tamanho, o tipo e/ou a imagem do sistema operacional (SO) da VM para um disco de inicialização. Se você quiser apenas personalizar a imagem do SO da VM, consulte Especificar a imagem do SO da VM para um job.

Para saber mais sobre discos de inicialização e quando configurar discos de inicialização, 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 um disco de inicialização personalizado

Especifique um disco de inicialização personalizado ao criar um job selecionando um destes métodos:

  • Use um modelo de instância do Compute Engine que especifique um disco de inicialização personalizado preexistente. Se você quiser usar um modelo de instância de VM ao criar esse job ou usar um disco de inicialização personalizado, siga estas etapas:

    1. Crie ou identifique um disco de inicialização personalizado.

      Para conferir os requisitos de disco de inicialização do Batch, consulte este documento e Visão geral do ambiente do SO da VM. Para instruções sobre como criar um disco de inicialização, consulte Criar um disco de inicialização personalizado na documentação do Compute Engine.

    2. Crie ou identifique um modelo de instância de VM que inclua esse disco de inicialização personalizado.

      Para instruções sobre como criar um modelo de instância de VM, consulte Criar modelos de instância na documentação do Compute Engine.

    3. Crie e execute um job que inclua esse modelo de instância de VM.

      Para instruções sobre como criar e executar o job, consulte Definir recursos de job usando um modelo de instância de VM.

  • Use o campo "boot disk" para especificar um novo disco de inicialização personalizado. Conforme explicado nas instruções a seguir, é possível definir um novo disco de inicialização personalizado usando o campo boot disk (bootDisk) ao criar e executar um job usando a CLI gcloud ou a API Batch.

    Especificamente, é possível personalizar o disco de inicialização configurando os subcampos da imagem do SO da VM (image), do tipo de disco permanente (type) e/ou do tamanho (sizeGb). O lote define um valor padrão para qualquer um desses subcampos que você decide omitir.

gcloud

  1. Crie um arquivo JSON que especifique os detalhes de configuração do job. Para especificar um novo disco de inicialização personalizado para as VMs do job, inclua o campo e os subcampos bootDisk.

    Por exemplo, para criar um job de script básico que usa um novo disco de inicialização personalizado, 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",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

    Substitua:

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

      • Especifique um prefixo do Batch OS. 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 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 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.

    • BOOT_DISK_TYPE: o tipo de disco de inicialização, pd-standard, pd-balanced, pd-ssd ou pd-extreme. O tipo de disco padrão para discos de inicialização é pd-balanced.

    • BOOT_DISK_SIZE: o tamanho do novo disco de inicialização permanente em GB. Esse valor precisa obedecer a todos os requisitos de tamanho do disco de inicialização.

  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 local 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 do job. Para especificar a imagem do SO da VM para o job, inclua o campo e os subcampos bootDisk. Por exemplo, para criar um job de script básico que usa um novo disco de inicialização personalizado, 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",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Substitua:

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

    • Especifique um prefixo do Batch OS. 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 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 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.

  • BOOT_DISK_TYPE: o tipo de disco de inicialização, pd-standard, pd-balanced, pd-ssd ou pd-extreme. O tipo de disco padrão para discos de inicialização é pd-balanced.

  • BOOT_DISK_SIZE: o tamanho do novo disco de inicialização permanente em GB. Esse valor precisa obedecer a todos os requisitos de tamanho do disco de inicialização.

A seguir