Plantilla de Checklist de Desmantelamiento de Sistemas

Descripcion General

Los servicios antiguos nunca mueren en silencio. Persisten en registros DNS, confunden a nuevos ingenieros, cuestan dinero y ocasionalmente rompen cosas cuando alguien cambia un certificado o rota un secreto. El desmantelamiento es el proceso disciplinado de apagar un servicio: identificar cada dependencia, migrar cada usuario, eliminar cada recurso y documentar que fue removido. Bien hecho, reduce costos y complejidad. Mal hecho, causa interrupciones en sistemas que pensabas no estaban relacionados.

Cuando Usar

• For alternatives, see Blue-Green Deployment.

Usa esta plantilla cuando:

• Un servicio ha sido reemplazado por uno nuevo y el trafico ha migrado
• Una funcion esta siendo discontinuada y la infraestructura de soporte ya no se necesita
• Una integracion de terceros esta siendo discontinuada
• Un experimento o prueba de concepto ha concluido
• Una auditoria requiere evidencia de que recursos no utilizados fueron removidos

Requisitos Previos

Antes de desmantelar un sistema:

• El sistema de reemplazo esta listo para produccion y maneja todo el trafico
• Una linea de tiempo de deprecacion ha sido comunicada a todos los stakeholders
• Todos los requisitos de retencion de datos y cumplimiento han sido revisados
• Existe un plan de rollback en caso de que el nuevo sistema falle despues del apagado
• El propietario del servicio ha aprobado la fecha de desmantelamiento

Solucion

# Checklist de Desmantelamiento: `<Nombre del Sistema / Servicio>`

> Propietario del servicio: ______ | Fecha: ______ | Aprobado por: ______
> Sistema de reemplazo: ______ | Fecha objetivo de desmantelamiento: ______

## 1. Descubrimiento

- [ ] Listar todos los servicios upstream que llaman a este sistema
- [ ] Listar todos los servicios downstream a los que este sistema llama
- [ ] Listar todas las integraciones externas (proveedores, socios, webhooks)
- [ ] Listar todos los registros DNS, balanceadores de carga y configs de CDN que apuntan a este servicio
- [ ] Listar todos los certificados SSL vinculados a este servicio
- [ ] Listar todas las bases de datos, caches, colas y buckets de almacenamiento propiedad de este servicio
- [ ] Listar todos los trabajos programados, tareas cron o workers en segundo plano
- [ ] Listar todos los feature flags o entradas de configuracion que referencian este servicio

## 2. Manejo de Datos

- [ ] Confirmar requisitos de retencion de datos (legal, cumplimiento, negocio)
- [ ] Exportar y archivar datos que deben retenerse
- [ ] Verificar ubicacion del archivo, cifrado y controles de acceso
- [ ] Migrar datos activos al sistema de reemplazo
- [ ] Documentar la ubicacion del archivo de datos y el cronograma de retencion
- [ ] Confirmar eliminacion de datos que no necesitan retenerse

## 3. Eliminacion de Dependencias

- [ ] Remover servicio de balanceadores de carga upstream y DNS
- [ ] Actualizar servicios upstream para dejar de llamar a este sistema
- [ ] Remover referencias del servicio de API gateways y service meshes
- [ ] Remover servicio de monitoreo, alertas y dashboards
- [ ] Remover servicio de pipelines CI/CD y herramientas de despliegue
- [ ] Remover servicio de administradores de secretos y almacenes de credenciales
- [ ] Remover servicio de cronogramas de respaldo y planes de recuperacion ante desastres

## 4. Apagado

- [ ] Redirigir trafico (si aplica) al reemplazo o pagina de discontinuacion
- [ ] Detener el servicio en staging / pre-produccion
- [ ] Monitorear errores o trafico inesperado por 24-48 horas
- [ ] Detener el servicio en produccion
- [ ] Monitorear nuevamente por 24-48 horas
- [ ] Deshabilitar auto-reinicio o recuperacion de health-check

## 5. Limpieza de Recursos

- [ ] Terminar instancias de computo, contenedores o funciones serverless
- [ ] Eliminar bases de datos (tras confirmar archivo y retencion)
- [ ] Eliminar caches, colas y topics
- [ ] Eliminar buckets y volumenes de almacenamiento
- [ ] Liberar IPs estaticas e interfaces de red elasticas
- [ ] Eliminar listeners de balanceador de carga y target groups
- [ ] Eliminar registros DNS (tras expirar el TTL)
- [ ] Revocar o eliminar certificados SSL
- [ ] Eliminar roles IAM, politicas y cuentas de servicio

## 6. Documentacion

- [ ] Actualizar diagramas de arquitectura para remover el servicio
- [ ] Actualizar runbooks y documentacion operacional
- [ ] Actualizar catalogo de servicios o documentos de propiedad
- [ ] Escribir un breve postmortem o retrospectiva sobre el desmantelamiento
- [ ] Notificar a stakeholders que el servicio ha sido completamente retirado

## 7. Verificacion

