Eine Konfigurationsdatei für den privaten Pool (Konfigurationsdatei für privaten Pool) enthält eine Anleitung zur Erstellung eines privaten Pools gemäß den Spezifikationen von Cloud Build. Eine Konfigurationsdatei für den privaten Pool enthält Informationen wie die Laufwerksgröße und den Maschinentyp, die Sie für Ihren privaten Pool verwenden möchten. Die Konfigurationsdatei für den privaten Pool ist erforderlich, wenn Sie benutzerdefinierte private Pools mit dem gcloud-Tool oder der Cloud Build API erstellen und verwalten.
Struktur einer Konfigurationsdatei für den privaten Pool
Sie können die Konfigurationsdatei des privaten Pools in der YAML- oder JSON-Syntax schreiben. Wenn Sie private Pools mit curl erstellen und verwalten möchten, schreiben Sie die Konfigurationsdatei des privaten Pools im JSON-Format. Wenn Sie private Pools mit dem gcloud-Tool erstellen und verwalten möchten, schreiben Sie die Konfigurationsdatei des privaten Pools in das YAML- oder JSON-Format.
Eine Konfigurationsdatei für die Erstellung des privaten Pools hat folgende Struktur:
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"
}
}
}
Die Felder in der Konfigurationsdatei für den privaten Pool werden im Folgenden erläutert:
networkConfig
Dieses Feld ist optional. Geben Sie networkConfig nur an, wenn Sie Ihr VPC-Netzwerk mit dem Diensterstellernetzwerk verbinden.
egressOption
Dieses Feld ist optional. Setzen Sie den Wert dieses Felds auf NO_PUBLIC_EGRESS, wenn Sie Ihren privaten Pool in einem VPC Service Controls-Perimeter erstellen. Wenn Sie dieses Feld nicht in die Konfigurationsdatei des privaten Pools aufnehmen, ist der öffentliche ausgehende Traffic aktiviert.
Informationen zum Einrichten von VPC Service Controls für private Pools finden Sie unter VPC Service Controls verwenden.
peeredNetwork
Dies ist ein Pflichtfeld, wenn die Konfigurationsdatei des privaten Pools das Feld networkConfig enthält. Legen Sie den Wert dieses Felds auf die Netzwerkressourcen-URL des VPC-Netzwerks fest, das per Peering mit dem Netzwerk des Diensterstellers verbunden ist. Die URL der Netzwerkressource muss das Format projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME haben, wobei NETWORK_PROJECT_ID die Projekt-ID des Google Cloud-Projekts ist, das Ihr VPC-Netzwerk enthält, und NETWORK_NAME der Name Ihres VPC-Netzwerks ist.
Wenn Sie keinen Wert angeben, verwendet Cloud Build standardmäßig das Diensterstellernetzwerk.
peeredNetworkIpRange
Dieses Feld ist optional. Legen Sie den Wert dieses Felds fest, um den internen IP-Bereich anzugeben, dem VMs innerhalb des zugewiesenen Bereichs des Peering-Netzwerks zugewiesen werden können. Wenn der angegebene IP-Bereich nicht innerhalb des Bereichs der privaten Verbindung zugewiesen werden kann, z. B. aufgrund von Größenbeschränkungen oder einer ungültigen Start-IP-Adresse, kann der private Pool nicht erstellt werden.
peeredNetworkIpRange wird in der CIDR-Notation (Classless Inter-Domain Routing) im Format 'STARTING_IP/SUBNET_PREFIX_SIZE' angegeben. Wenn dieses Feld verwendet wird, muss SUBNET_PREFIX_SIZE angegeben werden. SUBNET_PREFIX_SIZE bestimmt die Größe des IP-Bereichs. Er muss mit einem Schrägstrich (/) beginnen und einen Wert kleiner oder gleich 29 haben. Der STARTING_IP-Teil ist optional und gibt die Startadresse des Bereichs an. Wenn STARTING_IP nicht angegeben ist, wird automatisch eine Startadresse aus dem Bereich der privaten Verbindung zugewiesen. Wenn für peeredNetworkIpRange kein Wert angegeben ist, wird der Standardwert /24 verwendet. Dadurch wird automatisch eine Start-IP mit einem Bereich von 256 IP-Adressen zugewiesen.
Der Wert von SUBNET_PREFIX_SIZE darf 29 nicht überschreiten. Eine größere Zahl gibt ein größeres Subnetzpräfix an, wodurch weniger mögliche IP-Adressen übrig bleiben und der IP-Bereich kleiner wird. Da eine IP-Adresse 32 Bit groß ist, erlaubt eine Präfixgröße von /24 256 mögliche IP-Adressen im Bereich (acht Bits), während eine Präfixgröße von /29 acht mögliche IP-Adressen (drei Bits) hinterlässt. Die maximale Anzahl von Builder-VMs ist auf die Anzahl der verwendbaren IP-Adressen im Bereich (die maximal mögliche Anzahl von IP-Adressen im Bereich minus zwei) beschränkt.
Hier sehen Sie Beispiele für das Feld peeredNetworkIpRange:
192.168.0.0/24gibt einen IP-Bereich ab 192.168.0.0 mit einer Subnetzpräfixgröße von 24 an (256 IP-Adressen, 254 verwendbare IP-Adressen)./29gibt einen Bereich mit einer automatisch bestimmten Start-IP-Adresse und einer Subnetzpräfixgröße von 29 an (acht IP-Adressen, sechs verwendbare IP-Adressen).
workerConfig
Dies ist ein erforderliches Feld. Es enthält Konfigurationsoptionen für den privaten Pool.
diskSizeGb
Dieses Feld ist optional. Geben Sie in diesem Feld eine Laufwerkgröße für die private Poolinstanz in GB an. Geben Sie einen Wert größer oder gleich 100 und kleiner oder gleich 2.000 an. Wenn Sie dieses Feld nicht in die Konfigurationsdatei des privaten Pools aufnehmen oder 0 als Wert dieses Felds angeben, verwendet Cloud Build den Standardwert 100.
machineType
Dieses Feld ist optional. Geben Sie in diesem Feld den Compute Engine-Maschinentyp für die private Poolinstanz an. Geben Sie einen der folgenden Maschinentypen an:
e2-mediume2-standard-2e2-standard-4e2-standard-8e2-standard-16e2-standard-32e2-highmem-2e2-highmem-4e2-highmem-8e2-highmem-16e2-highcpu-2e2-highcpu-4e2-highcpu-8e2-highcpu-16e2-highcpu-32
Wenn Sie keinen Wert angeben, verwendet Cloud Build den Standardwert e2-medium.