Aller au contenu principal

Domaines Personnalisés

Utilisez vos propres noms de domaine pour une expérience professionnelle et brandée.

Vue d'Ensemble​

Les gateways SailOps nécessitent des domaines personnalisés - aucun sous-domaine par défaut n'est fourni. Cela vous donne un contrôle total sur votre branding et votre configuration DNS dès le premier jour.

Avantages​

  • Contrôle total du branding - Utilisez votre propre domaine dès le départ
  • Optimisation SEO - Votre domaine construit votre classement de recherche
  • Confiance utilisateur - Les clients reconnaissent votre marque
  • Intégration email - Correspondance avec votre domaine email

Ajouter un Domaine Personnalisé​

Prérequis​

  • Un nom de domaine enregistré
  • Accès aux paramètres DNS de votre domaine
  • Une gateway créée dans votre projet

Guide Pas à Pas​

1. Accéder à Votre Gateway​

  1. Allez dans Gateways
  2. Cliquez sur votre gateway
  3. Cliquez sur l'onglet Domaines

2. Ajouter Votre Domaine​

  1. Cliquez sur Ajouter un Domaine
  2. Entrez votre nom de domaine (ex : app.example.com)
  3. Sélectionnez le protocole : HTTPS, TLS ou TCP
  4. Configurez le port (défaut : 443 pour HTTPS/TLS)
  5. Cliquez sur Ajouter

3. Configurer le DNS​

SailOps fournit une adresse IP pour votre gateway. Configurez votre DNS avec un enregistrement A :

Pour les sous-domaines :

Type: A
Nom: app
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300

Pour les domaines apex :

Type: A
Nom: @
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300
Adresse IP de la Gateway

Après la création de votre gateway, l'adresse IP est affichée dans la page de détails de votre gateway.

4. Vérification du Domaine​

SailOps vérifie automatiquement votre configuration DNS. Une fois l'enregistrement A détecté pointant vers l'IP de votre gateway, le certificat SSL est automatiquement provisionné. Aucune étape de vérification manuelle n'est nécessaire.

Exemples de Configuration DNS​

Cloudflare​

Type: A
Nom: app
Contenu: <adresse-IP-depuis-les-détails-gateway>
Statut proxy: DNS uniquement (nuage gris)
TTL: Auto
Proxy Cloudflare

Définissez initialement sur "DNS uniquement" pour la vérification. Vous pouvez activer le proxy après le provisionnement SSL.

Route 53 (AWS)​

Nom d'enregistrement: app.example.com
Type d'enregistrement: A
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300
Politique de routage: Simple

GoDaddy​

Type: A
Hôte: app
Pointe vers: <adresse-IP-depuis-les-détails-gateway>
TTL: 1 heure

Namecheap​

Type: A Record
Hôte: app
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: Automatique

Squarespace Domains (anciennement Google Domains)​

Nom d'hôte: app
Type: A
TTL: 300
Données: <adresse-IP-depuis-les-détails-gateway>

Domaines Apex​

Les domaines apex (ex: example.com sans www) utilisent la même configuration d'enregistrement A :

Type: A
Nom: @
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300
Adresse IP

L'adresse IP est affichée dans la page de détails de votre gateway.

Statut des Domaines​

Statut DNS​

Chaque domaine affiche son statut DNS et TLS actuel :

StatutDescription
DNS Configuré (vert)L'enregistrement A pointe correctement vers l'IP du gateway
DNS Non Configuré (rouge)Enregistrement A manquant ou incorrect
TLS Prêt (vert)Le certificat SSL est valide et actif
TLS Non Prêt (rouge)Certificat en attente ou problème de provisionnement

Dépannage DNS​

DNS pas encore propagé

  • Attendez 5-10 minutes pour la propagation
  • Utilisez dig ou des outils en ligne pour vérifier
# Vérifier l'enregistrement A
dig app.example.com A

Mauvaise valeur DNS

  • Vérifiez que l'adresse IP correspond à votre gateway
  • Assurez-vous qu'il n'y a pas de fautes de frappe dans l'adresse IP

Proxy activé (Cloudflare)

  • Désactivez temporairement le proxy (nuage orange → nuage gris)
  • Réactivez après le provisionnement SSL

Domaines Wildcard​

Configuration des Wildcards​

Routez tous les sous-domaines vers votre gateway :

Type: A
Nom: *
Valeur: <adresse-IP-depuis-les-détails-gateway>

Cela permet :

  • api.example.com
  • app.example.com
  • staging.example.com
  • N'importe quel *.example.com

Ajouter un Wildcard dans SailOps​

  1. Ajoutez le domaine comme *.example.com
  2. Configurez l'enregistrement DNS wildcard
  3. Le SSL couvre tous les sous-domaines

Domaines Multiples​

Ajouter Plusieurs Domaines​

Une seule gateway peut servir plusieurs domaines :

Domaines:
- example.com
- www.example.com
- app.example.com
- api.example.com
- monautrapp.com

Routage par Domaine​

Routez différents domaines vers différents conteneurs :

routes:
- host: api.example.com
path: /
container: api
port: 8080
- host: app.example.com
path: /
container: frontend
port: 3000
- host: "*" # Par défaut pour tous les autres domaines
path: /
container: landing
port: 80

Gestion des Domaines​

Voir le Statut des Domaines​

  1. Allez dans votre gateway
  2. Cliquez sur l'onglet Domaines
  3. Consultez le statut de chaque domaine

Supprimer un Domaine​

  1. Trouvez le domaine dans la liste
  2. Cliquez sur Supprimer
  3. Confirmez la suppression
attention

Supprimer un domaine arrête immédiatement le trafic sur ce domaine.

Bonnes Pratiques DNS​

Utiliser des Sous-domaines​

Préférez app.example.com à example.com :

  • Organisation plus claire des services
  • Plus facile de gérer plusieurs services
  • Provisionnement SSL plus simple

TTL Bas Pendant la Configuration​

Utilisez un TTL bas (300 secondes) pendant la configuration initiale :

  • Propagation plus rapide
  • Mises à jour rapides si des changements sont nécessaires
  • Augmentez le TTL une fois stable

Sauvegarder les Enregistrements DNS​

Avant de faire des changements :

  1. Documentez les enregistrements existants
  2. Testez les changements en staging
  3. Ayez un plan de rollback prêt

Dépannage​

Domaine Non Résolu​

# Vérifier si le DNS est configuré
dig app.example.com A

# La sortie attendue montre un enregistrement A avec l'IP de votre gateway
;; ANSWER SECTION:
app.example.com. 300 IN A <votre-ip-gateway>

Certificat SSL Non Provisionné​

  1. Vérifiez que le domaine est vérifié
  2. Vérifiez que le DNS est correct
  3. Attendez jusqu'à 10 minutes
  4. Contactez le support si le problème persiste

"Too Many Redirects"​

Généralement causé par :

  • Boucle de redirection HTTPS avec un proxy externe
  • Règles de redirection conflictuelles

Solution :

  • Vérifiez les paramètres SSL/TLS de tout proxy externe
  • Vérifiez la configuration de redirection

Domaine Fonctionne Mais Lent​

  1. Vérifiez le TTL DNS (plus bas = plus de lookups)
  2. Vérifiez la latence de la gateway et les métriques du trafic HTTP
  3. Vérifiez les performances du conteneur

Sujets Connexes​