The Will Will Web

雖然 Azure Pipelines 提供的 Microsoft-hosted agents 大多已經內建了 Adopt OpenJDK 8.0/11.0/13.0 版本可供選擇，但是我們最近有個案子，客戶指定要用 IBM Java SDK 8.0 為主要的 JDK 版本，所以就需要額外下載與設定才能使用。本篇文章將說明完整的設定方法。

指定 JDK 版本的方法

由於 Azure Pipelines 提供的 Microsoft-hosted agents 已經內建了三個版本的 Adopt OpenJDK，你可以從 Microsoft-hosted agents 頁面得知每一個不同 Agents 的內建軟體清單：

單就 Java 相關的軟體，windows-2019 就包含了以下 4 個不同版本的 OpenJDK，也設定好了三個不同的環境變數，讓你可以自由切換：

預設 Microsoft-hosted agents 也會幫你設定好 JAVA_HOME 環境變數，所以預設你的建置環境就會有 Adopt OpenJDK 8.0.312+7 為你主要的 JDK 環境！

要更換 JDK 版本其實很簡單，基本上就兩個條件：

1. 指定正確的 JAVA_HOME 環境變數
2. 設定正確的 PATH 環境變數可預設指向正確的 Java 工具組路徑

假設我們要在 Pipeline 執行的中間設定這兩個環境變數，你可以有以下 3 種選擇：

• 新增一個 Windows PowerShell 工作 (Windows)

  echo '##vso[task.setvariable variable=JAVA_HOME]$(JAVA_HOME_17_X64)'
  echo '##vso[task.prependpath]$(JAVA_HOME_17_X64)\bin'
  

• 新增一個 Command line 工作 (cmd.exe on Windows)

  echo ##vso[task.setvariable variable=JAVA_HOME]$(JAVA_HOME_17_X64)
  echo ##vso[task.prependpath]$(JAVA_HOME_17_X64)\bin
  

  注意：千萬不要加上雙引號在 echo 後方的字串，否則路徑會有問題！我被這個細節雷到過！💥

• 新增一個 Command line 工作 (Bash on Linux/macOS)

  echo '##vso[task.setvariable variable=JAVA_HOME]$(JAVA_HOME_17_X64)'
  echo '##vso[task.prependpath]$(JAVA_HOME_17_X64)\bin'
  

指定 IBM Java SDK 8.0 版本的方法

要在 Microsoft-hosted agents 安裝與設定沒有內建的 JDK 版本，就需要每次都下載 JDK 檔案，並設定好 JAVA_HOME 與 PATH 環境變數。

以下是設定的三個步驟：

1. 下載 IBM Java SDK 80

   我將檔案上傳到與 Azure DevOps 組織相同 地區(Region) 的 Azure 儲存體帳戶 (Storage account)，如此一來才能節省頻寬支出，因為 Azure Storage 的流量費用在相同地區內是完全免費的，這點非常重要！🔥

   像我的 Azure DevOps 組織就落在 East US 2 這個地區，所以我就特別到 Azure 建立一個也在 East US 2 地區的 Storage account！

   curl.exe -s https://xxxxx.blob.core.windows.net/cicd/ibm_sdk80.zip -o "$(Agent.ToolsDirectory)\ibm_sdk80.zip"
   

2. 解壓縮 IBM Java SDK 80 到 $(Agent.ToolsDirectory) 目錄下

   新增 Extract files 工作，並設定以下參數：

   steps:
   - task: ExtractFiles@1
     displayName: '解壓縮 IBM Java SDK 80 到 $(Agent.ToolsDirectory)'
     inputs:
       archiveFilePatterns: '$(Agent.ToolsDirectory)\ibm_sdk80.zip'
       destinationFolder: '$(Agent.ToolsDirectory)'
       cleanDestinationFolder: false
   

   注意：我的 ibm_sdk80.zip 壓縮檔中的第一層只有 ibm_sdk80 一個資料夾，所以解壓縮的時候可以直接輸出到 $(Agent.ToolsDirectory) 目錄。

3. 設定 JAVA_HOME 與 PATH 環境變數

   echo ##vso[task.setvariable variable=JAVA_HOME]$(Agent.ToolsDirectory)\ibm_sdk80
   echo ##vso[task.prependpath]$(Agent.ToolsDirectory)\ibm_sdk80\bin
   

相關連結

• Java SDK downloads, version 8.0
• Microsoft-hosted agents for Azure Pipelines - Azure Pipelines | Microsoft Docs