- [ ] Confirmar que no hay cargos de facturacion para el servicio en el siguiente ciclo
- [ ] Confirmar que no hay alertas ni errores que referencien el servicio
- [ ] Confirmar que no hay repositorios de codigo que referencien el servicio (excluyendo historial)
- [ ] Confirmar que ningun ingeniero nuevo esta siendo onboarded al servicio retirado

Explicacion

La checklist esta ordenada por riesgo: descubrimiento primero (para saber que estas tocando), manejo de datos segundo (para no eliminar algo que debes conservar), eliminacion de dependencias tercero (para que sistemas upstream no se rompan), apagado cuarto, limpieza quinto y documentacion al final. La seccion de verificacion atrapa lo que siempre se olvida: un registro DNS con TTL largo, un trabajo cron en un servidor olvidado, o un rol IAM que silenciosamente otorga acceso a otra cosa.

Script de Verificacion de Recursos Remanentes

#!/bin/bash
# Verificar recursos remanentes despues del desmantelamiento
set -euo pipefail

SERVICE_NAME="legacy-auth-service"
AWS_REGION="us-east-1"

echo "=== Verificacion de Recursos Remanentes ==="
echo "Servicio: $SERVICE_NAME"
echo "Fecha: $(date)"
echo ""

# Verificar registros DNS
echo "--- Registros DNS ---"
dig +short "$SERVICE_NAME.internal.example.com" && echo "ADVERTENCIA: Registro DNS aun existe" || echo "OK: Sin registro DNS"

# Verificar recursos AWS
echo "--- Recursos AWS ---"
aws ec2 describe-instances --region $AWS_REGION --filters "Name=tag:Service,Values=$SERVICE_NAME" --query 'Reservations[*].Instances[*].InstanceId' --output text 2>/dev/null | while read id; do
  [ -n "$id" ] && echo "ADVERTENCIA: Instancia EC2 encontrada: $id"
done

aws rds describe-db-instances --region $AWS_REGION --query 'DBInstances[?DBInstanceIdentifier.contains(@, `'$SERVICE_NAME'`)].DBInstanceIdentifier' --output text 2>/dev/null | while read id; do
  [ -n "$id" ] && echo "ADVERTENCIA: Instancia RDS encontrada: $id"
done

aws s3 ls --region $AWS_REGION 2>/dev/null | grep "$SERVICE_NAME" && echo "ADVERTENCIA: Bucket S3 encontrado" || echo "OK: Sin buckets S3"

# Verificar certificados
echo "--- Certificados ---"
aws acm list-certificates --region $AWS_REGION --query 'CertificateSummaryList[*].DomainName' --output text 2>/dev/null | tr '	' '
' | grep -i "$SERVICE_NAME" && echo "ADVERTENCIA: Certificado ACM encontrado" || echo "OK: Sin certificados"

# Verificar CloudWatch alarms
echo "--- Alarmas CloudWatch ---"
aws cloudwatch describe-alarms --region $AWS_REGION --query 'MetricAlarms[?AlarmName.contains(@, `'$SERVICE_NAME'`)].AlarmName' --output text 2>/dev/null | while read alarm; do
  [ -n "$alarm" ] && echo "ADVERTENCIA: Alarma CloudWatch encontrada: $alarm"
done

echo ""
echo "=== Verificacion Completada ==="

Plantilla de Notificacion de Desmantelamiento

=== Notificacion de Desmantelamiento de Servicio ===

Para: engineering@example.com, stakeholders@example.com
De: platform-team@example.com
Fecha: [FECHA]
Asunto: Desmantelamiento de [NOMBRE_SERVICIO]

El servicio [NOMBRE_SERVICIO] sera desmantelado el [FECHA_APERTURA].

Que significa esto?
- El servicio dejara de aceptar trafico el [FECHA_APERTURA]
- Los datos seran archivados y disponibles por [PERIODO_RETENCION]
- Los endpoints devolveran 410 Gone despues del apagado
- Las dependencias upstream deben actualizarse antes del [FECHA_APERTURA]

Que necesitas hacer?
1. Verifica si tu servicio depende de [NOMBRE_SERVICIO]
2. Si depende, migra a [SERVICIO_REEMPLAZO] antes del [FECHA_APERTURA]
3. Actualiza configuraciones, variables de entorno y documentacion
4. Contacta a platform-team@example.com si necesitas ayuda con la migracion

Cronograma:
- [FECHA_HOY]: Notificacion enviada
- [FECHA-30]: Apagado del servicio (stop)
- [FECHA-60]: Eliminacion de infraestructura
- [FECHA-90]: Eliminacion de datos (segun politica de retencion)

Contacto: platform-team@example.com

Checklist de Auditoria Post-Desmantelamiento

=== Auditoria Post-Desmantelamiento (30 dias) ===

Infraestructura:
  [ ] Ningun recurso cloud genera cargos
  [ ] No hay alarmas activas referenciando el servicio
  [ ] No hay dashboards obsoletos en Grafana/Datadog
  [ ] No hay targets en Prometheus/CloudWatch

Red y DNS:
  [ ] Registros DNS eliminados o redirigidos
  [ ] Certificados TLS revocados o eliminados
  [ ] Reglas de firewall/security groups eliminadas
  [ ] Load balancers y target groups eliminados

