Un file di configurazione del pool privato (file di configurazione del pool privato) contiene
istruzioni per creare un pool privato basato su Cloud Build
le tue specifiche. Un file di configurazione del pool privato contiene informazioni quali la dimensione del disco e il tipo di macchina che vuoi utilizzare per il pool privato. Il
file di configurazione del pool privato è obbligatorio quando crei e gestisci i pool privati
utilizzando lo strumento gcloud
o l'API Cloud Build.
Struttura del file di configurazione di un pool privato
Puoi scrivere il file di configurazione del pool privato utilizzando la sintassi YAML o JSON. Per creare e gestire i pool privati utilizzando curl
, scrivi
il file di configurazione del pool privato in formato JSON. Per creare e gestire elementi privati
utilizzando lo strumento gcloud
, scrivi il file di configurazione del pool privato
YAML o JSON.
Un file di configurazione del pool privato ha la seguente struttura:
YAML
privatePoolV1Config:
networkConfig:
egressOption: NO_PUBLIC_EGRESS
peeredNetwork: 'PEERED_NETWORK'
peeredNetworkIpRange: 'PEERED_NETWORK_IP_RANGE'
workerConfig:
diskSizeGb: 'PRIVATE_POOL_DISK_SIZE'
machineType: PRIVATE_POOL_MACHINE_TYPE
JSON
{
"privatePoolV1Config": {
"networkConfig": {
"egressOption": "NO_PUBLIC_EGRESS",
"peeredNetwork": "PEERED_NETWORK",
"peeredNetworkIpRange": "PEERED_NETWORK_IP_RANGE"
},
"workerConfig": {
"diskSizeGb": "PRIVATE_POOL_DISK_SIZE",
"machineType": "PRIVATE_POOL_MACHINE_TYPE"
}
}
}
I campi nel file di configurazione del pool privato sono spiegati di seguito:
networkConfig
Questo è un campo facoltativo. Specifica networkConfig
solo se stai eseguendo il peering di
rete VPC con la rete del producer di servizi.
egressOption
Questo campo è facoltativo. Imposta il valore di questo campo su NO_PUBLIC_EGRESS
se
stai creando il tuo pool privato all'interno di un perimetro dei Controlli di servizio VPC. Se
non includere questo campo nel file di configurazione del pool privato, il traffico in uscita pubblico è abilitato.
Per informazioni sulla configurazione dei Controlli di servizio VPC per i pool privati, consulta
Utilizzare i Controlli di servizio VPC.
peeredNetwork
Questo è un campo obbligatorio se il file di configurazione del pool privato contiene il campo networkConfig
. Imposta il valore di questo campo sull'URL della risorsa di rete della rete VPC in peering con la rete del produttore di servizi. L'URL della risorsa di rete deve essere nel formato
projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME
,
dove NETWORK_PROJECT_ID è l'ID progetto
al progetto Google Cloud che contiene la tua rete VPC
NETWORK_NAME è il nome della tua rete VPC.
Se non specifichi un valore, Cloud Build utilizza per impostazione predefinita la rete del produttore del servizio.
peeredNetworkIpRange
Questo è un campo facoltativo. Imposta il valore di questo campo per specificare l'intervallo IP interno a cui è possibile assegnare le VM all'interno dell'intervallo allocato della rete in peering. Se l'intervallo IP specificato non può essere allocato nell'intervallo della connessione privata, ad esempio a causa di limitazioni di dimensioni o di un indirizzo IP iniziale non valido, non è possibile creare il pool privato.
peeredNetworkIpRange
viene specificato utilizzando la notazione CIDR (Classless Inter-Domain Routing) nel formato 'STARTING_IP/SUBNET_PREFIX_SIZE'
. Se viene utilizzato questo campo, è necessario specificare SUBNET_PREFIX_SIZE
. SUBNET_PREFIX_SIZE
determina la dimensione dell'intervallo IP. Deve iniziare con una barra (/
) e avere un valore minore o uguale a 29. La parte STARTING_IP
è facoltativa e specifica l'indirizzo iniziale dell'intervallo. Se STARTING_IP
non viene specificato, viene assegnato automaticamente un indirizzo iniziale all'interno dell'intervallo di connessioni private. Se non viene specificato alcun valore per peeredNetworkIpRange
, verrà utilizzato un valore predefinito di /24
che assegna automaticamente un IP iniziale con un intervallo di 256 IP.
Il valore di SUBNET_PREFIX_SIZE
non deve superare 29. Un numero maggiore specifica un prefisso di subnet più grande, che lascerebbe meno IP possibili e comporterebbe un intervallo IP più piccolo. Poiché un indirizzo IP è di 32 bit, una dimensione del prefisso pari a /24
consente 256 possibili IP nell'intervallo (otto bit), mentre una dimensione del prefisso pari a /29
lascia otto possibili IP (tre bit). Il numero massimo di VM del builder è limitato al numero di IP utilizzabili nell'intervallo (il numero totale possibile di IP nell'intervallo meno due).
Di seguito sono riportati alcuni esempi del campo peeredNetworkIpRange
:
192.168.0.0/24
specifica un intervallo IP che inizia da 192.168.0.0 con un prefisso di subnet di 24 (256 IP, con 254 IP utilizzabili)./29
specifica un intervallo con un IP iniziale determinato automaticamente e una dimensione del prefisso della subnet pari a 29 (otto IP, con sei IP utilizzabili).
workerConfig
Questo campo è obbligatorio. Contiene le opzioni di configurazione per i tuoi piscina.
diskSizeGb
Questo campo è facoltativo. Utilizza questo campo per specificare le dimensioni del disco in GB per l'istanza del pool privato. Specifica un valore maggiore o uguale a
100 e minore o uguale a 2000. Se non includi questo campo nei tuoi
di configurazione del pool oppure, se specifichi 0
come valore di questo campo,
Cloud Build utilizza il valore predefinito di 100.
machineType
Questo è un campo facoltativo. Utilizza questo campo per specificare il tipo di macchina Compute Engine per l'istanza del pool privato. Specifica uno dei seguenti tipi di macchina:
e2-medium
e2-standard-2
e2-standard-4
e2-standard-8
e2-standard-16
e2-standard-32
e2-highmem-2
e2-highmem-4
e2-highmem-8
e2-highmem-16
e2-highcpu-2
e2-highcpu-4
e2-highcpu-8
e2-highcpu-16
e2-highcpu-32
Se non specifichi un valore, Cloud Build utilizza il valore predefinito
di e2-standard-2
.
Passaggi successivi
- Scopri come eseguire build in pool privati.
- Scopri come creare e gestire i pool privati.