Documentation contributeur

Terminologie

Nouveau sur DoubleZero ? Consultez le Glossaire pour les définitions des termes clés comme DZD, DZX et CYOA.

Bienvenue dans la documentation contributeur de DoubleZero. Cette section couvre tout ce dont vous avez besoin pour devenir contributeur au réseau.

Intéressé pour devenir contributeur au réseau ?

Consultez la page Exigences et architecture pour comprendre le matériel, la bande passante et la connectivité nécessaires pour contribuer au réseau DoubleZero.

Checklist d'intégration

Utilisez cette checklist pour suivre votre progression. Tous les éléments doivent être complétés avant que votre contribution soit techniquement opérationnelle.

Phase 1 : Prérequis

CLI DoubleZero installée sur un serveur de gestion
Matériel acquis et conforme aux exigences
Espace rack et alimentation disponibles dans le centre de données (4U, 4KW recommandés)
DZD physiquement installé avec connectivité de gestion
Bloc IPv4 public alloué pour le protocole DZ (voir Règles des préfixes DZ)

Phase 2 : Configuration du compte

Paire de clés de service générée (doublezero keygen)
Paire de clés de publication de métriques générée
Clé de service soumise à la DZF pour autorisation
Compte contributeur créé onchain (vérifier avec doublezero contributor list)
Accès accordé au dépôt malbeclabs/contributors

Phase 3 : Provisionnement du dispositif

Configuration de base du dispositif appliquée (depuis le dépôt contributors)
Dispositif créé onchain (doublezero device create)
Interfaces du dispositif enregistrées
Interfaces loopback créées (Loopback255 vpnv4, Loopback256 ipv4)
Interfaces CYOA/DIA configurées (si dispositif edge/hybride)

Phase 4 : Établissement des liens et installation des agents

Liens WAN créés (le cas échéant)
Lien DZX créé (statut : requested)
Lien DZX accepté par le contributeur pair
Config Agent installé et en cours d'exécution
Config Agent recevant la configuration du contrôleur
Telemetry Agent installé et en cours d'exécution
Éditeur de métriques enregistré onchain
Soumissions de télémétrie visibles sur le registre

Phase 5 : Rodage des liens

Tous les liens drainés pour une période de rodage de 24 heures
metrics.doublezero.xyz affiche zéro perte et zéro erreur pendant 24h
Liens réactivés après un rodage propre

Phase 6 : Vérification et activation

doublezero device list affiche votre dispositif (avec max_users = 0)
doublezero link list affiche vos liens
Les logs du Config Agent montrent des récupérations de configuration réussies
Les logs du Telemetry Agent montrent des soumissions de métriques réussies
Coordonner avec DZ/Malbec Labs pour exécuter un test de connectivité (connexion, réception de routes, routage via DZ)
Après la réussite du test, définir max_users à 96 via doublezero device update

Obtenir de l'aide

Dans le cadre de l'intégration, la DZF vous ajoutera aux canaux Slack contributeurs :

Canal	Objectif
#dz-contributor-announcements	Communications officielles de la DZF et de Malbec Labs — mises à jour CLI/agents, changements majeurs, annonces de sécurité. Surveillez les mises à jour critiques ; posez vos questions dans les fils de discussion.
#dz-contributor-incidents	Événements non planifiés ayant un impact sur le service. Les incidents sont publiés automatiquement via l'API/formulaire web avec la sévérité et les dispositifs/liens affectés. Discussion et résolution de problèmes dans les fils.
#dz-contributor-maintenance	Activités de maintenance planifiées (mises à niveau, réparations). Programmées via l'API/formulaire web avec les heures de début/fin prévues. Discussion dans les fils.
#dz-contributor-ops	Discussion ouverte pour tous les contributeurs — questions opérationnelles, aide CLI, partage de runbooks et playbooks.

Vous recevrez également un canal privé DZ/Malbec Labs pour un support direct pour votre organisation.

Règles des préfixes DZ

Critique : Utilisation du pool de préfixes DZ

Le pool de préfixes DZ que vous fournissez est géré par le protocole DoubleZero pour l'allocation d'adresses IP.

Comment les préfixes DZ sont utilisés :

