Schema der privaten Pool-Konfigurationsdatei

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 folgende Format haben: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, Dabei ist NETWORK_PROJECT_ID die Projekt-ID das Google Cloud-Projekt mit Ihrem VPC-Netzwerk und NETWORK_NAME ist der Name Ihres VPC-Netzwerk. 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, der VMs innerhalb des zugewiesenen Bereichs des Peer-Netzwerks zugewiesen werden kann. 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. Sie muss mit einem Schrägstrich (/) beginnen und einen Wert kleiner oder gleich 29 haben. Der Teil STARTING_IP 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, der automatisch eine Start-IP mit einem Bereich von 256 IP-Adressen zuweist.

Der Wert für SUBNET_PREFIX_SIZE darf 29 nicht überschreiten. Eine größere Zahl gibt ein größeres Subnetzpräfix an, was weniger mögliche IP-Adressen und einen kleineren IP-Bereich zur Folge hätte. Da eine IP-Adresse 32 Bit umfasst, erlaubt eine Präfixgröße von /24 256 mögliche IP-Adressen im Bereich (8 Bit), während bei einer Präfixgröße von /29 acht mögliche IP-Adressen (3 Bits) übrig bleiben. Die maximale Anzahl von Builder-VMs ist auf die Anzahl der nutzbaren IP-Adressen im Bereich beschränkt (die Gesamtzahl der möglichen IP-Adressen im Bereich abzüglich zwei).

Im Folgenden finden Sie Beispiele für das Feld peeredNetworkIpRange:

  • 192.168.0.0/24 gibt einen IP-Bereich ab 192.168.0.0 mit einer Subnetzpräfixgröße von 24 (256 IP-Adressen, 254 verwendbare IP-Adressen) an.
  • /29 gibt einen Bereich mit einer automatisch bestimmten Start-IP-Adresse und einer Subnetzpräfixgröße von 29 an (acht IP-Adressen mit sechs verwendbaren IP-Adressen).

workerConfig

Dies ist ein Pflichtfeld. 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 an 100 und kleiner oder gleich 2.000 ist. 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-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

Wenn Sie keinen Wert angeben, verwendet Cloud Build den Standardwert e2-standard-2.

Nächste Schritte