Redirections d'URL

Onglet Paramètres → Redirections — administrateurs de plateforme uniquement.

Une redirection répond 301 (redirection permanente) à toute requête adressée à un nom d'hôte, vers l'URL de votre choix. Elle sert aux migrations de services, dans les deux sens :

• de l'extérieur vers le cluster : l'ancien domaine d'un service (www.client.com, par exemple) est redirigé vers l'application qui le remplace dans le cluster ;
• du cluster vers l'extérieur, ou vers une autre application : l'ancienne adresse d'une application du cluster (ancienne-app.<domaine du cluster>) est redirigée vers son nouveau service, interne ou externe.

Les navigateurs et les moteurs de recherche retiennent une redirection permanente : les liens et favoris existants continuent de fonctionner.

Créer une redirection

Nouvelle redirection :

1. Nom d'hôte redirigé : le nom seul, sans https:// ni chemin. Il ne peut plus changer ensuite : pour en changer, supprimez la redirection puis recréez-la.
2. Cible :
   • Application du cluster : choisissez le namespace, puis l'application ; l'URL cible devient la racine de l'application ;
   • URL : n'importe quelle adresse http:// ou https://, sans paramètres (?…) ni ancre (#…).
3. Conserver le chemin de la requête (coché par défaut) : https://ancienne-adresse/docs/a.pdf mène à <cible>/docs/a.pdf. Décoché, toute requête mène à l'URL cible elle-même. Les paramètres de la requête sont conservés dans les deux cas.
4. Créer.

Les adresses http:// du nom redirigé sont redirigées elles aussi.

Certificat du nom d'hôte

• Sous-domaine du cluster (ancienne-app.<domaine du cluster>) : couvert par le certificat du cluster, la redirection est active en quelques secondes.
• Domaine externe : un certificat dédié est demandé à Let's Encrypt. Faites d'abord pointer le DNS du domaine vers l'adresse publique du cluster, indiquée dans la fenêtre de création : Let's Encrypt vérifie le domaine en le joignant. Le certificat est en général émis en une à deux minutes.

• Certificat fourni (option de la fenêtre, pour tout nom d'hôte) : utilisez un certificat généré hors de la plateforme (autorité interne, certificat acheté, etc.). Collez ou chargez depuis un fichier :

  • le certificat au format PEM : celui du serveur en premier, suivi des certificats intermédiaires ;
  • la clé privée au format PEM, non chiffrée.

  Le Control Panel vérifie que la clé correspond au certificat, que le certificat couvre le nom d'hôte (nom exact ou wildcard *.domaine) et qu'il n'est pas expiré. La clé n'est conservée que dans le cluster (Secret TLS), jamais dans la base du Control Panel. Le DNS du domaine doit toujours pointer vers le cluster, mais aucune vérification par Let's Encrypt n'a lieu.

Pas de renouvellement automatique

Un certificat fourni n'est pas renouvelé par la plateforme : la ligne affiche son échéance (en orange à moins de 30 jours). Avant l'échéance, ouvrez Modifier et déposez le nouveau certificat et sa clé ; laissés vides, le certificat en place est conservé.

Suivre une redirection

Chaque ligne indique :

• Domaine du cluster ou Domaine externe ;
• Chemin conservé ou Chemin remplacé ;
• Route : prêt quand la passerelle du cluster sert la redirection ; en attente juste après une création ou une modification ;
• Certificat (domaine externe) : en attente tant que Let's Encrypt n'a pas émis le certificat. Survolez le badge pour lire le détail, par exemple un DNS qui ne pointe pas encore vers le cluster. Pour un certificat fourni : prêt, ou erreur une fois expiré, avec son émetteur et son échéance.

Actualiser relit l'état depuis le cluster.

Modifier, supprimer

• Modifier : changez la cible, l'option de chemin, la description ou le certificat (passage au certificat fourni ou retour au certificat automatique, dépôt d'un nouveau certificat). La nouvelle cible s'applique en quelques secondes.
• Supprimer : le nom d'hôte cesse d'être redirigé ; son certificat dédié (émis ou fourni) est supprimé aussi.

Nom d'hôte encore utilisé

Une redirection ne peut pas être créée pour un nom d'hôte qu'une application ou une route sert encore : le message nomme l'objet concerné. Pour rediriger l'ancienne adresse d'une application, supprimez d'abord l'application.