Usar mapas de URL

En esta guía, se muestra cómo configurar Trusted Cloudmapas de URL. Un mapa de URL es un conjunto de reglas para enrutar solicitudes HTTP(S) entrantes a servicios de backend. Un mapa de URL mínimo coincide con todas las rutas de solicitud entrantes (/*).

Antes de seguir las instrucciones de esta guía, familiarízate con los conceptos de los mapas de URL.

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

Los mapas de URL que se usan con balanceadores de cargas de aplicaciones regionales externos y los balanceadores de cargas de aplicaciones regionales internos también admiten varias funciones avanzadas de administración del tráfico. Para obtener más información, consulta Conceptos de mapas de URL: Administración avanzada de tráfico.

Valores predeterminados del mapa de URL

Los mapas de URL tienen dos valores predeterminados, como se describe en la siguiente tabla.

Predeterminado Configuración Significado
Configuración predeterminada del mapa de URL gcloud compute url-maps create

--default-service

 El servicio de backend predeterminado especificado se usa si ninguno de los comparadores de rutas de acceso o reglas de host coinciden con la URL entrante.
Configuración predeterminada del comparador de rutas de acceso gcloud compute url-maps add-path-matcher

--default-service

 El servicio de backend predeterminado especificado se usa si la ruta de acceso de la URL coincide con un comparador de rutas, pero ninguna de las --path-rules especificadas coincide.

Reglas de host

Una regla de host define un conjunto de hosts con los que se deben hacer coincidir las solicitudes.

En una regla de host, el nombre de host debe ser un nombre de dominio completamente calificado (FQDN). El nombre de host no puede ser una dirección IPv4 o IPv6. Por ejemplo:

  • Works: example.com
  • Works: web.example.com
  • Works: *.example.com
  • No funciona: 35.244.221.250

Configura mapas de URL

Un mapa de URL puede enviar tráfico a los servicios de backend.

Console

Para agregar un mapa de URL con la Trusted Cloud consola, sigue estos pasos:

  1. Ve a la página Balanceo de cargas.

    Ir a Balanceo de cargas

  2. Haz clic en el Nombre de un balanceador de cargas.
  3. En la página Detalles del balanceador de cargas, haz clic en Editar para el balanceador de cargas seleccionado.
  4. Selecciona Reglas de host y ruta.
  5. Haz clic en Agrega la regla de host y de ruta.

  6. Completa el campo Host, el campo Rutas de acceso o ambos, y selecciona un servicio de backend.

    1. Ingresa un Nombre de host completamente calificado, como web.example.com.
    2. Ingresa la ruta de acceso, por ejemplo, /video.
    3. En la página Reglas de host y ruta de acceso, en el menú Backends, selecciona un servicio de backendque esté disponible.

  7. Revisa que aparezca una marca de verificación azul a la izquierda de Reglas de host y ruta y haz clic en el botón Actualizar.

gcloud

Para agregar un mapa de URL mediante Google Cloud CLI, usa el comando url-maps create:

gcloud compute url-maps create URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--region=REGION]

En el caso de los balanceadores de cargas de aplicaciones externos regionales y los balanceadores de cargas de aplicaciones internos, asegúrate de incluir la marca --region cuando crees el mapa de URL.

Para borrar un comparador de rutas, usa el comando gcloud compute url-maps add-path-matcher:

gcloud compute url-maps add-path-matcher URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   --path-matcher-name PATH_MATCHER \
   [--path-rules="PATH=SERVICE"]

Este comando requiere un servicio de backend predeterminado al que pueda enviar las solicitudes sin coincidencia. La marca --path-rules define las asignaciones entre las rutas de solicitud y los servicios. En el siguiente ejemplo, se envían las rutas de solicitud /video/ y /video/* al servicio de backend video-service:

--path-rules="/video=video-service,/video/*=video-service"

Para crear una regla de host, usa el comando gcloud compute url-maps add-host-rule:

gcloud compute url-maps add-host-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

Por ejemplo, el siguiente valor --hosts hace coincidir las solicitudes con www.example.com y cualquier subdominio de altostrat.com:

--hosts=[*.altostrat.com,www.example.com]

Para cambiar el servicio predeterminado de un mapa de URL, usa el comando url-maps set-default-service:

gcloud compute url-maps set-default-service URL_MAP_NAME
  (--default-service=DEFAULT_SERVICE)[GCLOUD_WIDE_FLAG ...]

Terraform

Para crear un mapa de URL regional, usa el recurso google_compute_region_url_map. 

resource "google_compute_region_url_map" "default" {
  name            = "regional-l7-xlb-map"
  region          = "us-west1"
  default_service = google_compute_region_backend_service.default.id
}

Mostrar lista de mapas de URL

Console

No puedes enumerar todos tus mapas de URL en la consola de Trusted Cloud .

gcloud

Para mostrar una lista de los mapas de URL mediante Google Cloud CLI, usa el comando url-maps list.

gcloud compute url-maps list

Obtén información sobre un mapa de URL

Console

Para obtener información sobre un mapa de URL, sigue estos pasos:

  1. Ve a la página Balanceo de cargas.

    Ir a Balanceo de cargas

  2. Haz clic en el Nombre de un balanceador de cargas.
  3. En la página Detalles del balanceador de cargas, haz clic en Editar para el balanceador de cargas seleccionado.
  4. Mira las Reglas de host y ruta.

gcloud

Para obtener información sobre un solo mapa de URL mediante Google Cloud CLI, usa el comando url-maps describe.

gcloud compute url-maps describe URL_MAP_NAME

Borrar un mapa de URL

Solo puedes borrar un mapa de URL una vez que hayas borrado todos los proxies de destino que hacen referencia a él. Para obtener más información, consulta Borra un proxy de destino.

Console

Para borrar un mapa de URL, sigue estos pasos:

  1. Ve a la página Balanceo de cargas.

    Ir a Balanceo de cargas

  2. Haz clic en el Nombre de un balanceador de cargas.
  3. En la página Detalles del balanceador de cargas, haz clic en Editar para el balanceador de cargas seleccionado.
  4. En la página Detalles del balanceador de cargas, ve a las Reglas de host y ruta.
  5. Haz clic en la "X" que aparece a la derecha de un mapa de URL para borrarlo. El mapa de URL desaparecerá.
  6. Revisa que aparezca una marca de verificación azul a la izquierda de Reglas de host y ruta y haz clic en el botón Actualizar.

gcloud

Para borrar un mapa de URL mediante Google Cloud CLI, usa el comando url-maps delete. Para que puedas borrar un mapa de URL, primero debes borrar cualquier proxy HTTP de destino que haga referencia a ese mapa.

gcloud compute url-maps delete URL_MAP_NAME [--quiet]

Borra un comparador de rutas

Console

Para borrar un comparador de rutas de acceso, sigue estos pasos:

  1. Ve a la página Balanceo de cargas.

    Ir a Balanceo de cargas

  2. Haz clic en el Nombre de un balanceador de cargas.
  3. En la página Detalles del balanceador de cargas, haz clic en Editar para el balanceador de cargas seleccionado.
  4. Selecciona Reglas de host y ruta.
  5. En el campo Rutas de acceso de un mapa de URL existente, haz clic en la “x” que aparece en el nombre del comparador de rutas.
  6. Revisa que aparezca una marca de verificación azul a la izquierda de Reglas de host y ruta y haz clic en el botón Actualizar.

gcloud

Para borrar un comparador de rutas, usa el comando gcloud compute url-maps remove-path-matcher:

gcloud compute url-maps remove-path-matcher URL_MAP_NAME \
   [--path-matcher-name PATH_MATCHER]

Borra una regla de host

Console

Para borrar una regla de host, sigue estos pasos:

  1. Si no estás en la página Reglas de host y ruta, ve a la página Balanceo de cargas.

    Ir a Balanceo de cargas

  2. Haz clic en el Nombre de un balanceador de cargas.
  3. En la página Detalles del balanceador de cargas, haz clic en Editar para el balanceador de cargas seleccionado.
  4. Selecciona Reglas de host y ruta.
  5. En el campo Hosts de un mapa de URL existente, haz clic en la “x” que aparece en el nombre del host.
  6. Revisa que aparezca una marca de verificación azul a la izquierda de Reglas de host y ruta y haz clic en el botón Actualizar.

gcloud

Para borrar una regla de host del mapa de URL, usa el comando gcloud compute url-maps remove-host-rule:

gcloud compute url-maps remove-host-rule URL_MAP_NAME --host=HOST

Por ejemplo, si deseas quitar una regla de host que contiene el host altostrat.com de un mapa de URL llamado my-map, debes ejecutar el siguiente comando:

gcloud compute url-maps remove-host-rule my-map --host altostrat.com

Guías de administración de tráfico

No todas las funciones de mapas de URL están disponibles para todos los productos. Los mapas de URL se usan con balanceadores de cargas para admitir varias funciones avanzadas de administración del tráfico.

Usa la siguiente tabla a fin de obtener información sobre las características de asignación de URL para la administración.

Producto Funciones del mapa de URL y guías de administración del tráfico
Balanceador de cargas de aplicaciones externo regional Funciones del balanceador de cargas: Administración de tráfico y enrutamiento

Descripción general de la administración del tráfico

Configurar la administración del tráfico

Configurar un redireccionamiento de URL

Configurar un redireccionamiento de HTTP a HTTPS

nombre de host y ruta de acceso

Enrutamiento de solicitudes

Cookies
Balanceador de cargas de aplicaciones interno Funciones del balanceador de cargas: Administración de tráfico y enrutamiento

Descripción general de la administración del tráfico

Configura la administración del tráfico

Configura redireccionamientos de URL

Configurar redireccionamientos de HTTP a HTTPS

Cookies

nombre de host y ruta de acceso

Referencia de la CLI de gcloud y la API

Además de la Trusted Cloud consola, puedes usar la API y gcloud CLI para crear mapas de URL.

API

Para obtener descripciones de las propiedades y los métodos disponibles cuando trabajas con mapas de URL a través de la API de REST, consulta lo siguiente:

Producto Documentación de la API
Balanceador de cargas de aplicaciones externo urlMaps
Balanceador de cargas de aplicaciones interno regionUrlMaps

gcloud CLI

Para Google Cloud CLI en la CLI de Google Cloud, consulta lo siguiente:

  • Regional: --region=[REGION]

Para la administración avanzada del tráfico, usa los archivos YAML y, luego, impórtalos con el comando gcloud compute url-maps import.

¿Qué sigue?