Ir para o conteúdo

Guia de Provisionamento de Dispositivos

This translation was generated using artificial intelligence and has not been reviewed by a human translator. It may contain inaccuracies or errors and should not be relied upon.

Este guia orienta você no provisionamento de um Dispositivo DoubleZero (DZD) do início ao fim. Cada fase corresponde à Lista de Verificação de Integração.

Como Tudo Se Encaixa

Antes de mergulhar nas etapas, aqui está a visão geral do que você está construindo:

flowchart TB
    subgraph Onchain
        SC[Ledger DoubleZero]
    end

    subgraph Sua Infraestrutura
        MGMT[Servidor de Gerenciamento<br/>CLI DoubleZero]
        DZD[Seu DZD<br/>Switch Arista]
        DZD ---|Link WAN| DZD2[Seu outro DZD]
    end

    subgraph Outro Contribuidor
        OtherDZD[DZD deles]
    end

    subgraph Usuários
        VAL[Validadores]
        RPC[Nós RPC]
    end

    MGMT -.->|Registra dispositivos,<br/>links, interfaces| SC
    DZD ---|Link DZX| OtherDZD
    VAL ---|Conecta via Internet| DZD
    RPC ---|Conecta via Internet| DZD

Fase 1: Pré-requisitos

Antes de poder provisionar um dispositivo, você precisa do hardware físico configurado e alguns endereços IP alocados.

O Que Você Precisa

Requisito Por Que É Necessário
Hardware DZD Switch Arista 7280CR3A (consulte especificações de hardware)
Espaço em Rack 4U com fluxo de ar adequado
Energia Alimentações redundantes, ~4KW recomendado
Acesso de Gerenciamento Acesso SSH/console para configurar o switch
Conectividade à Internet Para publicação de métricas e busca de configuração do controlador
Bloco IPv4 Público Mínimo /29 para o pool de prefixos DZ (veja abaixo)

Instalar o CLI do DoubleZero

O CLI do DoubleZero (doublezero) é usado ao longo do provisionamento para registrar dispositivos, criar links e gerenciar sua contribuição. Deve ser instalado em um servidor ou VM de gerenciamento — não no próprio switch DZD. O switch executa apenas o Config Agent e o Telemetry Agent (instalados na Fase 4).

Ubuntu / Debian: 

curl -1sLf https://dl.cloudsmith.io/public/malbeclabs/doublezero/setup.deb.sh | sudo -E bash
sudo apt-get install doublezero

Rocky Linux / RHEL: 

curl -1sLf https://dl.cloudsmith.io/public/malbeclabs/doublezero/setup.rpm.sh | sudo -E bash
sudo yum install doublezero

Verificar se o daemon está em execução: 

sudo systemctl status doublezerod

Entendendo seu Prefixo DZ

Seu prefixo DZ é um bloco de endereços IP públicos que o protocolo DoubleZero gerencia para alocação de IP.

flowchart LR
    subgraph "Seu Bloco /29 (8 IPs)"
        IP1["Primeiro IP<br/>Reservado para<br/>seu dispositivo"]
        IP2["IP 2"]
        IP3["IP 3"]
        IP4["..."]
        IP8["IP 8"]
    end

    IP1 -->|Atribuído a| LO[Loopback100<br/>no seu DZD]
    IP2 -->|Alocado para| U1[Usuário 1]
    IP3 -->|Alocado para| U2[Usuário 2]

Como os prefixos DZ são usados:

  • Primeiro IP: Reservado para seu dispositivo (atribuído à interface Loopback100)
  • IPs restantes: Alocados para tipos específicos de usuários que se conectam ao seu DZD:
    • Usuários IBRLWithAllocatedIP
    • Usuários EdgeFiltering
    • Publicadores multicast
  • Usuários IBRL: NÃO consomem deste pool (usam seu próprio IP público)

Regras de Prefixo DZ

Você NÃO PODE usar esses endereços para:

  • Seu próprio equipamento de rede
  • Links ponto a ponto em interfaces DIA
  • Interfaces de gerenciamento
  • Qualquer infraestrutura fora do protocolo DZ

