Admin-Sistemas ·

etckeeper: versiona /etc con git y deshaz cualquier cambio roto

Actualizas un paquete, reinicias un servicio y algo deja de funcionar. Revisas el fichero de configuración y parece correcto, pero ¿qué cambió exactamente: la actualización, un ajuste manual de hace dos semanas o ese cambio «provisional» que nunca se revirtió? En un servidor Linux, /etc guarda todas esas decisiones, y sin control de versiones es un diario sin fechas.

etckeeper resuelve justo eso: pone /etc bajo control de versiones con git, registra automáticamente los cambios de las instalaciones y actualizaciones de paquetes, y guarda también los metadatos que git no entiende, como permisos y propietario. No es una copia de seguridad completa, pero te dice qué cambió, cuándo y cómo volver atrás.

Qué hace etckeeper (y qué no hace)

etckeeper no reinventa git: lo envuelve. Al inicializarlo crea un repositorio git dentro de /etc, instala ganchos para el gestor de paquetes y, en cada commit, guarda en /etc/.etckeeper los permisos, propietarios y directorios vacíos que git no registraría. El detalle importa: git solo guarda el bit de ejecución, y en /etc un fichero como /etc/shadow no puede quedar con los permisos equivocados tras una restauración.

Con etckeeper puedes registrar cada cambio provocado por apt, hacer commits manuales antes de tocar una configuración delicada, ver el historial de cualquier fichero y revertir un fichero concreto o todo /etc a un estado anterior.

Lo que no hace: no es un backup del sistema ni sustituye a Borg, Restic o Rclone. Si el disco muere, el repositorio que vive en /etc muere con él. Su trabajo es el historial y la reversión rápida, no la recuperación ante desastres.

Instalación y primer commit

En Debian y Ubuntu, etckeeper está en los repositorios oficiales:

sudo apt update && sudo apt install -y etckeeper
sudo etckeeper init
sudo etckeeper commit "Estado inicial de /etc"

A partir de ahí, cada operación con apt genera sus propios commits.

Si git se queja de que no conoce tu identidad al hacer el primer commit, configúrala para root antes de repetirlo:

sudo git config --global user.name "root"
sudo git config --global user.email "root@localhost"

Un detalle de seguridad desde el primer día: el repositorio de /etc contiene copias de ficheros sensibles, como los hashes de /etc/shadow. etckeeper limita los permisos del directorio .git a root, y así debe quedarse. No lo copies a un sitio compartido ni lo subas jamás a un repositorio público.

El día a día: commit antes de tocar nada

La rutina que de verdad salva servidores es sencilla: commit antes de cambiar, commit después de cambiar. Antes de editar la configuración de nginx, de sshd o de cualquier servicio crítico, deja constancia del punto de partida:

sudo etckeeper commit "Antes de ajustar nginx"
# ... edita /etc/nginx/nginx.conf ...
sudo etckeeper commit "nginx: ajustar buffers y timeouts"

Para revisar qué ha cambiado, o qué tocó una actualización reciente, usa git a través de etckeeper desde /etc:

cd /etc
sudo etckeeper vcs status
sudo etckeeper vcs diff
sudo etckeeper vcs log --oneline -15

status dice qué ficheros están pendientes, diff muestra las líneas exactas que cambiaron y log resume los últimos commits con su mensaje. Cuando un servicio falla tras una actualización, ese diff suele responder en segundos a la pregunta de «¿qué ha cambiado aquí?».

En Debian, etckeeper trae además un autocommit diario; desactívalo con AVOID_DAILY_AUTOCOMMITS=1 en /etc/etckeeper/etckeeper.conf si solo quieres registrar lo que confirmas.

Deshacer un cambio roto

Aquí es donde etckeeper paga su instalación. Supón que editaste la configuración de nginx y el servicio ya no arranca. Comprueba qué cambió y vuelve al commit anterior solo para ese fichero:

cd /etc
sudo etckeeper vcs log --oneline -5 -- nginx/nginx.conf
sudo etckeeper vcs checkout HEAD~1 -- nginx/nginx.conf
sudo etckeeper init
sudo nginx -t && sudo systemctl reload nginx

El checkout recupera el contenido anterior y etckeeper init vuelve a aplicar los metadatos guardados (permisos y propietario). La comprobación con nginx -t antes de recargar no es opcional: evita convertir un fichero roto en un servicio caído.

Si el estropicio es mayor y quieres devolver todo /etc a un commit concreto, el procedimiento es el mismo a mayor escala. Hazlo en una ventana de mantenimiento si el servidor es crítico: restaurar /etc entero afecta a todos los servicios a la vez, así que recarga cada servicio afectado y compruébalos uno a uno.

Un remoto privado, con cabeza

etckeeper también permite empujar el repositorio a un remoto, lo que añade una copia del historial fuera del propio servidor:

cd /etc
sudo git remote add origin git@tu-servidor-privado:copias/etc-servidor.git
sudo git push -u origin HEAD

Pero la advertencia es seria: ese remoto contiene secretos de tu sistema. Solo tiene sentido en un servidor privado, con acceso restringido y, a ser posible, cifrado. Un repositorio público o un remoto compartido con quien no debe convierte una buena práctica en una filtración. Si no puedes garantizar ese entorno, quédate con el repositorio local y deja las copias externas a tu sistema de backups cifrado.

Checklist para empezar hoy

  • Instalar: sudo apt install -y etckeeper y sudo etckeeper init.
  • Primer commit: sudo etckeeper commit "Estado inicial de /etc".
  • Antes de un cambio: commit con un mensaje que diga qué vas a tocar.
  • Mensajes útiles: «Antes de tocar sshd» vale; «cambios» no vale. Dentro de tres meses, el mensaje es lo único que te orientará.
  • Ver qué cambió: sudo etckeeper vcs diff.
  • Revertir un fichero: checkout del commit anterior, etckeeper init, comprobar y recargar el servicio.
  • Probar la restauración: un historial que nunca has usado para revertir algo es una promesa sin verificar. Haz la prueba en un momento tranquilo, no durante una incidencia.

La próxima vez que una actualización o un cambio manual rompa algo, no tendrás que adivinar qué pasó: tendrás el historial, la diferencia exacta y un camino de vuelta. Instalar etckeeper lleva cinco minutos; la primera vez que te salve de una madrugada de depuración, te parecerá la mejor inversión de la semana.

Configuración de servidor versionada con etckeeper y git