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 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, 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. Er 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 die STARTING_IP nicht angegeben wird, 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 IPs zuweist.

Der Wert von SUBNET_PREFIX_SIZE darf 29 nicht überschreiten. Eine größere Zahl gibt ein größeres Subnetzpräffix an, was weniger mögliche IP-Adressen und einen kleineren IP-Bereich zur Folge hat. Da eine IP-Adresse 32 Bit hat, sind bei einer Präfixgröße von /24 256 mögliche IP-Adressen im Bereich zulässig (acht Bits), während bei einer Präfixgröße von /29 acht mögliche IP-Adressen verbleiben (drei Bits). 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 Subnetzmaske mit 24 Bit (256 IP-Adressen, davon 254 verwendbar) an.
  • /29 gibt einen Bereich mit einer automatisch ermittelten Start-IP und einer Subnetzmaske mit 29 Bits (acht IP-Adressen, davon sechs nutzbar) an.

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 an, der größer oder gleich 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