Schema del file di configurazione dei pool privati

Un file di configurazione del pool privato contiene le istruzioni per Cloud Build per creare un pool privato in base alle 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 è necessario quando crei e gestisci pool privati utilizzando lo strumento gcloud o l'API Cloud Build.

Struttura di un file di configurazione del pool privato

Puoi scrivere il file di configurazione del pool privato utilizzando la sintassi YAML o JSON. Per creare e gestire pool privati utilizzando curl, scrivi il file di configurazione del pool privato in formato JSON. Per creare e gestire pool privati utilizzando lo strumento gcloud, scrivi il file di configurazione del pool privato in formato 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 come segue:

networkConfig

Questo è un campo facoltativo. Specifica networkConfig solo se esegui 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 pool privato all'interno di un perimetro dei Controlli di servizio VPC. Se non includi questo campo nel file di configurazione del pool privato, l'uscita pubblica è abilitata. Per informazioni sulla configurazione dei Controlli di servizio VPC per i pool privati, consulta Utilizzo dei 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 del servizio. 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 del progetto Google Cloud che contiene la tua rete VPC e NETWORK_NAME è il nome della tua rete VPC. Se non specifichi un valore, Cloud Build utilizza la rete del produttore di servizi per impostazione predefinita.

peeredNetworkIpRange

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

peeredNetworkIpRange è 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 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 non viene specificato STARTING_IP, viene assegnato automaticamente un indirizzo iniziale dall'intervallo di connessione privata. 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 è a 32 bit, una dimensione del prefisso di /24 consente 256 IP possibili nell'intervallo (8 bit), mentre una dimensione del prefisso di /29 lascia 8 IP possibili (3 bit). Il numero massimo di VM builder è limitato al numero di IP utilizzabili nell'intervallo (il numero totale possibile di IP nell'intervallo meno due).

Vedi di seguito alcuni esempi del campo peeredNetworkIpRange:

  • 192.168.0.0/24 specifica un intervallo IP che inizia da 192.168.0.0 con una dimensione del prefisso della subnet di 24 (256 IP, con 254 IP utilizzabili).
  • /29 specifica un intervallo con un IP iniziale determinato automaticamente e una dimensione del prefisso di subnet di 29 (otto IP, con sei IP utilizzabili).

workerConfig

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

diskSizeGb

Questo è un campo facoltativo. Utilizza questo campo per specificare le dimensioni di un disco per l'istanza del pool privato in GB. Specifica un valore maggiore o uguale a 100 e minore o uguale a 4000. 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. Se non specifichi un valore, Cloud Build utilizza il valore predefinito e2-medium. In caso contrario, specifica uno dei seguenti tipi di macchine:

Tipi di macchine

e2 n2d c3
e2-medium n2d-standard-2 c3-standard-4
e2-standard-2 n2d-standard-4 c3-standard-8
e2-standard-4 n2d-standard-8 c3-standard-22
e2-standard-8 n2d-standard-16 c3-standard-44
e2-standard-16 n2d-standard-32 c3-standard-88
e2-standard-32 n2d-standard-48 c3-standard-176
e2-highmem-2 n2d-standard-64 c3-highcpu-4
e2-highmem-4 n2d-standard-80 c3-highcpu-8
e2-highmem-8 n2d-standard-96 c3-highcpu-22
e2-highmem-16 n2d-standard-128 c3-highcpu-44
e2-highcpu-2 n2d-standard-224 c3-highcpu-88
e2-highcpu-4 n2d-highmem-2 c3-highcpu-176
e2-highcpu-8 n2d-highmem-4 c3-highmem-4
e2-highcpu-16 n2d-highmem-8 c3-highmem-8
e2-highcpu-32 n2d-highmem-16 c3-highmem-22
n2d-highmem-32 c3-highmem-44
n2d-highmem-48 c3-highmem-88
n2d-highmem-64 c3-highmem-176
n2d-highmem-80
n2d-highmem-96
n2d-highcpu-2
n2d-highcpu-4
n2d-highcpu-8
n2d-highcpu-16
n2d-highcpu-32
n2d-highcpu-48
n2d-highcpu-64
n2d-highcpu-80
n2d-highcpu-96
n2d-highcpu-128
n2d-highcpu-224

La tabella seguente mostra la disponibilità dei tipi di macchine per regione:

Disponibilità dei tipi di macchine per regione

c3-standard-* c3-highcpu-* c3-highmem-* e2-* n2d-*
asia-northeast1 asia-southeast1 asia-southeast1 africa-south1 africa-south1
asia-southeast1 europe-west1 europe-west1 asia-east1 asia-east1
australia-southeast1 europe-west3 europe-west2 asia-east2 asia-east2
europe-west1 europe-west4 europe-west3 asia-northeast1 asia-northeast1
europe-west2 me-central2 europe-west4 asia-northeast2 asia-northeast2
europe-west3 us-central1 us-central1 asia-northeast3 asia-northeast3
europe-west4 us-east1 us-east1 asia-south1 asia-south1
europe-west9 us-east4 us-east4 asia-south2 asia-south2
me-central2 us-east5 us-east5 asia-southeast1 asia-southeast1
me-west1 us-west2 us-west1 asia-southeast2 asia-southeast2
northamerica-northeast1 us-west3 us-west2 australia-southeast1 australia-southeast1
southamerica-east1 us-west4 australia-southeast2 australia-southeast2
us-central1 europe-central2 europe-central2
us-east1 europe-north1 europe-north1
us-east4 europe-north2 europe-southwest1
us-east5 europe-southwest1 europe-west1
us-west1 europe-west1 europe-west10
us-west2 europe-west2 europe-west12
us-west3 europe-west3 europe-west2
us-west4 europe-west4 europe-west3
europe-west6 europe-west4
europe-west8 europe-west6
europe-west9 europe-west8
europe-west10 europe-west9
europe-west12 me-central1
me-central1 me-central2
me-central2 me-west1
me-west1 northamerica-northeast1
northamerica-northeast1 northamerica-northeast2
northamerica-northeast2 southamerica-east1
northamerica-south1 southamerica-west1
southamerica-east1 us-central1
southamerica-west1 us-east1
us-central1 us-east4
us-east1 us-east5
us-east4 us-south1
us-east5 us-west1
us-south1 us-west2
us-west1 us-west3
us-west2 us-west4
us-west3
us-west4

enableNestedVirtualization

Questo è un campo facoltativo. Se il tuo pool privato utilizza una VM con un tipo di macchina C3, puoi attivare la virtualizzazione nidificata per eseguire altre istanze VM all'interno della VM del pool privato. Per ulteriori informazioni, vedi Informazioni sulla virtualizzazione nidificata.

Passaggi successivi