Saltar a contenido

Redirecciones de URL

Pestaña Parámetros → Redirecciones — solo administradores de la plataforma.

Una redirección responde con un 301 (redirección permanente) a toda petición dirigida a un nombre de host, hacia la URL de su elección. Sirve para las migraciones de servicios, en ambos sentidos:

  • del exterior hacia el clúster: el antiguo dominio de un servicio (www.cliente.com, por ejemplo) se redirige hacia la aplicación que lo sustituye en el clúster;
  • del clúster hacia el exterior, o hacia otra aplicación: la antigua dirección de una aplicación del clúster (app-antigua.<dominio del clúster>) se redirige hacia su nuevo servicio, interno o externo.

Los navegadores y los motores de búsqueda recuerdan una redirección permanente: los enlaces y favoritos existentes siguen funcionando.

Crear una redirección

Nueva redirección:

  1. Nombre de host redirigido: solo el nombre, sin https:// ni ruta. Ya no puede cambiar después: para cambiarlo, elimine la redirección y vuelva a crearla.
  2. Destino:
    • Aplicación del clúster: elija el namespace y luego la aplicación; la URL de destino pasa a ser la raíz de la aplicación;
    • URL: cualquier dirección http:// o https://, sin parámetros (?…) ni ancla (#…).
  3. Conservar la ruta de la petición (marcado por defecto): https://antigua-direccion/docs/a.pdf lleva a <destino>/docs/a.pdf. Desmarcado, toda petición lleva a la propia URL de destino. Los parámetros de la petición se conservan en ambos casos.
  4. Crear.

Las direcciones http:// del nombre redirigido también se redirigen.

Certificado del nombre de host

  • Subdominio del clúster (app-antigua.<dominio del clúster>): cubierto por el certificado del clúster, la redirección está activa en unos segundos.
  • Dominio externo: se solicita un certificado dedicado a Let's Encrypt. Apunte primero el DNS del dominio a la dirección pública del clúster, indicada en la ventana de creación: Let's Encrypt verifica el dominio accediendo a él. El certificado suele emitirse en uno o dos minutos.
  • Certificado proporcionado (opción de la ventana, para cualquier nombre de host): utilice un certificado generado fuera de la plataforma (autoridad interna, certificado comprado, etc.). Pegue o cargue desde un archivo:

    • el certificado en formato PEM: el del servidor primero, seguido de los certificados intermedios;
    • la clave privada en formato PEM, sin cifrar.

    El Control Panel comprueba que la clave corresponde al certificado, que el certificado cubre el nombre de host (nombre exacto o wildcard *.dominio) y que no ha caducado. La clave solo se conserva en el clúster (Secret TLS), nunca en la base de datos del Control Panel. El DNS del dominio debe seguir apuntando al clúster, pero no hay verificación de Let's Encrypt.

Sin renovación automática

Un certificado proporcionado no lo renueva la plataforma: la fila muestra su fecha de caducidad (en naranja a menos de 30 días). Antes de que caduque, abra Modificar y suba el nuevo certificado y su clave; si se dejan vacíos, se conserva el certificado actual.

Seguir una redirección

Cada fila indica:

  • Dominio del clúster o Dominio externo;
  • Ruta conservada o Ruta reemplazada;
  • Ruta: listo cuando la pasarela del clúster sirve la redirección; pendiente justo después de una creación o modificación;
  • Certificado (dominio externo): pendiente mientras Let's Encrypt no haya emitido el certificado. Pase el ratón sobre la etiqueta para leer el detalle, por ejemplo un DNS que aún no apunta al clúster. Para un certificado proporcionado: listo, o error una vez caducado, con su emisor y su fecha de caducidad.

Actualizar vuelve a leer el estado desde el clúster.

Modificar, eliminar

  • Modificar: cambie el destino, la opción de ruta, la descripción o el certificado (paso al certificado proporcionado o vuelta al automático, subida de un nuevo certificado). El nuevo destino se aplica en unos segundos.
  • Eliminar: el nombre de host deja de redirigirse; su certificado dedicado (emitido o proporcionado) también se elimina.

Nombre de host aún en uso

No se puede crear una redirección para un nombre de host que una aplicación o una ruta aún sirve: el mensaje indica el objeto correspondiente. Para redirigir la antigua dirección de una aplicación, elimine primero la aplicación.