Tutorial de Debian 13 / Migrar un servicio a otro servidor Debian y ensayar la reversión

Al migrar servicios a un nuevo servidor Debian, primero debe preparar el entorno de ejecución y las cuentas, luego restaurar la copia de seguridad final tomada mientras se detenían las escrituras, y finalmente comparar la funcionalidad y los datos. La migración no se completa simplemente cambiando el acceso, y debe decidir cómo conservar cualquier dato generado en el nuevo servidor para poder revertir de manera segura al servidor original.

Defina el alcance de la migración e identifique cada servidor

Este ejercicio migra un pequeño servicio HTTP de solo lectura hecho con Python entre dos máquinas virtuales (VM) Debian 13. Proporciona el programa, los datos y la unidad systemd, y solo responde en 127.0.0.1:8085. Como se describe en la documentación de Python http.server , este no es un ejemplo para usar como un servidor de producción expuesto a Internet. La migración del esquema de la base de datos, los cambios reales del sistema de nombres de dominio (DNS, Domain Name System) y las transiciones externas de seguridad de la capa de transporte (TLS, Transport Layer Security) no están incluidas en este ejercicio.

Roles Conexión del ejercicio Qué verificar
Origen old-server Host 127.0.0.1:22212 → SSH de la VM original Respuesta de referencia, copia de seguridad final, detener y reiniciar
Destino new-server Host 127.0.0.1:22213 → VM de destino SSH Cuenta dedicada · Restauración · Respuesta del servicio · Reinicio
Computadora de trabajo SSH/SCP que verifica individualmente las claves del host de los dos servidores Transferencia de copia de seguridad, comparación de hash, selección del objetivo de conexión

Incluso si la misma dirección 10.0.2.15 aparece dentro de las dos VM usando traducción de direcciones de red (NAT, Network Address Translation), no son el mismo servidor. En este ejemplo, se conectaron diferentes puertos de loopback del host a través de VirtualBox Network → NAT → Avanzado → Reenvío de Puertos. Reemplace con la dirección y el puerto reales de su servidor, y verifique por separado la identidad y la clave del host de cada servidor. Durante el ejercicio, el arranque de la VM objetivo se detuvo, por lo que se reinició después de un apagado normal ACPI, y la restauración se llevó a cabo solo después de confirmar que el destino podía conectarse exitosamente.

En la computadora Linux de trabajo, puede configurar un alias como el siguiente en ~/.ssh/config. Reemplace la ruta de la clave privada con la suya propia, y no copie contraseñas ni el contenido de la clave privada en texto o registros.

Host old-server
    HostName 127.0.0.1
    Port 22212
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Host new-server
    HostName 127.0.0.1
    Port 22213
    User lfstudent
    IdentityFile ~/.ssh/id_ed25519

Cada servidor requiere Python 3, curl y tar. Si no están instalados, prepárelos con sudo apt install python3 curl tar, e instale los clientes SSH y SCP en la computadora de trabajo. El ejemplo original a continuación asume la existencia de la cuenta lfstudent con ID de usuario (UID) y ID de grupo (GID) 1000 del tutorial. Si se utiliza una cuenta diferente, también cambie las directivas User y Group y los propietarios de los archivos. Use un nuevo entorno de práctica que no sobrescriba directorios o servicios existentes con el mismo nombre.

Cree el servicio completo en el origen y respáldelo mientras está detenido

Ejecutar en el servidor de origen. Este bloque crea programas, datos y unidades, compara las respuestas y luego detiene el servicio. Cuando se crea el último tar, el proceso de lectura de datos de este ejemplo también se encuentra en estado detenido. Otros servicios o archivos de práctica de actualización existentes no son el objetivo.

sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != '/':
            self.send_error(404)
            return
        try:
            body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
            status = 200
        except OSError:
            body = b'data unavailable\n'
            status = 503
        self.send_response(status)
        self.send_header('Content-Type', 'text/plain; charset=utf-8')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers()
        self.wfile.write(body)

HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT

