Crea subredes adicionales en la nube privada virtual (VPC) interna de tu organización o en la VPC predeterminada para satisfacer tus requisitos de red interna. Por ejemplo, añade subredes de VPC para asegurarte de que tus cargas de trabajo internas, como las máquinas virtuales y los contenedores, tengan suficientes direcciones IP.
En esta página se describen varias tareas que no tienen por qué completarse en orden:
- Crear una subred de rama de zona para cargas de trabajo: esta tarea es útil para organizar o asignar mejor las direcciones IP internas de tu zona a las cargas de trabajo.
- Crear una subred de hoja para una carga de trabajo concreta: esta tarea es útil cuando tienes una carga de trabajo nueva que aún no tiene una dirección IP que usar.
- Asignar una subred de zona de un intervalo de direcciones IP globales: esta tarea es útil cuando tu zona ya no tiene suficiente espacio de direcciones IP internas.
- Dividir la subred global raíz sin asignación de zona: esta tarea es útil para organizar mejor las direcciones IP internas en el servidor de la API global antes de asignarlas a una zona.
- Añadir una nueva subred global de intervalo raíz de red: esta tarea es útil cuando tu VPC predeterminada ya no tiene suficiente espacio de direcciones IP internas globales para asignarlo a tus zonas.
Para obtener una descripción general de las subredes y sus conceptos antes de completar las tareas de esta página, consulta Subredes y direcciones IP.
Este documento está dirigido a los administradores de plataformas y a los operadores de aplicaciones que se encargan de gestionar el tráfico de red de su organización. Para obtener más información, consulta la documentación sobre las audiencias de GDC aislado.
Antes de empezar
Para obtener el permiso que necesitas para crear subredes, pide al admin. de la org. de gestión de identidades y accesos que te asigne el rol de gestión de identidades y accesos de administrador de la organización de subredes (subnet-org-admin). Este rol no está vinculado a un espacio de nombres.
Crear una subred de sucursal de zona para cargas de trabajo
Para subdividir aún más las direcciones IP de tu VPC predeterminada de zona, puedes crear una subred interna de zona a partir de la subred raíz de zona de la zona. Debes crear este tipo de subred en el espacio de nombres platform.
Si la subred raíz de zona superior no tiene suficientes direcciones IP disponibles, asigna otra subred de zona del intervalo de direcciones IP globales antes de continuar.
En una ventana de la terminal, crea la nueva subred de zona en el servidor de la API Management:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f - <<EOF apiVersion: ipam.gdc.goog/v1 kind: Subnet metadata: labels: ipam.gdc.goog/vpc: default-vpc name: SUBNET_NAME namespace: platform spec: ipv4Request: prefixLength: CIDR_PREFIX_LENGTH networkSpec: enableGateway: true enableVLANID: false parentReference: name: PARENT_SUBNET_NAME namespace: platform type: Branch EOFHaz los cambios siguientes:
MANAGEMENT_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig de tu servidor de la API de gestión. Para obtener más información, consulta el artículo Recursos de servidor de la API de gestión de zonas.SUBNET_NAME: el nombre de tu nueva subred.CIDR_PREFIX_LENGTH: la longitud del prefijo de tu nueva subred, como27. Este campo asigna de forma dinámica el siguiente intervalo de direcciones IP disponible de ese tamaño de la subred superior. Usa el campoprefixLengthcuando solo te interese el tamaño de la subred, no su intervalo de direcciones IP específico.Para asignar un intervalo de direcciones IP específico, sigue estos pasos:
- Elimina la línea
prefixLength: CIDR_PREFIX_LENGTH. - Añade una línea
cidr: "YOUR_CIDR_BLOCK"en su lugar, comocidr: "10.0.10.0/27".
Usa el campo
cidrcuando sigas un plan de IP estricto y necesites asignar un intervalo de direcciones IP preciso y predecible. Este intervalo debe ser una subred válida y disponible dentro de la subred superior.- Elimina la línea
PARENT_SUBNET_NAME: el nombre de la subred superior, comodefault-vpc-zone0-cidr. La subred superior suele ser una subred raíz de zona de la VPC predeterminada.
Para obtener más información, consulta la documentación de referencia sobre la API del recurso
Subnet.Puedes seguir subdividiendo tus subredes de zona o crear una subred de hoja para asignar una dirección IP individual directamente a una carga de trabajo interna.
Crear una subred hoja para una carga de trabajo individual
Para asignar una sola dirección IP a tu carga de trabajo, debes crear una subred hoja.
Esta subred hoja debe tener el valor de campo type: Leaf y debe residir en el mismo espacio de nombres de proyecto que tu recurso de carga de trabajo, como una VM o un contenedor.
Tu subred hoja debe configurarse con un valor de prefixLength de 32, ya que está pensada para asignar una sola dirección IP. El valor parentReference hace referencia a una subred asignada anteriormente, como la subred de zona principal que has creado en Crear una subred de rama de zona para cargas de trabajo.
En una ventana de la terminal, crea la subred hoja en el servidor de la API de gestión:
kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG apply -f - <<EOF apiVersion: ipam.gdc.goog/v1 kind: Subnet metadata: labels: ipam.gdc.goog/vpc: default-vpc name: SUBNET_NAME namespace: PROJECT_NAMESPACE spec: ipv4Request: prefixLength: 32 parentReference: name: PARENT_SUBNET namespace: PARENT_NAMESPACE type: Leaf EOFHaz los cambios siguientes:
MANAGEMENT_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig de tu servidor de la API de gestión. Para obtener más información, consulta el artículo Recursos de servidor de la API de gestión de zonas.SUBNET_NAME: el nombre de la subred hoja.PROJECT_NAMESPACE: el espacio de nombres del proyecto correspondiente a tu proyecto donde se encuentran tus cargas de trabajo.PARENT_SUBNET: el nombre de la subred principal de la que esta subred hoja obtendrá su dirección IP.PARENT_NAMESPACE: el espacio de nombresPROJECT_NAMESPACEoplatform.
Tu dirección IP individual ya se puede usar en tus cargas de trabajo internas, como máquinas virtuales y contenedores. Para obtener más información sobre cómo configurar la dirección IP de tus cargas de trabajo, consulta Crear una VM con una dirección IP estática o dinámica o Configurar un balanceador de carga interno para cargas de trabajo de contenedores.
Asignar una subred de zona de un intervalo de direcciones IP globales
Si tu zona no proporciona suficientes direcciones IP para tus cargas de trabajo del intervalo de direcciones IP de la subred raíz de la zona, puedes asignar direcciones IP adicionales del intervalo raíz de direcciones IP globales.
Para asignar una subred de zona del intervalo de direcciones IP globales, sigue estos pasos para la red de VPC predeterminada en el espacio de nombres platform:
En una ventana de la terminal, describe todas las subredes raíz de la VPC predeterminada y comprueba sus bloques CIDR disponibles:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe subnets --namespace platform \ -l ipam.gdc.goog/vpc=default-vpc,ipam.gdc.goog/usage=network-root-rangeSustituye
GLOBAL_API_SERVER_KUBECONFIGpor la ruta al archivo kubeconfig del servidor de la API global. Para obtener más información, consulta Recursos globales del servidor de la API. Las etiquetas son constantes y deben seguir siendo las mismas.El resultado debería ser similar al siguiente:
Name: default-vpc-root-cidr Namespace: platform Labels: ipam.gdc.goog/allocation-preference=default ipam.gdc.goog/subnet-group=default-vpc-root-group ipam.gdc.goog/usage=network-root-range ipam.gdc.goog/vpc=default-vpc Annotations: <none> API Version: ipam.global.gdc.goog/v1 Kind: Subnet Metadata: Creation Timestamp: 2025-06-18T23:05:38Z Finalizers: global-subnet-finalizer Generation: 1 Resource Version: 439434 UID: 5ed1c51a-b5ee-473e-a185-8e065a87ae8f Spec: ipv4Request: Cidr: 10.252.0.0/14 Propagation Strategy: None Type: Root Status: Children Refs: Name: default-vpc-zone1-root-cidr Namespace: platform Type: SingleSubnet Conditions: Last Transition Time: 2025-06-18T23:05:38Z Message: IP allocation finished successfully Observed Generation: 1 Reason: AllocationSucceeded Status: True Type: Ready ipv4Allocation: Available CIDRs: 10.254.0.0/15 10.253.0.0/16 Cidr: 10.252.0.0/14 Events: <none>Ten en cuenta los valores de
Status.ipv4Allocation.Available CIDRs. Estos valores son los bloques CIDR disponibles a los que se hace referencia en el siguiente paso. En el resultado anterior, los intervalos CIDR10.254.0.0/15y10.253.0.0/16están disponibles. Es posible que tu salida muestre varias subredes. Anota todos los bloques CIDR disponibles y sus subredes de origen.Compara el bloque CIDR más grande disponible del paso anterior con el tamaño del bloque CIDR que necesitas para tu zona. Si el bloque CIDR más grande disponible no es lo suficientemente grande como para asignar tu nueva subred, añade una nueva subred global de intervalo raíz de red antes de continuar. Anota la subred superior de la que quieres obtener el bloque CIDR para tu nueva subred.
Por ejemplo, si necesitas un bloque CIDR
/13, pero los CIDRs disponibles solo incluyen/15y/16, debes añadir una nueva subred global de intervalo raíz de red. Si necesitas una subred/15, puedes asignar una nueva subred de zona del bloque CIDR/15que ya tengas.Crea la nueva subred en el servidor de la API global:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF apiVersion: ipam.global.gdc.goog/v1 kind: Subnet metadata: labels: ipam.gdc.goog/vpc: default-vpc ipam.gdc.goog/usage: zone-network-root-range name: SUBNET_NAME namespace: platform spec: ipv4Request: prefixLength: CIDR_PREFIX_LENGTH zone: ZONE_NAME propagationStrategy: SingleZone type: Branch parentReference: name: PARENT_SUBNET_NAME namespace: ORG_NAME EOFHaz los cambios siguientes:
GLOBAL_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API global. Para obtener más información, consulta Recursos globales del servidor de la API.SUBNET_NAME: el nombre de la nueva subred.CIDR_PREFIX_LENGTH: la longitud del prefijo CIDR de la nueva subred que se asigna dinámicamente, como20. Para definir el CIDR de forma estática, sustituye el campoprefixLengthpor el campocidry, a continuación, define el bloque CIDR, como10.0.10.0/27.ZONE_NAME: la zona a la que se asignará la subred, comozone1.PARENT_SUBNET_NAME: el nombre de la subred superior, comodefault-vpc-root-cidr, o la nueva subred global del intervalo raíz de la red que has creado.ORG_NAME: el nombre de la organización.
Para obtener más información, consulta la documentación de referencia sobre la API del recurso
Subnet.Comprueba que la subred esté lista y disponible en el servidor de la API global. Para ello, verifica que el tipo de estado
Readyseatrue:kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG get subnet --namespace platform \ SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'El resultado debería ser similar al siguiente:
status: conditions: - lastTransitionTime: "2025-06-06T07:28:48Z" message: IP allocation finished successfully observedGeneration: 1 reason: AllocationSucceeded status: "True" type: ReadyVerifica que la subred de zona se haya creado en el servidor de la API de gestión de zonas y que su tipo de estado
Readyseatrue:kubectl --kubeconfig MANAGEMENT_API_SERVER_KUBECONFIG get subnet --namespace platform \ SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'Sustituye
MANAGEMENT_API_SERVER_KUBECONFIGpor la ruta al archivo kubeconfig de tu servidor de la API de gestión. Para obtener más información, consulta el artículo Recursos de servidor de la API de gestión de zonas.El resultado debería ser similar al siguiente:
status: conditions: - lastTransitionTime: "2025-06-06T07:29:34Z" message: IP allocation finished successfully observedGeneration: 1 reason: AllocationSucceeded status: "True" type: ReadyDesde esta nueva subred de zona, puedes crear más subredes secundarias de zona o asignar una dirección IP individual directamente a una carga de trabajo interna.
Dividir la subred global raíz sin asignación de zona
Para dividir aún más una subred global sin asignarla a una zona, crea una subred global y omite la estrategia de propagación en el recurso personalizado Subnet. Este enfoque es útil si quieres seguir organizando tu intervalo de direcciones IP de acceso global desde la subred raíz global sin asignar las direcciones IP a una zona.
Para dividir tu subred raíz global dentro del ámbito global, sigue estos pasos en el espacio de nombres platform:
En una ventana de la terminal, describe todas las subredes raíz de la VPC predeterminada y comprueba sus bloques CIDR disponibles:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe subnets --namespace platform \ -l ipam.gdc.goog/vpc=default-vpc,ipam.gdc.goog/usage=network-root-rangeSustituye
GLOBAL_API_SERVER_KUBECONFIGpor la ruta al archivo kubeconfig del servidor de la API global. Para obtener más información, consulta Recursos globales del servidor de la API. Las etiquetas son constantes y deben seguir siendo las mismas.El resultado debería ser similar al siguiente:
Name: default-vpc-root-cidr Namespace: platform Labels: ipam.gdc.goog/allocation-preference=default ipam.gdc.goog/subnet-group=default-vpc-root-group ipam.gdc.goog/usage=network-root-range ipam.gdc.goog/vpc=default-vpc Annotations: <none> API Version: ipam.global.gdc.goog/v1 Kind: Subnet Metadata: Creation Timestamp: 2025-06-18T23:05:38Z Finalizers: global-subnet-finalizer Generation: 1 Resource Version: 439434 UID: 5ed1c51a-b5ee-473e-a185-8e065a87ae8f Spec: ipv4Request: Cidr: 10.252.0.0/14 Propagation Strategy: None Type: Root Status: Children Refs: Name: default-vpc-zone1-root-cidr Namespace: platform Type: SingleSubnet Conditions: Last Transition Time: 2025-06-18T23:05:38Z Message: IP allocation finished successfully Observed Generation: 1 Reason: AllocationSucceeded Status: True Type: Ready ipv4Allocation: Available CIDRs: 10.254.0.0/15 10.253.0.0/16 Cidr: 10.252.0.0/14 Events: <none>Ten en cuenta los valores de
Status.ipv4Allocation.Available CIDRs. Estos valores son los bloques CIDR disponibles a los que se hace referencia en el siguiente paso. En el resultado anterior, los intervalos CIDR10.254.0.0/15y10.253.0.0/16están disponibles. Puede haber varias subredes en tu salida, dependiendo del número de subredes raíz que tengas, así que anota todos los bloques CIDR disponibles y de qué subred procede cada uno.Compara el bloque CIDR más grande disponible del paso anterior con el tamaño del bloque CIDR que necesitas para tu nueva subred global. Si el bloque CIDR más grande disponible no es lo suficientemente grande como para asignar tu nueva subred, añade una nueva subred global de intervalo raíz de red antes de continuar. Anota la subred superior de la que quieres obtener el bloque CIDR para tu nueva subred.
Por ejemplo, si necesitas un bloque CIDR
/13, pero los CIDRs disponibles solo incluyen/15y/16, debes crear una nueva subred global de intervalo raíz de red. Si necesitas una subred/15, puedes asignar la nueva subred global desde el bloque CIDR/15que ya tienes.Crea la nueva subred en el servidor de la API global:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF apiVersion: ipam.global.gdc.goog/v1 kind: Subnet metadata: labels: ipam.gdc.goog/vpc: default-vpc ipam.gdc.goog/usage: zone-network-root-range name: SUBNET_NAME namespace: platform spec: ipv4Request: prefixLength: CIDR_PREFIX_LENGTH propagationStrategy: None type: Branch parentReference: name: PARENT_SUBNET_NAME namespace: ORG_NAME EOFHaz los cambios siguientes:
GLOBAL_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API global. Para obtener más información, consulta Recursos globales del servidor de la API.SUBNET_NAME: el nombre de la nueva subred.CIDR_PREFIX_LENGTH: la longitud del prefijo CIDR de la nueva subred que se asigna dinámicamente, como20. Para definir el CIDR de forma estática, sustituye el campoprefixLengthpor el campocidry, a continuación, define el bloque CIDR, como10.0.10.0/27.PARENT_SUBNET_NAME: el nombre de la subred superior, comodefault-vpc-root-cidr, o la nueva subred global del intervalo raíz de la red que has creado.ORG_NAME: el nombre de la organización.
Para obtener más información, consulta la documentación de referencia sobre la API del recurso global
Subnet.Comprueba que la subred esté lista y disponible en el servidor de la API global. Para ello, verifica que el tipo de estado
Readyseatrue:kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG get subnet --namespace platform \ SUBNET_NAME --output jsonpath='{.status.conditions[?(@.type=="Ready")].status}'El resultado debería ser similar al siguiente:
status: conditions: - lastTransitionTime: "2025-06-06T07:28:48Z" message: IP allocation finished successfully observedGeneration: 1 reason: AllocationSucceeded status: "True" type: Ready
La nueva subred global de tu organización en la VPC predeterminada ya está disponible. Puedes crear una subred para una zona concreta a partir de esta nueva subred principal global.
Añadir nueva subred global de intervalo raíz de red
Las subredes globales con la etiqueta ipam.gdc.goog/usage: network-root-range alojan el CIDR de todas las zonas de la red. Si se agota el CIDR, debes crear una nueva subred de intervalo raíz de red en el servidor de la API global. Puedes crear varias subredes globales raíz si es necesario.
Para crear una subred de intervalo raíz de red, sigue estos pasos:
En una ventana de la terminal, crea la nueva subred global del intervalo raíz de red para la VPC predeterminada en el espacio de nombres
platform:kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f - <<EOF apiVersion: ipam.global.gdc.goog/v1 kind: Subnet metadata: labels: ipam.gdc.goog/vpc: default-vpc ipam.gdc.goog/usage: network-root-range name: SUBNET_NAME namespace: platform spec: ipv4Request: cidr: NEW_CIDR type: Root EOFHaz los cambios siguientes:
GLOBAL_API_SERVER_KUBECONFIG: la ruta al archivo kubeconfig del servidor de la API global. Para obtener más información, consulta Recursos globales del servidor de la API.SUBNET_NAME: el nombre de la nueva subred.NEW_CIDR: el nuevo CIDR de la subred. Este CIDR no puede solaparse con ningún CIDR de todas las subredes que tengan la etiquetaipam.gdc.goog/usage: network-root-rangeen el mismo servidor de la API global.
Esta nueva subred de intervalo raíz global se puede subdividir en el servidor de la API global o asignar a una zona específica.
Siguientes pasos
- Subredes y direcciones IP
- Descripción general de las redes
- Desplegar una aplicación de VM de alta disponibilidad
- Desplegar una aplicación en contenedores de alta disponibilidad