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'
peeredNetworkIpRange: 'PEERED_NETWORK_IP_RANGE'
workerConfig:
diskSizeGb: 'PRIVATE_POOL_DISK_SIZE'
machineType: PRIVATE_POOL_MACHINE_TYPE
JSON
{
"privatePoolV1Config": {
"networkConfig": {
"egressOption": "NO_PUBLIC_EGRESS",
"peeredNetwork": "PEERED_NETWORK",
"peeredNetworkIpRange": "PEERED_NETWORK_IP_RANGE"
},
"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
Google 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.
peeredNetworkIpRange
Esse campo é opcional. Defina o valor deste campo para especificar o intervalo de IPs internos a que as VMs podem ser atribuídas, dentro do intervalo alocado da rede com peering. Se o intervalo de IP especificado não puder ser alocado dentro do intervalo da conexão particular, por exemplo, devido a limitações de tamanho ou um IP inicial inválido, não será possível criar o pool particular.
peeredNetworkIpRange
é especificado usando a notação de roteamento entre domínios sem classe (CIDR) no formato 'STARTING_IP/SUBNET_PREFIX_SIZE'
. Se esse campo for usado, será necessário especificar SUBNET_PREFIX_SIZE
. SUBNET_PREFIX_SIZE
determina o tamanho do intervalo de IP. Precisa começar com uma barra (/
) e ter um valor menor ou igual a 29. A parte STARTING_IP
é opcional e especifica o endereço inicial do intervalo. Se STARTING_IP
não for especificado, um endereço inicial será atribuído automaticamente de dentro do intervalo da conexão particular. Se nenhum valor for especificado para peeredNetworkIpRange
, será usado um valor padrão de /24
, que atribui automaticamente um IP inicial com um intervalo de 256 IPs.
O valor de SUBNET_PREFIX_SIZE
não pode exceder 29. Um número maior especifica um prefixo de sub-rede maior, o que deixaria menos IPs possíveis e resultaria em um intervalo de IP menor. Como um endereço IP tem 32 bits, o tamanho de prefixo /24
permite 256 IPs possíveis no intervalo (oito bits), enquanto o tamanho de prefixo /29
deixa oito IPs possíveis (três bits). O número máximo de VMs do builder é limitado ao número de IPs utilizáveis no intervalo (o número total possível de IPs no intervalo menos dois).
Consulte exemplos do campo peeredNetworkIpRange
a seguir:
192.168.0.0/24
especifica um intervalo de IPs a partir de 192.168.0.0 com um tamanho de prefixo de sub-rede de 24 (256 IPs, com 254 IPs utilizáveis)./29
especifica um intervalo com um IP inicial determinado automaticamente e um tamanho de prefixo de sub-rede de 29 (oito IPs, com seis IPs utilizáveis).
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 2.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-standard-2
.
A seguir
- Saiba como executar builds em pools particulares.
- Saiba como criar e gerenciar pools privados.