Introducción

En esta página se ofrece una descripción general de las políticas de red de proyectos en Google Distributed Cloud (GDC) aislado.

Las políticas de red del proyecto definen reglas de entrada o de salida. A diferencia de las políticas de red de Kubernetes, solo puedes especificar un tipo de política para cada política. Cada regla de una política se puede configurar con una acción de Permitir (la predeterminada) o Denegar.

Para el tráfico dentro de un proyecto, GDC aplica una política de red de proyecto predefinida, la política predeterminada dentro del proyecto, a cada proyecto.

Los servicios y las cargas de trabajo de un proyecto están aislados de los servicios y las cargas de trabajo externos de forma predeterminada. Sin embargo, los servicios y las cargas de trabajo de diferentes espacios de nombres de proyectos y de la misma organización pueden comunicarse entre sí aplicando políticas de red de tráfico entre proyectos.

Del mismo modo, para conectar servicios y cargas de trabajo a un destino fuera de tu proyecto en otra organización, se requiere una aprobación explícita. Debes inhabilitar la protección contra la filtración externa de datos para permitir el tráfico externo a la organización.

Las reglas de cortafuegos de entrada y salida son los componentes principales de las políticas de red de los proyectos y determinan qué tipos de tráfico se permiten o se deniegan en tu red. Para definir reglas de cortafuegos para el espacio de nombres de tu proyecto en GDC, usa la consola de GDC.

Seguridad y conectividad

De forma predeterminada, los servicios y las cargas de trabajo de un proyecto están aislados dentro de ese proyecto. No pueden comunicarse con servicios ni cargas de trabajo externos sin configurar una política de red.

Para definir una política de red para el espacio de nombres de tu proyecto en GDC, usa el recurso ProjectNetworkPolicy. Este recurso te permite definir políticas que permiten la comunicación dentro de los proyectos, entre proyectos, con direcciones IP externas y desde direcciones IP externas. Además, solo puedes transferir cargas de trabajo de un proyecto si inhabilitas la protección contra la filtración externa de datos del proyecto.

Las políticas de red de proyectos de GDC son acumulativas. La aplicación resultante para una carga de trabajo es una coincidencia cualquiera del flujo de tráfico con la unión de todas las políticas aplicadas a esa carga de trabajo. Cuando hay varias políticas, las reglas de cada una se combinan de forma aditiva, lo que permite el tráfico si coincide con al menos una de las reglas.

Las reglas de Deny explícitas tienen prioridad absoluta sobre las reglas de Allow. Si un flujo de tráfico coincide con una regla Deny, se descarta, aunque lo permitan otra regla o las políticas predeterminadas de la plataforma.

Además, después de aplicar una sola política que seleccione una carga de trabajo, se denegará todo el tráfico que no especifiques (modo de denegación predeterminado). Por lo tanto, cuando aplicas una o varias políticas que seleccionan una carga de trabajo como asunto, solo se permite el tráfico que se permite de forma explícita (y no se deniega de forma explícita).

Cuando usas una dirección IP conocida que asignas al proyecto, se realiza una traducción de dirección de red (NAT) de origen en el tráfico saliente de la organización.

Política predeterminada dentro del proyecto

Cuando creas un proyecto, GDC crea automáticamente una política de red de proyecto global llamada base-policy-allow-intra-project-traffic en el espacio de nombres del proyecto. Esta política predeterminada hace lo siguiente:

  • Selecciona todas las cargas de trabajo de usuario del proyecto como asunto.
  • Permite el tráfico entrante a esas cargas de trabajo desde todas las cargas de trabajo del mismo proyecto, en todos los puertos.
  • No permite el tráfico entrante de otros proyectos ni de fuera de la organización.

GDC crea la política predeterminada solo una vez, cuando crea el proyecto. Si cambias o eliminas la política, GDC no la restaurará. GDC propaga la política a cada clúster del proyecto como una política de red llamada g-base-policy-allow-intra-project-traffic. El campo status.zones[].replicaStatus.propagatedName de la política muestra este nombre.

Para ver la política predeterminada, ejecuta el siguiente comando:

kubectl --kubeconfig GLOBAL_API_SERVER get projectnetworkpolicy \
    base-policy-allow-intra-project-traffic -n PROJECT -o yaml

Haz los cambios siguientes:

Si el comando devuelve un error NotFound, significa que se ha eliminado la política predeterminada. Para volver a añadirla, consulta Crear una política de entrada dentro de un proyecto.

