Introducción
Azure DevOps anunció la obsolescencia de las políticas de check-in heredadas de Team Foundation Version Control (TFVC) debido a limitaciones en su implementación y almacenamiento. Estas políticas, que han sido una parte fundamental de los flujos de trabajo de control de versiones, ahora deben ser reemplazadas por alternativas modernas y compatibles.
Este artículo explica cómo identificar y eliminar las políticas obsoletas en TFVC, y cómo configurar las políticas actualizadas para garantizar la continuidad de los procesos en Azure DevOps.
¿Qué son las políticas de check-in en TFVC?
Las políticas de check-in son reglas que se aplican antes de realizar un commit en TFVC. Estas aseguran que el código cumpla con ciertos estándares antes de integrarse en el repositorio. Ejemplos comunes incluyen:
- Requerir comentarios en los cambios.
- Validar que el código pase pruebas unitarias.
- Asegurar que se adjunten work items a los cambios.
Con la transición hacia políticas modernas, es esencial entender cómo estas reglas han evolucionado y cómo migrar eficientemente.
Identificación de políticas obsoletas
Las políticas obsoletas en TFVC están marcadas como “deprecated” en Azure DevOps. Para identificarlas, sigue estos pasos:
Paso 1: Acceder a la configuración del repositorio
- Ve al proyecto en Azure DevOps.
- Navega a Repositorios > TFVC.
- Selecciona la opción Policies.
Paso 2: Revisar las políticas configuradas
En la lista de políticas configuradas, las políticas obsoletas estarán marcadas con un aviso de “Obsolete”. Estas políticas ya no reciben soporte y deben ser reemplazadas.
Warning: No ignorar las políticas obsoletas. Su uso puede generar errores en futuros commits y afectar la integridad del repositorio.
Migración a políticas modernas
Para reemplazar las políticas obsoletas, Azure DevOps ofrece alternativas actualizadas que garantizan compatibilidad y mejor rendimiento. Aquí tienes un ejemplo práctico para migrar una política de validación de comentarios.
Ejemplo: Migrar la política “Check for Comments”
La política “Check for Comments” verifica que cada check-in incluya un comentario. Su versión obsoleta puede ser reemplazada por una política moderna basada en extensiones.
Paso 1: Instalar la extensión de política moderna
Azure DevOps Marketplace ofrece extensiones que implementan políticas actualizadas. Para instalar una extensión:
# Desde la interfaz web de Azure DevOps:
1. Ve a **Extensions** en el menú principal.
2. Busca "Check-in Comments Policy".
3. Instala la extensión en tu organización.
Paso 2: Configurar la política moderna
Una vez instalada la extensión, configúrala desde la sección de políticas:
# Ejemplo de configuración de política moderna
policies:
- name: "Check-in Comments Policy"
enabled: true
parameters:
requireComments: true
Note: La configuración puede variar según la extensión utilizada. Consulta la documentación de la extensión para detalles precisos.
Ejemplo práctico: Validación de work items
Otra política común es la validación de work items asociados a los cambios. En este caso, la migración implica configurar una política moderna que asegure que cada check-in esté vinculado a un work item.
Configuración de la política moderna
- Instala la extensión “Work Item Link Policy” desde el Marketplace.
- Configura la política en el repositorio:
# Configuración de política de work items
policies:
- name: "Work Item Link Policy"
enabled: true
parameters:
requireWorkItems: true
Esta política garantiza que cada cambio esté vinculado a un elemento de trabajo, mejorando la trazabilidad.
Eliminación de políticas obsoletas
Una vez configuradas las políticas modernas, es importante eliminar las políticas obsoletas para evitar conflictos. Sigue estos pasos:
Paso 1: Deshabilitar la política obsoleta
Desde la configuración del repositorio:
- Identifica la política obsoleta.
- Haz clic en Disable para desactivarla.
Paso 2: Eliminar la política
Una vez deshabilitada, selecciona Delete para eliminarla completamente.
Warning: Asegúrate de que la política moderna esté funcionando correctamente antes de eliminar la obsoleta.
Verificación y pruebas
Después de migrar y eliminar las políticas obsoletas, verifica que las nuevas políticas funcionen correctamente. Realiza pruebas de check-in para confirmar que las reglas se aplican como se espera.
Ejemplo de prueba
- Realiza un cambio en el código.
- Intenta hacer un check-in sin cumplir las políticas configuradas.
- Confirma que el sistema rechaza el check-in con un mensaje de error.
# Mensaje esperado al incumplir la política
Error: Check-in rejected. Please add a comment to your changes.
Conclusión
La eliminación de políticas obsoletas en TFVC es un paso crítico para garantizar la compatibilidad y el rendimiento en Azure DevOps. Migrar a políticas modernas no solo asegura la continuidad de los procesos, sino que también mejora la flexibilidad y la capacidad de personalización.
Si aún no has comenzado la transición, ahora es el momento. Aprovecha las herramientas y extensiones disponibles en Azure DevOps para mantener tus repositorios actualizados y funcionales.
Note: Si tienes dudas sobre la configuración de políticas modernas, revisa la documentación oficial de Azure DevOps.