Configurer le lien entre Osuny et son client Git

Cette fiche présente un tutoriel pour configurer la liaison entre Osuny et GitLab. Cette manipulation permet de mettre à jour automatiquement le contenu du site web.

Liens d'accès

Initialiser le dépôt avec la CI (depuis GitLab)

Consulter l'article "Déployer un site depuis la CI".

Une fois la procédure suivie et le site généré, vous aurez accès à son répertoire sur la forge de Plateaux dans le groupe "Mairie".

Créer un nouveau site web Osuny

L'étape suivante est réservée aux personnes dotées de droits d'administration de sites Osuny.

Depuis l'instance d'Osuny, dans le bandeau de gauche, cliquer sur "Site web" sous l'onglet "Communication".

Cliquer sur le bouton 'créer' en bas à droite.

Renseigner les informations suivantes (pour les champs ici en gras, se référer aux étapes de documentation suivantes) :

  • Informations

    • Nom : nom du site

    • URL : lien d'accès au site (non configurer pour le moment)

    • Sujet du site : Site indépendant (aucun sujet)

  • Git

    • Git provider : GitLab

    • Git endpoint : https://forge.liiib.re/api/v4

    • Access token : le token généré dans GitLab

    • Repository : le Project ID du dépot git

      Dans les versions récentes, Osuny propose de choisir la langue du site dans les paramètres d'édition. Nous vous conseillons de sélectionner uniquement "fr".

      Récupérer le project ID sur le répertoire git du site

      • Noter le Project ID, disponible sous le nom du projet

      Générer un token d'accès Git

      La génération d'un token d'accès est expliquée dans l'article "Générer un Access Token"

      Vérifier le fonctionnement

      Une fois la configuration faite, vérifier qu'une première modification du site sur Osuny publie automatiquement sur GitLab la structure du site.

      Remarques

      Pour ajouter un contenu, il est nécessaire de cocher Publié ?