Menjalankan skrip lintas platform

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dengan Azure Pipelines, Anda dapat menjalankan build di komputer macOS, Linux, dan Windows. Jika Anda mengembangkan teknologi lintas platform seperti .NET Core, Node.js dan Python, kemampuan ini membawa manfaat dan tantangan.

Misalnya, sebagian besar alur menyertakan satu atau beberapa skrip yang ingin Anda jalankan selama proses build. Tetapi skrip sering tidak berjalan dengan cara yang sama pada platform yang berbeda. Anda dapat menggunakan script pintasan kata kunci untuk membuat penulisan skrip lebih mudah dan juga dapat menggunakan kondisi untuk menargetkan platform tertentu dengan skrip Anda.

Menjalankan alat lintas platform dengan langkah skrip

Kata kunci skrip adalah pintasan untuk tugas baris perintah. Kata script kunci menjalankan Bash di Linux dan macOS dan cmd.exe di Windows.

Menggunakan script dapat berguna ketika tugas Anda hanya meneruskan argumen ke alat lintas platform. Misalnya, panggilan npm dengan sekumpulan argumen dapat dengan mudah dicapai dengan langkah script . script berjalan di setiap penerjemah skrip asli platform: Bash di macOS dan Linux, cmd.exe di Windows.

YAML

steps:
- script: |
    npm install
    npm test

Klasik

1. Tambahkan tugas Baris Perintah ke alur Anda.

2. Ganti isi skrip dengan:

   npm install
   npm test
   

Menangani variabel lingkungan

Variabel lingkungan melemparkan kerutan pertama ke dalam menulis skrip lintas platform. Baris perintah, PowerShell, dan Bash masing-masing memiliki cara berbeda untuk membaca variabel lingkungan. Jika Anda perlu mengakses nilai yang disediakan sistem operasi seperti PATH, Anda memerlukan teknik yang berbeda per platform.

Namun, Azure Pipelines menawarkan cara lintas platform untuk merujuk ke variabel yang diketahuinya tentang yang disebut sintaks makro. Dengan mengelilingi nama variabel di $( ), itu diperluas sebelum shell platform pernah melihatnya. Misalnya, jika Anda ingin menggemakan ID alur, skrip berikut ramah lintas platform:

YAML

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

Ini juga berfungsi untuk variabel yang Anda tentukan dalam alur.

variables:
  Example: 'myValue'

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

Klasik

1. Tambahkan tugas Baris Perintah ke alur Anda.

2. Ganti isi skrip dengan:

   echo This is pipeline $(System.DefinitionId)
   

Pertimbangkan Bash atau pwsh

Jika Anda memiliki kebutuhan pembuatan skrip yang lebih kompleks daripada contoh yang ditunjukkan di atas, pertimbangkan untuk menulisnya di Bash. Sebagian besar agen macOS dan Linux memiliki Bash sebagai shell yang tersedia, dan agen Windows termasuk Git Bash atau Subsistem Windows untuk Linux Bash.

Untuk Azure Pipelines, agen yang dihosting Microsoft selalu memiliki Bash yang tersedia.

Misalnya, jika Anda perlu membuat keputusan tentang apakah build Anda dipicu oleh permintaan pull:

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

Klasik

1. Tambahkan tugas Bash ke alur Anda.

2. Untuk Jenis, pilih Sebaris.

3. Ganti isi skrip dengan:

   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) juga merupakan opsi. Ini mengharuskan setiap agen menginstal PowerShell Core.

Beralih berdasarkan platform

Secara umum, kami sarankan Anda menghindari skrip khusus platform untuk menghindari masalah seperti duplikasi logika alur Anda. Duplikasi menyebabkan pekerjaan ekstra dan risiko ekstra bug. Namun, jika tidak ada cara untuk menghindari pembuatan skrip khusus platform, Anda dapat menggunakan condition untuk mendeteksi platform apa yang Anda gunakan.

Misalnya, anggaplah bahwa karena alasan tertentu Anda memerlukan alamat IP agen build. Di Windows, ipconfig mendapatkan informasi tersebut. Di macOS, itu ifconfigadalah . Dan di Ubuntu Linux, itu ip addradalah .

Siapkan alur di bawah ini, lalu coba jalankan terhadap agen pada platform yang berbeda.

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)

Klasik

Pertama, tambahkan skrip Linux.

1. Tambahkan tugas Bash ke alur Anda.

2. Atur Jenis ke Sebaris.

3. Ganti isi skrip dengan:

   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. Ubah nilai Jalankan tugas ini menjadi "Kondisi kustom".

5. Di bidang Kondisi kustom yang muncul, masukkan "eq( variabel['Agent.OS'], 'Linux' )".

Selanjutnya, tambahkan skrip macOS.

1. Ulangi langkah-langkah di atas, tetapi untuk isi skrip, masukkan:

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

2. Untuk Kondisi kustom, masukkan "eq( variabel['Agent.OS'], 'Darwin' )".

Selanjutnya, tambahkan skrip Windows.

1. Tambahkan tugas PowerShell ke alur Anda.

2. Atur Jenis ke Sebaris.

3. Ganti isi skrip dengan:

   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. Ubah nilai Jalankan tugas ini menjadi "Kondisi kustom".

5. Di bidang Kondisi kustom yang muncul, masukkan "eq( variabel['Agent.OS'], 'Windows_NT' )".

Terakhir, tambahkan tugas yang menggunakan nilai , tidak peduli bagaimana kita mendapatkannya.

1. Tambahkan tugas Baris perintah ke alur Anda.

2. Ganti isi tugas dengan:

   echo The IP address is $(IP_ADDR)