Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Criar e gerenciar pools particulares

Nesta página, descrevemos como criar, atualizar, visualizar e excluir pools particulares do Cloud Build. Se você não conhece os pools privados, leia a Visão geral dos pools privados.

Antes de começar

Crie um novo Google Cloud projeto ou escolha um projeto atual. Você usará esse projeto para criar o pool privado.
Ative a API Cloud Build.
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.
Ativar a API
Para usar os exemplos de linha de comando deste guia, instale e configure a Google Cloud CLI.

**Observação**: se você já tiver instalado a CLI gcloud, verifique se você tem a versão mais recente disponível executando gcloud components update.
Opcional: para que os builds acessem recursos particulares da sua rede de nuvem privada virtual, é necessário configurar uma conexão de peering entre sua rede de nuvem privada virtual e a rede de nuvem privada virtual em que os pools privados residem. Para mais instruções, consulte Configurar o ambiente para criar pools particulares.
Opcional: familiarize-se com as configurações de tipo de máquina e a disponibilidade regional. Para mais informações, consulte workerconfig na documentação do esquema de arquivo de configuração do pool particular.

Criar um pool particular

Para garantir que tenha as permissões necessárias para criar um pool particular, peça ao administrador para conceder opapel do IAM de proprietário do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolOwner) a na sua conta de serviço. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Seu administrador também pode conceder as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

É possível criar até 10 pools particulares por Google Cloud projeto por região. Para criar um pool particular, faça o seguinte:

Google Cloud Console

Abra a página Pool de worker no Google Cloud console:

Abrir a página do pool de worker do Cloud Build
Clique em Criar pool particular.

A página Criar pool particular será exibida.

Insira as seguintes informações para criar seu pool particular:
Nome: digite um nome para o pool particular. Esse valor só pode conter caracteres alfanuméricos /[a-z][0-9]/ ou traços -. O nome do pool particular precisa ter entre 1 e 63 caracteres.
Região: selecione a região em que você quer que o pool particular seja criado.
Configuração da máquina: configure o seguinte:
1. Série: escolha uma série de máquinas.
2. Tipo de máquina: essa configuração mostra os tipos de máquina, com base na série de máquinas selecionada, que o pool de worker pode usar. Os tipos de máquina disponíveis variam de acordo com a região.
3. Tamanho do disco: insira um tamanho de disco para o pool particular. Especifique um valor maior ou igual a 100 e menor ou igual a 4.000. Se você não fornecer um valor, o Cloud Build usará um tamanho de disco de 100.
4. Virtualização aninhada: se você selecionou uma máquina da série C3, poderá ativar a virtualização aninhada. Esse recurso permite executar instâncias de máquina virtual (VM) dentro de outras VMs para que você possa criar seus próprios ambientes de virtualização.
Em Tipo de rede, selecione uma das seguintes opções:
1. Rede padrão: selecione essa opção se a instância estiver acessível pela Internet pública. Quando a opção Rede padrão é selecionada, o pool particular usa a rede do produtor de serviços. Para mais informações, consulte Configurar o ambiente para usar pools particulares em uma rede VPC.
2. Rede particular: selecione essa opção se a instância estiver hospedada em uma rede particular e faça o seguinte:
  1. Projeto: selecione o ID do Google Cloud projeto.
  2. Rede: selecione sua rede no menu suspenso. Se você não tiver criado uma rede, consulte Criar e gerenciar redes VPC para saber como criar uma rede.
  3. Intervalo de IP: insira o intervalo de IP interno que a rede do produtor do Cloud Build pode usar para alocar VMs que mantêm uma conexão com repositórios particulares.
    
    É possível especificar o intervalo usando a notação de roteamento entre domínios sem classe (CIDR) no formato STARTING_IP_ADDRESS/SUBNET_PREFIX_SIZE. Por exemplo, 192.0.2.0/24 tem um comprimento de prefixo de 24. Os primeiros 24 bits do intervalo de IP são usados como a máscara de sub-rede (192.0.2.0), enquanto os possíveis endereços de host variam de 192.0.2.0 a 192.0.2.255.
    
    O valor do comprimento do prefixo não pode exceder /29. Se nenhum valor for especificado para o intervalo, um valor padrão de /24 será atribuído automaticamente. Se nenhum valor for especificado para o comprimento do prefixo, os endereços IP serão atribuídos automaticamente na rede VPC em peering. Se nenhum valor for especificado para o endereço IP, um intervalo será atribuído automaticamente ao endereço IP na rede VPC em peering.
    
    Observação: só é possível especificar um intervalo de IP se você tiver especificado uma rede. Se você especificou uma rede, o intervalo de IP é opcional.
3. Atribuir IPs externos: Essa opção é selecionada por padrão para permitir que pools particulares acessem a Internet pública. Desmarque essa caixa para restringir o acesso à sua rede particular.
Clique em Criar para criar seu pool particular.

gcloud

Você tem duas opções para criar um novo pool particular usando gcloud: é possível transmitir o arquivo de configuração do pool particular para o comando gcloud ou transmitir as opções de configuração diretamente para o comando gcloud.

