Cette page est l’index pour tout ce qui touche aux domaines sur le Stack Harbor PaaS — attacher des domaines à des environnements, échanger des domaines entre environnements pour un blue/green ou une bascule staging-vers-production, héberger plusieurs domaines sur un seul environnement, et utiliser des TLD internationalisés ou génériques.
La plateforme traite les domaines comme des attributs de première classe de l’environnement. Ajouter, retirer ou échanger un domaine est une action du tableau de bord ou de l’API et prend effet immédiatement — la propagation DNS mise à part.
Dans cette section
Domaines personnalisés
Domaines personnalisés couvre le flux de base : acheter un domaine chez un registrar, créer un enregistrement DNS (CNAME, ANAME ou A) pointant sur votre environnement, et — si vous n’avez pas d’IP publique attachée — lier le domaine dans le tableau de bord pour que le répartiteur partagé route correctement.
C’est le bon point de départ pour tout environnement à rendre accessible sur un domaine que vous contrôlez plutôt que sur l’URL émise par la plateforme.
Swap de domaine
L’action swap de la plateforme déplace l’attachement d’un domaine entre deux environnements de façon atomique. C’est le motif standard pour les déploiements blue/green et pour promouvoir un environnement de staging en production sans changer le DNS :
- Lancez la nouvelle version dans un environnement séparé avec le même domaine personnalisé qu’elle servira au final.
- Vérifiez sur l’URL de staging.
- Échangez — la production continue de servir sur le même domaine, mais maintenant depuis le nouvel environnement. L’ancien environnement reste en ligne (accessible désormais sur l’URL de staging) pour un retour arrière instantané.
Le swap fonctionne avec les IP publiques (DNS inchangé, IP réassignée) et avec les environnements via répartiteur partagé (la liaison du domaine est déplacée entre environnements).
Plusieurs domaines sur un environnement
Plusieurs domaines couvre le fait de servir plus d’un domaine depuis un seul environnement. Le cas le plus courant est d’héberger plusieurs applications sur un même Tomcat, GlassFish ou serveur PHP — hôtes virtuels distincts, racines de documents distinctes, mêmes ressources de calcul.
Le motif est identique selon le serveur applicatif :
- Liez le domaine supplémentaire à l’environnement (DNS + liaison dans le tableau de bord).
- Ajoutez un bloc d’hôte virtuel dans la configuration du serveur applicatif qui route le nouveau domaine vers sa racine de documents ou son contexte.
- Redémarrez ou rechargez le serveur applicatif.
Domaines gTLD et IDN
Support gTLD et IDN couvre deux cas précis :
- Noms de domaine internationalisés (IDN) — domaines en alphabets non latins (cyrillique, chinois, grec, etc.) utilisant Punycode en arrière-plan. La plateforme les accepte dans les noms d’environnement, les alias et les liaisons de domaines personnalisés.
- Domaines génériques de premier niveau (gTLD) — TLD au-delà du jeu original
.com,.org,.net—.academy,.best,.cloud, etc. Ils se comportent comme n’importe quel autre TLD sur la plateforme.
Noms d’hôte DNS des conteneurs
À l’intérieur d’un environnement, la plateforme expose des noms d’hôte DNS pour que les conteneurs puissent s’adresser par nom sans coder en dur d’adresses IP. Documenté séparément dans la section Réseautage.