Requisitos:

  • Devem ser endereços IPv4 globalmente roteáveis (públicos)
  • Intervalos de IP privados (10.x, 172.16-31.x, 192.168.x) são rejeitados pelo contrato inteligente
  • Tamanho mínimo: /29 (8 endereços), prefixos maiores são preferidos (por exemplo, /28, /27)
  • Todo o bloco deve estar disponível — não pré-aloque nenhum endereço

Se você precisar de endereços para seu próprio equipamento (IPs de interface DIA, gerenciamento, etc.), use um pool de endereços separado.

Fase 2: Configuração de Conta

Nesta fase, você cria as chaves criptográficas que identificam você e seus dispositivos na rede.

Onde Executar o CLI

NÃO instale o CLI no seu switch

O CLI do DoubleZero (doublezero) deve ser instalado em um servidor ou VM de gerenciamento, não no seu switch Arista.

flowchart LR
    subgraph "Servidor/VM de Gerenciamento"
        CLI[CLI DoubleZero]
        KEYS[Seus Keypairs]
    end

    subgraph "Seu Switch DZD"
        CA[Config Agent]
        TA[Telemetry Agent]
    end

    CLI -->|Cria dispositivos, links| BC[Blockchain]
    CA -->|Busca config| CTRL[Controlador]
    TA -->|Envia métricas| BC
Instalar no Servidor de Gerenciamento Instalar no Switch
CLI doublezero Config Agent
Seu keypair de serviço Telemetry Agent
Seu keypair do editor de métricas Keypair do editor de métricas (cópia)

O Que São Chaves?

Pense nas chaves como credenciais de login seguras:

  • Chave de Serviço: Sua identidade de contribuidor — usada para executar comandos CLI
  • Chave do Editor de Métricas: A identidade do seu dispositivo para enviar dados de telemetria

Ambas são keypairs criptográficos (uma chave pública que você compartilha, uma chave privada que você mantém em segredo).

flowchart LR
    subgraph "Suas Chaves"
        SK[Chave de Serviço<br/>~/.config/solana/id.json]
        MK[Chave do Editor de Métricas<br/>~/.config/doublezero/metrics-publisher.json]
    end

    SK -->|Usada para| CLI[Comandos CLI<br/>doublezero device create<br/>doublezero link create]
    MK -->|Usada para| TEL[Telemetry Agent<br/>Envia métricas onchain]

Passo 2.1: Gerar Sua Chave de Serviço

Esta é sua identidade principal para interagir com o DoubleZero.

doublezero keygen

Isso cria um keypair no local padrão. A saída mostra sua chave pública — isso é o que você compartilhará com a DZF.

Passo 2.2: Gerar Sua Chave do Editor de Métricas

Esta chave é usada pelo Telemetry Agent para assinar envios de métricas.

doublezero keygen -o ~/.config/doublezero/metrics-publisher.json

Passo 2.3: Enviar Chaves para a DZF

Entre em contato com a DoubleZero Foundation ou Malbec Labs e forneça:

  1. Sua chave pública de serviço
  2. Seu nome de usuário GitHub (para acesso ao repositório)

Eles irão:

  • Criar sua conta de contribuidor onchain
  • Conceder acesso ao repositório de contribuidores privado

Passo 2.4: Verificar Sua Conta

Uma vez confirmado, verifique se sua conta de contribuidor existe:

doublezero contributor list

Você deve ver seu código de contribuidor na lista.

Passo 2.5: Acessar o Repositório de Contribuidores

O repositório malbeclabs/contributors contém:

  • Configurações base do dispositivo
  • Perfis TCAM
  • Configurações ACL
  • Instruções de configuração adicionais

Siga as instruções lá para configuração específica do dispositivo.

Fase 3: Provisionamento de Dispositivos

Agora você registrará seu dispositivo físico no blockchain e configurará suas interfaces.

Entendendo os Tipos de Dispositivos

flowchart TB
    subgraph "Dispositivo Edge"
        E[DZD Edge]
        EU[Usuários se conectam aqui]
        EU --> E
        E <-->|Link DZX| ED[Outro DZD]
    end

    subgraph "Dispositivo Transit"
        T[DZD Transit]
        T <-->|Link WAN| T2[Outro DZD]
        T <-->|Link DZX| TD[Outro DZD]
    end

    subgraph "Dispositivo Hybrid"
        H[DZD Hybrid]
        HU[Usuários se conectam aqui]
        HU --> H
        H <-->|Link WAN| H2[Outro DZD]
        H <-->|Link DZX| HD[Outro DZD]
    end
