Platformfüggetlen szkriptek futtatása

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

Az Azure Pipelines segítségével macOS, Linux és Windows rendszerű gépeken futtathatja a buildeket. Ha olyan platformfüggetlen technológiákon fejleszt, mint a .NET Core, a Node.js és a Python, ezek a képességek előnyöket és kihívásokat is jelentenek.

A legtöbb folyamat például egy vagy több szkriptet tartalmaz, amelyet a buildelési folyamat során futtatni szeretne. A szkriptek azonban gyakran nem ugyanúgy futnak különböző platformokon. A kulcsszó-parancsikon használatával script egyszerűbbé teheti a szkriptek írását, és feltételeket is használhat adott platformok megcélzásához a szkriptekkel.

Platformfüggetlen eszközök futtatása szkriptlépéssel

A szkript kulcsszó a parancssori feladat parancsikonja. A script kulcsszó Linuxon, macOS-en és windowsos cmd.exe futtatja a Basht.

A használat script akkor lehet hasznos, ha a feladat csak egy platformfüggetlen eszköznek adja át az argumentumokat. Egy lépéssel például npm egyszerűen hívható script meg egy argumentumkészlettel. script Az egyes platformok natív szkript-értelmezőjében fut: Bash macOS és Linux rendszeren, cmd.exe Windows rendszeren.

YAML

steps:
- script: |
    npm install
    npm test

Klasszikus

1. Adjon hozzá parancssori feladatot a folyamathoz.

2. Cserélje le a szkript törzsét a következőre:

   npm install
   npm test
   

Környezeti változók kezelése

A környezeti változók az első ráncot a platformfüggetlen szkriptek írására vetik. A parancssor, a PowerShell és a Bash különböző módokon olvashatók a környezeti változókban. Ha hozzá kell férnie egy operációs rendszer által biztosított értékhez, például a PATH-hoz, platformonként különböző technikákra lesz szüksége.

Az Azure Pipelines azonban platformfüggetlen módot kínál a makrószintaxisról ismert változókra való hivatkozásra. Ha körülvesz egy változónevet $( ), az ki van bontva, mielőtt a platform rendszerhéja valaha is látni látná. Ha például vissza szeretné adni a folyamat azonosítóját, a következő szkript platformfüggetlen:

YAML

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

Ez a folyamat által megadott változók esetében is működik.

variables:
  Example: 'myValue'

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

Klasszikus

1. Adjon hozzá parancssori feladatot a folyamathoz.

2. Cserélje le a szkript törzsét a következőre:

   echo This is pipeline $(System.DefinitionId)
   

Fontolja meg a Basht vagy a pwsh-t

Ha összetettebb szkriptelési igényei vannak, mint a fent bemutatott példák, fontolja meg a Bashben való írást. A legtöbb macOS- és Linux-ügynök rendelkezik Bash-lel elérhető rendszerhéjként, a Windows-ügynökök közé tartozik a Git Bash vagy Linuxos Windows-alrendszer Bash.

Az Azure Pipelines esetében a Microsoft által üzemeltetett ügynökök mindig elérhetők a Bash használatával.

Ha például döntést kell hoznia arról, hogy a buildet egy lekéréses kérelem aktiválja-e:

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

Klasszikus

1. Bash-feladat hozzáadása a folyamathoz.

2. A Típus mezőben válassza a Beágyazott elemet.

3. Cserélje le a szkript törzsét a következőre:

   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
   

A PowerShell Core (pwsh) szintén lehetőség. Minden ügynöknek telepítve kell lennie a PowerShell Core-nak.

Váltás platform alapján

Általában azt javasoljuk, hogy kerülje a platformspecifikus szkripteket, hogy elkerülje az olyan problémákat, mint a folyamatlogika duplikálása. A duplikáció többletmunkát és a hibák fokozott kockázatát okozza. Ha azonban nincs mód a platformspecifikus szkriptek elkerülésére, akkor a használatával észlelheti condition , hogy melyik platformon van.

Tegyük fel például, hogy valamilyen okból szüksége van a buildügynök IP-címére. Windows ipconfig rendszeren lekéri ezeket az információkat. MacOS rendszeren ez a .ifconfig És az Ubuntu Linuxon ez .ip addr

Állítsa be az alábbi folyamatot, majd próbálja meg futtatni az ügynökökön különböző platformokon.

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)

Klasszikus

Először adjon hozzá egy Linux-szkriptet.

1. Bash-feladat hozzáadása a folyamathoz.

2. Állítsa be a típust beágyazottra.

3. Cserélje le a szkript törzsét a következőre:

   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. Módosítsa a feladat futtatásának értékét "Egyéni feltételek" értékre.

5. A megjelenő Egyéni feltétel mezőben adja meg az "eq( változók;Agent.OS", "Linux" )" értéket.

Ezután vegyen fel egy macOS-szkriptet.

1. Ismételje meg a fenti lépéseket, de a szkript törzséhez írja be a következőt:

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

2. Az egyéni feltételhez adja meg az "eq( változók;Agent.OS", "Darwin" )" értéket.

Ezután vegyen fel egy Windows-szkriptet.

1. PowerShell-feladat hozzáadása a folyamathoz.

2. Állítsa be a típust beágyazottra.

3. Cserélje le a szkript törzsét a következőre:

   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. Módosítsa a feladat futtatásának értékét "Egyéni feltételek" értékre.

5. A megjelenő Egyéni feltétel mezőben adja meg az "eq( változók;Agent.OS", "Windows_NT" )" értéket.

Végül adjon hozzá egy olyan feladatot, amely az értéket használja, függetlenül attól, hogy hogyan szereztük be.

1. Adjon hozzá parancssori feladatot a folyamathoz.

2. Cserélje le a feladat törzsét a következőre:

   echo The IP address is $(IP_ADDR)