Scripts multiplataforma

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

Con Azure Pipelines, puede ejecutar compilaciones en máquinas macOS, Linux y Windows. Si desarrolla tecnologías multiplataforma, como .NET Core, Node.js y Python, estas funcionalidades aportan ventajas y retos.

Por ejemplo, la mayoría de las canalizaciones incluyen uno o varios scripts que querrá ejecutar durante el proceso de compilación. Pero los scripts a menudo no se ejecutan de la misma manera en las distintas plataformas. Puede usar el acceso directo de palabras clave script para facilitar la escritura de scripts y también puede usar condiciones para dirigirse a plataformas específicas con los scripts.

Ejecución de herramientas multiplataforma con un paso de script

La palabra clave script es un método abreviado de la tarea de línea de comandos. La palabra clave script ejecuta Bash en Linux y macOS y cmd.exe en Windows.

El uso de script puede ser útil cuando la tarea simplemente pasa argumentos a una herramienta multiplataforma. Por ejemplo, la llamada a npm con un conjunto de argumentos se puede realizar fácilmente con un paso script. script se ejecuta en el intérprete de scripts nativos de cada plataforma: Bash en macOS y Linux, cmd.exe en Windows.

YAML

steps:
- script: |
    npm install
    npm test

Clásico

1. Agregue una tarea Línea de comandos a la canalización.

2. Reemplace el cuerpo del script por:

   npm install
   npm test
   

Control de las variables de entorno

Las variables de entorno plantean el primer problema a la hora de escribir scripts multiplataforma. La línea de comandos, PowerShell y Bash tienen diferentes formas de leer variables de entorno. Si necesita acceder a un valor proporcionado por el sistema operativo como PATH, necesitará diferentes técnicas por cada plataforma.

Sin embargo, Azure Pipelines ofrece una manera multiplataforma de hacer referencia a las variables que conoce que llamada sintaxis de macros. Al rodear un nombre de variable en $( ), se expandirá antes de que el shell de la plataforma lo vea. Por ejemplo, si quiere obtener el identificador de la canalización, el siguiente script es compatible con todas las plataformas:

YAML

steps:
- script: echo This is pipeline $(System.DefinitionId)

Esto también funciona con variables que especifique en la canalización.

variables:
  Example: 'myValue'

steps:
- script: echo The value passed in is $(Example)

Clásico

1. Agregue una tarea Línea de comandos a la canalización.

2. Reemplace el cuerpo del script por:

   echo This is pipeline $(System.DefinitionId)
   

Consideración de Bash o pwsh

Si tiene necesidades de scripting más complejas que los ejemplos mostrados anteriormente, considere la posibilidad de escribirlos en Bash. La mayoría de los agentes de macOS y Linux tienen Bash como shell disponible y los agentes de Windows incluyen Bash de GIT o Bash de Subsistema de Windows para Linux.

En Azure Pipelines, los agentes hospedados por Microsoft siempre tienen Bash disponible.

Por ejemplo, si necesita tomar una decisión sobre si la compilación se desencadena mediante una solicitud de incorporación de cambios:

YAML

trigger:
    batch: true
    branches:
        include:
        - main
steps:
- bash: |
    echo "Hello world from $AGENT_NAME running on $AGENT_OS"
    case $BUILD_REASON in
            "Manual") echo "$BUILD_REQUESTEDFOR manually queued the build." ;;
            "IndividualCI") echo "This is a CI build for $BUILD_REQUESTEDFOR." ;;
            "BatchedCI") echo "This is a batched CI build for $BUILD_REQUESTEDFOR." ;;
        *) $BUILD_REASON ;;
    esac
  displayName: Hello world

Clásico

1. Agregue una tarea de Bash a la canalización.

2. En Tipo, seleccione "Insertado".

3. Reemplace el cuerpo del script por:

   if [ -n "$SYSTEM_PULLREQUEST_PULLREQUESTNUMBER" ]; then
    echo This is for pull request $SYSTEM_PULLREQUEST_PULLREQUESTNUMBER
   else
    echo This is not a pull request build. The trigger was $BUILD_REASON
   fi
   

