Descripción general de los mapas de URL

Los balanceadores de cargas HTTP(S) de Google Cloud y Traffic Director usan un mapa de URL para dirigir las solicitudes a un destino. Cuando configuras un balanceador de cargas HTTP(S) o Traffic Director, creas un mapa de URL. Este mapa de URL dirige el tráfico a uno o más de los siguientes destinos según las reglas que definas:

Un servicio de backend representa una colección de backends, que son instancias de una aplicación o un microservicio. Un depósito de backend es un depósito de Google Cloud Storage, que se suele usa para alojar contenido estático, como imágenes.

Por ejemplo, puedes usar un solo mapa de URL para enrutar las solicitudes según el host y la ruta de acceso de la solicitud:

  • Las solicitudes de https://example.com/video se envían a un servicio de backend.
  • Las solicitudes de https://example.com/audio se envían a un servicio de backend diferente.
  • Las solicitudes de https://example.com/images se envían a un depósito de backend de Cloud Storage.
  • Las solicitudes de cualquier otra combinación de host y ruta de acceso se envían a un servicio de backend predeterminado.

Los mapas de URL se usan con los siguientes productos de Google Cloud:

Acerca de los mapas de URL

Cuando una solicitud llega al balanceador de cargas, este la enruta a un servicio o depósito de backend en particular según la configuración en un mapa de URL.

Por ejemplo, supón que tienes la siguiente configuración:

  • Una dirección IP:
    • Todas las solicitudes a tu organización se envían a la misma dirección IP y al mismo balanceador de cargas.
    • El tráfico se dirige a diferentes servicios de backend según la URL de la solicitud.
  • Dos dominios:
    • example.net aloja videos de capacitación.
    • example.org aloja el sitio web de la organización.
  • Cuatro conjuntos de servidores:
    • Uno aloja el sitio web de la organización (servicio de backend: org-site).
    • Uno aloja el sitio web general del video de capacitación (servicio de backend: video-site).
    • Uno aloja videos de capacitación en alta definición (HD) (servicio de backend: video-hd).
    • Uno aloja videos de capacitación en definición estándar (SD) (servicio de backend: video-sd).

