Crie e execute uma compilação num conjunto privado

Esta página explica como criar um pool privado do Cloud Build ligado à rede do produtor de serviços e executar uma compilação no pool privado.

A rede do produtor de serviços é a rede que aloja o pool privado. Por predefinição, um conjunto privado é configurado para usar a rede do produtor de serviços, que fornece um ambiente de compilação com:

  • Tipos de máquinas configuráveis
  • Tamanhos de disco configuráveis
  • Acesso a recursos na Internet pública, como recursos num repositório ou num registo

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada


Antes de começar

  1. 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.
  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 (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. Install the Google Cloud CLI.

  6. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  7. Para inicializar a CLI gcloud, 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 (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. Install the Google Cloud CLI.

  12. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

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

    gcloud init
  14. Crie um conjunto privado

    1. Na Google Cloud consola, abra o separador Pool de trabalhadores do Cloud Build:

      Abra o separador Worker pool do Cloud Build

    2. Clique em Criar.

    3. No painel Criar conjunto privado, introduza as seguintes definições:

      1. No campo Nome, introduza 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, introduza 800.

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

      6. Deixe o campo Rede em branco.

      7. Certifique-se de que a opção Atribuir IPs externos está selecionada.

    Clique em Criar para criar o conjunto privado.

    Aguarde um pouco para que o conjunto privado seja criado. Depois de criado, o conjunto privado é apresentado no separador Conjunto de trabalhadores.

    Captura de ecrã da página da piscina privada

    Execute uma compilação num conjunto privado

    1. Abra uma janela de terminal.

    2. Crie um novo diretório denominado quickstart-private-pool e navegue para o mesmo:

      mkdir quickstart-private-pool
      cd quickstart-private-pool
      
    3. Crie um ficheiro denominado 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 com o ficheiro de configuração de compilação:

      gcloud builds submit
      

    Quando a compilação estiver concluída, verá um resultado semelhante ao seguinte:

    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
    

    Veja os detalhes da compilação

    1. Abra a página Histórico de compilações na Google Cloud consola.

      Abra a página do Cloud Build

    2. Na caixa de menu pendente Região, selecione us-central1.

      É apresentada a compilação que executou no conjunto privado.
    3. Clique na compilação para ver os detalhes da compilação, como o resumo da compilação e os artefactos.

    4. Limpar

      Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

      1. Abra a página Worker pool na Google Cloud consola:

        Abra a página do conjunto privado do Cloud Build

      2. Na linha com o seu conjunto privado, clique no ícone do lixo.

      3. Na caixa de pop-up Eliminar conjunto privado?, clique em Eliminar.

      O conjunto privado que criou como parte deste início rápido foi eliminado. Pode ter de atualizar o ecrã para eliminar o conjunto privado da página Conjunto de trabalhadores.

      O que se segue?