Python 3.10 alcanzó el fin de vida upstream el 1 de octubre de 2026. La última versión de seguridad es 3.10.22. No habrá más actualizaciones upstream. El soporte del fabricante debe verificarse por separado. La compatibilidad específica de la aplicación debe probarse individualmente.
Crear un inventario del proyecto
Antes de realizar una migración, es importante crear un inventario completo del proyecto. Esto incluye todos los paquetes utilizados, dependencias y la versión actual del intérprete de Python. Este inventario ayuda a identificar problemas de compatibilidad potenciales con anticipación y a planificar soluciones.
Verificar la compatibilidad del fabricante y de los paquetes
La compatibilidad debe verificarse sistemáticamente, considerando no solo la versión de Python, sino también todas las bibliotecas dependientes y sus versiones. Las interfaces externas, como controladores de base de datos o APIs, deben verificarse para su compatibilidad con la versión objetivo. Para los paquetes binarios, la compatibilidad con la plataforma y la arquitectura es decisiva. La planificación debe establecer responsabilidades claras y ventanas de mantenimiento para poder reaccionar rápidamente ante problemas. Es importante dividir los pasos de migración en fases y evaluar en cada paso el impacto en toda la aplicación. Una migración general sin análisis previo puede provocar errores inesperados.
Las especificaciones del fabricante sobre las versiones compatibles son de gran importancia.
Proteger la aplicación, los datos y la configuración
Antes de iniciar la migración, se deben respaldar completamente la aplicación, los datos y las configuraciones. El entorno antiguo debe permanecer inalterado para poder recurrir a él en caso de problemas.
Proyecto de prueba y verificación del intérprete
Los comandos mostrados son ejemplos de Unix; todos los comandos se ejecutan en el directorio raíz de un proyecto de prueba separado; las rutas relativas se refieren a ello. Antes de usarlos, verificar la versión real de python3. La versión objetivo debe ya estar instalada, mantenida y compatible con el proyecto. No se realizarán cambios en servicios en producción.
El proyecto de prueba sirve para la verificación aislada de los pasos de migración y no debe confundirse con entornos de producción. Antes de iniciar la migración, determinar la versión actual de Python en el lugar de implementación y compararla con la versión objetivo. Todos los comandos en el proyecto de prueba son ejemplares y sirven para la demostración; deben adaptarse a su entorno.
Antes de la instalación, el intérprete python3 debe ya estar instalado, mantenido y compatible con el proyecto. El archivo requirements-reviewed.txt es una lista de paquetes preparada por usted y probada en la versión objetivo, no un archivo incluido. El Python del sistema operativo no debe reemplazarse. El PATH global no debe modificarse. No se recomiendan actualizaciones masivas de paquetes. Los siguientes comandos deben usarse en el proyecto de prueba:
python3 --version
python3 -m venv .venv-next
.venv-next/bin/python -m pip install -r requirements-reviewed.txt
.venv-next/bin/python -m pip checkInstalación y verificación de dependencias
pip check solo verifica la compatibilidad de dependencias declaradas. No se realizan pruebas de aplicación ni auditorías de seguridad. Un venv aísla paquetes, pero no es un entorno aislado de seguridad y no resuelve el fin del soporte del intérprete. Los entornos deben crearse de nuevo, no copiarse ni moverse. No es necesario activar el entorno si se indica explícitamente la ruta del intérprete.
Pruebas y planificación de rollback
La aceptación de la migración solo debe realizarse si todas las pruebas planificadas se han completado con éxito y no han surgido errores críticos. Los datos sensibles deben manejarse según las normas del proyecto para evitar riesgos de violación de normas de protección de datos. Antes del cambio, documentar los resultados esperados y compararlos con los resultados reales. Las diferencias deben documentarse detalladamente y no ignorarse simplemente.
Después de la instalación y verificación de dependencias, se deben probar la aplicación, los datos de ejemplo y las integraciones externas. Los criterios de prueba deben documentarse. Los entornos existentes, junto con respaldos de la aplicación y datos, deben mantenerse hasta la aceptación. Solo después puede planificarse una transición controlada. Volver al entorno antiguo es solo una opción temporal y no restaura el soporte upstream.
Más información puede encontrarse en la documentación oficial: PEP 619, Documentación de venv, pip check.