Aller au contenu

Domaine personnalisé

Faites pointer votre propre domaine (par ex. monsite.com) vers votre site GitLab Pages. Cela prend 15 minutes et c'est gratuit.

Par défaut, votre site Silex est accessible à https://votreutilisateur.gitlab.io/nomduprojet/. Si vous possédez un domaine, vous pouvez faire en sorte que les visiteurs accèdent à https://monsite.com à la place — et cela fait plus professionnel.

Ce dont vous aurez besoin

  • Un nom de domaine (acheté auprès d'un registrar comme Le Bureau (coopérative), Gandi, ou tout autre registrar de votre choix)
  • L'accès aux paramètres DNS de votre domaine (le panneau de contrôle de votre registrar)
  • L'URL de votre GitLab Pages (par ex. https://votreutilisateur.gitlab.io/nomduprojet/)

Raccourci Silex : Vous pouvez trouver le lien vers votre projet GitLab directement dans Silex sous Site Settings > onglet General.

Étape 1 : Obtenir votre URL GitLab Pages

Si vous ne la connaissez pas encore :

  1. Dans Silex, ouvrez Site Settings > onglet General pour trouver le lien vers votre projet GitLab, ou rendez-vous directement sur votre projet GitLab
  2. Cliquez sur Deploy → Pages (barre latérale gauche)
  3. Sous « Access pages at », copiez l'URL

Par exemple : https://alice.gitlab.io/mon-portfolio/

Gardez-la sous la main — vous en aurez besoin dans un instant.

Étape 2 : Choisir entre un sous-domaine ou un domaine racine

Vous avez deux options :

Option A : Domaine racine — monsite.com (sans www)

C'est le plus simple pour la plupart des utilisateurs. Les visiteurs accèdent à monsite.com et voient votre site.

Option B : Sous-domaine — www.monsite.com

Les visiteurs doivent taper www.monsite.com pour voir votre site. monsite.com seul ne fonctionne pas à moins de configurer des redirections DNS supplémentaires.

Ce guide couvre l'Option A (domaine racine). Les deux sont parfaitement valables — choisissez en fonction de vos préférences et de ce que votre registrar prend en charge.

Étape 3 : Ajouter des enregistrements DNS chez votre registrar

C'est ici que cela devient technique, mais il n'y a que trois étapes.

Connectez-vous au panneau de contrôle de votre registrar de domaine et trouvez la section Paramètres DNS ou Enregistrements DNS.

Vous devez ajouter ou mettre à jour un enregistrement A :

  • Type : A
  • Nom ou Hostname : @ (ou laissez vide — cela désigne le domaine racine)
  • Valeur : 185.199.108.153 (c'est l'adresse IP de GitLab)

GitLab fournit également trois autres adresses IP pour la redondance. La bonne pratique est d'ajouter les quatre :

  • 185.199.108.153
  • 185.199.109.153
  • 185.199.110.153
  • 185.199.111.153

Comment les ajouter :

Créez quatre enregistrements A séparés, un pour chaque IP. Configurez-les tous pour pointer vers @ (le domaine racine).

Alternativement, certains registrars vous permettent de lister plusieurs IP dans un seul enregistrement. Consultez la documentation de votre registrar.

N'utilisez pas CNAME pour les domaines racines — Les enregistrements CNAME ne fonctionnent pas pour les domaines racines (uniquement pour les sous-domaines). Utilisez des enregistrements A à la place.

Étape 4 : Configurer le domaine dans GitLab

Maintenant, informez GitLab de votre domaine.

  1. Rendez-vous sur votre projet GitLab
  2. Cliquez sur Deploy → Pages (barre latérale gauche)
  3. Cherchez la section « Domains »
  4. Cliquez sur + New domain (ou Add domain)
  5. Entrez votre nom de domaine (par ex. monsite.com)
  6. Cliquez sur Create domain

GitLab s'attend maintenant à voir ces enregistrements DNS A pointant vers ses adresses IP.

Étape 5 : Attendre la propagation DNS

Les changements DNS ne sont pas instantanés. Il faut généralement de 5 minutes à 24 heures pour que le DNS se propage dans le monde entier. Pendant ce temps :

  • Certains visiteurs pourraient voir votre site, d'autres pourraient voir une erreur ou l'ancien site
  • C'est normal et temporaire

Pour vérifier si le DNS est prêt :

  1. Ouvrez un terminal ou une invite de commandes sur votre ordinateur
  2. Tapez : nslookup monsite.com (remplacez monsite.com par votre domaine)
  3. Si cela affiche les adresses IP de GitLab (185.199.10X.153), le DNS s'est propagé
  4. Si cela affiche autre chose, le DNS ne s'est pas encore propagé — attendez et réessayez dans 10 minutes

Alternativement, utilisez un vérificateur DNS en ligne comme MXToolbox ou DNS Checker.

Étape 6 : Vérifier le HTTPS (certificat SSL)

Une fois le DNS propagé, votre site est en ligne à monsite.com. GitLab provisionne automatiquement un certificat SSL gratuit via Let's Encrypt.

Cela se fait automatiquement — vous n'avez rien à faire. Cherchez l'icône de cadenas dans la barre d'adresse de votre navigateur. Si vous le voyez, le HTTPS fonctionne.

Si le certificat SSL n'est pas encore apparu :

  1. Attendez 10 minutes
  2. Rendez-vous dans GitLab → Deploy → Pages
  3. Sous votre domaine, vérifiez s'il y a un statut « Pending »
  4. Si oui, attendez encore un peu. Si cela reste en attente pendant plus d'une heure, consultez le dépannage ci-dessous

Dépannage

Le vérificateur DNS affiche mes enregistrements mais le site ne charge pas

Cause : Vos enregistrements DNS sont correctement configurés, mais soit :

  • Le DNS ne s'est pas entièrement propagé (attendez 10 minutes et réessayez)
  • Votre navigateur met en cache l'ancien résultat DNS
  • GitLab Pages n'a pas encore reconnu le domaine

Solution : 1. Ouvrez une fenêtre de navigation privée/incognito et visitez votre domaine 2. Si cela fonctionne en navigation privée mais pas en mode normal, videz le cache de votre navigateur 3. Si cela ne fonctionne toujours pas, laissez encore 10 à 30 minutes au DNS pour se propager 4. Vérifiez le pipeline CI/CD de votre projet GitLab — assurez-vous que le dernier build a réussi

Le certificat SSL affiche « pending » depuis plus d'une heure

Cause : GitLab ne peut pas vérifier que vous êtes propriétaire du domaine, souvent parce que le DNS n'était pas entièrement configuré.

Solution : 1. Revérifiez que les quatre enregistrements A sont bien définis dans les paramètres DNS de votre registrar 2. Relancez nslookup monsite.com pour confirmer la propagation DNS 3. Dans GitLab, rendez-vous dans Deploy → Pages et supprimez le domaine 4. Attendez 5 minutes, puis ajoutez-le à nouveau avec + New domain 5. Attendez encore 10 à 30 minutes pour que le certificat SSL soit provisionné

« monsite.com » charge mais « www.monsite.com » ne fonctionne pas

Cause : Vous avez configuré le domaine racine (@) mais pas le sous-domaine www.

Solution :

Si vous souhaitez que monsite.com et www.monsite.com fonctionnent tous les deux :

  1. Ajoutez un enregistrement CNAME pour www :
  2. Type : CNAME
  3. Nom ou Hostname : www

  4. Valeur : monsite.com (ou votre URL GitLab Pages)

  5. Dans GitLab, ajoutez également le domaine www.monsite.com dans Deploy → Pages → + New domain

  6. Attendez la propagation DNS

Les deux URL fonctionnent maintenant et affichent votre site.

Je souhaite déplacer mon domaine vers un autre projet GitLab

Vous pouvez le faire sans changer le DNS :

  1. Dans le nouveau projet GitLab, rendez-vous dans Deploy → Pages → + New domain
  2. Ajoutez le même nom de domaine
  3. Dans l'ancien projet, rendez-vous dans Deploy → Pages et supprimez le domaine
  4. Le DNS pointe déjà vers les serveurs de GitLab (pas vers un projet spécifique), donc il résout automatiquement vers le nouveau projet

Aucune modification DNS nécessaire.

HTTPS et sécurité

GitLab fournit automatiquement un certificat HTTPS gratuit pour votre domaine via Let's Encrypt. Le certificat se renouvelle automatiquement — vous n'avez rien à faire.

Le HTTPS est activé par défaut. Si quelqu'un visite http://monsite.com (sans le s), il est automatiquement redirigé vers https://monsite.com.

À propos des enregistrements A et CNAME

  • Enregistrement A : Fait pointer un domaine directement vers une adresse IP. À utiliser pour les domaines racines (monsite.com).
  • Enregistrement CNAME : Fait pointer un domaine vers un autre domaine. À utiliser pour les sous-domaines (www.monsite.com) pointant vers le domaine racine ou vers le domaine de GitLab.

GitLab utilise des enregistrements A pour les domaines racines car le CNAME ne fonctionne pas au niveau racine (normes DNS).

En savoir plus

Quiz

Q1 : Quel type d'enregistrement DNS devez-vous utiliser pour votre domaine racine ?

  • A) CNAME
  • B) Enregistrement A
  • C) Enregistrement MX
