Descripción general del servicio
- Usuario del sistema:
etcd - Nombre de nodo predeterminado: generado automáticamente
etcd-<timestamp> - Archivo de configuración:
/etc/etcd/etcd.yml - Directorio de datos:
/var/lib/etcd - Binarios:
/usr/local/bin/etcd,/usr/local/bin/etcdctl, y/usr/local/bin/etcdutl - Nivel de registro:
debug
Red y puertos
- Tráfico de clientes:
http://localhost:2379 - Tráfico entre pares:
http://localhost:2380 - Acceso local solo de forma predeterminada (se vincula a localhost)
Gestión del 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
Copia de seguridad y restauración
Haga una copia de seguridad de una instantánea (guarde el estado actual del etcd en un archivo):
etcdctl snapshot save /root/etcd-backup.db
Verificar el estado de la instantánea:
etcdutl snapshot status /root/etcd-backup.db -w table
Detenga el servicio etcd para evitar conflictos:
systemctl stop etcd
Elimine el contenido existente del directorio de datos:
rm -rf /var/lib/etcd/*
Restaurar la instantánea:
etcdutl snapshot restore /root/etcd-backup.db --data-dir /var/lib/etcd
Asegúrese de que los permisos sean correctos:
chown -R etcd:etcd /var/lib/etcd
Inicie el servicio etcd nuevamente:
systemctl start etcd
Notas
- Clúster de un solo nodo por defecto, adecuado para desarrollo/pruebas.
- Configurado con nivel de registro de depuración.
- Para producción, habilite TLS para la comunicación entre clientes y pares.
- Considere la posibilidad de configurar un clúster de varios nodos para obtener alta disponibilidad.
- Restrinja los puertos 2379 (cliente) y 2380 (par) a hosts confiables mediante reglas de firewall.
- Modificar
/etc/etcd/etcd.ymlpara configuración avanzada y reinicie eletcdservicio para aplicar cambios. - Siempre haga una copia de seguridad de los datos antes de realizar operaciones destructivas (eliminar/restaurar/compactar).
- Asegurar
/var/lib/etcdes propiedad deetcd:etcd; Los permisos incorrectos pueden impedir que etcd se inicie después de restauraciones o cambios de datos.