Lo que debe ocurrir es lo siguiente:

  • Las solicitudes a example.org (o cualquier dominio que no sea example.net) para ir al servicio de backend org-site.
  • Solicitudes a example.net que no coinciden con rutas más específicas para ir al servicio de backend video-site.
  • Solicitudes a example.net/video/hd/* para ir al servicio de backend video-hd.
  • Solicitudes a example.net/video/sd/* para ir al servicio de backend video-sd.

El mapa de URL te permite configurar este tipo de enrutamiento basado en host y ruta de acceso.

Ejemplo de configuración del servicio de backend (haz clic para ampliar)
Ejemplo de configuración del servicio de backend (haz clic para ampliar)

Administración avanzada del tráfico

En el balanceo de cargas de HTTP(S) interno y Traffic Director, se usan mapas de URL para el enrutamiento basado en host y ruta de acceso (como se describe en este documento). Cuando se usan con estos productos, los mapas de URL también admiten funciones de administración avanzada del tráfico. Para obtener más información sobre la administración avanzada del tráfico, consulta la Descripción general de la administración del tráfico y la Administración avanzada del tráfico.

Nombre

Cada mapa de URL tiene un nombre. Cuando creas un balanceador de cargas basado en HTTP(S) mediante Google Cloud Console, se asigna un nombre al mapa de URL. Este nombre es el mismo que el nombre del balanceador de cargas. Si usas gcloud o la API, puedes definir un nombre personalizado para el mapa de URL.

Componentes del mapa de URL

Un mapa de URL es un recurso de configuración de Google Cloud que dirige las solicitudes de URL a los servicios o depósitos de backend. Para ello, usa el nombre del host y las partes de la ruta de acceso de cada URL que procesa:

  • Un nombre de host es la parte del nombre de dominio de una URL; por ejemplo, la parte del nombre del host de la URL http://example.net/video/hd es example.net.
  • Una ruta de acceso es la parte de una URL que sigue al nombre del host; por ejemplo, la parte de la ruta de acceso de la URL http://example.net/video/hd es /video/hd.
Flujo básico del mapa de URL (haz clic para ampliar)
Flujo básico del mapa de URL (haz clic para ampliar)

Para controlar qué servicios o depósitos de backend reciben solicitudes entrantes, usa los siguientes parámetros de configuración del mapa de URL:

  • Servicio de backend predeterminado o depósito de backend predeterminado. Cuando creas un mapa de URL, debes especificar un servicio o un depósito de backend predeterminado, pero no ambos. Este valor predeterminado representa el servicio o depósito de backend al que Google Cloud dirige las solicitudes de URL con cualquier nombre de host, a menos que exista una regla de host aplicable.

  • Regla de host. Esta dirige las solicitudes enviadas a uno o más nombres de host asociados a un solo comparador de rutas de acceso. La parte del nombre de host de una URL coincide con exactitud con el conjunto de nombres de host configurados de la regla de host. Para dirigir las solicitudes de http://example.net/video/hd a un comparador de rutas de acceso, necesitas una sola regla de host que incluya, al menos, el nombre del host example.net. Esa misma regla de host también podría manejar solicitudes de otros nombres de host, pero los dirigiría al mismo comparador de rutas de acceso.

    Si necesitas dirigir solicitudes a diferentes comparadores de rutas de acceso, debes usar reglas de host diferentes. Dos reglas de host en un mapa de URL no pueden tener el mismo nombre de host.

    Es posible hacer coincidir todos los nombres de host si especificas el carácter comodín * en la regla de host. Por ejemplo, para las URL http://example.org, http://example.net/video/hd y http://example.com/audio, se puede hacer coincidir a los tres nombres de host example.org, example.net y example.com si se especifica * en la regla de host. También es posible hacer coincidir un nombre de host parcial mediante el carácter comodín *. Por ejemplo, una regla de host *.example.net coincide con ambos nombres de host, foo.example.net y bar.example.net.

  • Comparador de rutas de acceso. Este es el parámetro de configuración al que hace referencia una regla de host. Define la relación entre la parte de la ruta de acceso de una URL y el servicio o depósito de backend que debe entregar la solicitud. Un comparador de rutas de acceso consta de dos elementos:

    • Servicio de backend predeterminado del comparador de rutas de acceso o depósito de backend predeterminado del comparador de rutas de acceso. Para cada comparador de rutas de acceso, debes especificar, al menos, un servicio o un depósito de backend predeterminado, pero no ambos. Este valor predeterminado representa el servicio o depósito de backend o al que Google Cloud dirige las URL cuyos nombres de host coinciden con una regla de host asociada a un comparador de rutas de acceso y cuyas rutas de URL no coinciden con ninguna otra en el comparador de rutas de acceso.

    • Reglas de ruta de acceso Para cada comparador de rutas de acceso, puedes especificar una o más reglas de ruta de acceso, que son pares clave-valor que asignan una ruta de URL a un solo servicio o depósito de backend. La siguiente sección contiene más información sobre cómo funcionan las reglas de ruta de acceso.

Orden de las operaciones

Para un nombre de host y una ruta de acceso en una URL solicitada, Google Cloud usa el siguiente procedimiento a fin de dirigir la solicitud al servicio o depósito de backend correcto, como se configuró en el mapa de URL:

  • Si el mapa de URL no contiene una regla de host para el nombre del host de la URL, Google Cloud dirige las solicitudes al servicio o al depósito de backend predeterminado del mapa de URL, según cuál definiste.

  • Si el mapa de URL contiene una regla de host que incluye el nombre del host de la URL, se consulta el comparador de rutas de acceso al que hace referencia esa regla de host:

    • Si el comparador de rutas de acceso contiene una regla de ruta que coincide con exactitud con la ruta de la URL, Google Cloud dirige las solicitudes al servicio o depósito de backend para esa regla de ruta.

    • Si el comparador de rutas de acceso no contiene una regla de ruta que coincide con exactitud con la ruta de la URL, pero contiene una regla de ruta que termina en /*, cuyo prefijo coincide con la sección más larga de la ruta de la URL, Google Cloud dirigirá las solicitudes al servicio de backend o al depósito de backend para esa regla de ruta. Por ejemplo, para el mapa de URL que contiene dos reglas del comparador de rutas de acceso /video/hd/movie1 y /video/hd/*, si la URL contiene la ruta de acceso exacta /video/hd/movie1, se compara con esa regla de ruta.

    • Si ninguna de las condiciones anteriores es verdadera, Google Cloud dirige las solicitudes al servicio o depósito de backend predeterminado del comparador de rutas de acceso, según cuál definiste.

Restricciones del comparador de rutas de acceso

Los comparadores y las reglas de rutas tienen las siguientes restricciones:

  • Una regla de ruta solo puede incluir un carácter comodín (*) después de un carácter de barra diagonal (/). Por ejemplo, /videos/* y /videos/hd/* son válidos para las reglas de ruta, pero /videos* y /videos/hd* no.

  • Las reglas de ruta no usan expresiones regulares ni coincidencias de substrings. Por ejemplo, las reglas de ruta para /videos/hd o /videos/hd/* no se aplican a una URL con la ruta /video/hd-abcd. Sin embargo, una regla de ruta para /video/* sí se aplica a esa ruta.

  • Los comparadores de rutas de acceso (y los mapas de URL en general) no ofrecen características que funcionen como las directivas LocationMatch de Apache. Si tienes una aplicación que genera rutas de acceso de URL dinámicas que tienen un prefijo común, como /videos/hd-abcd y /videos/hd-pqrs, y necesitas enviar solicitudes a esas rutas de servicios de backend diferentes, es posible que no puedas hacerlo con un mapa de URL. Para casos simples que contengan solo algunas posibles URL dinámicas, puedes crear un comparador de rutas de acceso con un conjunto limitado de reglas de ruta. Para casos más complejos, es necesario realizar coincidencias de expresiones regulares basadas en rutas de acceso en tus backends.

Un nombre de host solo puede hacer referencia a una regla de host única, y una regla de host solo puede hacer referencia a un comparador de rutas de acceso único. Sin embargo, una sola regla de host puede procesar varios nombres de host, y varias reglas de host pueden hacer referencia a un solo comparador de rutas. En consecuencia, cada URL única se dirige a un solo servicio o depósito de backend:

  • Google Cloud usa la parte del nombre de host de una URL para seleccionar una sola regla de host y el comparador de rutas de acceso al que se hace referencia.

  • En el comparador de rutas de acceso, no puedes crear más de una regla de ruta para la misma ruta. Por ejemplo, las solicitudes de /videos/hd no se pueden dirigir a más de un servicio ni a un depósito de backend. Los servicios de backend pueden tener grupos de instancias de backend o grupos de extremos de red (NEG) de backend en diferentes zonas y regiones, y puedes crear depósitos de backend que usen clases Multi-Regional Storage.

Protocolos y mapas de URL

Puedes usar el mismo mapa de URL, las reglas de host y los comparadores de rutas de acceso para procesar las solicitudes HTTP y HTTPS que envían los clientes, siempre y cuando los proxies HTTP y HTTPS de destino hagan referencia al mapa de URL.

Los mapas de URL no proporcionan un redireccionamiento del protocolo para las conexiones entre los clientes y el balanceador de cargas. Por ejemplo, no se puede usar un mapa de URL para indicar a los sistemas cliente que cambien de HTTP a HTTPS. Debes implementar todo el redireccionamiento de protocolo de cliente en tus backends.

Mapa de URL más simple

El mapa de URL más simple solo tiene un servicio de backend predeterminado o un depósito de backend predeterminado. No contiene reglas de host ni comparadores de rutas de acceso. El servicio o el depósito de backend predeterminado (el que definiste) administra todas las URL solicitadas.

Si defines un servicio de backend predeterminado, Google Cloud dirige las solicitudes a sus grupos de instancias de backend o NEG de backend de acuerdo con la configuración del servicio de backend.

Mapa de URL sin reglas, excepto las predeterminadas (haz clic para ampliar)
Mapa de URL sin reglas, excepto las predeterminadas (haz clic para ampliar)

Ejemplo de mapa de URL

En el siguiente ejemplo, se ilustra el orden de las operaciones para un mapa de URL. Por simplicidad conceptual, solo se usan los servicios de backend. Sin embargo, puedes sustituirlos por depósitos de backend. Con los siguientes pasos, se configura el mapa de URL para un balanceador de cargas HTTP(S) externo. Si deseas ver un ejemplo de cómo crear los demás componentes del balanceador de cargas HTTP(S) externo, consulta Crea un balanceador de cargas HTTP(S) externo. Si deseas ver un ejemplo de cómo crear un mapa de URL del balanceador de cargas HTTP(S) interno y otros componentes, consulta Prepara la configuración del balanceo de cargas de HTTP(S) interno.

Cada servicio de backend que se analiza en el siguiente ejemplo cuenta con un esquema externo y usa el protocolo HTTP, HTTPS o HTTP/2.

  1. Crea un mapa de URL para el balanceador de cargas y especifica un servicio de backend predeterminado. En este ejemplo, se crea un mapa de URL llamado video-org-url-map que hace referencia a un servicio de backend existente llamado org-site.

    gcloud compute url-maps create video-org-url-map \
        --default-service=org-site
    
  2. Crea un comparador de rutas de acceso llamado video-matcher con las siguientes características:

    • El servicio de backend predeterminado es video-site, un servicio de backend existente.
    • Agrega reglas de ruta que dirigen las solicitudes para la ruta de URL /video/hd exacta o el prefijo de ruta de URL /video/hd/* a un servicio de backend existente llamado video-hd.
    • Agrega reglas de ruta que dirigen las solicitudes para la ruta de URL /video/sd exacta o el prefijo de ruta de URL /video/sd/* a un servicio de backend existente llamado video-sd.
    gcloud compute url-maps add-path-matcher video-org-url-map \
        --path-matcher-name=video-matcher \
        --default-service=video-site \
        --path-rules=/video/hd=video-hd,/video/hd/*=video-hd,/video/sd=video-sd,/video/sd/*=video-sd
    
  3. Crea una regla de host para el nombre de host example.net que hace referencia al comparador de rutas de acceso video-matcher.

    gcloud compute url-maps add-host-rule video-org-url-map \
        --hosts=example.net \
        --path-matcher-name=video-matcher
    

El mapa de URL video-org-url-map dirige las URL solicitadas a los backends de la siguiente manera.

Mapa de URL con una regla de ruta, comparadores de rutas de acceso y una regla de host (haz clic para ampliar)
Mapa de URL con una regla de ruta, comparadores de rutas de acceso y una regla de host (haz clic para ampliar)

En la siguiente tabla, se explica el procesamiento de solicitudes que se muestra en el diagrama anterior.

Nombre de host Rutas de URL Servicio de backend seleccionado Motivo de la selección
Nombre de host
example.org y todos los demás nombres de host diferentes de
example.net
todas las rutas org-site El nombre de host no figura en ninguna regla de host del mapa de URL, por lo que la solicitud se dirige al servicio de backend predeterminado del mapa de URL.
Nombre de host:
example.net
/video
/video/examples
video-site La solicitud se envía al servicio de backend predeterminado porque no hay una regla de ruta para /video/ o /video/*. La regla de host para example.net hace referencia a un comparador de rutas de acceso, pero ese comparador no tiene ninguna regla de ruta que se aplique a estas rutas de acceso.
Nombre de host:
example.net
/video/hd
/video/hd/movie1
/video/hd/movies/movie2
Otras URL que comienzan con /video/hd/*
video-hd Una regla de host para example.net hace referencia a un comparador de rutas de acceso cuyas reglas de acceso envían solicitudes para rutas de URL que coinciden con exactitud con /video/hd o que comienzan con /video/hd/* al servicio de backend video-hd.
Nombre de host:
example.net
/video/sd
/video/sd/show1
/video/sd/shows/show2
Otras URL que comienzan con /video/sd/*
video-sd Una regla de host para example.net hace referencia a un comparador de rutas de acceso cuyas reglas de acceso envían solicitudes para rutas de URL que coinciden con exactitud con /video/sd o que comienzan con /video/sd/* al servicio de backend video-sd.

Qué sigue

  • Para agregar, probar, enumerar o borrar un mapa de URL, consulta Usa mapas de URL.