Si la breve demora al iniciar es insuficiente y curl falla, inspeccione sudo systemctl status lf-migrate35.service y sudo journalctl -u lf-migrate35.service -n 30. Verifique rutas, propiedad y conflictos de puertos, luego reintente la solicitud fallida y la comparación después de que todo esté listo. No vuelva a ejecutar el bloque de creación sobre recursos parcialmente creados ni cree el archivo final antes de detener el origen. Asegúrese de que las solicitudes locales de curl omitan cualquier proxy configurado.

El resultado esperado es service.tar: OK y un mensaje de preparación de respaldo. La respuesta normal es una sola línea migration payload 35. Si no hay datos o son ilegibles, este servicio devuelve 503, y no revela listas de archivos ni lee otras rutas.

Para servicios reales de base de datos o carga de archivos, necesita juzgar si detener solo un proceso es suficiente. Detenga trabajos por lotes, consumidores de colas, escrituras en otros servidores, o use los métodos de volcado consistente o respaldo en línea del producto. Si vuelve a sincronizar los cambios finales después de la copia masiva inicial, registre los dos puntos en el tiempo y los intervalos de detención de escritura.

Transfiera la copia de seguridad a través de la estación de trabajo

Ejecute el bloque de exportación en el servidor de origen como lfstudent. Deténgase si el directorio de exportación ya existe o si alguna copia falla. En la estación de trabajo, deténgase si mkdir migration35, la verificación de suma de comprobación o la creación del directorio de importación de destino falla; no permita que comandos scp posteriores reutilicen un directorio anterior.

Copie solo los dos archivos de práctica, el tar y su suma de verificación, sin abrir el acceso al directorio de respaldo exclusivo de root del origen, a un directorio dedicado para la cuenta de práctica. Para copias de seguridad de servicio reales, aplique políticas separadas de cifrado y almacenamiento dependiendo de si contienen información confidencial.

test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"

Ejecute en la estación de trabajo Linux. Confirme que los alias SSH apuntan a los servidores previstos, luego reciba los archivos en un nuevo directorio local dedicado.

ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/

El hash debe coincidir, y la lista solo debe incluir opt/lf-migrate35, var/lib/lf-migrate35 y la unidad de servicio relevante. Conceda permisos de restauración únicamente a archivos confiables que haya creado y deténgase si hay rutas absolutas, rutas que asciendan al directorio padre mediante .., o enlaces inesperados. La suma de verificación es para verificar daños durante la transferencia y no reemplaza la confianza en la fuente. Las opciones de SCP y métodos de transferencia se pueden encontrar en el manual de scp de OpenSSH.

Restaure en el destino con una cuenta dedicada

Ejecute en el servidor de destino. Primero confirme que /opt/lf-migrate35, /var/lib/lf-migrate35, /var/backups/lf-migrate35 y /etc/systemd/system/lf-migrate35.service están ausentes y que getent passwd lf-migrate35 no encuentra ninguna cuenta existente. Si sudo ss -ltn muestra que el puerto 8085 está ocupado, deténgase e investigue.

Todos los controles de ausencia de destino anteriores son obligatorios: el bloque de restauración asume que pasaron. Además, confirme que getent group lf-migrate35 no encuentra ningún grupo existente. La ruta de importación asume que el inicio de sesión de la cuenta es /home/lfstudent; reemplácelo de manera consistente si el suyo difiere. La afirmación final de UID-no-1000 demuestra IDs diferentes en este laboratorio; la asignación exitosa en producción se define por la identidad de destino prevista, no por una diferencia de número universalmente requerida.

El tar se extrae primero en un directorio de preparación y solo se instalan los archivos necesarios. Tras confirmar que la unidad de destino no existe, el bloque crea únicamente la unidad de esta práctica; no sustituye todo el /etc del destino. En lugar de copiar el UID numérico original, restablece la propiedad de los datos al nombre de cuenta dedicado del destino.

sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target