La política predeterminada se combina con las políticas que crees de la siguiente manera:

  • Entrada: las cargas de trabajo están aisladas de otros proyectos y de fuera de la organización de forma predeterminada, independientemente de si existe o no la política predeterminada. Las políticas de entrada que creas añaden fuentes permitidas, como otros proyectos o bloques CIDR externos. Aunque la política predeterminada existe, no es necesario que repitas la regla intraproyecto en tus propias políticas de entrada.
  • Entrada intraproyecto a nivel de carga de trabajo: mientras exista la política predeterminada, todas las cargas de trabajo del proyecto podrán comunicarse entre sí en todos los puertos. Una política de entrada dentro del proyecto a nivel de carga de trabajo que use la acción Allow no restringe este tráfico hasta que elimines o cambies la política predeterminada. Para evitar interrupciones, aplica tus políticas a nivel de carga de trabajo y verifica que estén listas antes de eliminar la política predeterminada. Para bloquear el tráfico específico dentro de un proyecto mientras mantienes la política predeterminada, puedes usar una regla de denegación explícita, que es una función de vista previa. Para obtener más información, consulta Crear una política de entrada a nivel de carga de trabajo dentro de un proyecto.
  • Salida: de forma predeterminada, un proyecto no tiene ninguna política de salida. El tráfico saliente no está restringido dentro de la organización, pero la protección contra la filtración externa de datos (habilitada de forma predeterminada) bloquea el tráfico que sale de la organización. Las políticas de salida solo se aplican después de inhabilitar la protección contra la filtración externa de datos en el proyecto. Mientras la protección contra la filtración externa de datos esté habilitada, los servidores de la API de zona rechazarán las políticas de salida y las políticas de salida globales no estarán listas.

Políticas de red de proyectos globales

Puedes crear políticas de red de proyectos globales. El ámbito de las políticas de red de proyectos globales abarca todo el universo de GDC. Cada universo de GDC puede constar de varias zonas de GDC organizadas en regiones que están interconectadas y comparten un plano de control. Por ejemplo, un universo que conste de dos regiones con tres zonas cada una podría tener este aspecto: us-virginia1-a, us-virginia1-b, us-virginia1-c y eu-ams1-a, eu-ams1-b, eu-ams1-c.

El ámbito de las políticas de red de proyectos de zona se limita a las zonas especificadas en el momento de la creación. Cada zona es un dominio de desastre independiente. Una zona gestiona la infraestructura, los servicios, las APIs y las herramientas que usan un plano de control local.

Para obtener más información sobre los recursos globales de un universo de GDC, consulta Información general sobre varias zonas.

Puedes crear políticas de red de proyectos globales con la API de modelo de recursos de Kubernetes (KRM) de redes. Usa la versión networking.global.gdc.goog de la API para crear recursos globales.

Puedes crear políticas de red de proyectos de zona con la API de KRM o la consola de GDC. Usa la versión networking.gdc.goog de la API para crear recursos de zona.

Políticas de red que permiten todo

Puedes crear políticas de red que permitan todo para establecer reglas de acceso predeterminadas y generales para un proyecto.

Puedes configurar los siguientes tipos de políticas de red que permiten todo:

  • Política de red que permite todo: permite el tráfico hacia y desde cualquier fuente, lo que incluye otros proyectos e IPs externas.
  • Política de red que permite todo el tráfico externo: permite el tráfico hacia y desde direcciones IP externas a la organización.
  • Política de red para permitir todos los proyectos: permite el tráfico hacia y desde todos los proyectos de la organización.

Para obtener más información, consulta Crear políticas de red que permitan todo el tráfico.

Políticas de red de denegación explícita

Puedes configurar reglas de denegación explícitas en las políticas de red del proyecto para restringir la conectividad entre proyectos o bloques CIDR específicos.

Características y restricciones principales de las reglas de denegación:

  • Prioridad: las reglas de denegación tienen prioridad absoluta sobre las reglas de permiso (incluidas las políticas de la plataforma base).
  • Reglas de seguridad de salida: para evitar que se bloquee accidentalmente el tráfico de infraestructura crítica, las reglas de denegación de salida excluyen automáticamente los espacios de nombres del sistema y que no son de proyectos.
  • Restricción de pares: para garantizar una configuración segura, las reglas de denegación de entrada deben especificar explícitamente un par de origen en el campo from, y las reglas de denegación de salida deben especificar explícitamente un par de destino en el campo to. No puedes seleccionar todas las fuentes o destinos dejando vacío el campo de interlocutor. No se permite dejar el campo de par vacío y se rechazará la política.
  • No se puede denegar la salida con DEP: no puedes configurar reglas de denegación de salida cuando la protección contra la filtración externa de datos (DEP) está habilitada en el proyecto.

