Spouštění skriptů pro různé platformy

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

S Azure Pipelines můžete spouštět buildy na počítačích s macOS, Linuxem a Windows. Pokud vyvíjíte na multiplatformních technologiích, jako jsou .NET Core, Node.js a Python, přináší tyto funkce výhody i výzvy.

Většina kanálů například obsahuje jeden nebo více skriptů, které chcete spustit během procesu sestavení. Skripty se ale často nespouštějí stejným způsobem na různých platformách. Pomocí klávesové zkratky klíčového slova můžete script usnadnit psaní skriptů a také můžete použít podmínky pro cílení na konkrétní platformy s vašimi skripty.

Spuštění nástrojů pro různé platformy pomocí kroku skriptu

Klíčové slovo skriptu je zkratka pro úlohu příkazového řádku. Klíčové script slovo spouští Bash v Linuxu a macOS a cmd.exe ve Windows.

Použití script může být užitečné, když úkol právě předává argumenty nástroji pro různé platformy. Volání pomocí sady argumentů lze například npm snadno provést pomocí script kroku. script běží v interpretu nativních skriptů jednotlivých platforem: Bash v systému macOS a Linux cmd.exe ve Windows.

YAML

steps:
- script: |
    npm install
    npm test

Klasické

1. Přidejte do kanálu úlohu příkazového řádku .

2. Text skriptu nahraďte:

   npm install
   npm test
   

Zpracování proměnných prostředí

Proměnné prostředí hází první vrásku do psaní skriptů pro různé platformy. Příkazový řádek, PowerShell a Bash mají různé způsoby čtení proměnných prostředí. Pokud potřebujete získat přístup k hodnotě poskytované operačním systémem, jako je PATH, budete potřebovat různé techniky pro každou platformu.

Azure Pipelines ale nabízí multiplatformní způsob, jak odkazovat na proměnné, které zná volanou syntaxi maker. Když název $( )proměnné obklopíte , rozbalí se předtím, než ho prostředí platformy uvidí. Pokud například chcete vyhlásit ID kanálu, je pro různé platformy vhodný následující skript:

YAML

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

To funguje také pro proměnné, které zadáte v kanálu.

variables:
  Example: 'myValue'

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

Klasické

1. Přidejte do kanálu úlohu příkazového řádku .

2. Text skriptu nahraďte:

   echo This is pipeline $(System.DefinitionId)
   

Zvažte Bash nebo pwsh.

Pokud máte složitější skriptovací potřeby než výše uvedené příklady, zvažte jejich napsání v Bashu. Většina agentů pro macOS a Linux má Bash jako dostupné prostředí a agenti Windows zahrnují Git Bash nebo Subsystém Windows pro Linux Bash.

Pro Azure Pipelines mají agenti hostovaní Microsoftem vždy k dispozici Bash.

Pokud například potřebujete rozhodnout o tom, jestli je sestavení aktivované žádostí o přijetí změn:

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

Klasické

1. Přidejte do kanálu úlohu Bash.

2. Jako typ vyberte Vložený.

3. Text skriptu nahraďte:

   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) je také možnost. Vyžaduje, aby každý agent měl nainstalovaný PowerShell Core.

Přepínač založený na platformě

Obecně doporučujeme, abyste se vyhnuli skriptům specifickým pro platformu, abyste se vyhnuli problémům, jako je duplikování logiky kanálu. Duplikace způsobuje nadbytečnou práci a riziko chyb. Pokud ale neexistuje způsob, jak se vyhnout skriptování specifické pro platformu, můžete pomocí nástroje zjistit, jakou platformu condition používáte.

Předpokládejme například, že z nějakého důvodu potřebujete IP adresu agenta sestavení. Ve Windows ipconfig získá informace. V macOS je to ifconfig. A v Ubuntu Linuxu ip addrje to .

Nastavte níže uvedený kanál a zkuste ho spustit s agenty na různých platformách.

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)

Klasické

Nejprve přidejte linuxový skript.

1. Přidejte do kanálu úlohu Bash.

2. Nastavte typ na vložený.

3. Text skriptu nahraďte:

   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. Změňte hodnotu Spustit tuto úlohu na Vlastní podmínky.

5. Do pole Vlastní podmínka, které se zobrazí, zadejte "eq( variables['Agent.OS'], 'Linux' )".

Dále přidejte skript macOS.

1. Zopakujte výše uvedené kroky, ale pro text skriptu zadejte:

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

2. Jako vlastní podmínku zadejte "eq( variables['Agent.OS'], 'Darwin' )".

Dále přidejte skript systému Windows.

1. Přidejte do kanálu úlohu PowerShellu.

2. Nastavte typ na vložený.

3. Text skriptu nahraďte:

   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. Změňte hodnotu Spustit tuto úlohu na Vlastní podmínky.

5. Do pole Vlastní podmínka, které se zobrazí, zadejte "eq( variables['Agent.OS'], 'Windows_NT' )".

Nakonec přidejte úkol, který používá hodnotu bez ohledu na to, jak jsme ji získali.

1. Přidejte do kanálu úlohu příkazového řádku .

2. Text úkolu nahraďte:

   echo The IP address is $(IP_ADDR)