JavaToolInstaller@0 – úloha instalačního programu nástrojů Java v0

Tuto úlohu použijte k získání konkrétní verze Javy z uživatelem zadaného objektu blob Azure nebo mezipaměti nástrojů a nastavte 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.

Vstupy

versionSpec - Verze sady JDK
string. Povinná hodnota. Výchozí hodnota: 8.

Určuje verzi sady JDK, která se má zpřístupnit v cestě. Použijte celočíselovou verzi, například 10.

jdkArchitectureOption - Architektura sady JDK
string. Povinná hodnota. Povolené hodnoty: x64, x86.

Určuje architekturu (x86, x64) sady JDK.

jdkSourceOption - Zdroj sady JDK
string. Povinná hodnota. Povolené hodnoty: AzureStorage (Azure Storage), LocalDirectory (místní adresář) PreInstalled (předinstalované).

Určuje zdroj pro komprimovanou sadu JDK. Zdrojem může být Azure Blob Storage nebo místní adresář v agentu nebo zdrojovém úložišti, případně můžete použít předinstalovanou verzi Javy (k dispozici pro agenty hostované Microsoftem). V následujícím příkladu se dozvíte, jak používat předinstalovanou verzi Javy.

jdkFile - Soubor JDK
string. Vyžaduje se, když jdkSourceOption == LocalDirectory.

Určuje cestu k souboru archivu sady JDK, který obsahuje komprimovanou sadu JDK. Cesta může být ve zdrojovém úložišti nebo v místní cestě agenta. Soubor by měl být archiv (.zip, .tar.gz, .7z) obsahující složku bin na kořenové úrovni nebo uvnitř jednoho adresáře. MacOS podporuje soubory .pkg a .dmg, které obsahují jenom jeden soubor .pkg.

azureResourceManagerEndpoint - Předplatné Azure
string. Vyžaduje se, když jdkSourceOption == AzureStorage.

Určuje předplatné Azure Resource Manager pro sadu JDK.

azureStorageAccountName - Název účtu úložiště
string. Vyžaduje se, když jdkSourceOption == AzureStorage.

Určuje Azure Classic nebo Resource Manager účty úložiště. Vyberte název účtu úložiště, ve kterém se sada JDK nachází.

azureContainerName - Název kontejneru
string. Vyžaduje se, když jdkSourceOption == AzureStorage.

Určuje název kontejneru v účtu úložiště, ve kterém se sada JDK nachází.

azureCommonVirtualFile - Běžná virtuální cesta
string. Vyžaduje se, když jdkSourceOption == AzureStorage.

Určuje cestu k SADĚ JDK v kontejneru úložiště Azure.

jdkDestinationDirectory - Cílový adresář
string. Vyžaduje se, když jdkSourceOption != PreInstalled.

Určuje cílový adresář, do kterého se má sada JDK extrahovat. V Linuxu a Windows se používá jako cílový adresář pro instalaci sady JDK. V systému macOS se tento adresář používá jako dočasná složka pro extrahování souborů .dmg, protože macOS nepodporuje instalaci sady JDK do konkrétního adresáře.

azureResourceGroupName - Název skupiny prostředků
string. Nepovinný parametr. Použijte, když jdkSourceOption == AzureStorage.

Název skupiny prostředků účtu úložiště.

cleanDestinationDirectory - Vyčistit cílový adresář
boolean. Nepovinný parametr. Použijte, když jdkSourceOption != PreInstalled. Výchozí hodnota: true.

Určuje možnost vyčištění cílového adresáře před extrahováním sady JDK do něj.

createExtractDirectory - Vytvoření adresáře pro extrahování
boolean. Nepovinný parametr. Použijte, když jdkSourceOption != PreInstalled. Výchozí hodnota: true.

Ve výchozím nastavení úloha vytvoří adresář podobný adresáři JAVA_HOME_8_X64_OpenJDK_zip pro extrahování sady JDK. Tato možnost zakáže vytváření této složky a pokud je nastavená na false, sada JDK se nachází v kořenovém adresáři jdkDestinationDirectory .

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte k získání konkrétní verze Javy z uživatelem zadaného objektu blob Azure, umístění ve zdroji nebo v agentu nebo mezipaměti nástrojů. Úloha také nastaví proměnnou JAVA_HOME prostředí. Pomocí této úlohy můžete změnit verzi Javy, která se používá v úlohách v Javě.

Poznámka

Aby bylo možné spustit úlohu instalačního programu nástrojů Java v systému macOS, musí mít uživatel, pod kterým agent běží, oprávnění ke spuštění příkazu sudo bez hesla. Toto oprávnění můžete povolit podle následujících kroků:

1. Spusťte příkaz sudo visudo . Soubor sudoers se otevře pro úpravy.
2. Přejděte na konec souboru a přidejte následující řádek: user ALL=NOPASSWD: /usr/sbin/installer (Nahraďte uživatele skutečným aliasem uživatele).
3. Uložte soubor a zavřete ho.

Příklady

Tady je příklad získání souboru archivu z místního adresáře v Linuxu. Soubor by měl být archivem (.zip, .gz) JAVA_HOME adresáře, takže obsahuje binadresáře , libinclude, , jreatd.

  - 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

Tady je příklad stažení souboru archivu ze služby Azure Storage. Soubor by měl být archivem (.zip, .gz) JAVA_HOME adresáře, takže obsahuje binadresáře , libinclude, , jreatd.

- 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

Tady je příklad použití "předinstalované" funkce. Tato funkce umožňuje používat verze Javy, které jsou předinstalované v agentech hostovaných Microsoftem. Dostupné předinstalované verze Javy najdete ve sloupci zahrnutý software v tabulce hostovaných agentů.

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build, klasická verze
Běží na	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Spuštění této úlohy splňuje následující požadavky na všechny následné úkoly ve stejné úloze: Java, JDK
Omezení příkazů	Tato úloha se spustí pomocí následujících omezení příkazu: restricted
Nastavitelné proměnné	Tato úloha má oprávnění nastavit následující proměnné: PATH, JAVA_HOME*
Verze agenta	2.182.1 nebo vyšší
Kategorie úloh	Nástroj

Viz také

Vysvětlení instalačních programů nástrojů a příklady najdete v tématu Instalační programy nástrojů.