Première IP : Réservée pour votre dispositif (assignée à l'interface Loopback100)
IPs restantes : Allouées à des types d'utilisateurs spécifiques se connectant à votre DZD :
- Utilisateurs IBRLWithAllocatedIP
- Utilisateurs EdgeFiltering
- Éditeurs multicast
Utilisateurs IBRL : Ne consomment PAS de ce pool (ils utilisent leur propre IP publique)

Vous NE POUVEZ PAS utiliser ces adresses pour :

Votre propre équipement réseau
Les liens point à point sur les interfaces DIA
Les interfaces de gestion
Toute infrastructure en dehors du protocole DZ

Exigences :

Doivent être des adresses IPv4 routables publiquement (publiques)
Les plages d'IP privées (10.x, 172.16-31.x, 192.168.x) sont rejetées par le contrat intelligent
Taille minimale : /29 (8 adresses), les préfixes plus grands sont préférés (ex. /28, /27)
Le bloc entier doit être disponible — ne pré-allouez aucune adresse

Si vous avez besoin d'adresses pour votre propre équipement (IPs d'interface DIA, gestion, etc.), utilisez un pool d'adresses séparé.

Référence rapide : Termes clés

Nouveau sur DoubleZero ? Voici les termes essentiels (voir le Glossaire complet) :

Terme	Définition
DZD	DoubleZero Device - votre commutateur Arista physique exécutant les agents DZ
DZX	DoubleZero Exchange - point d'interconnexion métropolitain où les contributeurs s'appairent
CYOA	Choose Your Own Adventure - méthode de connectivité utilisateur (GREOverDIA, GREOverFabric, etc.)
DIA	Direct Internet Access - connectivité Internet requise par tous les DZDs pour le contrôleur et la télémétrie, couramment utilisée comme type CYOA pour la connectivité utilisateur sur les dispositifs edge/hybrides
WAN Link	Lien entre vos propres DZDs (même contributeur)
DZX Link	Lien vers le DZD d'un autre contributeur (nécessite une acceptation mutuelle)
Config Agent	Interroge le contrôleur, applique la configuration à votre DZD
Telemetry Agent	Collecte les métriques de latence/perte TWAMP, les soumet au registre onchain
Service Key	Votre clé d'identité contributeur pour les opérations CLI
Metrics Publisher Key	Clé pour signer les soumissions de télémétrie onchain

Structure de la documentation

Guide	Description
Exigences et architecture	Spécifications matérielles, architecture réseau, options de bande passante
Provisionnement du dispositif	Étape par étape : clés → accès au dépôt → dispositif → liens → agents
Opérations	Mises à jour des agents, gestion des liens, surveillance
Déploiement de Geoprobe	Déploiement et configuration des agents geoProbe pour la géolocalisation
Glossaire	Toute la terminologie DoubleZero définie

Notions de base réseau pour les non-ingénieurs réseau

Si vous ne venez pas d'un environnement d'ingénierie réseau, voici une introduction aux concepts utilisés dans cette documentation :

Adressage IP

Adresse IPv4 : Un identifiant unique pour un dispositif sur un réseau (ex. 192.168.1.1)
Notation CIDR (/29, /24) : Indique la taille du sous-réseau. /29 = 8 adresses, /24 = 256 adresses
IP publique : Routable sur Internet ; IP privée : Réseaux internes uniquement (10.x, 172.16-31.x, 192.168.x)

Couches réseau

Couche 1 (Physique) : Câbles, optiques, longueurs d'onde
Couche 2 (Liaison de données) : Commutateurs, VLANs, adresses MAC
Couche 3 (Réseau) : Routeurs, adresses IP, protocoles de routage

Termes courants

MTU : Maximum Transmission Unit - taille maximale de paquet (typiquement 9000 octets pour les liens WAN)
VLAN : Virtual LAN - sépare logiquement le trafic sur une infrastructure partagée
VRF : Virtual Routing and Forwarding - isole les tables de routage sur un même dispositif
BGP : Border Gateway Protocol - échange de routes inter-réseaux
GRE : Generic Routing Encapsulation - protocole de tunnelisation pour les réseaux overlay
TWAMP : Two-Way Active Measurement Protocol - mesure la latence/perte entre les dispositifs

Spécifique à DoubleZero

Onchain : Dans DoubleZero, les enregistrements de dispositifs, les configurations de liens et la télémétrie sont enregistrés sur le registre DoubleZero — rendant l'état du réseau transparent et vérifiable par tous les participants
Contrôleur : Service qui dérive la configuration du DZD à partir de l'état onchain sur le registre DoubleZero

Prêt à commencer ? Démarrez avec Exigences et architecture.