Esta página foi traduzida pela API Cloud Translation.

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 projeto do Google Cloud ou escolha um projeto existente. Você usará esse projeto para criar o pool privado.
Enable the Cloud Build API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API
Para usar os exemplos de linha de comando neste guia, instale e configure a Google Cloud CLI.

Observação: se você já instalou a CLI gcloud, verifique se 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: conheça as configurações de tipo de máquina e a disponibilidade regional. Para mais informações, consulte workerconfig na documentação do esquema do arquivo de configuração do pool particular.

Criar um pool particular

Para receber as permissões necessárias para criar um pool particular, peça ao administrador para conceder a você o papel do IAM de Proprietário do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolOwner) 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.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

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

Console do Google Cloud

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

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

A página Criar pool particular é exibida.

Insira as seguintes informações para criar seu pool particular:
Nome: insira 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 selecionada, que o pool de trabalhadores 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, é possível ativar a virtualização aninhada. Com esse recurso, é possível executar instâncias de máquina virtual (VM) dentro de outras VMs para 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 está selecionada, seu 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 seu Google Cloud ID do projeto.
  2. Rede: selecione sua rede no menu suspenso. Se você ainda não criou uma rede, consulte Criar e gerenciar redes VPC para saber como fazer isso.
  3. Intervalo de IP: insira o intervalo de IP interno que a rede produtora do Cloud Build pode usar para alocar às VMs, mantendo 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 hosts 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 tamanho 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, ele será automaticamente atribuído a um intervalo na rede VPC pareada.
    
    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 privados acessem a Internet pública. Desmarque essa caixa para restringir o acesso à sua rede privada.
Clique em Criar para criar seu pool particular.

gcloud

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

Transmita 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

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

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 do projeto 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 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 receber as permissões necessárias para criar um pool particular, peça ao administrador para conceder a você o papel do IAM de Editor do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolEditor) 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.

Também é possível conseguir as permissões necessárias usando 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 console Google Cloud :

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 mudar no 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
```

Passe 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 código 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.

Ver os detalhes do pool particular

Para receber as permissões necessárias para criar um pool particular, peça ao administrador para conceder a você o papel do IAM de Leitor do WorkerPool do Cloud Build (roles/cloudbuild.workerPoolViewer) 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.

Também é possível conseguir as permissões necessárias usando 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 console Google Cloud :

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 é 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 projetoGoogle Cloud 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 comando cURL para listar os detalhes do pool, em que PRIVATEPOOL_PROJECT_ID é o ID do projeto Google Cloud 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:

    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 custará a execução do pool por mês. O cálculo se baseia 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

A estimativa de preços não inclui custos de tamanho de disco adicional 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 final do build, dos minutos reais usados e de outros fatores. Para mais informações, consulte Preços do Cloud Build.

Excluir um pool particular

Também é possível conseguir as permissões necessárias usando 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 console Google Cloud :

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 comando gcloud builds worker-pools delete:

 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

Console do Google Cloud

gcloud

API

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

Atualizar um pool particular

Console

gcloud

API

Ver 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