Configurar rutas y dominios

En esta página, se describe cómo funcionan las rutas y los dominios en Kf, y cómo los desarrolladores y administradores configuran las rutas y los dominios de una app implementada en el clúster de Kf.

Debes crear dominios y rutas para otorgar acceso externo a tu aplicación.

Enrutamiento interno

Las aplicaciones de Kf pueden comunicarse internamente con otras aplicaciones del clúster de forma directa a través de la red en malla que proporciona Cloud Service Mesh sin salir de la red del clúster. De forma predeterminada, todo el tráfico se encripta mediante TLS mutua.

Todas las apps implementadas en el clúster de Kf vienen con un extremo interno configurado de forma predeterminada. Puedes usar la dirección app-name.space-name.svc.cluster.local para la comunicación interna entre apps. Para usar esta dirección interna, no se requieren pasos adicionales. La TLS mutua está habilitada de forma predeterminada para las rutas internas. Ten en cuenta que solo se puede acceder a esta dirección interna desde los Pods que ejecutan las aplicaciones y no se puede desde el exterior del clúster.

Balanceo de cargas de la app

Istio enruta el tráfico a instancias en buen estado de una aplicación a través de una política de round robin. Actualmente, no se puede cambiar esta política.

Capacidades de ruta

Las rutas le indican a la puerta de enlace de entrada del clúster dónde entregar el tráfico y qué hacer si no hay aplicaciones disponibles en la dirección determinada. De forma predeterminada, si no hay una app disponible en una ruta y esta recibe una solicitud, se muestra un código de estado HTTP 503.

Las rutas se componen de tres partes: host, dominio y ruta de acceso. Por ejemplo, en la URI payroll.mydatacenter.example.com/login:

  • El host es payroll.
  • El dominio es mydatacenter.example.com.
  • La ruta de acceso es /login

Las rutas deben contener un dominio, pero el host y la ruta son opcionales. Varias rutas pueden compartir el mismo host y dominio si especifican diferentes rutas. Varias aplicaciones pueden compartir la misma ruta y el tráfico se dividirá entre ellas. Esto es útil si necesitas compatibilidad con implementaciones azul-verde heredadas. Si varias apps están vinculadas a diferentes rutas, la prioridad es de la más larga a la más corta.

Administra rutas

En las siguientes secciones, se describe cómo usar la CLI de kf para administrar rutas.

Mostrar lista de rutas

Los desarrolladores pueden enumerar las rutas del espacio actual con el comando kf routes.

$ kf routes
Getting Routes in Space: my-space
Found 2 Routes in Space my-space

HOST    DOMAIN       PATH    APPS
echo    example.com  /       echo
*       example.com  /login  uaa

Crear una ruta

Los desarrolladores pueden crear rutas mediante el comando kf create-route.

# Create a Route in the targeted Space to match traffic for myapp.example.com/*
$ kf create-route example.com --hostname myapp

# Create a Route in the Space myspace to match traffic for myapp.example.com/*
$ kf create-route -n myspace example.com --hostname myapp

# Create a Route in the targeted Space to match traffic for myapp.example.com/mypath*
$ kf create-route example.com --hostname myapp --path /mypath

# You can also supply the Space name as the first parameter if you have
# scripts that rely on the old cf style API.
$ kf create-route myspace example.com --hostname myapp # myapp.example.com

Después de crear una ruta, si no hay ninguna aplicación vinculada a ella, se muestra un código de estado HTTP 503 en cualquier solicitud coincidente.

Asigna una ruta a tu app

Los desarrolladores pueden hacer que su app sea accesible en una ruta con el comando kf map-route.

$ kf map-route MYAPP mycluster.example.com --host myapp --path mypath

Anula la asignación de una ruta

Los desarrolladores pueden quitar sus apps de una ruta mediante el comando kf unmap-route.

$ kf unmap-route MYAPP mycluster.example.com --host myapp --path mypath

Borrar una ruta

Los desarrolladores pueden borrar una ruta mediante el comando kf delete-route.

$ kf delete-route mycluster.example.com --host myapp --path mypath

Borrar una ruta evitará que el tráfico se enrute a todas las aplicaciones que escuchan en la ruta.

Administra rutas de forma declarativa en el manifiesto de tu app

Las rutas se pueden administrar de forma declarativa en el archivo de manifiesto de la app. Se crearán si aún no existen.

---
applications:
- name: my-app
  # ...
  routes:
  - route: example.com
  - route: www.example.com/path

Puedes leer más sobre las propiedades de rutas admitidas en la documentación del manifiesto.

Enrutamiento de CRD

Hay cuatro tipos que son relevantes para el enrutamiento:

  • VirtualService
  • Ruta
  • Servicio
  • App

Cada aplicación tiene un servicio, que es un nombre abstracto dado a todas las instancias en ejecución de tu aplicación. El nombre del servicio es el mismo que el de la aplicación. Una ruta representa una sola URL externa. Las rutas buscan de manera constante los cambios en las apps. Cuando una app solicita que se la agregue a una ruta, Route actualiza su lista de apps y, luego, el VirtualService. Un VirtualService representa un solo dominio y combina una lista de todas las rutas en un espacio que pertenecen a ese dominio.

Istio lee la configuración en VirtualServices para determinar cómo enrutar el tráfico.