Aller au contenu principal

Préconisations pour la migration de ForgeMIA vers Forge INRAE

La mise en production de la forge INRAE, initialement prévue du 10 au 12 mars 2025, a été reportée au mardi 10 juin 2025 à 12h. Plus d'informations.
Flyer

Suite à la migration, une redirection web sera mise en place depuis le nom de domaine forgemia.inra.fr vers forge.inrae.fr.

Toutefois, certaines actions sont à prévoir côté utilisateur. Elles sont listées sur cette page.

Un flyer récapitulatif permet d'avoir une vue synthétique des actions à faire avant et après migration. N'hésitez pas à le diffuser dans vos réseaux ➡️

Avant la migration​

  • "Faire du ménage", essentiellement pour ce qui concerne les dépôts volumineux ou inutilisés ainsi que les nombreux forks.
  • Vérifier dans les fichiers .gitlab-ci.yml de vos projets qu'il n'y ait pas de chemin en dur vers des dépôts ForgeMIA (code, packages, containers). Nous recommandons vivement d'utiliser à la place les variables GitLab.
attention

Si ces modifications sur vos fichiers .gitlab-ci.yml ne sont pas faites en amont de la migration, les pipelines CI-CD risquent de ne pas fonctionner correctement !

Après la migration​

Mise à jour des clients git​

  • Modifier la configuration des différents clients :

    • clients git (en ligne de commande, ou en client graphique)
    • outils tiers utilisant l'API GitLab (sonarqube, jira, etc.), retrouvez la liste via l'API1.
    • serveurs SSH si une restriction par IP a été mise en place (pour les runners partagés de forge INRAE)
    • éditeurs de code type Visual Studio Code, RStudio, Spyder, etc.

    Voici un exemple pour un dépôt git utilisant SSH, en ligne de commande :

    git remote set-url origin git@forge.inrae.fr:mon-groupe/mon-projet.git
    git remote -v

    Un script bash, pour Linux notamment, a été écrit pour simplifier cette modification si vous avez beaucoup de dépôts.

Mise à jour des runners GitLab​

  • Modifier la configuration des runners "utilisateurs", c'est à dire les runners privés déployés sur vos propres infrastructures : Documentation Gitlab

    # Fichier `config.toml`
    concurrent = 1
    check_interval = 0

    [[runners]]
        name = "mon_runner"
        url = "https://forge.inrae.fr/"
        id = 1
        (...)

Mise à jour des webhooks​

Mise à jour références externes​

  • Modifier autant que possible toutes les références à ForgeMIA utilisées ailleurs.
    remarque

    La redirection mise en place devrait permettre de maintenir un accès aux contenus en ligne, comme les publications scientifiques et les sites internet. Mais certains services externes faisant appel à l'API GitLab pourraient ne plus fonctionner avec cette redirection.

Vérification des tokens​

Arrêt authentification OIDC sur GitLab forge INRAE​

Si vous avez configuré un service tier pour qu'il délègue l'authentification de ses utilisateurs auprès du GitLab de la forge INRAE, cela n'est plus autorisé. Veuillez prendre connaissances des recommandations de la FAQ.

Messagerie instantanée​

Concernant Mattermost, il n'y aura pas de redirection de team.forgemia.inra.fr vers chat.forge.inrae.fr

Il faudra donc changer la configuration des clients lourds en conséquence, ainsi que mettre à jour l'intégration "Mattermost notifications".

Footnotes​

  1. Pour trouver la liste des outils externes intégrés avec vos projets, adaptez la valeur de :project_id dans le lien suivant, puis ouvrez-le : https://forgemia.inra.fr/api/v4/projects/:project_id/integrations Le :project_id est l'identifiant interne de votre projet GitLab, accessible via le bouton "trois points suspendus" situé en haut à droite de la page d'accueil de votre projet : test. ↩