Le Git d'Alpinux¶

L'association héberge sa propre forge logicielle à l'adresse gitea.alpinux.org. C'est l'équivalent associatif de GitHub ou GitLab : un endroit où déposer du code, le versionner, le partager, suivre des tickets.

Elle est ouverte aux membres pour leurs projets personnels : un script bricolé un dimanche, la configuration de sa machine, les sources d'un site, des notes — tout ce qui gagne à être versionné et à ne pas vivre uniquement sur un disque dur.

Gitea ou Forgejo ?

L'adresse dit gitea, la page affiche Forgejo. Forgejo est la suite du projet Gitea, dont il est issu ; l'adresse historique a été conservée. Si une documentation trouvée sur Internet parle de Gitea, elle s'applique presque toujours telle quelle.

Créer son compte¶

Il n'y a pas d'inscription directe sur la forge : le formulaire est désactivé et affiche « Registration is disabled ». C'est normal. Tous les comptes passent par AlpID, l'authentification unique de l'association — un seul identifiant pour la forge, le wiki, le cloud et les autres services.

1. Créer son compte AlpID¶

Allez sur https://alpid.alpinux.org.
Cliquez sur « Créer un compte » (ou Register).
Remplissez le formulaire :
- Nom d'utilisateur : simple, sans accent ni espace (ex. prenom.nom) — il servira aussi d'adresse à vos dépôts ;
- Adresse e-mail : une adresse que vous consultez régulièrement ;
- Mot de passe : au moins 8 caractères.
Validez, puis cliquez sur le lien de confirmation reçu par courriel.

Déjà membre ?

Si vous avez déjà un compte sur le portail membres ou le cloud de l'association, c'est le même : inutile d'en créer un second, passez directement à l'étape suivante.

2. Première connexion à la forge¶

Allez sur https://gitea.alpinux.org.
Cliquez sur « Connexion » en haut à droite.
Choisissez « Se connecter avec AlpID ».
AlpID confirme votre identité et vous ramène sur la forge.

Votre compte y est créé automatiquement à cette première connexion : vous avez maintenant votre espace, à l'adresse gitea.alpinux.org/votre-nom-dutilisateur.

Créer son premier dépôt¶

En haut à droite, cliquez sur + puis Nouveau dépôt.

Remplissez :

Champ	Conseil
Nom du dépôt	court, en minuscules, sans espace — `mes-scripts`, `config-i3`
Description	une phrase : dans six mois, elle vous rappellera de quoi il s'agit
Visibilité	Privé dans le doute : un dépôt se rend public plus tard, l'inverse n'efface pas ce qui a été vu
Initialiser avec un README	oui — un dépôt vide est pénible à cloner
.gitignore	choisissez le modèle correspondant à votre langage
Licence	pour un projet destiné à être partagé, la GPL ou la MIT selon vos préférences

Créer le dépôt.

Y envoyer son travail¶

Deux façons de vous authentifier. La clé SSH est à configurer une fois pour toutes ; le jeton HTTPS dépanne partout.

Par clé SSH (recommandé)¶

Générez une clé si vous n'en avez pas déjà une :

ssh-keygen -t ed25519 -C "prenom@ma-machine"

Acceptez le chemin proposé et choisissez une phrase de passe. Affichez la partie publique — celle qui se termine par .pub, la seule qui se partage :

cat ~/.ssh/id_ed25519.pub

Copiez la ligne entière, puis sur la forge : votre avatar → Paramètres → Clés SSH / GPG → Ajouter une clé. Donnez-lui un nom qui identifie la machine (portable, tour-du-salon), collez, validez.

Vérifiez :

ssh -T git@gitea.alpinux.org

La forge répond Hi there, votre-nom !… Forgejo does not provide shell access — c'est le message attendu : l'authentification fonctionne, et la forge ne donne pas d'accès au shell, ce qui est voulu.

Vous pouvez alors cloner et pousser :

git clone git@gitea.alpinux.org:votre-nom/mes-scripts.git

Par HTTPS avec un jeton¶

Utile depuis une machine où vous ne voulez pas déposer de clé, ou pour un script.

Avatar → Paramètres → Applications → Générer un nouveau jeton.
Donnez-lui un nom parlant et cochez seulement les portées nécessaires — pour pousser du code, repository suffit.
Copiez le jeton : il ne sera plus affiché ensuite.

Le jeton remplace le mot de passe :

git clone https://gitea.alpinux.org/votre-nom/mes-scripts.git
# utilisateur : votre nom d'utilisateur
# mot de passe : le jeton

Un jeton est un mot de passe

Ne le placez jamais dans un fichier versionné, ni dans l'URL d'un dépôt que vous partagez. S'il vous échappe, révoquez-le depuis la même page : il cesse immédiatement de fonctionner.

Quelques repères¶

Ce qui n'a pas sa place dans un dépôt : mots de passe, jetons, clés privées, fichiers .env. Une fois poussé, un secret reste dans l'historique même après suppression du fichier — il faut le considérer comme compromis et le changer. Les gros fichiers binaires (vidéos, machines virtuelles) n'y ont pas leur place non plus : git conserve chaque version, le dépôt gonfle et ne dégonfle jamais.

Gardez une copie ailleurs. La forge est un service rendu par des bénévoles, pas un service de sauvegarde. Un dépôt cloné sur votre machine est une copie complète de l'historique : c'est déjà une bonne assurance.

Public ou privé ? Un dépôt public est lisible par tout Internet, moteurs de recherche compris. Privé par défaut, publié quand c'est prêt : c'est le sens de la marche.

Et pour le wiki ?¶

Le wiki que vous lisez est lui-même hébergé sur cette forge. Pour y contribuer — corriger une faute, proposer un article — la marche à suivre est décrite dans Contribuer au wiki.

Une question ?¶

Posez-la lors d'une rencontre Alpinux : la forge est un service de l'association, les bénévoles sont les mieux placés pour vous aider à démarrer.