Tipo O Que Faz Quando Usar
Edge Aceita conexões de usuários apenas Localização única, voltado apenas para usuários
Transit Move tráfego entre dispositivos Conectividade de backbone, sem usuários
Hybrid Conexões de usuários E backbone Mais comum — faz tudo

Passo 3.1: Encontrar Sua Localização e Exchange

Antes de criar seu dispositivo, consulte os códigos para sua localização de data center e exchange mais próxima:

# Listar localizações disponíveis (data centers)
doublezero location list

# Listar exchanges disponíveis (pontos de interconexão)
doublezero exchange list

Passo 3.2: Criar Seu Dispositivo Onchain

Registrar seu dispositivo no blockchain:

doublezero device create \
  --code <SEU_CODIGO_DE_DISPOSITIVO> \
  --contributor <SEU_CODIGO_DE_CONTRIBUIDOR> \
  --device-type hybrid \
  --location <CODIGO_DE_LOCALIZACAO> \
  --exchange <CODIGO_DE_EXCHANGE> \
  --public-ip <IP_PUBLICO_DO_DISPOSITIVO> \
  --dz-prefixes <SEU_PREFIXO_DZ>

Exemplo:

doublezero device create \
  --code nyc-dz001 \
  --contributor acme \
  --device-type hybrid \
  --location EQX-NY5 \
  --exchange nyc \
  --public-ip "203.0.113.10" \
  --dz-prefixes "198.51.100.0/28"

Saída esperada:

Signature: 4vKz8H...truncated...7xPq2

Verificar se seu dispositivo foi criado:

doublezero device list | grep nyc-dz001

Parâmetros explicados:

Parâmetro O Que Significa
--code Um nome único para seu dispositivo (por exemplo, nyc-dz001)
--contributor Seu código de contribuidor (fornecido pela DZF)
--device-type hybrid, transit ou edge
--location Código do data center em location list
--exchange Código da exchange mais próxima em exchange list
--public-ip O IP público onde os usuários se conectam ao seu dispositivo via internet
--dz-prefixes Seu bloco de IP alocado para usuários

Passo 3.3: Criar Interfaces Loopback Necessárias

Todo dispositivo precisa de duas interfaces loopback para roteamento interno:

# Loopback VPNv4
doublezero device interface create <CODIGO_DO_DISPOSITIVO> Loopback255 --loopback-type vpnv4

# Loopback IPv4
doublezero device interface create <CODIGO_DO_DISPOSITIVO> Loopback256 --loopback-type ipv4

Saída esperada (para cada comando):

Signature: 3mNx9K...truncated...8wRt5

Passo 3.4: Criar Interfaces Físicas

Registrar as portas físicas que você usará:

# Interface básica
doublezero device interface create <CODIGO_DO_DISPOSITIVO> Ethernet1/1

Saída esperada:

Signature: 7pQw2R...truncated...4xKm9

Passo 3.5: Criar Interface CYOA (para dispositivos Edge/Hybrid)

DZDs híbridos e edge precisam de dois endereços IP públicos nos quais os usuários terminam seus túneis GRE. Os usuários podem se conectar via unicast, multicast, ou ambos, e qual IP serve qual propósito é rotacionado por usuário.

Ambos os IPs devem ser registrados com --user-tunnel-endpoint true, em uma interface física ou em um loopback. Isso inclui o IP fornecido no momento da criação do dispositivo; esse IP ainda precisa ser registrado explicitamente aqui.

Se você estiver com restrição de IP, pode usar o primeiro /32 do seu prefixo DZ como um dos dois IPs.

CYOA e DIA

Tipo Flag Propósito
DIA --interface-dia dia Marca a porta como acesso direto à internet
CYOA --interface-cyoa <subtipo> Declara como os usuários conectam túneis GRE ao seu dispositivo

O flag CYOA é sempre definido em uma interface física (porta Ethernet ou port channel). Nunca em um loopback.

