c52652f07e
La page de contribution portait tout : le parcours web, la syntaxe Markdown, la ligne de commande et Obsidian. Chacun de ces morceaux a maintenant sa page, et la page d'accueil de la contribution garde ce qu'elle sait faire — expliquer le processus de bout en bout. Nouvelle page « Le Git d'Alpinux » : l'inscription est fermée et passe par AlpID, ce que rien n'indiquait jusqu'ici. Le coffre Obsidian est configuré en liens Markdown relatifs, comme la page le décrit : MkDocs ne comprend pas les [[wikilinks]]. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BE4rvHVETRoWnYNDTGssdo
174 lines
6.3 KiB
Markdown
174 lines
6.3 KiB
Markdown
---
|
|
description: Créer son compte sur le Git d'Alpinux (Forgejo), y héberger ses propres dépôts, et y envoyer son travail en SSH ou en HTTPS.
|
|
---
|
|
|
|
# Le Git d'Alpinux
|
|
|
|
L'association héberge sa propre **forge logicielle** à l'adresse
|
|
**[gitea.alpinux.org](https://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.
|
|
|
|
!!! info "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
|
|
|
|
1. Allez sur **[https://alpid.alpinux.org](https://alpid.alpinux.org)**.
|
|
|
|
2. Cliquez sur **« Créer un compte »** (ou *Register*).
|
|
|
|
3. 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.
|
|
|
|
4. Validez, puis cliquez sur le lien de confirmation reçu par courriel.
|
|
|
|
!!! note "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
|
|
|
|
1. Allez sur **[https://gitea.alpinux.org](https://gitea.alpinux.org)**.
|
|
|
|
2. Cliquez sur **« Connexion »** en haut à droite.
|
|
|
|
3. Choisissez **« Se connecter avec AlpID »**.
|
|
|
|
4. 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
|
|
|
|
1. En haut à droite, cliquez sur **+** puis **Nouveau dépôt**.
|
|
|
|
2. 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 |
|
|
|
|
3. **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 :
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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 :
|
|
|
|
```bash
|
|
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.
|
|
|
|
1. Avatar → **Paramètres** → **Applications** → **Générer un nouveau jeton**.
|
|
|
|
2. Donnez-lui un nom parlant et **cochez seulement les portées nécessaires** — pour
|
|
pousser du code, `repository` suffit.
|
|
|
|
3. Copiez le jeton : **il ne sera plus affiché ensuite**.
|
|
|
|
Le jeton remplace le mot de passe :
|
|
|
|
```bash
|
|
git clone https://gitea.alpinux.org/votre-nom/mes-scripts.git
|
|
# utilisateur : votre nom d'utilisateur
|
|
# mot de passe : le jeton
|
|
```
|
|
|
|
!!! danger "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](../contribuer/index.md).
|
|
|
|
## Une question ?
|
|
|
|
Posez-la lors d'une [rencontre Alpinux](../alpinux/evenements.md) : la forge est un
|
|
service de l'association, les bénévoles sont les mieux placés pour vous aider à démarrer.
|