Réponse

B) Enregistrement A — Les enregistrements A font pointer les domaines vers des adresses IP. Le CNAME ne fonctionne pas pour les domaines racines. Utilisez les quatre adresses IP GitLab fournies.

Q2 : Combien d'enregistrements A devez-vous ajouter pour un domaine racine ?

  • A) Un (n'importe quelle adresse IP de GitLab suffit)
  • B) Quatre (toutes les adresses IP de GitLab pour la redondance)
  • C) Cela dépend de votre registrar
Réponse

B) Quatre (toutes les adresses IP de GitLab pour la redondance) — Ajouter les quatre offre une meilleure fiabilité. La plupart des registrars vous permettent d'ajouter plusieurs enregistrements A pointant vers le même nom de domaine.

Q3 : Combien de temps faut-il pour que les changements DNS prennent effet ?

  • A) Instantanément
  • B) 5 minutes
  • C) 5 minutes à 24 heures (généralement 10 à 60 minutes)
Réponse

C) 5 minutes à 24 heures (généralement 10 à 60 minutes) — La propagation DNS n'est pas instantanée. Elle dépend des paramètres TTL (Time To Live) et de la mise en cache des FAI.

Q4 : GitLab fournit-il le HTTPS pour votre domaine personnalisé ?

  • A) Uniquement si vous payez une mise à niveau
  • B) Oui, automatiquement via Let's Encrypt
  • C) Vous devez installer votre propre certificat SSL
Réponse

B) Oui, automatiquement via Let's Encrypt — GitLab provisionne et renouvelle automatiquement les certificats HTTPS gratuits. Aucune action de votre part n'est nécessaire.

Q5 : Si vous souhaitez que monsite.com et www.monsite.com fonctionnent tous les deux, quelle étape supplémentaire est nécessaire ?

  • A) Rien, les deux fonctionnent automatiquement avec les enregistrements A
  • B) Ajouter un enregistrement CNAME pour www pointant vers votre domaine racine, et ajouter le sous-domaine www dans les paramètres GitLab Pages
  • C) Contacter le support GitLab
Réponse

B) Ajouter un enregistrement CNAME pour www pointant vers votre domaine racine, et ajouter le sous-domaine www dans les paramètres GitLab Pages — Le domaine racine fonctionne avec les enregistrements A, mais www nécessite un enregistrement CNAME pointant vers le domaine racine.

Éditer cette page sur GitLab