執行跨平臺腳本

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

使用 Azure Pipelines 時，您可以在 macOS、Linux 和 Windows 機器上執行組建。 如果您在 .NET Core、Node.js 和 Python 等跨平臺技術上進行開發，這些功能會帶來優點和挑戰。

例如，大部分管線都包含您想要在建置程式期間執行的一或多個腳本。 但在不同的平臺上，腳本通常不會以相同方式執行。 您可以使用 script 關鍵詞快捷方式，讓撰寫腳本更容易，也可以使用條件來搭配腳本以特定平台為目標。

使用腳本步驟執行跨平臺工具

script 關鍵詞是命令行工作的快捷方式。 關鍵詞會在 script Linux和macOS上執行Bash，並在Windows上執行cmd.exe。

當您的工作剛將自變數傳遞至跨平臺工具時，使用 script 會很有用。 例如，使用一組自變數呼叫 npm ，即可透過步驟輕鬆完成 script 。 script 在每個平臺的原生腳本解釋器中執行：macOS 和 Linux 上的 Bash，cmd.exe Windows。

YAML

steps:
- script: |
    npm install
    npm test

傳統

1. 將 命令行 工作新增至管線。

2. 將文稿的主體取代為：

   npm install
   npm test
   

處理環境變數

環境變數會擲回第一個摺痕，以撰寫跨平臺腳本。 命令行、PowerShell 和Bash各有不同的讀取環境變數方式。 如果您需要存取PATH之類的操作系統提供值，則每個平臺都需要不同的技術。

不過，Azure Pipelines 提供跨平臺方式來參考其知道的稱為 宏語法的變數。 藉由圍繞 中的 $( )變數名稱，它會在平臺殼層看到它之前展開。 例如，如果您想要回應管線的標識碼，下列腳本是跨平臺易記的：

YAML

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

這也適用於您在管線中指定的變數。

variables:
  Example: 'myValue'

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

傳統

1. 將 命令行 工作新增至管線。

2. 將文稿的主體取代為：

   echo This is pipeline $(System.DefinitionId)
   

考慮Bash或 pwsh

如果您有比上述範例更複雜的腳本需求，請考慮在Bash中撰寫這些腳本。 大部分的macOS和Linux代理程式都有Bash作為可用的殼層，而 Windows 代理程式包含 Git Bash 或 Windows 子系統 Linux 版 Bash。

針對 Azure Pipelines，Microsoft 裝載的代理程式一律有 Bash 可用。

例如，如果您需要決定您的組建是否由提取要求觸發：

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

傳統

1. 將 Bash 工作新增至管線。

2. 針對 [ 類型]，選取 [內嵌]。

3. 將文稿的主體取代為：

   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） 也是一個選項。 它要求每個代理程式都已安裝PowerShell Core。

根據平臺切換

一般而言，建議您避免平臺特定的腳本，以避免管線邏輯重複等問題。 重複會導致額外的工作和錯誤的額外風險。 不過，如果沒有辦法避免平臺特定的腳本，您可以使用 condition 來偵測您正在使用的平臺。

例如，假設基於某些原因，您需要組建代理程式的IP位址。 在 Windows 上， ipconfig 取得該資訊。 在macOS上，它是 ifconfig。 在 Ubuntu Linux 上，它是 ip addr。

設定下列管線，然後嘗試對不同平臺上的代理程序執行它。

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)

傳統

首先，新增Linux腳本。

1. 將 Bash 工作新增至管線。

2. 將 [ 類型 ] 設定為 [內嵌]。

3. 將文稿的主體取代為：

   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. 將 [執行此工作] 的值變更為 [自定義條件]。

5. 在出現的 [ 自定義條件] 字段中，輸入 “eq（ variables['Agent.OS']， 'Linux' ）”。

接下來，新增macOS腳本。

1. 重複上述步驟，但針對腳本主體，輸入：

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

2. 針對 [ 自定義條件]，輸入 “eq（ variables['Agent.OS']， 'Darwin' ）”。

接下來，新增 Windows 腳本。

1. 將 PowerShell 工作新增至管線。

2. 將 [ 類型 ] 設定為 [內嵌]。

3. 將文稿的主體取代為：

   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. 將 [執行此工作] 的值變更為 [自定義條件]。

5. 在出現的 [ 自定義條件] 字段中，輸入 “eq（ variables['Agent.OS']， 'Windows_NT' ）”。

最後，新增使用 值的工作，無論我們是如何取得的。

1. 將 命令行 工作新增至管線。

2. 將工作的本文取代為：

   echo The IP address is $(IP_ADDR)