From f186b71ca51e83837db60de13322394bb5e6d348 Mon Sep 17 00:00:00 2001 From: murilo ijanc Date: Tue, 24 Mar 2026 21:41:06 -0300 Subject: Initial commit Import existing tesseras.net website content. --- book/pt-br/docker.html | 303 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 303 insertions(+) create mode 100644 book/pt-br/docker.html (limited to 'book/pt-br/docker.html') diff --git a/book/pt-br/docker.html b/book/pt-br/docker.html new file mode 100644 index 0000000..3cc228c --- /dev/null +++ b/book/pt-br/docker.html @@ -0,0 +1,303 @@ + + + + + + Docker - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

Docker

+

Tesseras fornece uma imagem Docker para executar o daemon em conteineres. Isso e util para servidores, testar redes com multiplos nos e ambientes de CI.

+

Construindo a imagem

+

A partir da raiz do repositorio:

+
docker build -t tesseras-daemon .
+
+

O Dockerfile multi-estagio usa rust:1.85 para compilar e debian:bookworm-slim como base de execucao. A imagem resultante e pequena e contem apenas o binario do daemon e certificados CA.

+

Executando um unico no

+
docker run -d \
+  --name tesseras \
+  -p 4433:4433/udp \
+  tesseras-daemon
+
+

Isso inicia um no que:

+
    +
  • Escuta na porta UDP 4433
    • +
  • Faz bootstrap a partir dos nos semente padrao
    • +
  • Armazena dados dentro do conteiner (efemero)
    • +
+

Para persistir dados entre reinicializacoes do conteiner, monte um volume:

+
docker run -d \
+  --name tesseras \
+  -p 4433:4433/udp \
+  -v tesseras-data:/root/.local/share/tesseras \
+  tesseras-daemon
+
+

Executando como no semente

+

Para executar um no semente que nao faz bootstrap de ninguem:

+
docker run -d \
+  --name tesseras-seed \
+  -p 4433:4433/udp \
+  tesseras-daemon --listen 0.0.0.0:4433 --bootstrap ""
+
+

Rede multi-no com Docker Compose

+

O repositorio inclui um arquivo Docker Compose para testar uma rede de 3 nos:

+
services:
+  boot1:
+    build: ../..
+    command: ["--listen", "0.0.0.0:4433", "--bootstrap", ""]
+    ports: ["4433:4433/udp"]
+
+  boot2:
+    build: ../..
+    command: ["--listen", "0.0.0.0:4433", "--bootstrap", "boot1:4433"]
+    depends_on: [boot1]
+
+  client:
+    build: ../..
+    command: ["--listen", "0.0.0.0:4433", "--bootstrap", "boot2:4433"]
+    depends_on: [boot2]
+
+

Iniciar a rede:

+
cd tests/smoke
+docker compose up --build -d
+
+

Verificar que todos os nos estao executando:

+
docker compose logs --tail=5
+
+

Voce devera ver daemon ready nos logs de cada no, e bootstrap successful para boot2 e client.

+

Parar a rede:

+
docker compose down
+
+

Configuracao personalizada

+

Para usar um arquivo de configuracao com Docker, monte-o no conteiner:

+
docker run -d \
+  --name tesseras \
+  -p 4433:4433/udp \
+  -v ./config.toml:/etc/tesseras/config.toml:ro \
+  -v tesseras-data:/root/.local/share/tesseras \
+  tesseras-daemon --config /etc/tesseras/config.toml
+
+

Veja o capitulo Configuracao para todas as opcoes disponiveis.

+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + -- cgit v1.2.3