Esquema del archivo de configuración del grupo privado

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Un archivo de configuración de grupo privado (archivo de configuración de grupo privado) contiene instrucciones para que Cloud Build cree un grupo privado en función de tus especificaciones. Un archivo de configuración de grupo privado contiene información como el tamaño de disco y el tipo de máquina que deseas usar para tu grupo privado. El archivo de configuración de grupo privado es obligatorio cuando creas y administras grupos privados mediante la herramienta de gcloud o la API de Cloud Build.

Estructura de un archivo de configuración de un grupo de trabajadores

Puedes escribir el archivo de configuración de grupo privado con la sintaxis YAML o JSON. Para crear y administrar grupos privados mediante curl, escribe el archivo de configuración de grupo privado en formato JSON. Para crear y administrar grupos privados mediante la herramienta de gcloud, escribe el archivo de configuración de grupo privado en el formato YAML o JSON.

Un archivo de configuración de grupo privado de trabajadores tiene la siguiente estructura:

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"
    }
  }
}

Los campos en el archivo de configuración del grupo privado se explican a continuación:

networkConfig

Este paso es opcional, Especifica networkConfig solo si intercambias tráfico entre tu red de VPC y la red del productor de servicios.

egressOption

Este paso es opcional, Configura el valor de este campo como NO_PUBLIC_EGRESS si creas tu grupo privado dentro de un perímetro de Controles del servicio de VPC. Si no incluyes este campo en el archivo de configuración de grupo privado, se habilita la salida pública. Si deseas obtener información sobre la configuración de los Controles del servicio de VPC para grupos privados, consulta Usa los Controles del servicio de VPC.

peeredNetwork

Este es un campo obligatorio si tu archivo de configuración de grupo privado contiene el campo networkConfig. Establece el valor de este campo en la URL de recursos de red de la red de VPC que intercambia el tráfico con la red del productor de servicios. La URL del recurso de red debe tener el formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, en el que NETWORK_PROJECT_ID es el ID del proyecto de Cloud que contiene tu red de VPC y NETWORK_NAME es el nombre de tu red de VPC. Si no especificas un valor, Cloud Build usa la red del productor de servicios de forma predeterminada.

peeredNetworkIpRange

Este paso es opcional, Establece el valor de este campo para especificar el rango de IP al que se pueden asignar las VM dentro del rango asignado de la red de intercambio de tráfico. Si el rango de IP especificado no se puede asignar dentro del rango de la conexión privada (por ejemplo, debido a limitaciones de tamaño o a una IP de inicio no válida), no se puede crear el grupo privado.

peeredNetworkIpRange se especifica mediante la notación de enrutamiento entre dominios sin clases (CIDR) en el formato 'STARTING_IP/SUBNET_PREFIX_SIZE'. Si se usa este campo, se debe especificar SUBNET_PREFIX_SIZE. SUBNET_PREFIX_SIZE determina el tamaño del rango de IP. Debe comenzar con una barra (/) y tener un valor menor o igual que 29. La parte STARTING_IP es opcional y especifica la dirección de inicio del rango. Si no se especifica STARTING_IP, se asigna automáticamente una dirección de inicio desde el rango de conexión privada. Si no se especifica un valor para peeredNetworkIpRange, se usará un valor predeterminado de /24, que asigna automáticamente una IP de inicio con un rango de 256 IP.

El valor de SUBNET_PREFIX_SIZE no debe ser superior a 29. Un número mayor especifica un prefijo de subred más grande, lo que dejaría menos IP posibles y daría como resultado un rango de IP más pequeño. Como una dirección IP es de 32 bits, un tamaño de prefijo de /24 permite 256 IP posibles en el rango (ocho bits), mientras que un tamaño de prefijo de /29 deja ocho IP posibles (tres bits). La cantidad máxima de VM del compilador se limita a la cantidad de IP que se pueden usar en el rango (la cantidad total posible de IP en el rango menos dos).

Consulta los siguientes ejemplos para ver ejemplos del campo peeredNetworkIpRange:

  • 192.168.0.0/24 especifica un rango de IP que comienza en 192.168.0.0 con un tamaño de prefijo de subred de 24 (256 IP, con 254 IP utilizables).
  • /29 especifica un rango con una IP de inicio determinada automáticamente y un tamaño de prefijo de subred de 29 (ocho IP, con seis IP utilizables).

workerConfig

Este campo es obligatorio. Contiene opciones de configuración para tu grupo privado.

diskSizeGb

Este paso es opcional, Usa este campo a fin de especificar un tamaño de disco para tu instancia de grupo privado en GB. Especifica un valor superior o igual a 100 y menor o igual que 1,000. Si no incluyes este campo en tu archivo de configuración de grupo privado o si especificas 0 como el valor de este campo, Cloud Build usa el valor predeterminado de 100.

machineType

Este paso es opcional, Usa este campo a fin de especificar el tipo de máquina de Compute Engine para la instancia de grupo privado. Especifica uno de los siguientes tipos de máquinas:

+ `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`

Si no especificas un valor, Cloud Build usa el valor predeterminado de e2-medium.

¿Qué sigue?