FAQ forge.april.org

Ce fichier recueille des astuces et informations pour l'utilisation de la forge April.

Quel gestionnaire de tickets utiliser ?

Par défaut, le gestionnaire de tickets à utiliser est celui choisi par l'April pour tous ses projets : https://agir.april.org/ (Redmine).

Redmine peut sembler archaïque mais il reste terriblement efficace pour la gestion des tickets. Continuer à l'utiliser permettra d'éviter de multiplier les outils pour une même fonction.

Gitea permet définir un gestionnaire de tickets externe dans les paramètres de dépôt :

• aller à la page de dépôt en tant qu'administrateur ;
• cliquer sur le bouton « Paramètres » en haut à droite ;
• cocher « Activer le suivi de tickets du dépôt ;
• sélectionner « Utiliser un système de suivi de tickets externe »
• champ « Adresse du système de tickets externe »
  • mettre l'URL de l'onglet « Demandes » du projet Agir,
  • exemple : https://agir.april.org/projects/admins/issues
• champ « Format de l'URL du système de tickets » :
  • mettre https://agir.april.org/issues/{index}
• champ « Format du nombre de tickets du système de tickets externe »
  • cocher « Numérique (#1234) »
• cliquer sur « Valider ».

Comment faire reconnaître ses différents courriels dans les commits ?

Lorsqu'on commite, il arrive souvent qu'on le fasse avec des adresses de courriel différentes. Résultat, dans la page qui liste les commits, votre avatar s'affiche uniquement pour le courriel associé à votre compte de forge.

Gitea permet d'ajouter d'autres courriels à son compte et ceux-ci seront utilisés pour reconnaître vos commits :

• menu avatar en haut à droite > Configuration ;
• onglet « compte » ;
• section Gérer les adresses de courriel ;
• ajouter une adresse e-mail.

Quelles sont les conventions markdown ?

Pour les *markdowns, Gitea utilise le logiciel de rendu Goldmark (licence MIT) qui est compatible CommonMark (https://commonmark.org/)

Que faire pour pouvoir pusher depuis une vm ?

Un pré-requis est de bien configurer son environnement SSH en suivant la doc admin : https://admin.chapril.org/doku.php?id=admin:procedures:ajouter-animateur-service&s[]=ssh#acces_ssh

Ensuite, pour pouvoir pusher depuis un vm, il faut déclarer la clé SSH publique de votre machine personnelle dans votre compte sur la forge :

• Avatar (en haut à droite) > Configuration > Onglet clé SSH/GPG.

Après un court instant, votre clé est déployée et vous pouvez pusher.

Oui, la clé publique de votre machine personnelle sera utilisée alors que vous êtes sur une vm distante.

Attention : sur certains système, il faut faire un ssh-add avant de se connecter pour que ça fonctionne.