Esquema del archivo de configuración del grupo privado

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 basado en según tus especificaciones. Un archivo de configuración de grupo privado contiene información como el tamaño del disco y el tipo de máquina que deseas usar para tu grupo privado. El archivo de configuración del grupo privado es necesario cuando creas y administras grupos privados con 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 del grupo privado con la sintaxis de YAML o JSON. Para crear y administrar grupos privados con curl, escribe el archivo de configuración del grupo privado en formato JSON. Para crear y administrar grupos privados con la herramienta de gcloud, escribe el archivo de configuración del grupo privado en 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 estableces un intercambio de tráfico entre tu red de VPC y la red del productor de servicios.

egressOption

Este paso es opcional, Establece el valor de este campo en NO_PUBLIC_EGRESS si vas a crear tu grupo privado dentro de un perímetro de Controles del servicio de VPC. Si no incluyas este campo en el archivo de configuración del grupo privado, la salida pública está habilitada. Si deseas obtener información para configurar los Controles del servicio de VPC para grupos privados, consulta Usa los Controles del servicio de VPC.

peeredNetwork

Este es un campo obligatorio si el archivo de configuración de tu grupo privado contiene el networkConfig . Establece el valor de este campo en la URL del recurso de red de la red de VPC que realiza un intercambio de 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 Google 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 el productor de servicios red de forma predeterminada.

peeredNetworkIpRange

Este paso es opcional, Establece el valor de este campo para especificar el rango de IP interno al que se pueden asignar las VMs dentro del rango asignado de la red en pares. 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 con la notación 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 diagonal (/) y tener un valor menor o igual que 29. La parte STARTING_IP es opcional y especifica la dirección inicial del rango. Si no se especifica STARTING_IP, se asigna automáticamente una dirección inicial desde el rango de conexión privada. Si no se especifica ningún valor para peeredNetworkIpRange, se usará un valor predeterminado de /24, que asignará automáticamente una IP inicial con un rango de 256 IP.

El valor de SUBNET_PREFIX_SIZE no debe superar los 29. Un número mayor especifica un prefijo de subred más extenso, lo que dejaría menos IP posibles y daría como resultado un rango de IP más pequeño. Dado que una dirección IP tiene 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 VMs de compilador se limita a la cantidad de IPs utilizables en el rango (la cantidad total posible de IPs en el rango menos dos).

Consulta los siguientes 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 inicial 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 para especificar un tamaño de disco para la instancia de tu grupo privado en GB. Especifica un valor superior o igual a 100 y menor o igual que 2,000. Si no incluyes este campo en el archivo de configuración del 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 para especificar el tipo de máquina de Compute Engine para tu 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-standard-2.

¿Qué sigue?