Criar e executar um build em um pool particular

Criar e executar um build em um pool particular

Nesta página, explicamos como criar um pool particular do Cloud Build conectado à rede do produtor de serviços e como executar uma versão no pool particular.

A rede do produtor de serviços é a rede que hospeda o pool particular. Por padrão, um pool particular é configurado para usar a rede do produtor de serviços, que fornece um ambiente de build com:

• Tipos de máquina configuráveis
• Tamanhos de disco configuráveis
• Acesso a recursos na Internet pública, como recursos em um repositório ou registro

---

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

---

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Install the Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Install the Google Cloud CLI.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

Se você já instalou a Google Cloud CLI, verifique se tem a versão mais recente disponível executando gcloud components update.

Criar um pool particular

1. No console Google Cloud , abra a guia Pool de worker do Cloud Build:

   Abra a guia "Pool de workers do Cloud Build"

2. Clique em Criar.

3. No painel Criar pool particular, insira as seguintes configurações:

   1. No campo Nome, digite my-first-privatepool.

   2. No campo Região, selecione us-central1.

   3. No campo Tipo de máquina, selecione e2-standard-2.

   4. No campo Tamanho do disco disponível, digite 800.

   5. Deixe o campo Número do projeto de rede em branco.

   6. Deixe o campo Rede em branco.

   7. Verifique se a opção Atribuir IPs externos está selecionada.

Clique em Criar para criar o pool particular.

Aguarde um pouco para que o pool particular seja criado. Depois que o pool particular é criado, ele é listado na guia Pool de workers.



Executar um build em um pool particular

1. Abra uma janela de terminal.

2. Crie um novo diretório chamado quickstart-private-pool e navegue até ele:

   mkdir quickstart-private-pool
   cd quickstart-private-pool
   

3. Crie um arquivo chamado cloudbuild.yaml com o seguinte conteúdo:

   steps:
   - name: "bash"
     script: echo "I am running in a private pool!"
   options:
     pool:
       name: "projects/$PROJECT_ID/locations/us-central1/workerPools/my-first-privatepool"
   

4. Inicie a compilação usando o arquivo de configuração da compilação:

   gcloud builds submit
   

Quando o build for concluído, você verá um resultado semelhante a este:

I am running in a private pool!
PUSH
DONE
------------------------------------------------------------------------------------------------------------------------------------     ------------------------------------------------------------------------

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                       IMAGES  STATUS
5df45735-6414-40b7-9e10-e6d2023c8cea  2020-08-31T13:16:18+00:00  10S       gs://private-pool-test_cloudbuild/source/1598879777.206444-    58901ecbd14e431f8cdacc85d5dd0fc3.tgz  -       SUCCESS

Ver detalhes do build

1. Abra a página Histórico do build no console do Google Cloud .

   Abra a página do Cloud Build

2. Na caixa suspensa Região, selecione us-central1.

   Você vai ver o build executado no pool particular:


3. Clique no build para ver os detalhes, como resumo e artefatos.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

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

   Abra a página do pool privado do Cloud Build

2. Na linha do pool particular, clique no ícone da lixeira.

3. Na caixa pop-up Excluir pool particular?, clique em Excluir.

O pool particular que você criou como parte deste guia de início rápido foi excluído. Observação: pode ser necessário atualizar a tela para excluir o pool particular da página Pool de workers.

A seguir

• Veja como criar uma conexão de peering de VPC particular.
• Saiba mais sobre pools privados.