Schema del file di configurazione dei pool privati

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Un file di configurazione di un pool privato (file di configurazione del pool privato) contiene istruzioni per Cloud Build per creare un pool privato in base alle tue specifiche. Un file di configurazione di un pool privato contiene informazioni quali dimensioni del disco e tipo di macchina da utilizzare per il pool privato. Il file di configurazione del pool privato è obbligatorio durante la creazione e la gestione di pool privati con lo strumento gcloud o l'API Cloud Build.

Struttura di un 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 pool privati con curl, scrivi il file di configurazione del pool privato nel formato JSON. Per creare e gestire i pool privati utilizzando lo strumento gcloud, scrivi il file di configurazione del pool privato nel formato YAML o JSON.

Un file di configurazione di un 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 della tua rete VPC con la rete del producer di servizi.

egressOption

Questo è un campo facoltativo. Imposta il valore di questo campo su NO_PUBLIC_EGRESS se stai creando il tuo pool privato all'interno di un perimetro Controlli di servizio VPC. Se non includi questo campo nel file di configurazione del pool privato, viene attivato il traffico in uscita pubblico. Per informazioni sulla configurazione di Controlli di servizio VPC per i pool privati, consulta Utilizzo di 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 producer di servizi. L'URL delle risorse di rete deve essere nel formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, dove NETWORK_PROJECT_ID è l'ID del progetto Cloud che contiene la rete VPC e NETWORK_NAME è il nome della rete VPC. Se non specifichi un valore, Cloud Build utilizza la rete del producer di servizi per impostazione predefinita.

peeredNetworkIpRange

Questo è un campo facoltativo. Imposta il valore di questo campo per specificare l'intervallo IP a cui possono essere assegnate le VM all'interno dell'intervallo allocato della rete in peering. Se non è possibile allocare l'intervallo IP specificato all'interno dell'intervallo della connessione privata, ad esempio a causa di limitazioni delle dimensioni o di un IP iniziale non valido, non è possibile creare il pool privato.

Il valore peeredNetworkIpRange viene specificato utilizzando la notazione Classless Inter-Domain Routing (CIDR) nel formato 'STARTING_IP/SUBNET_PREFIX_SIZE'. Se viene utilizzato questo campo, è necessario specificare SUBNET_PREFIX_SIZE. SUBNET_PREFIX_SIZE determina le dimensioni dell'intervallo IP. Deve iniziare con una barra (/) e avere un valore inferiore o uguale a 29. La parte STARTING_IP è facoltativa e specifica l'indirizzo iniziale dell'intervallo. Se STARTING_IP non è specificato, viene assegnato automaticamente un indirizzo iniziale dall'intervallo dell'intervallo di connessione privata. Se non specifichi 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 essere maggiore di 29. Un numero maggiore specifica un prefisso di subnet più ampio, che lascerebbe meno indirizzi IP possibili e comporterebbe un intervallo di indirizzi IP più piccolo. Poiché un indirizzo IP è di 32 bit, una dimensione del prefisso di /24 consente 256 possibili IP nell'intervallo (otto bit), mentre una dimensione del prefisso di /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).

Vedi gli esempi seguenti per il campo peeredNetworkIpRange:

  • 192.168.0.0/24 specifica un intervallo IP a partire da 192.168.0.0 con una 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 di 29 (otto IP, con sei IP utilizzabili).

workerConfig

Questo è un campo obbligatorio. Contiene opzioni di configurazione per il pool privato.

diskSizeGb

Questo è un campo facoltativo. Utilizza questo campo per specificare le dimensioni del disco per l'istanza del pool privato in GB. Specifica un valore maggiore o uguale a 100 e minore o uguale a 1000. Se non includi questo campo nel file di configurazione del pool privato o se specifichi 0 come valore di questo campo, Cloud Build utilizza il valore predefinito 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 alcun valore, Cloud Build utilizza il valore predefinito e2-medium.

Passaggi successivi