Para obtener más información, consulta Crear políticas de red de denegación explícita.

Políticas de red a nivel de carga de trabajo

Puedes crear políticas de red a nivel de carga de trabajo para definir un control de acceso pormenorizado para VMs y pods concretos de un proyecto. Estas políticas actúan como cortafuegos para tus cargas de trabajo, controlando el flujo de tráfico en función de las etiquetas para mejorar la seguridad y aislar las aplicaciones. Esta granularidad permite un control más estricto sobre qué cargas de trabajo pueden comunicarse entre sí dentro de los proyectos y entre ellos.

Las políticas de red a nivel de carga de trabajo también permiten aplicar la PNP en una sola zona.

Para obtener más información, consulta Crear una política de carga de trabajo dentro de un proyecto y Crear una política de carga de trabajo entre proyectos.

Etiquetas admitidas y no admitidas para políticas de red

GDC evalúa las políticas de red usando las etiquetas estáticas que definas en tus cargas de trabajo. Para mantener las tablas de políticas internas dentro de los límites de escala, GDC ignora las etiquetas que Kubernetes o la plataforma asignan automáticamente a pods, revisiones de controladores o componentes del sistema concretos.

Categoría Etiqueta o patrón excluidos Descripción
Etiquetas de StatefulSet statefulset.kubernetes.io/pod-name, apps.kubernetes.io/pod-index Nombre de réplica por pod de Kubernetes automatizado e índice ordinal
Etiquetas de tareas y lotes batch.kubernetes.io/job-name, batch.kubernetes.io/job-completion-index, batch.kubernetes.io/controller-uid, controller-uid y job-name Identificadores de instancias de tareas y tareas cron de Kubernetes automatizadas
Lanzamiento y hashes de plantillas pod-template-hash, pod-template-generation, controller-revision-hash Hashes de lanzamiento de ReplicaSet, Deployment y StatefulSet
Prefijos de sistema reservados kubernetes.io/*, io.kubernetes.*, *.beta.kubernetes.io/*, k8s.io/*, *.node.kubevirt.io/*, annotation.*, etcd_node Etiquetas de sistema de Kubernetes interno, de nodo de KubeVirt y de nivel de nodo

Sigue estas prácticas recomendadas para crear selectores de carga de trabajo:

  • Usa etiquetas de aplicación estables: apunta a etiquetas estáticas definidas en la especificación de tu carga de trabajo, como app, app.kubernetes.io/name, app.kubernetes.io/component, tier o role.
  • Prefijo de las etiquetas de máquina virtual: cuando se orienten anuncios a etiquetas de máquina virtual asignadas en la consola de GDC o en la API, añade user-label.gpc.gke.io/ al principio de la clave de etiqueta (por ejemplo, user-label.gpc.gke.io/app: backend).
  • Dirigirse a réplicas de StatefulSet concretas con etiquetas estáticas explícitas: para dirigirse a un pod de StatefulSet específico de forma independiente, asigna una etiqueta estática explícita a esa carga de trabajo en lugar de buscar coincidencias en statefulset.kubernetes.io/pod-name o apps.kubernetes.io/pod-index.

Estructura y validación de políticas

En un recurso ProjectNetworkPolicy, los selectores de etiquetas de carga de trabajo están anidados en varios niveles. La siguiente política de entrada muestra la ubicación correcta de cada selector:

apiVersion: networking.global.gdc.goog/v1
kind: ProjectNetworkPolicy
metadata:
  namespace: PROJECT
  name: allow-frontend-to-backend
spec:
  policyType: Ingress
  subject:
    subjectType: UserWorkload
    userWorkloadSelector:
      labelSelector:
        workloads:
          matchLabels:
            app: backend
  ingress:
  - from:
    - projectSelector:
        projects:
          matchNames:
          - PEER_PROJECT
        workloadSelector:
          labelSelector:
            workloads:
              matchLabels:
                app: frontend
    ports:
    - protocol: TCP
      port: 8080

Haz los cambios siguientes:

  • PROJECT: el nombre de tu proyecto.
  • PEER_PROJECT: el nombre del proyecto que contiene las cargas de trabajo del cliente.

Esta política permite que las cargas de trabajo etiquetadas como app: frontend en PEER_PROJECT se conecten a las cargas de trabajo etiquetadas como app: backend en tu proyecto en el puerto TCP 8080.

Cuando escribas una política, sigue estas reglas:

  • Asigna siempre a spec.policyType el valor Ingress o Egress de forma explícita. Una política Ingress solo puede contener ingress reglas con from pares, y una política Egress solo puede contener egress reglas con to pares. Si omites policyType, la política se establece de forma predeterminada en Ingress y el servidor de la API rechaza una política que solo contenga reglas egress.
  • Para seleccionar cargas de trabajo de asunto por etiqueta, usa spec.subject.userWorkloadSelector.labelSelector.workloads. Si omites userWorkloadSelector, la política se aplicará a todas las cargas de trabajo de los usuarios del proyecto.
  • No pongas selectores de etiquetas directamente debajo de spec.subject. De forma predeterminada, kubectl rechaza campos como spec.subject.matchLabels con un mensaje strict decoding error: unknown field.
  • Para seleccionar cargas de trabajo de pares por etiqueta, usa projectSelector.workloadSelector.labelSelector.workloads en una entrada from o to.
  • Si las cargas de trabajo de origen o de destino son VMs, añade el prefijo user-label.gpc.gke.io/ a sus claves de etiqueta. Por ejemplo, usa user-label.gpc.gke.io/app: backend.
  • La política predeterminada entre proyectos creada automáticamente y algunas políticas que ya existen usan el campo spec.subject.workloadSelector, que ya no se utiliza y que toma un selector de etiquetas directamente. Usa userWorkloadSelector en las nuevas políticas.

Para validar una política con el servidor de la API global sin aplicarla, ejecuta una ejecución de prueba del lado del servidor:

kubectl --kubeconfig GLOBAL_API_SERVER apply --dry-run=server \
    --validate=strict -f POLICY_FILE

La ejecución de prueba informa de los mismos errores de esquema y validación que un comando kubectl apply real, como un campo desconocido o una regla egress en una política de Ingress, pero no crea ni cambia la política. La ejecución de prueba requiere los mismos permisos que la aplicación de la política. Si la ejecución de prueba se realiza correctamente, no se confirma que se aplique la política. Después de aplicar la política, comprueba que esté lista.

Para ver una lista de los campos que acepta tu servidor de la API global, ejecuta el siguiente comando:

kubectl --kubeconfig GLOBAL_API_SERVER explain projectnetworkpolicy.spec \
    --api-version=networking.global.gdc.goog/v1 --recursive

Haz los cambios siguientes:

  • GLOBAL_API_SERVER: la ruta de kubeconfig del servidor de la API global.
  • POLICY_FILE: la ruta de tu archivo de manifiesto ProjectNetworkPolicy.

Preparar roles predefinidos y accesos

Para configurar políticas de red de proyectos, debes tener los roles de identidad y acceso necesarios:

  • Administrador de políticas de red del proyecto: tiene permisos de escritura en todos los recursos de PNP multizona del espacio de nombres del proyecto global. Pide al administrador de la organización de gestión de identidades y accesos que te asigne el rol global-project-networkpolicy-admin. Para obtener más información, consulta las descripciones de los roles predefinidos.

Nodos de clúster de destino que usan bloques de IP

Puedes usar el campo ipBlocks de un recurso ProjectNetworkPolicy para especificar direcciones IP de nodos individuales o intervalos CIDR de nodos y controlar el tráfico entre pods y nodos de clúster específicos (por ejemplo, permitir el tráfico de entrada de los nodos del plano de control a un pod de webhook personalizado o restringir el tráfico de salida de los pods a los nodos del plano de control). Para obtener instrucciones, consulta Crear una política de intraproyecto para clústeres estándar.

Consideraciones sobre la escala

Al configurar políticas de red de proyectos para orientarlas a nodos específicos o usar intervalos CIDR amplios, las opciones de configuración de la política pueden afectar a la escalabilidad y al rendimiento:

  • Comportamiento de 0.0.0.0/0: si se usa un intervalo CIDR amplio, como 0.0.0.0/0, en una regla ipBlocks, se detectarán todos los nodos del clúster, además de las direcciones IP externas.
  • Escala: a cada nodo del clúster se le asigna una identidad CIDR única. Cada endpoint de carga de trabajo (máquina virtual o pod) tiene una tabla de políticas interna que almacena sus reglas de red. En los clústeres grandes, las reglas amplias ipBlocks como 0.0.0.0/0 aumentan el uso de la tabla de políticas en proporción al número de nodos, porque el sistema debe crear entradas para cada identidad de CIDR de nodo única.
  • Advertencia: No uses intervalos CIDR demasiado amplios en las reglas de ipBlocks si tienes un número elevado de nodos o muchas políticas complejas, ya que corres el riesgo de alcanzar el límite de la tabla de políticas de un endpoint. Si un endpoint alcanza este límite, no se podrán aplicar nuevas políticas de red, lo que puede interrumpir la conectividad de red o impedir que se apliquen políticas a esa carga de trabajo.

Siguientes pasos