In questa pagina viene descritto come creare, aggiornare, visualizzare ed eliminare Cloud Build e pool privati. Se non hai familiarità con i pool privati, consulta 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.
-
Abilita l'API Cloud Build.
Per utilizzare gli esempi a riga di comando in questa guida, installa configurare Google Cloud CLI.
[Facoltativo] Per consentire alle build di accedere alle risorse private dalla tua rete Virtual Private Cloud, devi configurare una connessione in peering tra la tua rete Virtual Private Cloud e Rete Virtual Private Cloud in cui si trovano i pool privati. Per istruzioni, consulta la sezione sulla configurazione per creare pool privati.
Creazione di un nuovo pool privato
Autorizzazioni IAM: devi disporre di un proprietario del pool di worker di Cloud Build per eseguire questa attività. Per istruzioni su come concedere questo ruolo, consulta Configura l'accesso alle risorse Cloud Build.
Puoi creare fino a 10 pool privati per progetto Google Cloud per regione. A crea 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.
Verrà visualizzato il riquadro laterale Crea pool privato.
Inserisci le seguenti informazioni per creare il 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 essere compreso tra 1 e 63 caratteri.Regione: seleziona la regione in cui vuoi creare il pool privato.
Tipo di macchina: seleziona il tipo di macchina Compute Engine per cui desideri utilizzare la tua piscina privata.
Dimensione disco disponibile: inserisci una dimensione per il 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.
In Tipo di rete, seleziona una delle seguenti opzioni:
Rete predefinita: seleziona questa opzione se la tua istanza è accessibili tramite la rete internet pubblica. Quando viene usata l'impostazione Rete predefinita l'opzione è selezionata, il pool privato utilizza il servizio un'azienda di produttori di contenuti. Per ulteriori informazioni, vedi Configurare un ambiente da utilizzare pool privati in una rete VPC.
Rete privata: seleziona questa opzione se la tua istanza è ospitata su una rete privata.
Progetto: seleziona il tuo ID progetto Google Cloud.
Rete: seleziona la tua rete dal menu a discesa. Se non hanno creato una rete, consulta Creare e gestire VPC reti per imparare a creare una rete.
Intervallo IP: inserisci l'intervallo IP interno di cui la rete producer di Cloud Build può usare per allocare VM che mantengono una connessione con 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 caratteri. I primi 24 bit dell'intervallo IP vengono utilizzati come subnet mask (192.0.2.0
), mentre i possibili indirizzi host sono compresi tra192.0.2.0
e192.0.2.255
.Il valore della lunghezza del prefisso non deve superare
/29
. In caso contrario 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 in peering. Se non viene specificato alcun valore per l'IP indirizzo IP, all'indirizzo IP viene assegnato automaticamente un intervallo all'interno della rete VPC in peering.
Assegna IP esterni: questa opzione è selezionata per impostazione predefinita per consentire l'accesso per accedere alla rete internet pubblica. 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 a disposizione due opzioni:
passa il file di configurazione del pool privato al comando gcloud
oppure
le opzioni di configurazione direttamente sul comando gcloud
.
Passaggio del file di configurazione del pool privato al comando gcloud
:
Crea la configurazione del pool privato nel file YAML o JSON.
Esegui questo comando
gcloud
, dovePRIVATEPOOL_ID
è un identificatore univoco del tuo pool privato,PRIVATEPOOL_CONFIG_FILE
è il nome del file di configurazione del pool privato eREGION
è il 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 i seguenti:
PRIVATEPOOL_ID
: un identificatore univoco per il 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 in cui vuoi creare il pool privato.REGION
: una delle regioni supportate.PEERED_NETWORK
: l'URL della risorsa di rete della rete connessa in peering 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 al progetto Google Cloud che contiene la tua rete VPCNETWORK_NAME
è il nome della tua rete VPC. Se non specifichi un valore, Cloud Build utilizza il provider di servizi in ogni rete.PRIVATEPOOL_DISK_SIZE_GB
: le dimensioni del disco collegato alla piscina privata. 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. L'override di--worker-disk-size
viene eseguito se specificare una dimensione del disco diversa utilizzando--disk-size
durantegcloud builds submit
.PRIVATEPOOL_MACHINE_TYPE
: il tipo di macchina worker. Se viene lasciato vuoto, Cloud Build utilizza il valore predefinito die2-standard-2
. Per un elenco dei tipi di macchina supportati, vedi Schema del file di configurazione del pool privato. L'override di--worker-machine-type
viene eseguito se specifichi una macchina diversa digita utilizzando--machine-type
durantegcloud builds submit
.--no-public-egress
: se questo flag viene impostato, viene creato il pool privato senza un indirizzo IP esterno. Imposta questo flag creando un 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 chiama 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 del comando precedente con i seguenti:
PRIVATEPOOL_PROJECT_ID
: l'ID del progetto Google Cloud in cui vuoi creare il pool privato.PRIVATEPOOL_ID
: l'ID per il tuo privato piscina. Questo valore deve contenere da 1 a 63 caratteri e caratteri validi sono[a-zA-Z0-9_-]
.REGION
: una delle regioni supportate per creare il tuo 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 Utilizzo dei Controlli di servizio VPC.
Aggiornamento di un pool privato
Autorizzazioni IAM: devi disporre dell'editor del pool di worker di Cloud Build per eseguire questa attività. Per istruzioni su come concedere questo ruolo, consulta Configurazione dell'accesso alle risorse Cloud Build.
Puoi aggiornare le dimensioni del disco e il tipo di macchina di un piscina privata. 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 dimensioni del disco.
Fai clic su Salva.
gcloud
Aggiornando il file di configurazione del pool privato:
Aggiorna il campo che vuoi modificare nella configurazione del pool privato .
Esegui questo comando, dove
PRIVATEPOOL_ID
è l'identificatore univoco del tuo 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 per 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 i seguenti:
PRIVATEPOOL_ID
: l'ID del tuo profilo privato esistente piscina. Non puoi aggiornare questo valore; è necessario specificare l'ID pool.REGION
: la regione in cui hai creato il pool privato.PRIVATEPOOL_DISK_SIZE
: dimensione del disco aggiornata.PRIVATEPOOL_MACHINE_TYPE
è il tipo di macchina aggiornato.
API
Nel file di configurazione del pool privato, aggiornare la dimensione del disco e/o il tipo di macchina.
Utilizza cURL per chiama 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 del comando precedente con i seguenti:
PRIVATEPOOL_ID
: l'ID del 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: devi disporre del ruolo Visualizzatore pool di worker Cloud Build per eseguire questa attività. Per istruzioni su come concedere questo ruolo, consulta Configurazione dell'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 piscina privata.
gcloud
Se non conosci l'ID del tuo pool privato, esegui questo comando per elencare i dettagli del pool privato:
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 questo 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 del comando precedente con i seguenti:
PRIVATEPOOL_ID
: l'ID del 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 questo comando
cURL per
elenca i dettagli del pool privato, dove PRIVATEPOOL_PROJECT_ID
è l'ID del progetto Google Cloud che contiene 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 questo Comando cURL per ottenere i dettagli del tuo 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 i seguenti:
PRIVATEPOOL_ID
: l'ID del 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 tuo pool privato.
Eliminazione di un pool privato
Autorizzazioni IAM: devi disporre di un proprietario del pool di worker di Cloud Build per eseguire questa attività. Per istruzioni su come concedere questo ruolo, consulta Configurazione dell'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 del comando precedente con i seguenti:
PRIVATEPOOL_ID
: l'ID del 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 tuo pool privato.
Dopo aver eliminato il pool privato, dovresti vedere un output simile a questo: le seguenti:
Deleted [https://cloudbuild.googleapis.com/v1/projects/gcb-docs-project/locations/us-central1/workerPools/[PRIVATEPOOL_ID].
API
Utilizza cURL per chiama 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 i seguenti:
PRIVATEPOOL_ID
: l'ID del 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 tuo pool privato.
Passaggi successivi
- Scopri come eseguire build in pool privati.
- Scopri come utilizzare i Controlli di servizio VPC con i pool privati.