Configura la NAT detallada de GKE

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.
  • 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).
  • 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 --region para un clúster regional.
  • LOCATION: Es la región o zona de Compute Engine para el clúster (por ejemplo, us-central1 o us-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 --region para un clúster regional o --zone para un clúster zonal.
  • LOCATION: Es la región o zona de Compute Engine para el clúster (por ejemplo, us-central1 o us-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 --region si tu clúster existente es regional o --zone si 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 --region si tu clúster existente es regional o --zone si 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.

  1. 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=REGION
    

    Reemplaza 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).
  2. 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=REGION
    

    Reemplaza REGION por la región de Compute Engine en la que se encuentra tu clúster (por ejemplo, us-central1).

  3. Guarda el siguiente manifiesto como cloud-nat-public.yaml para 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: ALL
    

    Reemplaza 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.
  4. Guarda el siguiente manifiesto como traffic-selectors-public.yaml para 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/0
    

    En estos manifiestos, se observa lo siguiente:

    • La anotación cloud.google.com/cloud-nat especifica qué dirección IP externa estática reservada traduce el tráfico de salida para el espacio de nombres coincidente.
    • El campo namespaceSelector.matchLabels coincide con las etiquetas aplicadas a tus espacios de nombres de Kubernetes de destino.
    • La lista egress.to.ipBlock.cidrs que contiene 0.0.0.0/0 dirige todo el tráfico de Internet saliente a través de la puerta de enlace de Cloud NAT designada.
  5. 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.

  1. Crea subredes dedicadas con el propósito PRIVATE_NAT en 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_NAT
    

    Reemplaza 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.
  2. Guarda el siguiente manifiesto como cloud-nat-private.yaml para 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: 1200
    

    Reemplaza 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 bloque privateNATOptions por completo.
    • ROUTER_NAME: Es el nombre de tu Cloud Router.
  3. Guarda el siguiente manifiesto como traffic-selectors-private.yaml para 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/24
    
  4. Aplica 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.

  1. 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=yaml
    

    Reemplaza 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).
  2. Guarda el siguiente manifiesto como cloud-nat-shared.yaml para 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_NAME
    

    Reemplaza 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.
  3. Guarda el siguiente manifiesto como traffic-selector-shared.yaml para 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/0
    

    Reemplaza 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.
  4. 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.yaml
    

    Repite 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:

  1. 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 (como gnat-intra-cluster o gnat-default-internet) puede interrumpir el tráfico del clúster.

    kubectl delete trafficselector SELECTOR_NAME
    

    Reemplaza SELECTOR_NAME por 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.

  2. 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.
  3. 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-nat
    

    Reemplaza 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-central1 o us-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_NAME
    

    Reemplaza 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=yaml
    

    Reemplaza 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_identity para 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?