La Tour de Guet

Seed nodes, configuration, systemd et monitoring

Architecture d'un seed node

Dans le réseau Radicle, tous les participants ne sont pas égaux en termes de disponibilité. Quand tu éteins ton ordinateur portable, tes projets ne sont plus accessibles aux autres. C'est là qu'interviennent les seed nodes.

Le rôle d'un seed dans le réseau P2P

Un seed node (nœud graine) est un ordinateur qui reste connecté en permanence au réseau Radicle. Son rôle :

• Disponibilité : il garde une copie des projets qu'il suit, même quand les auteurs sont hors ligne
• Découverte : il aide les nouveaux pairs à trouver des projets et d'autres pairs
• Relais : il transmet les mises à jour entre pairs qui ne sont pas directement connectés

# Sans seed node :
Alice (en ligne) <--> Bob (en ligne)     OK !
Alice (hors ligne) <--> Bob (en ligne)   Bob ne peut pas accéder au projet d'Alice

# Avec seed node :
Alice (hors ligne)
    |
    v (Alice a publié avant de se déconnecter)
  Seed Node (toujours en ligne) <--> Bob (en ligne)   Bob accède au projet !

Peer vs Seed - quelle différence ?

Prérequis pour un seed node

Pour monter un seed node, tu as besoin d'une machine connectée en permanence. Voici les options :

Le serveur

• VPS (Virtual Private Server) : la solution la plus courante. Des fournisseurs comme Hetzner, OVH, Scaleway ou DigitalOcean proposent des VPS à partir de 3-5 euros par mois
• Raspberry Pi : un petit ordinateur chez toi, connecté à ta box. Économique mais nécessite un IP fixe ou du DNS dynamique
• Serveur dédié : pour les projets ambitieux avec beaucoup de trafic

Configuration minimale

• OS : Linux (Debian, Ubuntu, Fedora) - recommandé
• RAM : 512 Mo minimum, 1 Go recommandé
• Disque : 10 Go minimum (dépend du nombre de projets suivis)
• Réseau : IP publique, port 8776 accessible

Installer radicle-node

Le nœud Radicle est inclus dans l'installation de rad que tu as faite dans la quête précédente. Le composant qui fait tourner le nœud s'appelle radicle-node.

# Si rad est déjà installé, le nœud est disponible
rad node --help

# Sinon, installe Radicle (cf. Quête 21)
curl -sSf https://radicle.xyz/install | sh

Vérifier les composants

# Vérifie que tous les composants sont présents
rad --version
rad node --version

# Les binaires se trouvent dans :
ls ~/.radicle/bin/
# radicle-node  rad  ...

Configuration du nœud

Le fichier de configuration de ton nœud Radicle se trouve dans ~/.radicle/config.json. C'est là que tu définis le comportement de ta tour de guet.

Le fichier de configuration

# Afficher la configuration actuelle
rad config

# Le fichier se trouve ici :
cat ~/.radicle/config.json

Voici les paramètres importants :

{
  "node": {
    "alias": "ma-tour-de-guet",
    "listen": ["0.0.0.0:8776"],
    "peers": {
      "type": "dynamic"
    },
    "connect": [],
    "externalAddresses": ["mon-serveur.example.com:8776"],
    "policy": "allow",
    "scope": "all"
  }
}

Détail des paramètres

Policies : track et block

Les policies contrôlent quels projets ton nœud accepte de répliquer :

# Suivre un projet spécifique (le répliquer sur ton nœud)
rad track rad:z2e7RaGkMUjH3dMhiKd5dm2E3pCXA

# Ne plus suivre un projet
rad untrack rad:z2e7RaGkMUjH3dMhiKd5dm2E3pCXA

Ouvrir le pare-feu

Pour que d'autres pairs puissent se connecter à ton nœud, le port 8776 (TCP) doit être accessible depuis l'extérieur.

Avec UFW (Ubuntu / Debian)

# Ouvrir le port 8776
sudo ufw allow 8776/tcp

# Vérifier les règles
sudo ufw status

Avec firewalld (Fedora / RHEL)

