기여자 문서
DoubleZero 기여자 문서에 오신 것을 환영합니다. 이 섹션에서는 네트워크 기여자가 되기 위해 필요한 모든 내용을 다룹니다.
네트워크 기여자에 관심이 있으신가요?
요구사항 및 아키텍처 페이지를 검토하여 DoubleZero 네트워크에 기여하는 데 필요한 하드웨어, 대역폭 및 연결 요건을 파악하세요.
온보딩 체크리스트
이 체크리스트를 사용하여 진행 상황을 추적하세요. 기여가 기술적으로 운영 가능하려면 모든 항목을 완료해야 합니다.
1단계: 사전 준비
- 관리 서버에 DoubleZero CLI 설치 완료
- 하드웨어 조달 및 요구사항 충족 확인
- 데이터센터 랙 공간 및 전력 확보 (4U, 4KW 권장)
- DZD 물리적 설치 및 관리 연결 완료
- DZ 프로토콜용 공인 IPv4 블록 할당 (DZ 프리픽스 규칙 참조)
2단계: 계정 설정
- 서비스 키 쌍 생성 (
doublezero keygen) - 메트릭 퍼블리셔 키 쌍 생성
- DZF에 서비스 키 제출하여 인가 완료
- 온체인 기여자 계정 생성 (
doublezero contributor list로 확인) - malbeclabs/contributors 리포지토리 접근 권한 부여
3단계: 디바이스 프로비저닝
- 기본 디바이스 구성 적용 (contributors 리포지토리 참조)
- 온체인 디바이스 생성 (
doublezero device create) - 디바이스 인터페이스 등록
- 루프백 인터페이스 생성 (Loopback255 vpnv4, Loopback256 ipv4)
- CYOA/DIA 인터페이스 구성 (엣지/하이브리드 디바이스의 경우)
4단계: 링크 구축 및 에이전트 설치
- WAN 링크 생성 (해당되는 경우)
- DZX 링크 생성 (상태:
requested) - 피어 기여자의 DZX 링크 수락
- Config Agent 설치 및 실행
- Config Agent가 컨트롤러로부터 구성을 수신 중
- Telemetry Agent 설치 및 실행
- 메트릭 퍼블리셔 온체인 등록
- 원장에서 텔레메트리 제출 확인 가능
5단계: 링크 번인(Burn-in)
- 24시간 번인 기간 동안 모든 링크 드레인(drain) 처리
- metrics.doublezero.xyz에서 24시간 동안 무손실 및 무오류 확인
- 정상 번인 완료 후 링크 드레인 해제
6단계: 검증 및 활성화
-
doublezero device list에서 디바이스 확인 (max_users = 0상태) -
doublezero link list에서 링크 확인 - Config Agent 로그에서 구성 풀(pull) 성공 확인
- Telemetry Agent 로그에서 메트릭 제출 성공 확인
- DZ/Malbec Labs와 협의하여 연결 테스트 수행 (연결, 라우트 수신, DZ를 통한 라우팅)
- 테스트 통과 후
doublezero device update를 통해max_users를 96으로 설정
도움 받기
온보딩 과정에서 DZF가 기여자 Slack 채널에 초대합니다:
| 채널 | 용도 |
|---|---|
| #dz-contributor-announcements | DZF 및 Malbec Labs의 공식 커뮤니케이션 — CLI/에이전트 업그레이드, 호환성 변경 사항, 보안 공지. 중요 업데이트를 모니터링하고 스레드에서 질문하세요. |
| #dz-contributor-incidents | 계획되지 않은 서비스 영향 이벤트. 인시던트는 API/웹 양식을 통해 심각도 및 영향받는 디바이스/링크 정보와 함께 자동으로 게시됩니다. 토론 및 문제 해결은 스레드에서 진행됩니다. |
| #dz-contributor-maintenance | 계획된 유지보수 활동 (업그레이드, 수리). API/웹 양식을 통해 계획된 시작/종료 시간과 함께 예약됩니다. 토론은 스레드에서 진행됩니다. |
| #dz-contributor-ops | 모든 기여자를 위한 자유 토론 — 운영 관련 질문, CLI 도움, 런북 및 플레이북 공유. |
또한 조직의 직접 지원을 위한 비공개 DZ/Malbec Labs 채널이 제공됩니다.
DZ 프리픽스 규칙
중요: DZ 프리픽스 풀 사용
제공하시는 DZ 프리픽스 풀은 DoubleZero 프로토콜이 IP 할당을 위해 관리합니다.
DZ 프리픽스 사용 방식:
- 첫 번째 IP: 디바이스용으로 예약됨 (Loopback100 인터페이스에 할당)
- 나머지 IP: DZD에 연결하는 특정 사용자 유형에 할당:
IBRLWithAllocatedIP사용자EdgeFiltering사용자- 멀티캐스트 퍼블리셔
- IBRL 사용자: 이 풀에서 소비하지 않음 (자체 공인 IP 사용)
다음 용도로 이 주소를 사용할 수 없습니다:
- 자체 네트워크 장비
- DIA 인터페이스의 포인트 투 포인트 링크
- 관리 인터페이스
- DZ 프로토콜 외부의 모든 인프라
요구사항:
- 글로벌 라우팅 가능한 (공인) IPv4 주소여야 함
- 사설 IP 범위 (10.x, 172.16-31.x, 192.168.x)는 스마트 컨트랙트에서 거부됨
- 최소 크기: /29 (8개 주소), 더 큰 프리픽스 선호 (예: /28, /27)
- 전체 블록이 사용 가능해야 함 - 주소를 사전 할당하지 마세요
자체 장비용 주소가 필요한 경우 (DIA 인터페이스 IP, 관리 등) 별도의 주소 풀을 사용하세요.
빠른 참조: 주요 용어
DoubleZero가 처음이신가요? 필수 용어를 확인하세요 (전체 용어집 참조):
| 용어 | 정의 |
|---|---|
| DZD | DoubleZero Device - DZ 에이전트가 실행되는 물리적 Arista 스위치 |
| DZX | DoubleZero Exchange - 기여자들이 피어링하는 메트로 상호접속 포인트 |
| CYOA | Choose Your Own Adventure - 사용자 연결 방식 (GREOverDIA, GREOverFabric 등) |
| DIA | Direct Internet Access - 컨트롤러 및 텔레메트리를 위해 모든 DZD에 필요한 인터넷 연결, 엣지/하이브리드 디바이스에서 사용자 연결을 위한 CYOA 유형으로 일반적으로 사용됨 |
| WAN Link | 자체 DZD 간 링크 (동일 기여자) |
| DZX Link | 다른 기여자의 DZD로의 링크 (상호 수락 필요) |
| Config Agent | 컨트롤러를 폴링하고 DZD에 구성을 적용 |
| Telemetry Agent | TWAMP 지연/손실 메트릭을 수집하여 온체인 원장에 제출 |
| Service Key | CLI 작업을 위한 기여자 식별 키 |
| Metrics Publisher Key | 온체인 텔레메트리 제출 서명용 키 |
문서 구조
| 가이드 | 설명 |
|---|---|
| 요구사항 및 아키텍처 | 하드웨어 사양, 네트워크 아키텍처, 대역폭 옵션 |
| 디바이스 프로비저닝 | 단계별 안내: 키 → 리포지토리 접근 → 디바이스 → 링크 → 에이전트 |
| 운영 | 에이전트 업그레이드, 링크 관리, 모니터링 |
| Geoprobe 배포 | 지리적 위치 확인을 위한 geoProbe 에이전트 배포 및 구성 |
| 용어집 | 모든 DoubleZero 용어 정의 |
비네트워크 엔지니어를 위한 네트워크 기초
네트워크 엔지니어링 배경이 아닌 경우, 이 문서에서 사용되는 개념에 대한 입문 내용을 참고하세요:
IP 주소 지정
- IPv4 주소: 네트워크에서 디바이스의 고유 식별자 (예:
192.168.1.1) - CIDR 표기법 (
/29,/24): 서브넷 크기를 나타냄./29= 8개 주소,/24= 256개 주소 - 공인 IP: 인터넷에서 라우팅 가능; 사설 IP: 내부 네트워크 전용 (10.x, 172.16-31.x, 192.168.x)
네트워크 계층
- 레이어 1 (물리 계층): 케이블, 광 모듈, 파장
- 레이어 2 (데이터 링크 계층): 스위치, VLAN, MAC 주소
- 레이어 3 (네트워크 계층): 라우터, IP 주소, 라우팅 프로토콜
일반 용어
- MTU: Maximum Transmission Unit - 최대 패킷 크기 (WAN 링크의 경우 일반적으로 9000바이트)
- VLAN: Virtual LAN - 공유 인프라에서 트래픽을 논리적으로 분리
- VRF: Virtual Routing and Forwarding - 동일 디바이스에서 라우팅 테이블을 격리
- BGP: Border Gateway Protocol - 네트워크 간 라우트 교환
- GRE: Generic Routing Encapsulation - 오버레이 네트워크를 위한 터널링 프로토콜
- TWAMP: Two-Way Active Measurement Protocol - 디바이스 간 지연/손실 측정
DoubleZero 전용 용어
- 온체인: DoubleZero에서 디바이스 등록, 링크 구성 및 텔레메트리는 DoubleZero 원장에 기록되어 — 모든 참여자가 네트워크 상태를 투명하게 확인하고 검증할 수 있습니다
- 컨트롤러: DoubleZero 원장의 온체인 상태로부터 DZD 구성을 도출하는 서비스
시작할 준비가 되셨나요? 요구사항 및 아키텍처부터 시작하세요.