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 的体系结构 (x86x64) 。

jdkSourceOption - JDK 源
string. 必需。 允许的值： AzureStorage (Azure 存储) 、 LocalDirectory (Local Directory) (PreInstalled 预安装) 。

指定压缩 JDK 的源。 源可以是 Azure Blob 存储或代理或源存储库上的本地目录，也可以使用预安装的 Java (可用于 Microsoft 托管代理) 。 请参阅以下示例，了解如何使用预安装的 Java 版本。

jdkFile - JDK 文件
string. 当 jdkSourceOption == LocalDirectory 时，需要此选项。

指定包含压缩 JDK 的 JDK 存档文件的路径。 路径可能位于源存储库中，也可以位于代理上的本地路径中。 该文件应为存档 (.zip、.tar.gz、.7z) ，其中包含根级别或单个目录中的 bin 文件夹。 MacOS 支持内部仅包含一个 .pkg 文件的 .pkg 和 .dmg 文件。

azureResourceManagerEndpoint - Azure 订阅
string. 当 jdkSourceOption == AzureStorage 时，需要此选项。

指定 JDK 的 Azure 资源管理器 订阅。

azureStorageAccountName - 存储帐户名称
string. 当 jdkSourceOption == AzureStorage 时，需要此选项。

指定 Azure 经典或资源管理器存储帐户。 选择 JDK 所在的存储帐户名称。

azureContainerName - 容器名称
string. 当 jdkSourceOption == AzureStorage 时，需要此选项。

指定 JDK 所在的存储帐户中容器的名称。

azureCommonVirtualFile - 通用虚拟路径
string. 当 jdkSourceOption == AzureStorage 时，需要此选项。

指定 Azure 存储容器中 JDK 的路径。

jdkDestinationDirectory - 目标目录
string. 当 jdkSourceOption != PreInstalled 时，需要此选项。

指定应在其中提取 JDK 的目标目录。 在 Linux 和 Windows 上，此目录用作 JDK 安装的目标目录。 在 macOS 上，此目录用作提取 .dmg 的临时文件夹，因为 macOS 不支持将 JDK 安装到特定目录。

azureResourceGroupName - 资源组名称
string. 可选。 在 时 jdkSourceOption == AzureStorage使用 。

存储帐户的资源组名称。

cleanDestinationDirectory - 清理目标目录
boolean. 可选。 在 时 jdkSourceOption != PreInstalled使用 。 默认值：true。

指定在将 JDK 提取到目标目录之前清理目标目录的选项。

createExtractDirectory - 创建用于提取的目录
boolean. 可选。 在 时 jdkSourceOption != PreInstalled使用 。 默认值：true。

默认情况下，该任务创建一个类似于 JAVA_HOME_8_X64_OpenJDK_zip 的目录，用于提取 JDK。 此选项禁止创建该文件夹，如果设置为 false，则 JDK 位于 的 jdkDestinationDirectory 根目录中。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

使用此任务从用户提供的 Azure Blob、源或代理中的位置或工具缓存中获取特定版本的 Java。 该任务还会设置 JAVA_HOME 环境变量。 使用此任务更改 Java 任务中使用的 Java 版本。

注意

若要在 macOS 上运行 Java 工具安装程序 任务，运行代理的用户必须有权在没有密码的情况下执行 sudo 命令。 可以按照后续步骤启用此权限：

1. 运行 sudo visudo 命令。 此时会打开 sudoers 文件进行编辑。
2. 转到文件底部并添加以下行： user ALL=NOPASSWD: /usr/sbin/installer (将用户替换为实际用户别名) 。
3. 保存并关闭该文件。

示例

下面是从 Linux 上的本地目录获取存档文件的示例。 该文件应是目录的 JAVA_HOME 存档 (.zip、.gz) ，因此它包括 bin、 lib、 include、 jre等目录。

  - 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 存储下载存档文件的示例。 该文件应是目录的 JAVA_HOME 存档 (.zip、.gz) ，因此它包括 bin、 lib、 include、 jre等目录。

- 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，经典内部版本，经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	运行此任务可满足同一作业中任何后续任务的以下 要求 ：Java、JDK
命令限制	此任务使用以下命令 限制运行：受限
可设置的变量	此任务有权 设置以下变量：PATH、JAVA_HOME*
代理版本	2.182.1 或更高版本
任务类别	工具

请参阅

有关工具安装程序和示例的说明，请参阅工具安装程序。