Codigo y CI/CD:
  [ ] Repositorio archivado (no eliminado)
  [ ] Pipelines de CI/CD deshabilitados
  [ ] Webhooks eliminados
  [ ] Variables de entorno en CI eliminadas

Datos:
  [ ] Backups archivados en almacenamiento economico
  [ ] Politica de retencion documentada
  [ ] Acceso a datos archivados restringido y auditado

Documentacion:
  [ ] Lapida creada en wiki/documentacion
  [ ] Catalogo de servicios actualizado
  [ ] Diagramas de arquitectura actualizados
  [ ] Runbooks referenciando el servicio actualizados

Variantes

Contexto	Ajustes	Notas
Reemplazo de servicio de terceros	Agregar terminacion de contrato con proveedor, exportacion de datos y revocacion de claves API	No controlas la infraestructura
Retiro solo de base de datos	Enfocarse en migracion de esquema, integridad referencial y redireccion de consultas	Los datos sobreviven al codigo
Retiro de microservicio	Agregar remocion de service mesh, actualizacion de contratos y notificacion a consumidores	Los consumidores pueden ser otros equipos
Cierre de region	Agregar verificaciones de residencia de datos, migracion de usuarios y evaluacion de impacto de latencia	Las regiones tienen implicaciones de cumplimiento
Desmantelamiento de experimento	Checklist mas corta; enfocarse en eliminacion de datos y confirmacion de costos	Los experimentos deben limpiarse rapido

Lo que funciona

1. Nunca elimines el primer dia. Deten el servicio, espera y observa. La eliminacion debe ser el ultimo paso
2. Archiva antes de eliminar. El almacenamiento es barato; explicar datos faltantes a auditores es costoso
3. Comunica temprano y frecuentemente. La peor sorpresa de desmantelamiento es descubrir que otro equipo aun usaba el servicio
4. Documenta lo que fue removido. Futuros ingenieros buscaran el servicio; deja una lapida, no un misterio
5. Verifica la facturacion. Los recursos cloud tienen una forma de generar cargos incluso despues de que crees que se fueron

Errores Comunes

1. Saltarse el descubrimiento. El servicio que estas apagando es una dependencia critica de alguien mas
2. Eliminar datos muy temprano. Una retencion legal, auditoria o necesidad de negocio puede requerir conservacion mas larga de lo que esperas
3. No esperar despues del apagado. Algunos sistemas solo reciben trafico en ciclos mensuales o trimestrales
4. Olvidar el DNS. Un registro DNS apuntando a una IP eliminada puede ser secuestrado o causar errores extranos
5. Ignorar certificados. Los certificados expirados de servicios eliminados aun disparan alertas y automatizaciones de renovacion

Lectura Adicional

• Documentación oficial: consulta la referencia actualizada del framework o herramienta utilizada.
• Guías relacionadas: explora las guías de infrastructure y migration para profundizar.
• Patrones complementarios: revisa los patrones de diseño aplicables a tu stack tecnológico.
• Postmortems públicos: estudia incidentes reales de equipos que enfrentaron problemas similares en producción.

Notas de Producción

• Despliega gradualmente usando canary o blue-green para detectar regresiones temprano.
• Configura alertas para errores, latencia p99 y tasa de fallos antes de habilitar en producción.
• Documenta el rollback en el runbook; prueba el procedimiento en staging al menos una vez por trimestre.
• Revisa logs estructurados con correlation IDs para trazar requests end-to-end en incidentes.

Puntos Clave

• Aplica plantilla de checklist de desmantelamiento de sistemas cuando necesites una solución práctica para tu caso de uso.
• Monitorea el rendimiento después de implementar; mide latencia, errores y uso de recursos antes y después.
• Revisa la sección de Troubleshooting ante errores comunes; la mayoría tienen causa raíz documentada con solución.
• Mantén dependencias actualizadas y ejecuta tests en CI para prevenir regresiones en producción.

Troubleshooting

• Instance is unreachable: check security groups, routes, DNS, and health status in the provider console. Verify that the OS firewall is not blocking the port.
• Provisioning fails consistently: inspect the init script, IAM roles, and image availability. A missing permission is the most common root cause.
• Resource exhaustion alerts: correlate CPU, memory, disk, and network metrics.
• Backup restore does not work: test restores regularly. A backup that cannot be restored is not a backup.
• Configuration drift: Recreate from the canonical definition when in doubt.

Errores Comunes en Producción

• Dejar campos requeridos vacíos o usar respuestas vagas de una palabra.
• Llenar el documento una vez y nunca actualizarlo cuando cambia el alcance o las decisiones.
• Guardar el documento donde el equipo no lo busque durante incidentes o revisiones.
• No asignar un responsable, fecha límite o cadencia de revisión.
• Copiar texto base sin eliminar secciones que no aplican.
• Saltar el control de versiones, lo que impide rollback y responsabilidad.
• No vincular el documento con decisiones relacionadas o acciones de seguimiento.
• Evitar revisiones trimestrales que retirarían secciones obsoletas o sin uso.