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

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. Instale a CLI do Google Cloud.

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

  7. Para inicializar a gcloud CLI, execute o seguinte comando: 

    gcloud init

  8. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. 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

  11. Instale a CLI do Google Cloud.

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

  13. Para inicializar a gcloud CLI, execute o seguinte comando: 

    gcloud init

Criar um pool particular

  1. No console do 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.

Captura de tela da página do pool particular

Executar um build em um pool particular

  1. Abra uma janela do 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