Transmitir o arquivo de configuração do pool particular para o comando gcloud

Crie o arquivo de configuração do pool particular no formato YAML ou JSON.

Execute o seguinte comando gcloud, em que PRIVATEPOOL_ID é um identificador exclusivo para seu pool particular, PRIVATEPOOL_CONFIG_FILE é o nome do arquivo de configuração do pool particular e REGION é o região em que você quer criar o pool particular:

gcloud builds worker-pools create PRIVATEPOOL_ID --config-from-file PRIVATEPOOL_CONFIG_FILE --region REGION

O resultado será semelhante a este:

Created [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/private-pool].
NAME                 CREATE_TIME                STATUS
private-pool  2018-11-19T16:08:24+00:00  RUNNING

Transmitir as opções de configuração diretamente para o comando gcloud command:

Execute o seguinte comando gcloud:

    gcloud builds worker-pools create PRIVATEPOOL_ID \
        --project=PRIVATEPOOL_PROJECT_ID \
        --region=REGION \
        --peered-network=PEERED_NETWORK \
        --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE \
        --worker-disk-size=PRIVATEPOOL_DISK_SIZE_GB \
        --no-public-egress

Em que:

PRIVATEPOOL_ID: um identificador exclusivo para seu pool particular. Esse valor precisa ter de 1 a 63 caracteres, e os caracteres válidos são [a-zA-Z0-9_-]+.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto em que você quer criar o pool particular.
REGION: uma das regiões compatíveis.
PEERED_NETWORK: o URL do recurso da rede que está em peering com a rede do produtor de serviços. PEERED_NETWORK precisa ter o formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, em que NETWORK_PROJECT_ID é o ID do projeto que contém sua rede VPC e NETWORK_NAME é o nome da sua rede VPC. Google Cloud Se você não especificar um valor, o Cloud Build usará a rede do provedor de serviços.
PRIVATEPOOL_DISK_SIZE_GB: o tamanho do disco anexado ao pool particular. Especifique um valor maior ou igual a 100 e menor ou igual a 4.000. Se não for fornecido, o Cloud Build usará um tamanho de disco de 100. --worker-disk-size será modificado se você especificar um tamanho de disco diferente usando --disk-size durante gcloud builds submit.
PRIVATEPOOL_MACHINE_TYPE: o tipo de máquina do worker. Se deixado em branco, o Cloud Build usará o valor padrão de e2-standard-2. Para uma lista de tipos de máquina compatíveis, consulte Esquema de arquivo de configuração do pool particular. --worker-machine-type: será modificado se você especificar um tipo de máquina diferente usando --machine-type durante gcloud builds submit.
--no-public-egress: se essa sinalização for definida, o pool privado será criado sem um endereço IP externo. Defina essa sinalização se estiver criando o pool particular em um perímetro do VPC Service Controls.

API

Crie o arquivo de configuração do pool particular chamado workerpool.json.
Use cURL para chamar a API Cloud Build:
```
    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -H "Content-Type: application/json" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/?workerPoolId=PRIVATEPOOL_ID -d @workerpool.json
```
Em que:
- PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto em que você quer criar o pool particular.
- PRIVATEPOOL_ID: o ID do pool particular. Esse valor precisa ter de 1 a 63 caracteres, e os caracteres válidos são [a-zA-Z0-9_-]+.
- REGION: uma das regiões compatíveis para criar seu pool particular.

Criar um pool particular em um perímetro do VPC Service Controls

Para criar um pool particular com um perímetro do VPC Service Controls, consulte Como usar o VPC Service Controls.

Atualizar um pool particular

Para garantir que tenha as permissões necessárias para criar um pool particular, peça ao administrador para conceder o papel do IAM de editor do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolEditor) a na sua conta de serviço. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Seu administrador também pode conceder as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Para atualizar a configuração de um pool particular, faça o seguinte:

Console

Abra a página Pool de worker no Google Cloud console:

Abrir a página do pool de worker do Cloud Build
Selecione o projeto em que você criou o pool particular.
Clique no nome do pool particular.
Na página Editar pool particular, atualize o tipo de máquina e o tamanho do disco conforme necessário.
Clique em Salvar.

gcloud

Como atualizar o arquivo de configuração do pool particular:

Atualize o campo que você quer alterar no seu arquivo de configuração do pool particular.
Execute o seguinte comando, em que PRIVATEPOOL_ID é o identificador exclusivo do seu pool particular, REGION é a região em que o pool particular está localizado e PRIVATEPOOL_CONFIG_FILE é o nome do arquivo de configuração do pool particular:
```
gcloud builds worker-pools update PRIVATEPOOL_ID \
    --region=REGION \
    --config-from-file=PRIVATEPOOL_CONFIG_FILE
```

Transmitir o valor para atualizar diretamente para o comando gcloud builds worker-pools update

   gcloud builds worker-pools update PRIVATEPOOL_ID \
       --region=REGION \
       --worker-disk-size=PRIVATEPOOL_DISK_SIZE \
       --worker-machine-type=PRIVATEPOOL_MACHINE_TYPE

Em que:

