Crea ed esegui una build in un pool privato

Questa pagina spiega come creare un pool privato di Cloud Build connesso alla rete del producer di servizi ed eseguire una build nel pool privato.

La rete del producer di servizi è la rete che ospita il pool privato. Per impostazione predefinita, un pool privato è configurato per utilizzare la rete del producer di servizi, che fornisce un ambiente di build con:

  • Tipi di macchina configurabili
  • Dimensioni del disco configurabili
  • Accesso alle risorse nella rete internet pubblica, ad esempio le risorse in un repository o in un registro

Per seguire le indicazioni dettagliate per questa attività direttamente nell' editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

  1. Accedi al tuo Google Cloud account. Se non hai mai utilizzato Google Cloud, crea un account per valutare il rendimento dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

  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. Installa Google Cloud CLI.

  6. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  7. Per inizializzare gcloud CLI, esegui questo 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. Installa Google Cloud CLI.

  12. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  13. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

Crea un pool privato

  1. Nella Google Cloud console, apri la scheda Pool di worker di Cloud Build:

    Apri la scheda Pool di worker di Cloud Build

  2. Fai clic su Crea.

  3. Nel riquadro Crea pool privato, inserisci le seguenti impostazioni:

    1. Nel campo Nome, inserisci my-first-privatepool.

    2. Nel campo Regione, seleziona us-central1.

    3. Nel campo Tipo di macchina, seleziona e2-standard-2.

    4. Nel campo Dimensione disco disponibile, inserisci 800.

    5. Lascia il campo Numero progetto di rete vuoto.

    6. Lascia il campo Rete vuoto.

    7. Assicurati che l'opzione Assegna IP esterni sia selezionata.

Fai clic su Crea per creare il pool privato.

Potrebbe essere necessario un po' di tempo per la creazione del pool privato. Dopo la creazione, il pool privato viene elencato nella scheda Pool di worker.

Screenshot della pagina del pool privato

Esegui una build in un pool privato

  1. Apri una finestra del terminale.

  2. Crea una nuova directory denominata quickstart-private-pool e accedi alla directory:

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

  3. Crea un file denominato cloudbuild.yaml con i seguenti contenuti:

    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. Avvia la build utilizzando il file di configurazione della build:

    gcloud builds submit

Al termine della build, vedrai un output simile al seguente:

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

Visualizza i dettagli della build

  1. Apri la pagina Cronologia build nella Google Cloud console.

    Apri la pagina Cloud Build

  2. Nella casella a discesa Regione, seleziona us-central1.

    Viene visualizzata la build che hai eseguito nel pool privato.

  3. Fai clic sulla build per visualizzare i dettagli, ad esempio il riepilogo e gli artefatti.

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

  1. Apri la pagina Pool di worker nella Google Cloud console:

    Apri la pagina del pool privato di Cloud Build

  2. Nella riga corrispondente al tuo pool privato, fai clic sull'icona del cestino.

  3. Nella finestra popup Eliminare il pool privato?, fai clic su Elimina.

Il pool privato che hai creato nell'ambito di questa guida rapida è ora eliminato. Potresti dover aggiornare la schermata per eliminare il pool privato dalla pagina Pool di worker.

Passaggi successivi