PowerShell Core (pwsh) también es una opción. Requiere que cada agente tenga Instalado PowerShell Core.

Cambio basado en la plataforma

En general, se recomienda evitar scripts específicos de la plataforma para evitar problemas como la duplicación de la lógica de canalización. La duplicación provoca trabajo adicional y riesgo adicional de errores. Sin embargo, si no hay ninguna manera de evitar el scripting específico de la plataforma, puede usar un elemento condition para detectar la plataforma en la que se encuentra.

Por ejemplo, supongamos que, por algún motivo, necesita la dirección IP del agente de compilación. En Windows, ipconfig obtiene esa información. En macOS, es ifconfig. Y en Ubuntu Linux, es ip addr.

Configure la canalización siguiente y, luego, intente ejecutarla en agentes en distintas plataformas.

YAML

steps:
# Linux
- bash: |
    export IPADDR=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1  -d'/')
    echo "##vso[task.setvariable variable=IP_ADDR]$IPADDR"
  condition: eq( variables['Agent.OS'], 'Linux' )
  displayName: Get IP on Linux
# macOS
- bash: |
    export IPADDR=$(ifconfig | grep 'en0' -A3 | grep inet | tail -n1 | awk '{print $2}')
    echo "##vso[task.setvariable variable=IP_ADDR]$IPADDR"
  condition: eq( variables['Agent.OS'], 'Darwin' )
  displayName: Get IP on macOS
# Windows
- powershell: |
    Set-Variable -Name IPADDR -Value ((Get-NetIPAddress | ?{ $_.AddressFamily -eq "IPv4" -and !($_.IPAddress -match "169") -and !($_.IPaddress -match "127") } | Select-Object -First 1).IPAddress)
    Write-Host "##vso[task.setvariable variable=IP_ADDR]$IPADDR"
  condition: eq( variables['Agent.OS'], 'Windows_NT' )
  displayName: Get IP on Windows

# now we use the value, no matter where we got it
- script: |
    echo The IP address is $(IP_ADDR)

Clásico

En primer lugar, agregue un script de Linux.

1. Agregue una tarea de Bash a la canalización.

2. Establezca el valor Tipo en "Insertado".

3. Reemplace el cuerpo del script por:

   export IPADDR=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1  -d'/')
   echo ##vso[task.setvariable variable=IP_ADDR]$IPADDR
   

4. Cambie el valor de Ejecutar esta tarea por "Condiciones personalizadas".

5. En el campo Condición personalizada que aparece, escriba "eq( variables['Agent.OS'], 'Linux' )".

A continuación, agregue un script de macOS.

1. Repita los pasos anteriores, pero para el cuerpo del script, escriba:

   export IPADDR=$(ifconfig | grep 'en0' -A3 | tail -n1 | awk '{print $2}')
   echo ##vso[task.setvariable variable=IP_ADDR]$IPADDR
   

2. En Condición personalizada, escriba "eq( variables['Agent.OS'], 'Darwin' )".

A continuación, agregue un script de Windows.

1. Agregue una tarea PowerShell a la canalización.

2. Establezca el valor Tipo en "Insertado".

3. Reemplace el cuerpo del script por:

   Set-Variable -Name IPADDR -Value (Get-NetIPAddress | ?{ $_.AddressFamily -eq "IPv4" -and !($_.IPAddress -match "169") -and !($_.IPaddress -match "127") }).IPAddress
   Write-Host ##vso[task.setvariable variable=IP_ADDR]$env:IPADDR
   

4. Cambie el valor de Ejecutar esta tarea por "Condiciones personalizadas".

5. En el campo Condición personalizada que aparece, escriba "eq( variables['Agent.OS'], 'Windows_NT' )".

Por último, agregue una tarea que use el valor, independientemente de cómo lo obtengamos.

1. Agregue una tarea Línea de comandos a la canalización.

2. Reemplace el cuerpo de la tarea con:

   echo The IP address is $(IP_ADDR)