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 registro: debug

Rede e portas

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

Gerenciamento do sistema

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

Faça backup de um snapshot (salve o estado atual do etcd em um arquivo):

etcdctl snapshot save /root/etcd-backup.db

Verifique o status do instantâneo:

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

Pare o serviço etcd para evitar conflitos:

systemctl stop etcd

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

rm -rf /var/lib/etcd/*

Restaure o instantâneo:

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

Certifique-se de que as permissões estejam corretas:

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

Inicie o serviço etcd novamente:

systemctl start etcd

Notas

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