Establecimiento de directivas de retención para compilaciones, versiones y pruebas

Configuración de directivas de retención

1. Inicie sesión en el proyecto ( https://dev.azure.com/{yourorganization}/{yourproject} ).

2. Vaya al icono Configuración pestaña de la configuración del proyecto.

3. Seleccione Configuración Retención de versión enPipelinesRetención enProbar.

   • Seleccione Configuración directivas de retención para ejecuciones, artefactos, símbolos, datos adjuntos y ejecuciones de solicitudes de extracción.
   • Seleccione Retención de versión para configurar las directivas de retención de versiones y configurar cuándo eliminar o destruir permanentemente las versiones.
   • Seleccione Retención para configurar cuánto tiempo se mantendrán las ejecuciones de pruebas manuales y automatizadas.

   

Además de definir cuántos días se deben conservar las ejecuciones, también puede decidir el número mínimo de ejecuciones que se deben conservar para cada canalización.

1. Vaya al icono Configuración pestaña de la configuración del proyecto.

2. Seleccione Configuración en la sección Pipelines configuración.

   • Establezca el número de días que se conservarán los artefactos,los símbolos y los datos adjuntos.
   • Establecer el número de días para mantener las ejecuciones
   • Establecer el número de días para mantener las ejecuciones de solicitudes de extracción
   • Establecer el número de ejecuciones recientes que se mantienen para cada canalización

La configuración del número de ejecuciones recientes que se mantienen para cada canalización requiere una explicación más detallada. La interpretación de esta configuración varía en función del tipo de repositorio que compile en la canalización.

• Azure Repos: Azure Pipelines conserva siempre el número configurado de ejecuciones más recientes para la rama predeterminada y para cada rama protegida del repositorio. Una rama que tenga configuradas directivas de rama se considera una rama protegida. Por ejemplo, considere un repositorio con la rama predeterminada denominada main. Además, supongamos que la rama de versión de este repositorio tiene una directiva de rama. En este caso, si configuró la directiva para conservar tres ejecuciones, se conservan las tres ejecuciones más recientes de main, así como las tres últimas ejecuciones de la rama de versión. Además, también se conservan las tres últimas ejecuciones de esta canalización (independientemente de la rama).

  Para aclarar aún más esta lógica, supongamos que la lista de ejecuciones de esta canalización es la siguiente con la ejecución más reciente en la parte superior. En la tabla se muestran las ejecuciones que se conservarán si ha configurado para conservar las tres últimas ejecuciones (omitiendo el efecto de la configuración del número de días):

  Ejecutar #	Rama	Retenido/No retenido	¿Por qué?
  Ejecución 10	main (principal)	Retenido	Más reciente 3 para main
  Ejecución 9	branch1	Retenido	Más reciente 3 para la canalización
  Ejecución 8	branch2	Retenido	Más reciente 3 para la canalización
  Ejecución 7	main (principal)	Retenido	Más reciente 3 para main
  Ejecución 6	main (principal)	Retenido	Más reciente 3 para main
  Ejecución 5	main (principal)	No se conserva	Ni la versión más reciente 3 para main ni para la canalización
  Ejecución 4	main (principal)	No se conserva	Ni la versión más reciente 3 para main ni para la canalización
  Ejecución 3	branch1	No se conserva	Ni la versión más reciente 3 para main ni para la canalización
  Ejecutar 2	release	Retenido	Más reciente 3 para la versión
  Ejecución 1	main (principal)	No se conserva	Ni la versión más reciente 3 para main ni para la canalización

• Todos los demás repositorios de Git: Azure Pipelines el número configurado de ejecuciones más recientes para la rama predeterminada del repositorio y para toda la canalización.

• TFVC: Azure Pipelines el número configurado de ejecuciones más recientes para toda la canalización, independientemente de la rama.

Cuando las directivas de retención marcan una compilación para su eliminación, puede controlar qué información relacionada con la compilación se elimina:

• Registro de compilación: puede optar por eliminar todo el registro de compilación o mantener información básica sobre la compilación incluso después de eliminar la compilación.
• Etiqueta de origen: si etiqueta los orígenes como parte de la compilación, puede optar por eliminar la etiqueta (para Git) o la etiqueta (para TFVC) creada por una compilación.
• Resultados de pruebas automatizadas: puede optar por eliminar los resultados de prueba automatizados asociados a la compilación (por ejemplo, los resultados publicados por la tarea publicar Resultados de pruebas compilación).

La siguiente información se elimina cuando se elimina una compilación:

• Registros
• Artefactos publicados
• Símbolos publicados

La siguiente información se elimina cuando se elimina una ejecución:

• Registros
• Todos los artefactos de canalización y compilación
• Todos los símbolos
• Binarios
• Resultados de pruebas
• Ejecución de metadatos
• Etiquetas de origen (TFVC) o etiquetas (Git)

Los paquetes universales, NuGet, npm y otros paquetes no están asociados a la retención de canalizaciones.

Las directivas de retención se procesan una vez al día. El tiempo que las directivas obtienen variables procesadas porque se distribuye el trabajo a lo largo del día con fines de equilibrio de carga. No hay ninguna opción para cambiar este proceso.

Se elimina una ejecución si se cumplen todas las condiciones siguientes:

• Supera el número de días configurados en la configuración de retención.
• No es una de las ejecuciones recientes configuradas en la configuración de retención.
• No está marcado para conservarse indefinidamente
• No se conserva mediante una versión

Las directivas de retención se ejecutan todos los días a las 3:00 a. m. UTC. No hay ninguna opción para cambiar la hora en que se ejecutan las directivas.

Eliminación de una ejecución

Puede eliminar ejecuciones mediante el menú Más acciones de la página Detalles de ejecución de canalización.

La directiva de retención para YAML y las canalizaciones de compilación es la misma. Puede ver la configuración de retención de la canalización en Project Configuración para Pipelines en la Configuración configuración.

También puede aprender a personalizar estas directivas de forma paso a paso más adelante en este artículo.

Establecimiento de directivas de retención de nivel de recopilación

En el caso de los servidores locales, también puede establecer las directivas de retención de nivel de recopilación con reglas de retención personalizadas. Estas directivas de retención se aplican a las canalizaciones de compilación clásicas. La página en https://{your_server}/{collection_name}/_settings/buildqueue rige los valores máximos y los valores predeterminados.

Directivas de retención específicas de la fase

Es posible que desee conservar más versiones que se han implementado en fases específicas. Por ejemplo, es posible que el equipo desee conservar:

• Versiones implementadas en la fase de producción durante 60 días, con un mínimo de tres últimas versiones implementadas.
• Versiones implementadas en la fase de preproducción durante 15 días, con un mínimo de una última versión implementada.
• Versiones implementadas en la fase de control de calidad durante 30 días, con un mínimo de dos últimas versiones implementadas.
• Versiones implementadas en la fase de desarrollo durante 10 días, con un mínimo de una última versión implementada.

La siguiente directiva de retención de ejemplo para una canalización de versión cumple los requisitos anteriores:

En este ejemplo, si una versión que se implementa en Dev no se promueve a QA durante 10 días, es un posible candidato para la eliminación. Sin embargo, si esa misma versión se implementa en QA ocho días después de implementarse en Dev, su temporizador de retención se restablece y se conserva en el sistema durante otros 30 días.

Al especificar directivas personalizadas por canalización, no puede superar los límites máximos establecidos por el administrador.

Interacción entre las directivas de retención de compilación y versión

La compilación vinculada a una versión tiene su propia directiva de retención, que puede ser más corta que la de la versión. Si desea conservar la compilación durante el mismo período que la versión, establezca la casilla Conservar artefactos asociados para las fases adecuadas. Esto invalida la directiva de retención para la compilación y garantiza que los artefactos estén disponibles si necesita volver a implementar esa versión.

Al eliminar una canalización de versión, eliminar una versión o cuando la directiva de retención elimina una versión automáticamente, la directiva de retención de la compilación asociada determinará cuándo se elimina esa compilación.

Establecer directivas de retención de pruebas

Puede establecer directivas de ejecución de pruebas manuales y automatizadas.

Directivas de retención de ejecuciones de pruebas manuales

Para eliminar los resultados de pruebas manuales después de un número específico de días, establezca el límite de retención en el nivel de proyecto. Azure DevOps los resultados de pruebas manuales relacionados con las compilaciones, incluso después de eliminar esas compilaciones. De este modo, las directivas de compilación no eliminan los resultados de las pruebas antes de poder analizar los datos.

1. Inicie sesión en el Azure DevOps. Necesitará al menos permisos de administrador del proyecto.

2. Vaya al proyecto y, a continuación, seleccione proyecto del icono de engranaje en la parte inferior de la página.

3. En la página Retención de la sección Prueba, seleccione un límite para el tiempo que desea conservar los datos de prueba manual.

Directivas de retención de ejecuciones de prueba automatizadas

De forma predeterminada, Azure DevOps los resultados de pruebas automatizados relacionados con las compilaciones solo mientras mantenga esas compilaciones. Para mantener los resultados de las pruebas después de eliminar las compilaciones, edite la directiva de retención de compilación. Si usa Git para el control de versiones, puede especificar cuánto tiempo se deben mantener los resultados de las pruebas automatizadas en función de la rama.

1. Inicie sesión en Azure DevOps. Necesitará al menos permisos de nivel de compilación para editar canalizaciones de compilación.

2. Vaya al proyecto y, a continuación, seleccione proyecto del icono de engranaje en la parte inferior de la página.

3. Seleccione engranaje Configuración en Pipelines y modifique las directivas de retención.

Otros resultados de pruebas automatizadas

Para limpiar los resultados de pruebas automatizadas que se han dejado de las compilaciones eliminadas o los resultados de pruebas que no están relacionados con las compilaciones, por ejemplo, los resultados publicados desde sistemas de prueba externos, establezca los límites de retención en el nivel de proyecto como se muestra en Directivas de retención manual de ejecuciones de pruebas.

Establecimiento de directivas de retención de artefactos

Puede establecer directivas de retención de artefactos para las ejecuciones de canalización en la configuración de canalización.

1. Inicie sesión en el proyecto ( https://dev.azure.com/{yourorganization}/{yourproject} ).

2. Vaya a en el icono engranaje Configuración pestaña de la configuración del proyecto.

3. Seleccione Configuración en Pipelines.

4. Editar días para mantener artefactos, símbolos y datos adjuntos.

Uso de la tarea Copiar archivos para guardar los datos durante más tiempo

Puede usar la tarea Copiar archivos para guardar los datos de compilación y artefacto durante más tiempo del que se establece en las directivas de retención. La tarea Copiar archivos es preferible a la tarea Publicar compilación Artifacts porque los datos guardados con la tarea Publicar compilación Artifacts se limpiarán y eliminarán periódicamente.

- task: CopyFiles@2
  displayName: 'Copy Files to: \\mypath\storage\$(Build.BuildNumber)'
  inputs:
    SourceFolder: '$(Build.SourcesDirectory)'
    Contents: '_buildOutput/**'
    TargetFolder: '\\mypath\storage\$(Build.BuildNumber)'

También puede personalizar estas directivas rama a rama si va a compilar desde repositorios de Git.

Directiva de retención de compilación global

Puede especificar valores predeterminados y máximos de la directiva de retención de compilación para una colección de proyectos. También puede especificar cuándo se destruyen las compilaciones de forma permanente (se quitan de la pestaña Eliminados del explorador de compilación).

• TFS 2017 y versiones más recientes: https://{your_server}/tfs/DefaultCollection/_admin/_buildQueue

• TFS 2015.3: http://{your_server}:8080/tfs/DefaultCollection/_admin/_buildQueue

• TFS 2015 RTM: http://{your_server}:8080/tfs/DefaultCollection/_admin/_buildQueue#_a=settings

La directiva de retención máxima establece el límite superior para cuánto tiempo se pueden conservar las ejecuciones para todas las canalizaciones de compilación. Los autores de canalizaciones de compilación no pueden configurar valores para sus definiciones más allá de los valores especificados aquí.

La directiva de retención predeterminada establece los valores de retención predeterminados para todas las canalizaciones de compilación. Los autores de canalizaciones de compilación pueden invalidar estos valores.

Las versiones de destrucción permanente le ayudan a mantener las ejecuciones durante un determinado período de tiempo después de que se eliminen. Esta directiva no se puede invalidar en canalizaciones de compilación individuales.

Repositorios Git

Si el tipo de repositorio es uno de los siguientes, puede definir varias directivas de retención con filtros de rama:

• Azure Repos Git o GIT de TFS.
• GitHub.
• Git externo o de otro tipo.

Por ejemplo, es posible que el equipo desee conservar:

• La rama de usuario se compila durante cinco días, con un mínimo de una única compilación correcta o parcialmente correcta para cada rama.
• Compilaciones de rama principal y de características durante 10 días, con un mínimo de tres compilaciones correctas o parcialmente correctas para cada una de estas ramas. Excluya una rama de características especial que desee conservar durante un período de tiempo más largo.
• Se compila a partir de la rama de características especiales y todas las demás ramas durante 15 días, con un mínimo de una única compilación correcta o parcialmente correcta para cada rama.

La siguiente directiva de retención de ejemplo para una canalización de compilación cumple los requisitos anteriores:

Al especificar directivas personalizadas para cada canalización, no se pueden superar los límites máximos establecidos por el administrador.

Limpieza de compilaciones de solicitudes de extracción

Si protege las ramas de Gitcon compilaciones de solicitud de extracción, puede usar directivas de retención para eliminar automáticamente las compilaciones completadas. Para ello, agregue una directiva que mantenga un mínimo de 0 compilaciones con el siguiente filtro de rama:

  refs/pull/*

Repositorios TFVC y Subversion

Para los tipos de repositorio TFVC y Subversion, puede modificar una sola directiva con las mismas opciones mostradas anteriormente.

Orden de la directiva

Cuando el sistema purga compilaciones antiguas, evalúa cada compilación con las directivas en el orden especificado. Puede arrastrar y colocar una directiva más abajo o superior en la lista para cambiar este orden.

La directiva de ramas "Todas" se agrega automáticamente como la última directiva en el orden de evaluación para aplicar los límites máximos para todas las demás ramas.

Cómo conservar mis etiquetas o etiquetas de control de versiones?

Si es necesario conservar etiquetas o etiquetas de control de versiones, incluso cuando se elimina la compilación, se deben aplicar como parte de una tarea de la canalización, etiquetarse manualmente fuera de la canalización o la compilación deberá conservarse indefinidamente.