JavaToolInstaller@0 - Java ツール インストーラー v0 タスク

このタスクを使用して、ユーザー指定の Azure BLOB またはツール キャッシュから特定のバージョンの Java を取得し、 を設定 JAVA_HOMEします。

構文

# Java tool installer v0
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory' | 'PreInstalled'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    #jdkDestinationDirectory: # string. Required when jdkSourceOption != PreInstalled. Destination directory. 
    #azureResourceGroupName: # string. Optional. Use when jdkSourceOption == AzureStorage. Resource Group name. 
    #cleanDestinationDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Clean destination directory. Default: true.
    #createExtractDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Create directory for extracting. Default: true.

入力

versionSpec - JDK バージョン
string. 必須です。 既定値: 8。

パスで使用できるようにする JDK バージョンを指定します。 整数バージョン (10 など) を使用します。

jdkArchitectureOption - JDK アーキテクチャ
string. 必須です。 使用できる値: x64、x86。

JDK のアーキテクチャ (x86、 x64) を指定します。

jdkSourceOption - JDK ソース
string. 必須です。 使用できる値: AzureStorage (Azure Storage)、 LocalDirectory (ローカル ディレクトリ)、 PreInstalled (プレインストール)。

圧縮 JDK のソースを指定します。 ソースには、エージェントまたはソース リポジトリ上の Azure BLOB ストレージまたはローカル ディレクトリを指定するか、事前にインストールされたバージョンの Java (Microsoft ホステッド エージェントで使用可能) を使用できます。 事前インストールされたバージョンの Java の使用方法については、以下の例を参照してください。

jdkFile - JDK ファイル
string. jdkSourceOption == LocalDirectory の場合に必要です。

圧縮された JDK を含む JDK アーカイブ ファイルへのパスを指定します。 パスは、ソース リポジトリ内にあるか、エージェント上のローカル パスである可能性があります。 ファイルは、ルート レベルまたは単一ディレクトリ内の bin フォルダーを含むアーカイブ (.zip、.tar.gz、.7z) である必要があります。 MacOS では、内部に 1 つの .pkg ファイルのみを含む .pkg ファイルと .dmg ファイルがサポートされています。

azureResourceManagerEndpoint - Azure サブスクリプション
string. jdkSourceOption == AzureStorage の場合に必要です。

JDK の Azure Resource Manager サブスクリプションを指定します。

azureStorageAccountName - ストレージ アカウント名
string. jdkSourceOption == AzureStorage の場合に必要です。

Azure クラシック または Resource Manager ストレージ アカウントを指定します。 JDK が配置されているストレージ アカウント名を選択します。

azureContainerName - コンテナー名
string. jdkSourceOption == AzureStorage の場合に必要です。

JDK が配置されているストレージ アカウント内のコンテナーの名前を指定します。

azureCommonVirtualFile - 共通仮想パス
string. jdkSourceOption == AzureStorage の場合に必要です。

Azure ストレージ コンテナー内の JDK へのパスを指定します。

jdkDestinationDirectory - 宛先ディレクトリ
string. jdkSourceOption != PreInstalled の場合に必要です。

JDK を抽出する宛先ディレクトリを指定します。 Linux および Windows では、これは JDK インストールの宛先ディレクトリとして使用されます。 macOS では、macOS では特定のディレクトリへの JDK のインストールがサポートされていないため、このディレクトリは .dmg を抽出するための一時フォルダーとして使用されます。

azureResourceGroupName - リソース グループ名
string. 省略可能。 の場合は jdkSourceOption == AzureStorageを使用します。

ストレージ アカウントのリソース グループ名。

cleanDestinationDirectory - コピー先ディレクトリをクリーンする
boolean. 省略可能。 の場合は jdkSourceOption != PreInstalledを使用します。 既定値: true。

JDK が抽出される前に宛先ディレクトリをクリーンするオプションを指定します。

createExtractDirectory - 抽出用のディレクトリを作成する
boolean. 省略可能。 の場合は jdkSourceOption != PreInstalledを使用します。 既定値: true。

既定では、タスクは JDK を抽出するための と同様の JAVA_HOME_8_X64_OpenJDK_zip ディレクトリを作成します。 このオプションを選択すると、そのフォルダーの作成が無効になり、 が に false設定されている場合、JDK は 代わりに の jdkDestinationDirectory ルートに配置されます。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、ユーザーが指定した Azure BLOB、ソースまたはエージェント上の場所、またはツール キャッシュから特定のバージョンの Java を取得します。 タスクでは、環境変数も設定されます JAVA_HOME 。 このタスクを使用して、Java タスクで使用される Java のバージョンを変更します。

Note

macOS で Java ツール インストーラー タスクを実行するには、エージェントが実行されているユーザーがパスワードなしで sudo コマンドを実行するアクセス許可を持っている必要があります。 次の手順に従って、このアクセス許可を有効にすることができます。

1. sudo visudo コマンドを実行します。 sudoers ファイルが開き、編集が行われます。
2. ファイルの一番下に移動し、次の行を追加します user ALL=NOPASSWD: /usr/sbin/installer (user を実際のユーザー エイリアスに置き換えます)。
3. ファイルを保存して閉じます。

例

Linux 上のローカル ディレクトリからアーカイブ ファイルを取得する例を次に示します。 ファイルは、ディレクトリのアーカイブ (.zip、.gz) JAVA_HOME である必要があるため、、libincludejreなどのディレクトリがbin含まれます。

  - task: JavaToolInstaller@0
    inputs:
      versionSpec: "11"
      jdkArchitectureOption: x64
      jdkSourceOption: LocalDirectory
      jdkFile: "/builds/openjdk-11.0.2_linux-x64_bin.tar.gz"
      jdkDestinationDirectory: "/builds/binaries/externals"
      cleanDestinationDirectory: true

Azure Storage からアーカイブ ファイルをダウンロードする例を次に示します。 ファイルは、ディレクトリのアーカイブ (.zip、.gz) JAVA_HOME である必要があるため、、libincludejreなどのディレクトリがbin含まれます。

- task: JavaToolInstaller@0
  inputs:
    versionSpec: '6'
    jdkArchitectureOption: 'x64'
    jdkSourceOption: AzureStorage
    azureResourceManagerEndpoint: myARMServiceConnection
    azureStorageAccountName: myAzureStorageAccountName
    azureContainerName: myAzureStorageContainerName
    azureCommonVirtualFile: 'jdk1.6.0_45.zip'
    jdkDestinationDirectory: '$(agent.toolsDirectory)/jdk6'
    cleanDestinationDirectory: false

"プレインストール" 機能を使用する例を次に示します。 この機能を使用すると、Microsoft ホステッド エージェントにプレインストールされている Java バージョンを使用できます。 使用可能なプレインストールバージョンの Java は、 ホストされているエージェントの表の含まれているソフトウェア列にあります。

- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8'
    jdkArchitectureOption: 'x64'
    jdkSourceOption: 'PreInstalled'

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクの実行は、同じジョブ内の後続のタスクに対して次の 要求 を満たします: Java、JDK
コマンドの制限	このタスクは、次の コマンド制限を使用して実行されます。
設定可能な変数	このタスクには、PATH、JAVA_HOME* という 変数を設定するアクセス許可があります。
エージェントのバージョン	2.182.1 以上
タスクのカテゴリ	ツール

関連項目

ツール インストーラーの説明と例については、ツール インストーラーに関するページを参照してください。