Subtipo CYOA Quando usar
gre-over-dia Usuários se conectam pela internet pública. O mais comum.
gre-over-private-peering Usuários se conectam via cross-connect direto ou circuito privado
gre-over-public-peering Usuários fazem peering com você em um Internet Exchange (IX)
gre-over-fabric Usuários são co-localizados e se conectam por um fabric local
gre-over-cable Conexão de cabo direto a um único usuário dedicado

Cenário A: Interface física única

Um uplink físico para o ISP. Ethernet1/1 é a interface CYOA e DIA e carrega um dos dois IPs públicos. Loopback100 carrega o segundo IP público.

flowchart LR
    USERS(["Usuários Finais"])

    subgraph DZD["DZD"]
        E1["Eth1/1
        203.0.113.1/30
        CYOA · DIA · user tunnel endpoint"]
        LO["Loopback100
        198.51.100.1/32\n        user tunnel endpoint"]
        E1 --- LO
    end

    ISP["Roteador ISP
    203.0.113.2/30"]

    ISP -- "10GbE" --- E1
    USERS -. "Túneis GRE" .-> E1
    USERS -. "Túneis GRE" .-> LO
Interface --interface-cyoa --interface-dia --ip-net --bandwidth --cir --routing-mode --user-tunnel-endpoint
Ethernet1/1 gre-over-dia dia IP/sub-rede atribuída pelo contribuidor velocidade da porta taxa comprometida bgp ou static true
Loopback100 — — seu /32 público 0bps — — true

Exemplo de comandos para o Cenário A: 

doublezero device interface create mydzd-nyc01 Ethernet1/1 \
  --interface-cyoa gre-over-dia \
  --interface-dia dia \
  --ip-net 203.0.113.1/30 \
  --bandwidth 10Gbps \
  --cir 1Gbps \
  --routing-mode bgp \
  --user-tunnel-endpoint true

doublezero device interface create mydzd-nyc01 Loopback100 \
  --ip-net 198.51.100.1/32 \
  --bandwidth 0bps \
  --user-tunnel-endpoint true

Cenário B: Port channel (LAG)

O DZD se conecta ao dispositivo upstream via port channel com um IP. O port channel carrega um IP público e é o endpoint CYOA. Loopback100 carrega o segundo IP público.

flowchart LR
    USERS(["Usuários Finais"])

    subgraph SW["Roteador/Switch Upstream"]
        SWPC(["bond0
        203.0.113.2/30"])
    end

    subgraph DZD["DZD"]
        subgraph PC["Port-Channel1 · 203.0.113.1/30 · CYOA · DIA · user tunnel endpoint"]
            E1["Eth1/1"]
            E2["Eth2/1"]
        end
        LO["Loopback100
        198.51.100.1/32\n        user tunnel endpoint"]
        PC --- LO
    end

    SWPC -- "2x 10GbE" --- PC
    USERS -. "Túneis GRE" .-> PC
    USERS -. "Túneis GRE" .-> LO
Interface --interface-cyoa --interface-dia --ip-net --bandwidth --cir --routing-mode --user-tunnel-endpoint
Port-Channel1 gre-over-dia dia IP/sub-rede atribuída pelo contribuidor velocidade LAG combinada taxa comprometida bgp ou static true
Loopback100 — — seu /32 público 0bps — — true

Exemplo de comandos para o Cenário B: 

doublezero device interface create mydzd-fra01 Port-Channel1 \
  --interface-cyoa gre-over-dia \
  --interface-dia dia \
  --ip-net 203.0.113.1/30 \
  --bandwidth 20Gbps \
  --cir 2Gbps \
  --routing-mode bgp \
  --user-tunnel-endpoint true

doublezero device interface create mydzd-fra01 Loopback100 \
  --ip-net 198.51.100.1/32 \
  --bandwidth 0bps \
  --user-tunnel-endpoint true

Cada interface física se conecta a um roteador upstream diferente. Os dois IPs públicos ficam em Loopback100 e Loopback101, ambos registrados como endpoints de túnel de usuário.

flowchart LR
    USERS(["Usuários Finais"])

    RA["Roteador A
    203.0.113.2/30"]
    RB["Roteador B
    203.0.113.6/30"]

    subgraph DZD["DZD"]
        E1["Eth1/1
        203.0.113.1/30
        CYOA · DIA"]
        E2["Eth2/1
        203.0.113.5/30
        CYOA · DIA"]
        LO0["Loopback100
        198.51.100.1/32\n        user tunnel endpoint"]
        LO1["Loopback101
        198.51.100.2/32\n        user tunnel endpoint"]
        E1 --> LO0
        E2 --> LO1
    end

    RA -- "10GbE" --- E1
    RB -- "10GbE" --- E2
    USERS -. "Túneis GRE" .-> LO0
    USERS -. "Túneis GRE" .-> LO1
Interface --interface-cyoa --interface-dia --ip-net --bandwidth --cir --routing-mode --user-tunnel-endpoint
Ethernet1/1 gre-over-dia dia IP/sub-rede atribuída pelo contribuidor velocidade da porta taxa comprometida bgp ou static —
Ethernet2/1 gre-over-dia dia IP/sub-rede atribuída pelo contribuidor velocidade da porta taxa comprometida bgp ou static —
Loopback100 — — seu /32 público 0bps — — true
Loopback101 — — seu /32 público 0bps — — true

Exemplo de comandos para o Cenário C: 

doublezero device interface create mydzd-ams01 Ethernet1/1 \
  --interface-cyoa gre-over-dia \
  --interface-dia dia \
  --ip-net 203.0.113.1/30 \
  --bandwidth 10Gbps \
  --cir 1Gbps \
  --routing-mode bgp

doublezero device interface create mydzd-ams01 Ethernet2/1 \
  --interface-cyoa gre-over-dia \
  --interface-dia dia \
  --ip-net 203.0.113.5/30 \
  --bandwidth 10Gbps \
  --cir 1Gbps \
  --routing-mode bgp

doublezero device interface create mydzd-ams01 Loopback100 \
  --ip-net 198.51.100.1/32 \
  --bandwidth 0bps \
  --user-tunnel-endpoint true

doublezero device interface create mydzd-ams01 Loopback101 \
  --ip-net 198.51.100.2/32 \
  --bandwidth 0bps \
  --user-tunnel-endpoint true

Passo 3.6: Verificar Seu Dispositivo

doublezero device list

Exemplo de saída:

 account                                      | code      | contributor | location | exchange | device_type | public_ip    | dz_prefixes     | users | max_users | status    | health  | mgmt_vrf | owner
 7xKm9pQw2R4vHt3...                          | nyc-dz001 | acme        | EQX-NY5  | nyc      | hybrid      | 203.0.113.10 | 198.51.100.0/28 | 0     | 14        | activated | pending |          | 5FMtd5Woq5XAAg54...

Seu dispositivo deve aparecer com status activated.

Os links conectam seu dispositivo ao restante da rede DoubleZero.

flowchart LR
    subgraph "Sua Rede"
        D1[Seu DZD 1<br/>NYC]
        D2[Seu DZD 2<br/>LAX]
    end

    subgraph "Outro Contribuidor"
        O1[DZD deles<br/>NYC]
    end

    D1 ---|Link WAN<br/>Mesmo contribuidor| D2
    D1 ---|Link DZX<br/>Contribuidores diferentes| O1
Tipo de Link Conecta Aceitação
Link WAN Dois dos SEUS dispositivos Automática (você é dono de ambos)
Link DZX Seu dispositivo com OUTRO contribuidor Requer aceitação deles

Links WAN conectam seus próprios dispositivos:

doublezero link create wan \
  --code <CODIGO_DO_LINK> \
  --contributor <SEU_CONTRIBUIDOR> \
  --side-a <CODIGO_DISPOSITIVO_1> \
  --side-a-interface <INTERFACE_NO_DISPOSITIVO_1> \
  --side-z <CODIGO_DISPOSITIVO_2> \
  --side-z-interface <INTERFACE_NO_DISPOSITIVO_2> \
  --bandwidth 10000 \
  --mtu 9000 \
  --delay-ms 20 \
  --jitter-ms 1

Exemplo:

doublezero link create wan \
  --code nyc-lax-wan01 \
  --contributor acme \
  --side-a nyc-dz001 \
  --side-a-interface Ethernet3/1 \
  --side-z lax-dz001 \
  --side-z-interface Ethernet3/1 \
  --bandwidth 10000 \
  --mtu 9000 \
  --delay-ms 65 \
  --jitter-ms 1

Saída esperada:

Signature: 5tNm7K...truncated...9pRw2

Os links DZX conectam seu dispositivo diretamente ao DZD de outro contribuidor:

doublezero link create dzx \
  --code <CODIGO_DISPOSITIVO_A:CODIGO_DISPOSITIVO_Z> \
  --contributor <SEU_CONTRIBUIDOR> \
  --side-a <SEU_CODIGO_DE_DISPOSITIVO> \
  --side-a-interface <SUA_INTERFACE> \
  --side-z <CODIGO_DISPOSITIVO_OUTRO> \
  --bandwidth <LARGURA_DE_BANDA em Kbps, Mbps ou Gbps> \
  --mtu <MTU> \
  --delay-ms <ATRASO> \
  --jitter-ms <JITTER>

Saída esperada:

Signature: 8mKp3W...truncated...2nRx7

Após criar um link DZX, o outro contribuidor deve aceitá-lo:

# O OUTRO contribuidor executa isso
doublezero link accept \
  --code <CODIGO_DO_LINK> \
  --side-z-interface <INTERFACE_DELES>

Saída esperada (para o contribuidor que aceita):

Signature: 6vQt9L...truncated...3wPm4

doublezero link list

Exemplo de saída:

 account                                      | code          | contributor | side_a_name | side_a_iface_name | side_z_name | side_z_iface_name | link_type | bandwidth | mtu  | delay_ms | jitter_ms | delay_override_ms | tunnel_id | tunnel_net      | status    | health  | owner
 8vkYpXaBW8RuknJq...                         | nyc-dz001:lax-dz001 | acme        | nyc-dz001   | Ethernet3/1       | lax-dz001   | Ethernet3/1       | WAN       | 10Gbps    | 9000 | 65.00ms  | 1.00ms    | 0.00ms            | 42        | 172.16.0.84/31  | activated | pending | 5FMtd5Woq5XAAg54...

Os links devem mostrar status activated uma vez que ambos os lados estejam configurados.

Instalação de Agentes

Dois agentes de software são executados no seu DZD:

flowchart TB
    subgraph "Seu DZD"
        CA[Config Agent]
        TA[Telemetry Agent]
        HW[Hardware/Software do Switch]
    end

    CA -->|Busca config| CTRL[Serviço Controlador]
    CA -->|Aplica config| HW

    HW -->|Métricas| TA
    TA -->|Envia onchain| BC[Ledger DoubleZero]
Agente O Que Faz
Config Agent Busca configuração do controlador, aplica ao seu switch
Telemetry Agent Mede latência/perda para outros dispositivos, reporta métricas onchain

Passo 4.4: Instalar Config Agent

Habilitar a API no seu switch

Adicionar à configuração EOS:

management api eos-sdk-rpc
    transport grpc eapilocal
        localhost loopback vrf default
        service all
        no disabled

Nota sobre VRF

Substitua default pelo nome do seu VRF de gerenciamento se for diferente (por exemplo, management).

Baixar e instalar o agente

# Entrar no bash no switch
switch# bash
$ sudo bash
# cd /mnt/flash
# wget AGENT_DOWNLOAD_URL
# exit
$ exit

# Instalar como extensão EOS
switch# copy flash:AGENT_FILENAME extension:
switch# extension AGENT_FILENAME
switch# copy installed-extensions boot-extensions

Verificar a extensão

switch# show extensions

O Status deve ser "A, I, B":

Name                                        Version/Release     Status     Extension
------------------------------------------- ------------------- ---------- ---------
AGENT_FILENAME    MAINNET_CLIENT_VERSION/1             A, I, B    1

A: available | NA: not available | I: installed | F: forced | B: install at boot

Configurar e iniciar o agente

Adicionar à configuração EOS:

daemon doublezero-agent
    exec /usr/local/bin/doublezero-agent -pubkey <SUA_CHAVE_PUBLICA_DO_DISPOSITIVO>
    no shut

Nota sobre VRF

Se seu VRF de gerenciamento não for default (ou seja, o namespace não é ns-default), prefixe o comando exec com exec /sbin/ip netns exec ns-<VRF>. Por exemplo, se seu VRF for management: 

daemon doublezero-agent
    exec /sbin/ip netns exec ns-management /usr/local/bin/doublezero-agent -pubkey <SUA_CHAVE_PUBLICA_DO_DISPOSITIVO>
    no shut

Obtenha a pubkey do seu dispositivo com doublezero device list (coluna account).

Verificar se está em execução

switch# show agent doublezero-agent logs

Você deve ver "Starting doublezero-agent" e conexões bem-sucedidas ao controlador.

Passo 4.5: Instalar Telemetry Agent

Copiar a chave do editor de métricas para o seu dispositivo

scp ~/.config/doublezero/metrics-publisher.json <IP_DO_SWITCH>:/mnt/flash/metrics-publisher-keypair.json

Registrar o editor de métricas onchain

doublezero device update \
  --pubkey <CONTA_DO_DISPOSITIVO> \
  --metrics-publisher <CHAVE_PUBLICA_DO_EDITOR_DE_METRICAS>

Obtenha a pubkey do seu arquivo metrics-publisher.json.

Baixar e instalar o agente

switch# bash
$ sudo bash
# cd /mnt/flash
# wget TELEMETRY_DOWNLOAD_URL
# exit
$ exit

# Instalar como extensão EOS
switch# copy flash:TELEMETRY_FILENAME extension:
switch# extension TELEMETRY_FILENAME
switch# copy installed-extensions boot-extensions

Verificar a extensão

switch# show extensions

O Status deve ser "A, I, B":

Name                                        Version/Release     Status     Extension
------------------------------------------- ------------------- ---------- ---------
TELEMETRY_FILENAME    MAINNET_CLIENT_VERSION/1             A, I, B    1

A: available | NA: not available | I: installed | F: forced | B: install at boot

Configurar e iniciar o agente

Adicionar à configuração EOS:

daemon doublezero-telemetry
    exec /usr/local/bin/doublezero-telemetry --local-device-pubkey <CONTA_DO_DISPOSITIVO> --env mainnet --keypair /mnt/flash/metrics-publisher-keypair.json
    no shut

Nota sobre VRF

Se seu VRF de gerenciamento não for default (ou seja, o namespace não é ns-default), adicione --management-namespace ns-<VRF> ao comando exec. Por exemplo, se seu VRF for management: 

daemon doublezero-telemetry
    exec /usr/local/bin/doublezero-telemetry --management-namespace ns-management --local-device-pubkey <CONTA_DO_DISPOSITIVO> --env mainnet --keypair /mnt/flash/metrics-publisher-keypair.json
    no shut

Verificar se está em execução

switch# show agent doublezero-telemetry logs

Você deve ver "Starting telemetry collector" e "Starting submission loop".

Todos os novos links devem passar por rodagem antes de transportar tráfego

Novos links devem ser drenados por pelo menos 24 horas antes de serem ativados para tráfego de produção. Este requisito de rodagem é definido no RFC12: Provisionamento de Rede, que especifica ~200.000 slots do DZ Ledger (~20 horas) de métricas limpas antes que um link esteja pronto para serviço.

Com os agentes instalados e em execução, monitore seus links em metrics.doublezero.xyz por pelo menos 24 horas consecutivas:

  • Dashboard "DoubleZero Device-Link Latencies" — verifique zero perda de pacotes no link ao longo do tempo
  • Dashboard "DoubleZero Network Metrics" — verifique zero erros nos seus links

Remova o dreno do link apenas depois que o período de rodagem mostrar um link limpo com zero perda e zero erros.

Fase 6: Verificação & Ativação

Percorra esta lista de verificação para confirmar que tudo está funcionando.

Seu dispositivo começa bloqueado (max_users = 0)

Quando um dispositivo é criado, max_users é definido como 0 por padrão. Isso significa que nenhum usuário pode se conectar a ele ainda. Isso é intencional — você deve verificar se tudo funciona antes de aceitar tráfego de usuários.

Antes de definir max_users acima de 0, você deve:

  1. Confirmar que todos os links completaram sua rodagem de 24 horas com zero perda/erros em metrics.doublezero.xyz
  2. Coordenar com DZ/Malbec Labs para executar um teste de conectividade:
    • Um usuário de teste pode se conectar ao seu dispositivo?
    • O usuário recebe rotas pela rede DZ?
    • O usuário pode rotear tráfego pela rede DZ de ponta a ponta?
  3. Somente após o DZ/ML confirmar que os testes passaram, defina max_users como 96:
doublezero device update --pubkey <CONTA_DO_DISPOSITIVO> --max-users 96

Verificações do Dispositivo

# Seu dispositivo deve aparecer com status "activated"
doublezero device list | grep <SEU_CODIGO_DE_DISPOSITIVO>

Saída esperada:

 7xKm9pQw2R4vHt3... | nyc-dz001 | acme | EQX-NY5 | nyc | hybrid | 203.0.113.10 | 198.51.100.0/28 | 0 | 14 | activated | pending | | 5FMtd5Woq5XAAg54...

# Suas interfaces devem estar listadas
doublezero device interface list | grep <SEU_CODIGO_DE_DISPOSITIVO>

Saída esperada:

 nyc-dz001 | Loopback255 | loopback | vpnv4 | none | none | 0 | 0 | 1500 | static | 0 | 172.16.1.91/32  | 56 | false | activated
 nyc-dz001 | Loopback256 | loopback | ipv4  | none | none | 0 | 0 | 1500 | static | 0 | 172.16.1.100/32 | 0  | false | activated
 nyc-dz001 | Ethernet1/1 | physical | none  | none | none | 0 | 0 | 1500 | static | 0 |                 | 0  | false | activated

# Os links devem mostrar status "activated"
doublezero link list | grep <SEU_CODIGO_DE_DISPOSITIVO>

Saída esperada:

 8vkYpXaBW8RuknJq... | nyc-lax-wan01 | acme | nyc-dz001 | Ethernet3/1 | lax-dz001 | Ethernet3/1 | WAN | 10Gbps | 9000 | 65.00ms | 1.00ms | 0.00ms | 42 | 172.16.0.84/31 | activated | pending | 5FMtd5Woq5XAAg54...

Verificações de Agente

No switch:

# O config agent deve mostrar extrações de configuração bem-sucedidas
switch# show agent doublezero-agent logs | tail -20

# O telemetry agent deve mostrar envios bem-sucedidos
switch# show agent doublezero-telemetry logs | tail -20

Diagrama de Verificação Final

flowchart TB
    subgraph "Lista de Verificação"
        D[Status do Dispositivo: activated?]
        I[Interfaces: registradas?]
        L[Links: activated?]
        CA[Config Agent: buscando config?]
        TA[Telemetry Agent: enviando métricas?]
    end

    D --> PASS
    I --> PASS
    L --> PASS
    CA --> PASS
    TA --> PASS

    PASS[Todas as Verificações Passaram] --> NOTIFY[Notifique DZF/Malbec Labs<br/>Você está tecnicamente pronto!]

Resolução de Problemas

Criação de dispositivo falha

  • Verifique se sua chave de serviço está autorizada (doublezero contributor list)
  • Verifique se os códigos de localização e exchange são válidos
  • Certifique-se de que o prefixo DZ é um intervalo de IP público válido
  • Links DZX requerem aceitação do outro contribuidor
  • Entre em contato com eles para executar doublezero link accept

Config Agent não se conecta

  • Verifique se a rede de gerenciamento tem acesso à internet
  • Verifique se a configuração do VRF corresponde à sua configuração
  • Certifique-se de que a pubkey do dispositivo está correta

Telemetry Agent não envia

  • Verifique se a chave do editor de métricas está registrada onchain
  • Verifique se o arquivo de keypair existe no switch
  • Certifique-se de que a pubkey da conta do dispositivo está correta

Próximas Etapas

  • Revise o Guia de Operações para atualizações de agentes e gerenciamento de links
  • Consulte o Glossário para definições de termos
  • Entre em contato com DZF/Malbec Labs se encontrar problemas