Aller au contenu principal

GitLab Pages

GitLab Pages est un service pour générer des sites web statiques à partir de votre dépôt Git via les outils d'intégration continue de GitLab. Il est possible d'utiliser des générateurs de site comme Jekyll, Hugo, etc.

Cas par défaut​

Documentation officielle de GitLab Pages

L'URL d'accès au site web sera en :
https://username.pages-forge.inrae.fr/nom_projet
ou
https://groupe.pages-forge.inrae.fr/nom_projet

Attention

Si le login ou le groupe comporte un point dans le nom (par ex. robert.dupont ou projet.exceptionnel) l'URL générée par GitLab pour le HTTPS provoquera une exception de sécurité dans les navigateurs.

Solution

Les nouveaux projets "personnels" qui nécessitent Gitlab Pages ne doivent pas être créés sous l'espace utilisateur mais dans un groupe dédié ne contenant pas de point (.), par exemple en le remplaçant par un tiret.

Pour les projets existants concernés par le problème ci-dessus, une solution consiste à remplacer le point (.) de l'espace de nom.
Pour ce faire, créez un nouveau groupe nommé prenom-nom (par ex. robert-dupont au lieu de robert.dupont) et transférez-y votre projet de site web.

Démo​

Voici un exemple projet de démonstration : https://forge.inrae.fr/adminforgemia/demo-pages

Cas particulier : nom de domaine propre​

Si pour des raisons d'affichage ou de communication vous souhaitez que vos pages créées avec GitLab Pages aient un nom de domaine propre, il y a deux possibilités.

Un nom de domaine en inrae.fr​

Vous voulez un nom de domaine xxx.inrae.fr, xxx.unite.inrae.fr ou xxx.centre.inrae.fr.

  1. Envoyez un mail au support de la forge avec le modèle suivant :

    Bonjour,

    Pouvez-vous faire une demande de nom DNS auprès de la DSI pour mon projet [nom_du_projet] ?

    Le nom que je souhaiterais est :

    [nom_DNS_souhaite]

    Merci d'avance, bonne journée.

    Ce sont les services de la DSI qui gèrent les noms de domaine en inrae.fr. En règle générale, si votre groupe ou projet à une portée nationale, les services de la DSI peuvent accepter des noms en [mon_projet].[mon_groupe].inrae.fr. Pour les autres, les services de la DSI accepte plus facilement des noms en [mon_groupe].[centre].inrae.fr.

  2. Une fois le nom de domaine validé par la DSI, vous devez générer un certificat SSL et faire une demande Ariane auprès de la DSI pour la requête de certification.

  3. Après avoir récupéré la chaîne de certification, complétez la configuration de GitLab Pages avec le nouveau nom de domaine et les certificats SSL.

Autre cas de figure : Nom de domaine en .fr, .com, etc​

Voir les offres de la DSI dans ce domaine.