# Ouvrir le port 8776
sudo firewall-cmd --add-port=8776/tcp --permanent
sudo firewall-cmd --reload

# Vérifier
sudo firewall-cmd --list-ports

Avec iptables (avancé)

# Ouvrir le port 8776
sudo iptables -A INPUT -p tcp --dport 8776 -j ACCEPT

Démarrer et surveiller le nœud

Démarrer le nœud

# Démarrer le nœud Radicle
rad node start

# Le nœud démarre et se connecte au réseau
# Tu verras des messages de connexion aux pairs

Vérifier le statut

# État du nœud
rad node status

# Affiche :
# Node is running
# Listening on 0.0.0.0:8776
# Connected peers: 3
# Tracked repos: 5

Arrêter le nœud

# Arrêter proprement
rad node stop

Suivre des projets

Un seed node n'est utile que s'il réplique des projets. Voici comment gérer les projets suivis :

# Suivre un projet par son identifiant
rad track rad:z2e7RaGkMUjH3dMhiKd5dm2E3pCXA

# Lister les projets suivis / connus du noeud
rad inspect

# Arrêter de suivre un projet
rad untrack rad:z2e7RaGkMUjH3dMhiKd5dm2E3pCXA

Quand tu suis un projet, ton nœud :

1. Télécharge toutes les données du projet (code, patches, issues)
2. Se synchronise automatiquement quand des mises à jour arrivent
3. Sert ces données aux autres pairs qui les demandent

Monitoring et diagnostic

Les logs du nœud

# Voir les logs en temps réel
rad node logs

# Filtrer les logs par niveau
rad node logs --level info
rad node logs --level debug

Diagnostic courant

# Vérifier la connectivité
rad node status

# Voir les pairs connectés
rad node peers

# Tester la connexion à un pair spécifique
rad node connect <node-id>@<adresse>:8776

Problèmes fréquents

Service systemd - un seed persistant

Pour qu'un seed node tourne en permanence (même après un redémarrage du serveur), il faut le configurer comme un service systemd.

Créer le fichier de service

# Créer le fichier de service systemd
sudo nano /etc/systemd/system/radicle-node.service

Contenu du fichier :

[Unit]
Description=Radicle Node
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=radicle
ExecStart=/home/radicle/.radicle/bin/radicle-node
Restart=on-failure
RestartSec=5
Environment=RADICLE_HOME=/home/radicle/.radicle

[Install]
WantedBy=multi-user.target

Activer et démarrer le service

# Recharger la configuration systemd
sudo systemctl daemon-reload

# Activer le service au démarrage
sudo systemctl enable radicle-node

# Démarrer le service
sudo systemctl start radicle-node

# Vérifier le statut
sudo systemctl status radicle-node

Gérer le service

# Voir les logs du service
sudo journalctl -u radicle-node -f

# Redémarrer le service
sudo systemctl restart radicle-node

# Arrêter le service
sudo systemctl stop radicle-node

# Créer un utilisateur dédié
sudo useradd -m -s /bin/bash radicle

# Se connecter en tant que radicle pour initialiser
sudo -u radicle bash
curl -sSf https://radicle.xyz/install | sh
rad auth
exit

Exercice pratique - Lancer un nœud local

# Vérifie que rad est installé et que tu as une identité
rad --version
rad self

# Si tu n'as pas d'identité, crée-en une
rad auth

# Affiche ta configuration actuelle
rad config

# Note les paramètres : listen, policy, scope

# Lance le nœud
rad node start

# Vérifie qu'il tourne
rad node status

# Si tu as créé un projet dans la quête 21, note son RID
# Sinon, crée-en un rapidement :
mkdir test-seed && cd test-seed
git init -b main
echo "test" > fichier.txt
git add fichier.txt
git commit -m "test"
rad init

# Note le RID affiché

# Dans un autre terminal, suis ce projet
rad track rad:<le-rid-de-ton-projet>

# Observe ce que fait le nœud
rad node logs

# Tu devrais voir des messages de connexion et de réplication

# Arrête le nœud
rad node stop

# Vérifie qu'il est arrêté
rad node status

Récapitulatif des commandes