Números de ejecución y compilación

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

En este artículo se explica cómo se crean los números de compilación y ejecución de Azure Pipelines y cómo se pueden personalizar en las canalizaciones.

El número de ejecución se usa para identificar una ejecución específica de una canalización o compilación. El número de compilación es sinónimo del número de ejecución.

Si no especifica un nombre de compilación en canalizaciones YAML o deja el campo Nombre en blanco en canalizaciones clásicas, la ejecución obtiene un entero único como nombre. Puede asignar a las ejecuciones nombres mucho más útiles y relevantes para su equipo. Puede usar una combinación de tokens, variables y caracteres de subrayado en los nombres de compilación.

name: $(TeamProject)_$(Build.DefinitionName)_$(SourceBranchName)_$(Date:yyyyMMdd)$(Rev:r)

steps:
  - script: echo '$(Build.BuildNumber)'

Número de ejecución

El valor predeterminado de un número de ejecución en Azure Pipelines es $(Date:yyyyMMdd).$(Rev:r). $(Rev:r) es un formato de variable especial que solo funciona en el campo número de compilación. Una vez completada una compilación, si no ha cambiado nada más en el número de compilación, el valor entero de Rev se incrementa en uno.

$(Rev:r) se restablece en 1 cuando cambia cualquier otra parte del número de compilación. Por ejemplo, si configura el formato de número de compilación como $(Build.DefinitionName)_$(Date:yyyyMMdd).$(Rev:r), el número de compilación se restablece cuando la fecha cambie.

Si el número de compilación anterior era MyBuild_20230621.1, el siguiente número de compilación ese día es MyBuild_20230621.2. Al día siguiente, el primer número de compilación es MyBuild_20230622.1.

$(Rev:r) también se restablece a 1 si cambia el número de compilación para indicar un cambio de versión. Por ejemplo, si el formato de compilación es 1.0.$(Rev:r) y el último número de compilación era 1.0.3, si cambia el número de compilación a 1.1.$(Rev:r), el siguiente número de compilación es 1.1.1.

Ejemplo

Tenga en cuenta los siguientes datos para una ejecución de compilación:

• Nombre del proyecto: Fabrikam
• Nombre de la canalización: CIBuild
• Rama: principal.
• Id. de compilación/Id. de ejecución: 752
• Fecha: 6 de mayo de 2024
• Hora: 9:07:03 PM
• Una ejecución completada anteriormente hoy.

Si especifica el siguiente formato de número de compilación, la segunda ejecución del 6 de mayo de 2024 se denomina Fabrikam_CIBuild_main_20240506.2.

$(TeamProject)_$(Build.DefinitionName)_$(SourceBranchName)_$(Date:yyyyMMdd).$(Rev:r)

Tokens

En la tabla siguiente se muestra cómo se resuelve cada token basándose en el ejemplo anterior. Estos tokens solo se pueden usar para definir números de ejecución. No funcionan en ningún otro lugar de una canalización.

Expresiones

Si usa una expresión para establecer el número de compilación, no puede usar algunos tokens porque sus valores no se establecen en el momento en el que se evalúan las expresiones. Estos tokens incluyen $(Build.BuildId), $(Build.BuildURL) y $(Build.BuildNumber).

Variables

Puede utilizar variables definidas por el usuario y predefinidas en el número de compilación. Por ejemplo, si ha definido My.Variable, puede especificar el siguiente formato de número:

$(Build.DefinitionName)_$(Build.DefinitionVersion)_$(Build.RequestedFor)_$(Build.BuildId)_$(My.Variable)

En el ejemplo anterior, las cuatro primeras variables están predefinidas. Para obtener información sobre cómo definir variables de usuario, consulte Establecimiento de variables en canalizaciones.

Preguntas más frecuentes

¿Qué tamaño puede tener un número de ejecución y qué caracteres puedo usar?

Los números de ejecución pueden tener hasta 255 caracteres. No se pueden usar los caracteres ", /, :, <, >, ', |, ?, @ o * y no se puede finalizar el número con ..

¿En qué zona horaria se expresan los valores de tiempo del número de compilación?

variables:
  - name: why
    ${{ if eq(variables['Build.Reason'], 'PullRequest') }}:
      value: pr
    ${{ elseif eq(variables['Build.Reason'], 'Manual' ) }}:
      value: manual
    ${{ elseif eq(variables['Build.Reason'], 'IndividualCI' ) }}:
      value: indivci
    ${{ else }}:
      value: other

name: $(TeamProject)_$(SourceBranchName)_$(why)_$(Date:yyyyMMdd).$(Rev:r)

pool:
  vmImage: 'ubuntu-latest'

steps:
- script: echo '$(Build.BuildNumber)'

# Set MyRunNumber
variables: 
  MyRunNumber: '1.0.0-CI+$(Build.BuildNumber)'

steps:
- script: echo $(MyRunNumber)
- script: echo $(Build.BuildNumber)

Contenido relacionado

Definición de variables