etcd

Visão Geral do Serviço

• Usuário do sistema: etcd
• Nome do nó padrão: gerado automaticamente etcd-<timestamp>
• Arquivo de configuração: /etc/etcd/etcd.yml
• Diretório de dados: /var/lib/etcd
• Binários: /usr/local/bin/etcd, /usr/local/bin/etcdctl, e /usr/local/bin/etcdutl
• Nível de log: debug

Rede e Portas

• Tráfego do cliente: http://localhost:2379
• Tráfego entre pares: http://localhost:2380
• Acesso local apenas por padrão (vincula ao localhost)

Gerenciamento do Systemd

systemctl status etcd         # Check status
systemctl restart etcd        # Start service
systemctl stop etcd           # Stop service
systemctl restart etcd        # Restart service

Comandos Básicos

# Check etcd server version
etcd --version

# Check etcdctl client version
etcdctl version

# Check etcdutl version
etcdutl version

# Set a key
etcdctl put mykey "HelloEtcd"

# Get a key
etcdctl get mykey

# List all keys with values
etcdctl get "" --prefix

# List only key names
etcdctl get "" --prefix --keys-only

# Delete a key
etcdctl del mykey

# Check cluster health
etcdctl endpoint health

# List cluster members
etcdctl --endpoints=http://127.0.0.1:2379 member list

# Show cluster leader
etcdctl endpoint status --write-out=table

# Watch a key for changes
etcdctl watch mykey

Backup e Restauração

Fazer backup de um snapshot (salvar o estado atual do etcd em um arquivo):

etcdctl snapshot save /root/etcd-backup.db

Verificar status do snapshot:

etcdutl snapshot status /root/etcd-backup.db -w table

Parar o serviço etcd para evitar conflitos:

systemctl stop etcd

Remover o conteúdo existente do diretório de dados:

rm -rf /var/lib/etcd/*

Restaurar o snapshot:

etcdutl snapshot restore /root/etcd-backup.db --data-dir /var/lib/etcd

Verificar se as permissões estão corretas:

chown -R etcd:etcd /var/lib/etcd

Iniciar o serviço etcd novamente:

systemctl start etcd

Notas

• Cluster de nó único por padrão, adequado para desenvolvimento e testes.
• Configurado com nível de log de depuração.
• Em produção, habilite TLS para comunicação entre clientes e peers.
• Considere configurar um cluster multi-nó para alta disponibilidade.
• Restrinja as portas 2379 (cliente) e 2380 (peer) a hosts confiáveis usando regras de firewall.
• Modificar /etc/etcd/etcd.yml para configuração avançada e reinicie o serviço etcd para aplicar as alterações.
• Sempre faça backup dos dados antes de executar operações destrutivas (excluir/restaurar/compactar).
• Certifique-se /var/lib/etcd é de propriedade de etcd:etcd; permissões incorretas podem impedir que etcd inicie após restaurações ou alterações de dados.