Questa pagina descrive come creare, aggiornare, visualizzare ed eliminare i pool privati di Cloud Build. Se non hai dimestichezza con i pool privati, consulta la Panoramica dei pool privati.
Prima di iniziare
Crea un nuovo progetto Google Cloud o scegli un progetto esistente. Utilizzerai questo progetto per creare il pool privato.
-
Enable the Cloud Build API.
Per utilizzare gli esempi a riga di comando in questa guida, installa e configura Google Cloud CLI.
[Facoltativo] Affinché le build possano accedere alle risorse private dalla tua rete Virtual Private Cloud, devi configurare una connessione in peering tra la tua rete Virtual Private Cloud e la rete Virtual Private Cloud in cui si trovano i pool privati. Per le istruzioni, consulta la sezione Configurare l'ambiente per creare pool privati.
Creazione di un nuovo pool privato
Autorizzazioni IAM: per eseguire questa attività è necessario il ruolo Proprietario pool di lavoratori Cloud Build. Per istruzioni su come concedere questo ruolo, consulta Configurare l'accesso alle risorse Cloud Build.
Per creare un nuovo pool privato:
Console
Apri la pagina Pool di worker nella console Google Cloud:
Seleziona il progetto in cui vuoi creare il pool privato.
Nella pagina Pool di worker, fai clic su Crea.
Viene visualizzato il riquadro laterale Crea pool privato.
Inserisci le seguenti informazioni per creare il tuo pool privato:
Nome: inserisci un nome per il pool privato. Questo valore può contenere solo caratteri alfanumerici
/[a-z][0-9]/
o trattini-
. Il nome del pool privato deve contenere da 1 a 63 caratteri.Regione: seleziona la regione in cui vuoi che venga creato il pool privato.
Tipo di macchina: seleziona il tipo di macchina Compute Engine da utilizzare per il tuo pool privato.
Dimensione disco disponibile: inserisci una dimensione del disco per il pool privato. Specifica un valore maggiore o uguale a 100 e minore o uguale a 4000. Se non viene fornita, Cloud Build utilizza una dimensione del disco pari a 100.
In Tipo di rete, seleziona una delle seguenti opzioni:
Rete predefinita: seleziona questa opzione se l'istanza è accessibile tramite internet pubblico. Quando è selezionata l'opzione Rete predefinita, il pool privato utilizza la rete del produttore di servizi. Per ulteriori informazioni, consulta Configurare l'ambiente per utilizzare i pool privati in una rete VPC.
Rete privata: seleziona questa opzione se l'istanza è ospitata su una rete privata.
Project (Progetto): seleziona il tuo Google Cloud ID progetto.
Rete: seleziona la tua emittente dal menu a discesa. Se non hai creato una rete, consulta Creare e gestire reti VPC per scoprire come crearne una.
Intervallo IP: inserisci l'intervallo IP interno che la rete del produttore Cloud Build può utilizzare per allocare alle VM mantenendo una connessione con i repository privati.
Puoi specificare l'intervallo utilizzando la notazione di routing CIDR (Classless Inter-Domain Routing) nel formato
STARTING_IP_ADDRESS/SUBNET_PREFIX_SIZE
. Ad esempio,192.0.2.0/24
ha una lunghezza del prefisso di 24. I primi 24 bit dell'intervallo IP vengono utilizzati come subnet mask (192.0.2.0
), mentre i possibili indirizzi host vanno da192.0.2.0
a192.0.2.255
.Il valore della lunghezza del prefisso non deve superare
/29
. Se non viene specificato alcun valore per l'intervallo, viene assegnato automaticamente un valore predefinito di/24
. Se non viene specificato alcun valore per la lunghezza del prefisso, gli indirizzi IP vengono assegnati automaticamente all'interno della rete VPC accoppiata. Se non viene specificato alcun valore per l'indirizzo IP, a quest'ultimo viene assegnato automaticamente un intervallo all'interno della rete VPC con peering.
Assegna IP esterni: questa opzione è selezionata per impostazione predefinita per consentire ai pool privati di accedere a internet pubblico. Deseleziona questa casella per limitare l'accesso alla tua rete privata.
Fai clic su Crea per creare il pool privato.
gcloud
Per creare un nuovo pool privato utilizzando gcloud
hai due opzioni: puoi passare il file di configurazione del pool privato al comando gcloud
oppure passare le opzioni di configurazione direttamente al comando gcloud
.
Passaggio del file di configurazione del pool privato al comando gcloud
:
Crea il file di configurazione del pool privato in formato YAML o JSON.
Esegui il seguente comando
gcloud
, dovePRIVATEPOOL_ID
è un identificatore univoco per il tuo pool privato,PRIVATEPOOL_CONFIG_FILE
è il nome del file di configurazione del pool privato eREGION
è la regione in cui vuoi creare il pool privato:gcloud builds worker-pools create PRIVATEPOOL_ID --config-from-file PRIVATEPOOL_CONFIG_FILE --region REGION
Dovresti vedere un output simile al seguente:
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
Passaggio delle opzioni di configurazione direttamente al comando gcloud
:
Esegui questo 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
Sostituisci i valori segnaposto nei comandi precedenti con quanto segue:
PRIVATEPOOL_ID
: un identificatore univoco per il tuo pool privato. Questo valore deve contenere da 1 a 63 caratteri e i caratteri validi sono[a-zA-Z0-9_-]+
.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud dove vuoi creare il tuo pool privato.REGION
: una delle regioni supportate.PEERED_NETWORK
: l'URL della risorsa di rete della rete in peer con la rete del producer di servizi.PEERED_NETWORK
deve essere nel formatoprojects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME
, doveNETWORK_PROJECT_ID
è l'ID progetto del progetto Google Cloud che contiene la tua rete VPC eNETWORK_NAME
è il nome della tua rete VPC. Se non specifichi un valore, Cloud Build utilizza la rete del fornitore di servizi.PRIVATEPOOL_DISK_SIZE_GB
: le dimensioni del disco collegato al pool privato. Specifica un valore maggiore o uguale a 100 e minore o uguale a 4000. Se non viene specificato, Cloud Build utilizza una dimensione del disco di 100.--worker-disk-size
viene ignorato se specifichi una dimensione del disco diversa utilizzando--disk-size
durantegcloud builds submit
.PRIVATEPOOL_MACHINE_TYPE
: il tipo di macchina del worker. Se il campo viene lasciato vuoto, Cloud Build utilizza il valore predefinito die2-standard-2
. Per un elenco dei tipi di macchine supportati, consulta Schema del file di configurazione del pool privato.--worker-machine-type
viene sostituito se specifichi un altro tipo di macchina utilizzando--machine-type
durantegcloud builds submit
.--no-public-egress
: se questo flag è impostato, il pool privato viene creato senza un indirizzo IP esterno. Imposta questo flag se crei il pool privato all'interno di un perimetro dei Controlli di servizio VPC.
API
Crea il file di configurazione del pool privato denominato
workerpool.json
.Utilizza cURL per chiamare l'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
Sostituisci i valori segnaposto nel comando precedente con quanto segue:
PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud dove vuoi creare il tuo pool privato.PRIVATEPOOL_ID
: l'ID del tuo pool privato. Questo valore deve contenere da 1 a 63 caratteri e i caratteri validi sono[a-zA-Z0-9_-]+
.REGION
: una delle regioni supportate per creare il pool privato.
Creazione di un pool privato all'interno di un perimetro dei Controlli di servizio VPC
Se stai creando un pool privato all'interno di un perimetro dei Controlli di servizio VPC, consulta Utilizzare i Controlli di servizio VPC.
Aggiornamento di un pool privato
Autorizzazioni IAM: per eseguire questa attività è necessario il ruolo Editor di pool di lavoro Cloud Build. Per istruzioni su come concedere questo ruolo, consulta Configurare l'accesso alle risorse Cloud Build.
Puoi aggiornare le dimensioni del disco e il tipo di macchina di un pool privato esistente. Per aggiornare un pool privato:
Console
Apri la pagina Pool di worker nella console Google Cloud:
Seleziona il progetto in cui hai creato il pool privato.
Fai clic sul nome del pool privato.
Nel riquadro laterale Modifica pool privato, aggiorna il tipo di macchina e/o le dimensioni del disco.
Fai clic su Salva.
gcloud
Aggiornando il file di configurazione del pool privato:
Aggiorna il campo che vuoi modificare nel file di configurazione del pool privato.
Esegui il seguente comando, dove
PRIVATEPOOL_ID
è l'identificatore univoco del pool privato,REGION
è la regione in cui si trova il pool privato ePRIVATEPOOL_CONFIG_FILE
è il nome del file di configurazione del pool privato:gcloud builds worker-pools update PRIVATEPOOL_ID \ --region=REGION \ --config-from-file=PRIVATEPOOL_CONFIG_FILE
Passando il valore da aggiornare direttamente al 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
Sostituisci i valori segnaposto nei comandi precedenti con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato esistente. Non puoi aggiornare questo valore; devi specificare un ID pool privato esistente.REGION
: la regione in cui hai creato il pool privato.PRIVATEPOOL_DISK_SIZE
: la dimensione del disco aggiornata.PRIVATEPOOL_MACHINE_TYPE
è il tipo di macchina aggiornato.
API
Nel file di configurazione del pool privato, aggiorna le dimensioni del disco e/o il tipo di macchina.
Utilizza cURL per chiamare l'API Cloud Build, sostituendo le variabili con i valori appropriati:
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
Sostituisci i valori segnaposto nel comando precedente con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud che contiene il tuo pool privato.REGION
: la regione in cui hai creato il pool privato.
Visualizzazione dei dettagli del pool privato
Autorizzazioni IAM: per eseguire questa operazione, devi disporre del ruolo Visualizzatore pool di lavoro Cloud Build. Per istruzioni su come concedere questo ruolo, consulta Configurare l'accesso alle risorse Cloud Build.
Per visualizzare i dettagli di un pool privato:
Console
Apri la pagina Pool di worker nella console Google Cloud:
Seleziona il progetto in cui hai creato il pool privato
Fai clic sul nome del pool privato.
Viene visualizzato il riquadro laterale Modifica pool privato, che contiene i dettagli del pool privato.
gcloud
Se non conosci l'ID del tuo pool privato, esegui il seguente comando per elencarne i dettagli:
gcloud builds worker-pools list --project=PRIVATEPOOL_PROJECT_ID
dove PRIVATEPOOL_PROJECT_ID
è l'ID del progetto Google Cloud che contiene il pool privato.
Dovresti vedere un output simile al seguente:
NAME CREATE_TIME STATUS
projects/[PRIVATEPOOL_PROJECT_ID]/locations/us-central1/workerPools/[PRIVATEPOOL_ID] 2018-11-19T16:08:24+00:00 RUNNING
Se conosci l'ID del pool privato, esegui il seguente comando per ottenere ulteriori informazioni sul pool privato:
gcloud builds worker-pools describe PRIVATEPOOL_ID \
--region=REGION \
--project=PRIVATEPOOL_PROJECT_ID
Sostituisci i valori segnaposto nel comando precedente con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato.REGION
: la regione in cui hai creato il pool privato.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud che contiene il tuo pool privato.
API
Se non conosci l'ID del pool privato, esegui il seguente comando cURL per elencare i dettagli del pool privato, dove PRIVATEPOOL_PROJECT_ID
è l'ID del progetto Google Cloud contenente il pool privato:
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://cloudbuild.googleapis.com/v1/projects/PRIVATEPOOL_PROJECT_ID/locations/REGION/workerPools
Se conosci l'ID del pool privato, esegui il seguente comando cURL per ottenere i dettagli del pool privato:
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
Sostituisci i valori segnaposto nei comandi precedenti con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud che contiene il tuo pool privato.REGION
: la regione in cui hai creato il pool privato.
Eliminazione di un pool privato
Autorizzazioni IAM: per eseguire questa attività è necessario il ruolo Proprietario pool di lavoratori Cloud Build. Per istruzioni su come concedere questo ruolo, consulta Configurare l'accesso alle risorse Cloud Build.
Per eliminare un pool privato:
Console
Apri la pagina Pool di worker nella console Google Cloud:
Nella riga corrispondente al tuo pool privato, fai clic sull'icona del cestino.
gcloud
Per eliminare un pool privato, esegui il comando gcloud builds worker-pools
delete
:
gcloud builds worker-pools delete PRIVATEPOOL_ID \
--region=REGION \
--project=PRIVATEPOOL_PROJECT_ID
Sostituisci i valori segnaposto nel comando precedente con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud che contiene il tuo pool privato.REGION
: la regione in cui hai creato il pool privato.
Dopo l'eliminazione del pool privato, dovresti visualizzare un output simile al seguente:
Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[PRIVATEPOOL_ID].
API
Utilizza cURL per chiamare l'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
Sostituisci i valori segnaposto nei comandi precedenti con quanto segue:
PRIVATEPOOL_ID
: l'ID del tuo pool privato.PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud che contiene il tuo pool privato.REGION
: la regione in cui hai creato il pool privato.
Passaggi successivi
- Scopri come eseguire build in pool privati.
- Scopri come utilizzare i Controlli di servizio VPC con i pool privati.