Ceci est une ancienne révision du document !
Forgejo - Port
Migration de gitlab à Forgejo ; https://port.numenaute.org est actuellement sur gitlab, https://git.numenaute.org sur Forgejo.
Le service https://port.numenaute.org est une forge logicielle1).
Elle permet de travailler à plusieurs sur du code, de le partager au public, d'accepter des tickets, etc.
Le logiciel est basé sur Forgejo ; vous trouverez la documentation officielle (en anglais) sur https://forgejo.org/.
Conditions d'utilisation du service
Le service est ouvert sur simple demande. À cause des robots spammeurs, nous ne pouvons pas laisser les gens s'inscrire simplement, mais il suffit de nous contacter pour qu'on vous ouvre un compte. Quand on arrivera à gérer ces spammeurs automatiquement, nous laissons les inscriptions librement ouvertes.
Avec un compte, vous pourrez créer des tickets et échanger sur ces derniers, ainsi que rejoindre la gestion de certains projets hébergés dans la forge.
Pour pouvoir avoir vos propres dépôts, il faut que nous sachions ce que vous voulez faire :
- Projet sous licence libre et public, pas de souci, allez-y.
- Projet sous une licence non libre et/ou privé : nous apprécions que vous nous prouviez votre participation aux Communs par ailleurs, par exemple en participant à d'autres projets libres sur notre forge, ou en nous/les soutenant financièrement.
- Projet très demandeur en ressources (grosses CI par exemple) : informez-nous en amont de vos besoins, pour que nous adaptions les machines. Nous vous demanderons aussi, très probablement, un véritable engagement en tant que partenaire.
Par défaut, si vous êtes inscrit, nous vous laissons la possibilité de créer librement 10 projets, mais il peut y avoir une modération a posteriori si nous trouvons que vous abusez de nos services. Le mieux est donc de nous avertir lorsque vous créez un projet.
Par défaut, nous vous réservons 5Go de stockage. Si vous avez besoin de plus sur la Forge, demandez-nous.
Pour les utilisateurs de base
Explication pour les noobs, à compléter, afin que même quelqu'un qui n'est pas doué avec l'informatique puisse s'approprier le service. Si vous avez des liens vers des tutos vidéos, ajoutez-les !
Transférer un dépôt depuis Gitlab
Aller sur le menu “+” (en haut à droite à côté de votre avatar), sélectionner “Nouvelle migration”, choisissez Gitlab.
Ici une particularité sur l'URL à renseigner : il ne s'agit pas de l'url pour gérer votre projet (du type https://gitlab.com/user/nom_projet) mais de l'url de l'ID du projet. Ce dernier se trouve sous le titre de votre dépôt, c'est intitulé “Identifiant de projet”, et l'url à renseigner est de la forme https://gitlab.com/ID (par exemple https://port.numenaute.org/175
Pour le reste, ça devrait aller tout seul, Forgejo pointe la doc de Gitlab sur comment se créer un jeton d'accès, y'a des options de dev qui devraient vous parler… Et voilà, ça devrait être migré !
Pour les utilisateurs avancés
Les trucs un peu compliqués que permet le logiciel, ou qui sont accessibles avec des droits précis.
Pour les administrateurs de Numenaute
Infos pour gérer un service similaire.