PRIVATEPOOL_ID: o ID do pool particular atual; Não é possível atualizar esse valor; é preciso especificar um ID de pool particular existente.
REGION: a região em que você criou o pool particular.
PRIVATEPOOL_DISK_SIZE: o tamanho do disco atualizado.
PRIVATEPOOL_MACHINE_TYPE é o tipo de máquina atualizado.

API

No arquivo de configuração do pool particular, atualize o tamanho do disco e o tipo de máquina conforme necessário.

Use cURL para chamar a API Cloud Build, com a substituição das variáveis pelos valores adequados:

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID \
    -d @workerpool.json

Em que:

PRIVATEPOOL_ID: o ID do pool particular.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto que contém o pool particular.
REGION: a região em que você criou o pool particular.

Visualizar os detalhes do pool particular

Para garantir que tenha as permissões necessárias para criar um pool particular, peça ao administrador para conceder o papel do IAM de visualizador do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolViewer) a na sua conta de serviço. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Seu administrador também pode conceder as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Para ver os detalhes de um pool particular, siga estas etapas:

Console

Abra a página Pool de worker no Google Cloud console:

Abrir a página do pool de worker do Cloud Build
Selecione o projeto em que você criou o pool particular
Clique no nome do pool particular.

A página Editar pool particular será exibida.

gcloud

Se você não souber o ID do pool particular, execute o seguinte comando para listar os detalhes do pool particular:

gcloud builds worker-pools list --region=REGION --project=PRIVATEPOOL_PROJECT_ID

Em que:

PRIVATEPOOL_PROJECT_ID é o ID do Google Cloud projeto que contém o pool particular.
REGION é a região do pool particular.

O resultado será semelhante a este:

NAME                                                                  CREATE_TIME                STATUS
projects/[PRIVATEPOOL_PROJECT_ID]/locations/us-central1/workerPools/[PRIVATEPOOL_ID]      2018-11-19T16:08:24+00:00  RUNNING

Se você souber o ID do pool particular, execute o seguinte comando para receber mais informações sobre o pool:

gcloud builds worker-pools describe PRIVATEPOOL_ID \
    --region=REGION \
    --project=PRIVATEPOOL_PROJECT_ID

Onde

PRIVATEPOOL_ID: o ID do pool particular.
REGION: a região em que você criou o pool particular.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto que contém o pool particular.

API

Se você não souber o ID do pool particular, execute o seguinte cURL comando para listar os detalhes do pool particular, em que PRIVATEPOOL_PROJECT_ID é o ID do Google Cloud projeto que contém o pool particular:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools

Se você souber o ID do pool particular, execute o seguinte comando curl para ver os detalhes do pool particular:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Onde

PRIVATEPOOL_ID: o ID do pool particular.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto que contém o pool particular.
REGION: a região em que você criou o pool particular.

Ver estimativas de preços de pools particulares

Ao criar ou atualizar um pool particular, a barra lateral Estimativa mensal nas páginas Criar pool particular e Editar pool particular mostra uma estimativa de quanto o pool vai custar por mês. O cálculo é baseado nos seguintes fatores:

Número de CPUs virtuais
Tipo de máquina
Memória
Minutos de build
Região, somente para máquinas N2D e C3

O preço estimado não inclui custos por tamanho de disco extra além dos 100 GB incluídos por padrão. O preço estimado pode ser diferente do preço final, dependendo da configuração do build final, dos minutos de build reais usados e de outros fatores. Para mais informações, consulte Preços do Cloud Build.

Excluir um pool particular

Seu administrador também pode conceder as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Para excluir um pool particular, faça o seguinte:

Console

Abra a página Pool de worker no Google Cloud console:

Abrir a página do pool de worker do Cloud Build
Na linha do seu pool particular, clique no ícone da lixeira.

gcloud

Para excluir um pool particular, execute o gcloud builds worker-pools delete comando:

 gcloud builds worker-pools delete PRIVATEPOOL_ID \
     --region=REGION \
     --project=PRIVATEPOOL_PROJECT_ID

Em que:

PRIVATEPOOL_ID: o ID do pool particular.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto que contém o pool particular.
REGION: a região em que você criou o pool particular.

Depois que o pool privado for excluído, você verá uma saída semelhante a esta:

 Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[PRIVATEPOOL_ID].

API

Use cURL para chamar a API Cloud Build:

  curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools/PRIVATEPOOL_ID

Em que:

PRIVATEPOOL_ID: o ID do pool particular.
PRIVATEPOOL_PROJECT_ID: o ID do Google Cloud projeto que contém o pool particular.
REGION: a região em que você criou o pool particular.

A seguir

Saiba como executar builds em pools particulares.
Saiba como usar o VPC Service Controls com pools privados.

Criar e gerenciar pools particulares Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar um pool particular

Google Cloud Console

gcloud

API

Criar um pool particular em um perímetro do VPC Service Controls

Atualizar um pool particular

Console

gcloud

API

Visualizar os detalhes do pool particular

Console

gcloud

API

Ver estimativas de preços de pools particulares

Excluir um pool particular

Console

gcloud

API

A seguir

Criar e gerenciar pools particulares