Aller au contenu

Exporter quelques projets

Si vous n'avez que quelques projets, le plus simple est de les exporter un par un.

Export d'un projet depuis forge.aeif.fr

Commencez par vous rendre sur la page du projet sur forge.aeif.fr.

Sélectionner les paramètres

Exporter

Attendre le message

Télécharger l'export

Importation d'un projet sur forge.apps.education.fr

Création d'un groupe

Cette opération n'est à faire qu'une seule fois.

Créer un groupe

Vous devriez arriver sur https://forge.apps.education.fr/groups/new#create-group-pane

Vous pouvez désormais créer votre groupe

Création du groupe

À cet étape, il est essentiel que l'url du groupe soit votre identifiant de l'ancienne forge.

Vous pouvez désormais créer un projet :

Création d'un projet

Lors de cette phase, vous pourrez importer votre projet :

Import du projet

Alternativement, si vous êtes familier avec SSH et la ligne de commande : git push --set-upstream git@forge.apps.education.fr:vincent-xavier.jumel/$(git rev-parse --show-toplevel | xargs basename).git $(git rev-parse --abbrev-ref HEAD)

Sélectionner « Export gitlab » :

Import Gitlab

Reprendre désormais le nom de votre ancien projet, sélectionner votre fichier d'export et importez votre projet.

Import final

Ne pas oublier de modifier les urls

Attention, si vous utilisez un générateur de site web comme mkdocs, il faut penser à mettre à jour vos liens, en particulier site_url.

Exécuter le pipeline au moins une fois

Une fois le projet importé, il faut aller dans «Compilation>Pipeline» et l’exécuter au moins une fois. Puis dans «Déploiement>Pages», décocher «Domaine Unique».

Domaine

Gérer la redirection

Pour rediriger automatiquement vos pages, il suffit d'ajouter une ligne comme <meta http-equiv="refresh" content="0;url=https://vincentxavier.forge.apps.education.fr/playground/"> dans l'entête html de vos pages web.

Pour les utilisateurs de mkdocs, il faut rajouter dans le répertoire overrides un fichier main.html avec

{% block extrahead %}
  <!-- gestion de la redirection de la page -->
  <meta http-equiv="refresh" content="0;url={{ [config.site_url,page.url] | join('/') | replace('aeif','apps.education') }}">
  <!-- Fin de la redirection -->
{% endblock %}

Si le répertoire overrides n'est pas défini, il faut le rajouter dans la configuration, avec la clef custom_dir: overrides dans la configuration du thème.

Voir https://squidfunk.github.io/mkdocs-material/customization/#overriding-blocks