[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT

El propietario original de los datos de la máquina virtual de verificación era UID 1000, y la cuenta dedicada de destino era UID y GID 988. Los permisos de los datos se establecieron en lf-migrate35:lf-migrate35:640, y los bytes del código, las respuestas HTTP, y las respuestas después de reiniciar el servicio eran iguales. NoNewPrivileges y la protección del sistema de solo lectura son limitaciones de este ejemplo según la configuración del entorno de ejecución de systemd. Aplicar la misma unidad directamente a un servicio de escritura también puede bloquear la escritura de datos necesaria, por lo que los permisos deben diseñarse por separado para cada ruta.

En aplicaciones reales, también se comparan las versiones en tiempo de ejecución, los módulos de extensión, los clientes de base de datos, las variables de entorno, los certificados y las rutas de carga. No suponga que los formatos de archivo y los comportamientos son idénticos solo porque la versión del sistema operativo es la misma; ejecute las herramientas de verificación y las solicitudes de funciones admitidas por el producto en el objetivo.

Pruebe la transición, la reversión y una nueva transición

Actualmente, el servicio original está detenido y el servicio objetivo está respondiendo. En la computadora de trabajo, use la variable para seleccionar el destino de la conexión y verificar la lectura. Esto es para seleccionar el destino SSH y no es una operación que cambie DNS, balanceador de carga o direcciones web públicas.

active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
  1. Ejecute sudo systemctl stop lf-migrate35.service en el objetivo.
  2. Ejecute sudo systemctl start lf-migrate35.service en el original.
  3. En la computadora de trabajo, realice la lectura en el original como se muestra a continuación y verifique si la respuesta es la misma.
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'

Para cambiar al objetivo nuevamente, primero detenga la fuente, luego inicie el servicio objetivo y verifique con active=new-server. Comparamos todas las respuestas de restauración/reinicio del objetivo en ambas VM, la reversión de la fuente y el cambio al objetivo con el archivo de referencia. Este pequeño servicio es solo de lectura, por lo que no refleja un escenario en el que ocurran conflictos de escritura nuevos después del cambio.

Decisiones adicionales a tomar antes de un cambio real de producción

Elemento Criterios de juicio
DNS y balanceador de carga Tome en cuenta la caché actual, las conexiones existentes, las verificaciones de salud y los retrasos de propagación. Reducir solo el tiempo de vida (TTL, Time to Live) del DNS no dirige inmediatamente todas las solicitudes.
Reanudando escrituras y reversión Antes de la sincronización final, bloquee las escrituras en la fuente y determine si los datos generados en el destino pueden aplicarse nuevamente a la fuente. Evite una simple reversión si el esquema no es compatible hacia atrás.
Tareas programadas, correo electrónico, cola Si ambos servidores funcionan simultáneamente, active solo uno para las tareas que de otro modo se duplicarían. Verifique por separado del cambio de solicitud web.
Juicio de éxito Compare el proceso, el puerto, la respuesta, los datos, las funciones principales y las tasas de error individualmente. Leer correctamente por sí solo no cuenta como escritura normal.

Establezca la ventana de reversión y el período de retención antes de eliminar la fuente o las copias de seguridad. Consulte el manual de tar de Debian GNU para el comportamiento de extracción y propiedad numérica, y siga los procedimientos oficiales específicos del producto para bases de datos o migración de datos de versión principal.

Limpie solo los recursos del laboratorio

Después de la verificación, limpie solo los recursos del laboratorio que usted creó en cada servidor. Detenga y desactive el servicio, elimine exactamente los tres archivos y elimine solo los directorios vacíos. Mantenga las copias de seguridad y preserve la cuenta lfstudent existente del servidor fuente.

sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload

En el destino, elimine la cuenta dedicada recién creada con sudo userdel lf-migrate35 solo después de que sus procesos hayan finalizado y se hayan eliminado sus datos de laboratorio. Aplique su política de retención a los dos archivos de transferencia exactos en la fuente y en la estación de trabajo. Para una migración de producción, conserve la copia de seguridad final verificada y los registros de cambio hasta que termine la ventana de recuperación.