Esquema do arquivo de configuração do pool particular

Um arquivo de configuração de pool de workers (arquivo de configuração do pool de workers) contém instruções para o Cloud Build criar um pool particular com base nas suas especificações. Esse arquivo contém informações, como o tamanho do disco e o tipo de máquina que você quer usar no pool particular. O arquivo de configuração do pool de workers é necessário para criar e gerenciar pools particulares usando a ferramenta gcloud ou a API Cloud Build.

Estrutura de um arquivo de configuração do pool de worker

É possível gravar o arquivo de configuração do pool de worker usando a sintaxe YAML ou JSON. Para criar e gerenciar pools particulares usando curl, grave o arquivo de configuração do pool de workers no formato JSON. Para criar e gerenciar pools privados usando a ferramenta gcloud, grave o arquivo de configuração do pool de workers no formato YAML ou JSON.

A estrutura do arquivo de configuração da build do pool de workers é a seguinte:

YAML

privatePoolV1Config:
  networkConfig:
    egressOption: NO_PUBLIC_EGRESS
    peeredNetwork: PEERED_NETWORK
  workerConfig:
    diskSizeGb: 'WORKER_POOL_DISK_SIZE'
    machineType: WORKER_POOL_MACHINE_TYPE

JSON

{
  "privatePoolV1Config": {
    "networkConfig": {
      "egressOption": "NO_PUBLIC_EGRESS",
      "peeredNetwork": "PEERED_NETWORK"
    },
    "workerConfig": {
      "diskSizeGb": "WORKER_POOL_DISK_SIZE",
      "machineType": "WORKER_POOL_MACHINE_TYPE"
    }
  }
}

Os campos do arquivo de configuração do pool dos workers são explicados abaixo:

networkConfig

Esse campo é opcional. Especifique networkConfig somente se estiver fazendo peering da rede VPC com a rede do produtor de serviços.

egressOption

Esse campo é opcional. Defina o valor desse campo como NO_PUBLIC_EGRESS se você estiver criando seu pool particular em um perímetro do VPC Service Controls. Se você não incluir esse campo no arquivo de configuração do pool do worker, a saída pública será ativada. Para informações sobre como configurar o VPC Service Controls para pools particulares, consulte Como usar o VPC Service Controls.

peeredNetwork

Este é um campo obrigatório se o arquivo de configuração do pool de workers contiver o campo networkConfig. Defina o valor desse campo como o URL de recurso da rede VPC que tem peering com a rede do produtor de serviços. O URL do recurso de rede precisa estar no formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, em que NETWORK_PROJECT_ID é o ID do projeto do Cloud que contém sua rede VPC e NETWORK_NAME é o nome da sua rede VPC. Se você não especificar um valor, o Cloud Build usará a rede do produtor de serviços por padrão.

workerConfig

Este campo é obrigatório. Ele contém opções de configuração para seu pool particular.

diskSizeGb

Esse campo é opcional. Use esse campo para especificar um tamanho de disco para sua instância de pool particular em GB. Especifique um valor maior ou igual a 100 e menor ou igual a 1000. Se você não incluir esse campo no arquivo de configuração do pool de workers ou se especificar 0 como o valor desse campo, o Cloud Build usará o valor padrão 100.

machineType

Esse campo é opcional. Use esse campo para especificar o tipo de máquina do Compute Engine para a instância do pool particular. Especifique um dos seguintes tipos de máquina:

+ `e2-medium`
+ `e2-standard-2`
+ `e2-standard-4`
+ `e2-standard-8`
+ `e2-standard-16`
+ `e2-standard-32`
+ `e2-highmem-2`
+ `e2-highmem-4`
+ `e2-highmem-8`
+ `e2-highmem-16`
+ `e2-highmem-32`
+ `e2-highcpu-2`
+ `e2-highcpu-4`
+ `e2-highcpu-8`
+ `e2-highcpu-16`
+ `e2-highcpu-32`

Se você não especificar um valor, o Cloud Build usará o valor padrão de e2-medium.

A seguir