Aller au contenu principal

Préconisations pour la migration de ForgeMIA vers Forge INRAE

La mise en production de la forge INRAE s'est déroulée avec succès le 10 juin 2025. Plus d'informations.
Flyer

Depuis la migration, une redirection web du nom de domaine forgemia.inra.fr vers forge.inrae.fr est en place pour les liens depuis le web.

attention

Cette redirection ne fonctionne que pour les liens sur le web (depuis des articles scientifiques par exemple), par contre elle ne fonctionne pas lors des interactions avec le dépôt git via le protocole SSH (en utilisant une clé SSH).
Pour corriger, veuillez mettre à jour vos dépôts git (voir ci-dessous).
Dans le cas où vous utilisez le protocole SSH et qu'un mot de passe vous est demandé, penchez-vous sur la FAQ (Pourquoi Git me demande un mot de passe ?).

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://forge.inrae.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. ↩