JavaToolInstaller@0 – Java Tool Installer v0-uppgift

Använd den här uppgiften för att hämta en specifik version av Java från en Azure-blob som tillhandahålls av användaren eller verktygets cacheminne och ange JAVA_HOME.

Syntax

# 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.

Indata

versionSpec - JDK-version
string. Krävs. Standardvärde: 8.

Anger vilken JDK-version som ska vara tillgänglig på sökvägen. Använd en heltalsversion, till exempel 10.

jdkArchitectureOption - JDK-arkitektur
string. Krävs. Tillåtna värden: x64, x86.

Anger JDK:s arkitektur (x86, x64).

jdkSourceOption - JDK-källa
string. Krävs. Tillåtna värden: AzureStorage (Azure Storage), LocalDirectory (lokal katalog) PreInstalled (förinstallerade).

Anger källan för den komprimerade JDK:en. Källan kan vara Azure Blob Storage eller en lokal katalog på agenten eller källlagringsplatsen, eller så kan du använda den förinstallerade versionen av Java (tillgänglig för Microsoft-värdbaserade agenter). Se exemplet nedan om hur du använder den förinstallerade versionen av Java.

jdkFile - JDK-fil
string. Krävs när jdkSourceOption == LocalDirectory.

Anger sökvägen till JDK-arkivfilen som innehåller den komprimerade JDK:en. Sökvägen kan finnas i källlagringsplatsen eller en lokal sökväg på agenten. Filen ska vara ett arkiv (.zip, .tar.gz, .7z) som innehåller bin-mappen på rotnivå eller inuti en enda katalog. MacOS stöder .pkg- och .dmg-filer som bara innehåller en .pkg-fil inuti.

azureResourceManagerEndpoint - Azure-prenumeration
string. Krävs när jdkSourceOption == AzureStorage.

Anger Azure Resource Manager-prenumerationen för JDK:t.

azureStorageAccountName - Lagringskontonamn
string. Krävs när jdkSourceOption == AzureStorage.

Anger klassiska Azure-konton eller Resource Manager lagringskonton. Välj namnet på lagringskontot där JDK:et finns.

azureContainerName - Containernamn
string. Krävs när jdkSourceOption == AzureStorage.

Anger namnet på containern i lagringskontot där JDK:et finns.

azureCommonVirtualFile - Vanlig virtuell sökväg
string. Krävs när jdkSourceOption == AzureStorage.

Anger sökvägen till JDK:et i Azure Storage-containern.

jdkDestinationDirectory - Målkatalog
string. Krävs när jdkSourceOption != PreInstalled.

Anger målkatalogen där JDK:et ska extraheras. I Linux och Windows används detta som målkatalog för JDK-installationen. I macOS används den här katalogen som en tillfällig mapp för att extrahera .dmg eftersom macOS inte stöder installation av JDK till en specifik katalog.

azureResourceGroupName - Resursgruppsnamn
string. Valfritt. Använd när jdkSourceOption == AzureStorage.

Lagringskontots resursgruppnamn.

cleanDestinationDirectory - Rensa målkatalog
boolean. Valfritt. Använd när jdkSourceOption != PreInstalled. Standardvärde: true.

Anger alternativet för att rensa målkatalogen innan JDK extraheras till den.

createExtractDirectory - Skapa katalog för att extrahera
boolean. Valfritt. Använd när jdkSourceOption != PreInstalled. Standardvärde: true.

Som standard skapar aktiviteten en katalog som liknar för att JAVA_HOME_8_X64_OpenJDK_zip extrahera JDK. Det här alternativet inaktiverar skapandet av mappen och, om det är inställt på false, finns JDK i roten för jdkDestinationDirectory i stället.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att hämta en specifik version av Java från en Azure-blob som tillhandahålls av användaren, en plats i källan eller på agenten eller verktygens cacheminne. Uppgiften anger JAVA_HOME även miljövariabeln. Använd den här uppgiften om du vill ändra den version av Java som används i Java-uppgifter.

Anteckning

Om du vill köra Java Tool Installer-uppgiften på macOS krävs det att användaren som agenten körs under har behörighet att köra sudo-kommandot utan lösenord. Du kan följa nästa steg för att aktivera den här behörigheten:

1. Kör kommandot sudo visudo . Sudoers-filen öppnas för redigering.
2. Gå till slutet av filen och lägg till följande rad: user ALL=NOPASSWD: /usr/sbin/installer (Ersätt användaren med det faktiska användaraliaset).
3. Spara och stäng filen.

Exempel

Här är ett exempel på hur du hämtar arkivfilen från en lokal katalog i Linux. Filen ska vara ett arkiv (.zip, .gz) för JAVA_HOME katalogen, så den innehåller binkatalogerna , lib, include, jreosv.

  - 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

Här är ett exempel på hur du laddar ned arkivfilen från Azure Storage. Filen ska vara ett arkiv (.zip, .gz) för JAVA_HOME katalogen, så den innehåller binkatalogerna , lib, include, jreosv.

- 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

Här är ett exempel på hur du använder funktionen "förinstallerad". Med den här funktionen kan du använda Java-versioner som är förinstallerade på den Microsoft-värdbaserade agenten. Du hittar tillgängliga förinstallerade versioner av Java i den inkluderade programvarukolumnen i tabellen med värdbaserade agenter.

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

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Om du kör den här uppgiften uppfyller du följande krav för efterföljande uppgifter i samma jobb: Java, JDK
Kommandobegränsningar	Den här uppgiften körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här aktiviteten har behörighet att ange följande variabler: PATH, JAVA_HOME*
Agentversion	2.182.1 eller senare
Uppgiftskategori	Verktyg

Se även

En förklaring av verktygsinstallationer och exempel finns i Verktygsinstallationer.