Um arquivo de configuração de pool particular (arquivo de configuração do pool particular) contém instruções para o Cloud Build criar um pool particular com base nas suas especificações. Um arquivo de configuração do pool particular 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 particular é necessário quando você cria e gerencia pools particulares
usando a ferramenta gcloud
ou a API do Cloud Build.
Estrutura de um arquivo de configuração de pool particular
É possível gravar o arquivo de configuração do pool particular usando a sintaxe YAML ou JSON. Para criar e gerenciar pools particulares usando curl
, grave
o arquivo de configuração do pool particular no formato JSON. Para criar e gerenciar pools de particulares usando a ferramenta gcloud
, grave o arquivo de configuração do pool particular no
formato YAML ou JSON.
A estrutura do arquivo de configuração da build do pool particular é a seguinte:
YAML
privatePoolV1Config:
networkConfig:
egressOption: NO_PUBLIC_EGRESS
peeredNetwork: PEERED_NETWORK
workerConfig:
diskSizeGb: 'PRIVATE_POOL_DISK_SIZE'
machineType: PRIVATE_POOL_MACHINE_TYPE
JSON
{
"privatePoolV1Config": {
"networkConfig": {
"egressOption": "NO_PUBLIC_EGRESS",
"peeredNetwork": "PEERED_NETWORK"
},
"workerConfig": {
"diskSizeGb": "PRIVATE_POOL_DISK_SIZE",
"machineType": "PRIVATE_POOL_MACHINE_TYPE"
}
}
}
Os campos do arquivo de configuração do pool particular 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 particular, 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 particular 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 1.000. Se você não incluir esse campo no arquivo de configuração do pool particular 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-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
- Saiba como executar builds em pools particulares.
- Saiba como criar e gerenciar pools privados.