Deprecar y migrar: apagar un sistema antiguo sin dejar a nadie atrás

Cómo decidir si mantener o retirar un sistema y cómo migrar a los usuarios: el código como pasivo, deprecación con fecha límite, migración gradual, retirada solo cuando el uso llega a cero.

Metodologíametodologiamigrazionedeprecazioneingegneria del software19 de noviembre de 2026 · 3 min de lectura

Cada línea de código tiene un coste de mantenimiento: hay que leerla, actualizarla, protegerla, probarla. Un sistema antiguo que nadie quiere pero que alguien sigue usando es una deuda que crece. Deprecar y migrar significa decidir con método cuándo retirar algo y cómo llevar a los usuarios a otro sitio sin sorpresas.

El código como pasivo

El punto de partida es un cambio de perspectiva: el código no es un activo que conservar, es un pasivo que mantener. Se conserva porque sirve, no porque ya estuviera escrito. La pregunta no es «¿podemos apagarlo?» sino «¿cuánto cuesta mantenerlo frente a lo que aporta?».

Decidir si retirar

Algunas preguntas ayudan.

  • ¿Quién lo sigue usando y cuánto? (Con datos de uso, no con impresiones.)
  • ¿Existe un sustituto que cubra de verdad los casos de uso, o solo los principales?
  • ¿Cuánto cuesta mantenerlo (tiempo, riesgo, competencias escasas)?
  • ¿Qué pasa con los usuarios que quedan y en qué condiciones se les puede acompañar?

Si la respuesta es «no lo sabemos», el primer trabajo es medir el uso.

El proceso de deprecación

1. Anunciar, con una fecha. Decir qué se retira, por qué, qué lo sustituye y para cuándo. Un anuncio sin fecha no produce migraciones.

2. Hacer posible la migración. Ofrecer la ruta: guía, herramientas, ejemplos, soporte. Si migrar es difícil, los usuarios no lo harán.

3. Señalar el uso. El sistema antiguo avisa a quien lo usa (mensajes, cabeceras, registros), para que nadie se lleve una sorpresa.

4. Migrar gradualmente. Por grupos, empezando por los más sencillos o los más colaboradores. Los dos sistemas conviven el tiempo necesario y se comparan los resultados.

5. Apagar cuando el uso es cero (o cuando se ha decidido que el uso residual es aceptable). No antes. Apagar un sistema con usuarios activos es una interrupción del servicio.

6. Eliminar. Se borran el código, la configuración, la documentación y los datos que ya no hacen falta (respetando las obligaciones de conservación). El trabajo termina cuando el código ya no está, no cuando se envió el aviso.

El código de compatibilidad

El código que mantiene vivo el comportamiento antiguo para los usuarios antiguos tiene una fecha de fin: si no la tiene, se vuelve permanente. Se marca con un comentario que dice quién lo usa y cuándo se quita.

Señales de alarma

  • Un sistema «deprecado» sin fecha de apagado.
  • Ninguna medición del uso real.
  • Un sustituto que no cubre todos los casos de uso.
  • Apagado con usuarios todavía activos.
  • Código de compatibilidad sin caducidad.
  • Dos sistemas en paralelo durante años.

Un ejemplo

Una API interna de versión 1 la usan once servicios. Se mide el uso: siete ya la han abandonado, cuatro no. Se anuncia el apagado con una fecha, se prepara la guía de migración y se acompaña a cada uno de los cuatro equipos. A una semana de la fecha el uso es cero: se apaga y después se elimina el código.

Cuándo usarlo

Al retirar sistemas, API o funcionalidades antiguos; al migrar usuarios de una implementación a otra; al decidir si mantener o retirar el código existente.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

deprecation-and-migrationMétodo para retirar un sistema y migrar a los usuarios: el código como pasivo, medición del uso, anuncio con fecha, ruta de migración, avisos, migración gradual, apagado con uso cero, eliminación completa. Úsese al decidir si mantener o retirar código, API o funcionalidades.