Domaines personnalisés

Chaque environnement sur le Stack Harbor PaaS reçoit une URL émise par la plateforme de la forme <nomenv>.region.stackharbor.cloud. Vous pouvez la garder, mais la plupart des applications en production ont besoin d’un domaine que vous possédez — app.exemple.com, api.exemple.com, le domaine racine exemple.com — pointant sur l’environnement.

Cette page couvre les trois pièces de ce montage : l’enregistrement DNS chez votre registrar, l’étape de liaison dans le tableau de bord (quand elle est nécessaire) et le type d’enregistrement à choisir selon la topologie de l’environnement.

Vocabulaire

• Domaine — le nom tapé dans le navigateur. La partie tout à droite (.com, .org, .ca) est le domaine de premier niveau (TLD) ; la partie devant est le domaine de second niveau (SLD).
• Domaine racine — second niveau + premier niveau uniquement (exemple.com). Les sous-domaines s’ajoutent devant, séparés par un point (app.exemple.com).
• DNS — le système qui convertit un nom textuel en adresse IP du serveur qui répond pour ce nom. Les changements DNS peuvent prendre jusqu’à 48 heures pour se propager.

La plateforme supporte aussi les noms internationalisés (IDN) et les TLD génériques (gTLD) — voir la page dédiée.

Trois étapes

1. Achetez un domaine chez un registrar (ou utilisez-en un que vous possédez déjà).
2. Créez un enregistrement DNS chez votre registrar pointant sur votre environnement.
3. Si vous n’avez pas d’IP publique attachée à l’environnement, liez le domaine dans le tableau de bord pour que le répartiteur partagé puisse router le trafic.

Quel enregistrement DNS choisir

Trois types d’enregistrement possibles. Le bon dépend de votre topologie et du type d’adresse à exposer.

Les enregistrements A et ANAME ne nécessitent aucune liaison dans le tableau de bord. CNAME oui — voir section suivante.

Configurer un enregistrement DNS chez le registrar

Les étapes varient par registrar, mais la forme est identique :

1. Dans les paramètres DNS du domaine chez votre registrar, trouvez la section Records ou Gestion DNS.
2. Cliquez Ajouter un enregistrement.
3. Choisissez le type :
   • Enregistrement A — mettez Host à @ (ou le sous-domaine), Points to à l’IPv4 publique de l’environnement.
   • CNAME — mettez Host au sous-domaine, Points to à l’URL d’environnement émise par la plateforme.
   • ANAME — mettez Host à @, Points to à l’URL d’environnement émise par la plateforme (ou un autre domaine racine).
4. Choisissez un TTL pour l’enregistrement. Plus bas = propagation plus rapide mais plus de requêtes DNS. Une heure est un défaut raisonnable en production.
5. Enregistrez.

Les changements DNS peuvent prendre jusqu’à 48 heures à se propager partout sur Internet, même si la plupart des résolveurs prennent le changement en moins d’une heure.

Lier le domaine dans le tableau de bord (CNAME et ANAME seulement)

Quand le trafic vers votre environnement passe par le répartiteur partagé (pas d’IP publique), le répartiteur doit savoir que votre domaine personnalisé appartient à votre environnement pour router correctement la requête.

1. Dans le tableau de bord, cliquez l’icône Settings (clé) pour l’environnement.
2. Ouvrez Custom Domains.
3. Ajoutez votre nom de domaine et enregistrez.

Si vous avez une IP publique attachée, le trafic court-circuite le répartiteur partagé et arrive directement — pas de liaison nécessaire.

Exemples

• Enregistrement A, environnement avec IP publique

  • api.exemple.com → 198.51.100.10
  • app.exemple.com → 198.51.100.10

• CNAME, environnement sans IP publique (liaison requise)

  • app.exemple.com → monenv.region.stackharbor.cloud

• ANAME, domaine racine pointé sur un nom d’hôte

  • exemple.com → monenv.region.stackharbor.cloud
  • Les sous-domaines résolvent vers le même suffixe côté cible.

Voir aussi

• Gestion des noms de domaine
• Plusieurs domaines sur un environnement
• Domaines gTLD et IDN
• Aperçu SSL et TLS