En este documento, se muestra cómo configurar la NAT detallada de Google Kubernetes Engine (GKE) para asignar direcciones IP de salida dedicadas a espacios de nombres de Kubernetes específicos.
Con la NAT detallada, puedes configurar direcciones IP externas de origen específicas para la NAT pública o puedes configurar direcciones IP internas de origen específicas para la NAT privada, con la tecnología de las puertas de enlace de Cloud NAT.
Para configurar la NAT detallada, declara tus políticas de enrutamiento con dos recursos personalizados con alcance de clúster:
- CloudNATGateway: Usa este recurso para aprovisionar una puerta de enlace de Cloud NAT pública o privada nueva para tu clúster o para configurar tu clúster de modo que use una puerta de enlace de Cloud NAT existente. La puerta de enlace de Cloud NAT debe estar ubicada en la región y la red de VPC del clúster.
- TrafficSelector: Usa este recurso para definir tus reglas de enrutamiento de salida
asignando espacios de nombres de origen (
namespaceSelector) y CIDR de destino a una CloudNATGateway de destino.
Antes de comenzar
Antes de configurar la NAT detallada de GKE, completa los siguientes requisitos previos:
- Verifica los requisitos del clúster: Comprueba que tu clúster nativo de la VPC ejecute la versión 1.37.1-gke.2611000 o posterior de GKE con GKE Dataplane V2 habilitado. La NAT detallada de GKE es compatible con los clústeres de Autopilot y Standard, y con los clústeres regionales y zonales.
- Verifica los permisos de IAM:
- Verifica que tengas el rol de administrador de Kubernetes Engine
(
roles/container.admin) en el clúster para aplicar recursos personalizados. - Si usas una VPC compartida: El administrador del proyecto host debe
otorgar al agente de servicio de GKE del proyecto de servicio
(
service-SERVICE_PROJECT_NUMBER@container-engine-robot.s3ns-system.iam.gserviceaccount.com) el rol de administrador de red de Compute (roles/compute.networkAdmin) en la política de IAM del proyecto host. Este rol permite que GKE cree y administre las puertas de enlace de Cloud NAT, los Cloud Routers y las direcciones IP subyacentes en la red de VPC compartida. Las redes de VPC independientes no requieren este otorgamiento manual.
- Verifica que tengas el rol de administrador de Kubernetes Engine
(
- Actualiza las reglas de firewall para incluir direcciones IP de vínculo local si es necesario:
Antes de que los paquetes salientes abandonen un nodo, NAT detallada de GKE
traduce su dirección IP de origen a una dirección de vínculo local en el
rango
169.254.32.0/20. Si tu organización aplica reglas de firewall personalizadas estrictas, verifica que tus reglas se adapten a este comportamiento:- Reglas de salida: Evita especificar un parámetro de origen en las reglas de permiso de salida cuyos destinos sean nodos del clúster. Si especificas un parámetro de origen, debes incluir el rango de direcciones de vínculo local
(
169.254.32.0/20). - Reglas de entrada: Evita especificar el parámetro de destino en las reglas de permiso de entrada cuyos destinos sean nodos del clúster. Si especificas un parámetro de destino, debes incluir el rango de direcciones de vínculo local (
169.254.32.0/20).
- Reglas de salida: Evita especificar un parámetro de origen en las reglas de permiso de salida cuyos destinos sean nodos del clúster. Si especificas un parámetro de origen, debes incluir el rango de direcciones de vínculo local
(
- Tráfico dentro de la VPC: Asegúrate de que los recursos de TrafficSelector no incluyan CIDR de destino de rangos de subredes dentro de la red de VPC del clúster ni de otra red de VPC conectada con el intercambio de tráfico entre redes de VPC. La NAT privada solo proporciona conectividad para los radios de NCC o conectividad con la NAT híbrida.
- Requisitos de ruta de VPC: Para cada CIDR que se controle con NAT pública, la red de VPC del clúster debe incluir una ruta estática cuyo rango de destino incluya el CIDR y cuyo próximo salto sea la puerta de enlace de Internet predeterminada.
Limitaciones
- Granularidad a nivel de espacio de nombres: Puedes aplicar políticas de NAT detalladas de GKE solo a nivel de espacio de nombres de Kubernetes. En la versión preliminar, no puedes seleccionar Pods o cuentas de servicio individuales con selectores de etiquetas dentro de un espacio de nombres.
- Capacidad de reglas de puerta de enlace: Cada puerta de enlace de Cloud NAT admite hasta 128 reglas de NAT, lo que te permite configurar políticas para hasta 128 espacios de nombres de GKE distintos por puerta de enlace. Si tu clúster requiere políticas de salida para más de 128 espacios de nombres, debes aprovisionar puertas de enlace adicionales.
- Limitaciones de Cloud NAT: Revisa las limitaciones estándar de Cloud NAT, ya que también se aplican a tu tráfico de salida de NAT detallada. Para obtener más información, consulta las limitaciones de NAT pública y NAT privada.
Habilita la NAT detallada de GKE en un clúster
Puedes habilitar NAT detallada cuando creas un clúster nuevo o puedes actualizar un clúster existente.
Crear un clúster nuevo
Autopilot
Para crear un clúster nuevo con NAT detallada y GKE Dataplane V2 habilitados, ejecuta el siguiente comando:
gcloud container clusters create-auto "CLUSTER_NAME" \
--LOCATION_FLAG="LOCATION" \
--network="VPC_NETWORK_NAME" \
--enable-granular-nat \
--network-suite=STANDARD
Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster nuevo.LOCATION_FLAG: Especifica--regionpara un clúster regional.LOCATION: Es la región o zona de Compute Engine para el clúster (por ejemplo,us-central1ous-central1-a).VPC_NETWORK_NAME: Es el nombre de tu red de VPC.
Estándar
Para crear un clúster nuevo con NAT detallada y GKE Dataplane V2 habilitados, ejecuta el siguiente comando:
gcloud container clusters create <var>CLUSTER_NAME</var> \
--LOCATION_FLAG="LOCATION" \
--network="VPC_NETWORK_NAME" \
--enable-dataplane-v2 \
--enable-granular-nat \
--network-suite=STANDARD
Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster nuevo.LOCATION_FLAG: Especifica--regionpara un clúster regional o--zonepara un clúster zonal.LOCATION: Es la región o zona de Compute Engine para el clúster (por ejemplo,us-central1ous-central1-a).VPC_NETWORK_NAME: Es el nombre de tu red de VPC.
Actualiza un clúster existente
Autopilot
Para habilitar la NAT detallada en un clúster existente, ejecuta el siguiente comando:
gcloud container clusters update `CLUSTER_NAME` \
--LOCATION_FLAG="LOCATION" \
--enable-granular-nat
Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster existente.LOCATION_FLAG: Especifica--regionsi tu clúster existente es regional o--zonesi es zonal.LOCATION: Es la región o zona de Compute Engine en la que se encuentra el clúster.
Estándar
Para habilitar la NAT detallada en un clúster de Standard existente, ejecuta el siguiente comando:
gcloud container clusters update `CLUSTER_NAME` \
--LOCATION_FLAG="LOCATION" \
--enable-granular-nat \
--network-suite=STANDARD
Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster existente.LOCATION_FLAG: Especifica--regionsi tu clúster existente es regional o--zonesi es zonal.LOCATION: Es la región o zona de Compute Engine en la que se encuentra el clúster.
Configura NAT granular pública con direcciones IP de salida externas estáticas
Configura la NAT granular pública cuando las cargas de trabajo en espacios de nombres separados deban presentar direcciones IP públicas estáticas y distintas a servicios externos de terceros, como APIs de socios o puertas de enlace de pago que apliquen listas de entidades permitidas de direcciones IP estrictas.
Crea un Cloud Router regional para tu puerta de enlace de Cloud NAT. GKE no crea automáticamente el Cloud Router por ti.
gcloud compute routers create ROUTER_NAME \ --network=VPC_NETWORK_NAME \ --region=REGIONReemplaza lo siguiente:
ROUTER_NAME: Es el nombre de tu nuevo Cloud Router regional.VPC_NETWORK_NAME: Es el nombre de tu red de VPC.REGION: Es la región de Compute Engine en la que se encuentra tu clúster (por ejemplo,us-central1).
Reserva direcciones IP externas estáticas en la misma región que tu clúster de GKE para asignar direcciones IP de salida externas dedicadas a tus espacios de nombres, así como una dirección IP predeterminada para la puerta de enlace:
gcloud compute addresses create nat-ip-default \ --region=REGION gcloud compute addresses create nat-ip-1 \ --region=REGION gcloud compute addresses create nat-ip-2 \ --region=REGIONReemplaza
REGIONpor la región de Compute Engine en la que se encuentra tu clúster (por ejemplo,us-central1).Guarda el siguiente manifiesto como
cloud-nat-public.yamlpara definir una puerta de enlace de Cloud NAT regional administrada:kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-public-managed spec: type: Public cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME publicNATOptions: defaultNatExternalIPs: - name: nat-ip-default connectionOptions: udpTimeoutSeconds: 30 tcpEstablishedTimeoutSeconds: 1200 tcpTransitoryTimeoutSeconds: 30 tcpTimeWaitSeconds: 120 icmpTimeoutSeconds: 30 portOptions: minPortsPerVM: 32 maxPortsPerVM: 65536 logOptions: enable: true filter: ALLReemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de Cloud de Confiance .REGION: la región de Compute Engine en la que se encuentran tu clúster y Cloud Router.ROUTER_NAME: Es el nombre de tu Cloud Router.
Guarda el siguiente manifiesto como
traffic-selectors-public.yamlpara asignar cada espacio de nombres de destino a su dirección IP de NAT pública designada:kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-red-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"nat-ip-1"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-managed subject: pods: namespaceSelector: matchLabels: app: namespace-red-app egress: to: ipBlock: cidrs: - 0.0.0.0/0 --- kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-green-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"nat-ip-2"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-managed subject: pods: namespaceSelector: matchLabels: app: namespace-green-app egress: to: ipBlock: cidrs: - 0.0.0.0/0En estos manifiestos, se observa lo siguiente:
- La anotación
cloud.google.com/cloud-natespecifica qué dirección IP externa estática reservada traduce el tráfico de salida para el espacio de nombres coincidente. - El campo
namespaceSelector.matchLabelscoincide con las etiquetas aplicadas a tus espacios de nombres de Kubernetes de destino. - La lista
egress.to.ipBlock.cidrsque contiene0.0.0.0/0dirige todo el tráfico de Internet saliente a través de la puerta de enlace de Cloud NAT designada.
- La anotación
Aplica ambos manifiestos a tu clúster:
kubectl apply -f cloud-nat-public.yaml -f traffic-selectors-public.yaml
GKE aprovisiona automáticamente la puerta de enlace de Cloud NAT, configura las reglas de traducción según los selectores de carga de trabajo de tu espacio de nombres y asigna las direcciones IP externas reservadas.
Configura Cloud NAT privada detallada para la conectividad de VPC o NCC
Usa Cloud NAT detallada privada para asignar rangos de direcciones IP internas específicos para las cargas de trabajo que se conectan a redes locales o a otros radios de VPC en un concentrador de NCC.
Crea subredes dedicadas con el propósito
PRIVATE_NATen tu red de VPC:gcloud compute networks subnets create private-nat-subnet-1 \ --region=REGION \ --network=VPC_NETWORK_NAME \ --range=10.0.0.0/29 \ --purpose=PRIVATE_NAT gcloud compute networks subnets create private-nat-subnet-2 \ --region=REGION \ --network=VPC_NETWORK_NAME \ --range=10.0.1.0/29 \ --purpose=PRIVATE_NATReemplaza lo siguiente:
REGION: Es la región de Compute Engine en la que se encuentra tu clúster.VPC_NETWORK_NAME: Es el nombre de tu red de VPC.
Guarda el siguiente manifiesto como
cloud-nat-private.yamlpara crear un recurso CloudNATGateway privado:kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-private-managed spec: type: Private privateNATOptions: # Optional: Specify hubLink only if you are routing traffic through Network Connectivity Center hubLink: //networkconnectivity.googleapis.com/projects/PROJECT_ID/locations/global/hubs/HUB_NAME cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME connectionOptions: udpTimeoutSeconds: 30 tcpEstablishedTimeoutSeconds: 1200Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de Cloud de Confiance .HUB_NAME: Opcional Es el nombre de tu concentrador de Network Connectivity Center. Especifica esto solo si enrutas el tráfico a través de Network Connectivity Center. Si no usas Network Connectivity Center, omite el bloqueprivateNATOptionspor completo.ROUTER_NAME: Es el nombre de tu Cloud Router.
Guarda el siguiente manifiesto como
traffic-selectors-private.yamlpara crear recursos TrafficSelector privados que asignen tus espacios de nombres a la puerta de enlace de NAT privada:kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-red-private-route annotations: cloud.google.com/cloud-nat: '{"nat-subnet":"private-nat-subnet-1"}' spec: action: kind: CloudNATGateway name: cloud-nat-private-managed subject: pods: namespaceSelector: matchLabels: app: namespace-red-app egress: to: ipBlock: cidrs: - 10.200.0.0/24 --- kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-green-private-route annotations: cloud.google.com/cloud-nat: '{"nat-subnet":"private-nat-subnet-2"}' spec: action: kind: CloudNATGateway name: cloud-nat-private-managed subject: pods: namespaceSelector: matchLabels: app: namespace-green-app egress: to: ipBlock: cidrs: - 10.200.1.0/24Aplica la configuración de NAT privada:
kubectl apply -f cloud-nat-private.yaml -f traffic-selectors-private.yaml
Usa una puerta de enlace de Cloud NAT existente
Si administras varios clústeres de GKE en la misma red de VPC o tienes clústeres que comparten rangos de direcciones IP de Pods secundarios, puedes configurar NAT detallada para usar una puerta de enlace de Cloud NAT existente en la misma región y red de VPC. Esta configuración permite que las cargas de trabajo en clústeres separados presenten un grupo unificado de direcciones IP externas de origen cuando se conectan a extremos externos.
Enumera las puertas de enlace de Cloud NAT existentes en tu región para identificar el nombre de una puerta de enlace existente, el Cloud Router asociado y la red de VPC. La región y la red de VPC deben coincidir con las que usan los clústeres de GKE:
gcloud beta compute routers nats list \ --router=ROUTER_NAME \ --region=REGION \ --format=yamlReemplaza lo siguiente:
ROUTER_NAME: Es el nombre del Cloud Router que administra la puerta de enlace existente.REGION: Es la región de Compute Engine en la que se encuentran el clúster y la puerta de enlace existente (por ejemplo,us-central1).
Guarda el siguiente manifiesto como
cloud-nat-shared.yamlpara vincular tu clúster a la puerta de enlace existente:kind: CloudNATGateway apiVersion: networking.gke.io/v1 metadata: name: cloud-nat-public-shared spec: type: Public # type is a required field even for shared gateways. Can be either Public or Private. gatewayName: SHARED_NAT_GATEWAY_NAME cloudRouter: name: projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAMEReemplaza lo siguiente:
SHARED_NAT_GATEWAY_NAME: Es el nombre de la puerta de enlace de Cloud NAT existente.PROJECT_ID: Es el ID del proyecto de Cloud de Confiance .REGION: Es la región de Compute Engine en la que se encuentran el clúster y la puerta de enlace existente.ROUTER_NAME: Es el nombre del Cloud Router regional que administra la puerta de enlace existente.
Guarda el siguiente manifiesto como
traffic-selector-shared.yamlpara enrutar el tráfico saliente desde tu espacio de nombres a través de la puerta de enlace compartida:kind: TrafficSelector apiVersion: networking.gke.io/v2 metadata: name: ns-shared-public-route annotations: cloud.google.com/cloud-nat: '{"nat-external-ips":"NAT_IP_NAME"}' spec: action: kind: CloudNATGateway name: cloud-nat-public-shared subject: pods: namespaceSelector: matchLabels: app: NAMESPACE_APP_LABEL egress: to: ipBlock: cidrs: - 0.0.0.0/0Reemplaza lo siguiente:
NAT_IP_NAME: Es el nombre de la dirección IP estática externa reservada configurada en la puerta de enlace compartida.NAMESPACE_APP_LABEL: Es la etiqueta que se aplica a tu espacio de nombres de Kubernetes de destino.
Aplica los manifiestos a cada clúster de GKE que necesite compartir la puerta de enlace:
kubectl apply -f cloud-nat-shared.yaml -f traffic-selector-shared.yamlRepite este paso en cada clúster en el que las cargas de trabajo del espacio de nombres seleccionado deban salir a través de la puerta de enlace compartida.
Limpia y desactiva NAT detallada
Para evitar cargos de facturación continuos y recursos de Cloud de Confiance by S3NS huérfanos, sigue un orden estricto de operaciones cuando quites NAT detallada de tu clúster.
Para limpiar los recursos de NAT detallada, completa los siguientes pasos:
Borra los recursos TrafficSelector creados por el usuario:
Borra los recursos personalizados de TrafficSelector que creaste para tus espacios de nombres. No uses la marca
--all, ya que borrar los selectores creados por el sistema (comognat-intra-clusterognat-default-internet) puede interrumpir el tráfico del clúster.kubectl delete trafficselector SELECTOR_NAMEReemplaza
SELECTOR_NAMEpor el nombre del recurso TrafficSelector.Los controladores de NAT detallada se coordinan con las redes de Cloud de Confiance by S3NS para borrar las reglas de NAT específicas y las asignaciones de cargas de trabajo asociadas con tus espacios de nombres.
Verifica que todos los recursos de TrafficSelector hayan completado la finalización antes de continuar.
Borra los recursos de CloudNATGateway:
Borra todos los recursos personalizados de CloudNATGateway en el clúster:
kubectl delete cloudnatgateway --all- Puertas de enlace administradas: GKE borra automáticamente la puerta de enlace de Cloud NAT subyacente en Cloud de Confiance by S3NS después de que se quitan todas las reglas de traducción.
- Puertas de enlace compartidas: GKE limpia las reglas de NAT relevantes asociadas con tus espacios de nombres. GKE no quita las asociaciones de direcciones IP secundarias de los Pods del clúster, y la puerta de enlace de Cloud NAT compartida permanece activa para otros clústeres.
Inhabilita la función en el clúster:
Después de que se quiten por completo todos los recursos personalizados de NAT detallada, inhabilita la función en tu clúster:
gcloud container clusters update CLUSTER_NAME \ --location=LOCATION \ --no-enable-granular-natReemplaza lo siguiente:
CLUSTER_NAME: El nombre de tu clúster.LOCATION: Es la región o zona de Compute Engine en la que se encuentra el clúster (por ejemplo,us-central1ous-central1-a).
Soluciona problemas
Si tienes problemas de conectividad, usa los siguientes métodos para diagnosticar fallas en la configuración de NAT detallada y en el plano de datos.
Verifica el estado y los registros de los recursos
Inspecciona el estado de los recursos personalizados: Verifica si hay condiciones de error en tus recursos personalizados CloudNATGateway o TrafficSelector:
kubectl describe cloudnatgateway GATEWAY_NAME kubectl describe trafficselector SELECTOR_NAMEReemplaza lo siguiente:
GATEWAY_NAME: Es el nombre de tu recurso CloudNATGateway.SELECTOR_NAME: Es el nombre de tu recurso TrafficSelector.
Revisa las reglas de Cloud NAT: Verifica que las reglas del selector de cargas de trabajo de GKE estén activas en la puerta de enlace de Cloud NAT subyacente:
gcloud beta compute routers nats rules list \ --router=ROUTER_NAME \ --nat=NAT_NAME \ --region=REGION \ --format=yamlReemplaza lo siguiente:
ROUTER_NAME: Es el nombre de tu Cloud Router regional.NAT_NAME: Es el nombre de tu puerta de enlace de Cloud NAT.REGION: Es la región de Compute Engine en la que se encuentran tus recursos.
Analiza los registros de Cloud NAT: Si el tráfico de salida se descarta o no se traduce, consulta las entradas de registro de Cloud NAT en Cloud Logging. Filtra el campo
gke_workload_identitypara correlacionar los eventos de conexión directamente con espacios de nombres de GKE específicos.
Para obtener más información sobre el diagnóstico de errores generales de Cloud NAT, consulta Solución de problemas de Cloud NAT.
¿Qué sigue?
- Obtén más información sobre la descripción general de Cloud NAT.
- Consulta GKE Dataplane V2.