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

  • Článek

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.

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

# 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. 
    #cleanDestinationDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Clean destination directory. Default: true.

# 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'. 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. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Clean destination directory. Default: true.

# Java Tool Installer v0
# Acquires a specific version of Java from a user supplied Azure blob or the tools cache and sets JAVA_HOME. Use this task to change the version of Java used in Java tasks.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory'. 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. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Clean destination directory. 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.


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

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.


jdkDestinationDirectory - Cílový adresář
string. Povinná hodnota.

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.


cleanDestinationDirectory - Vyčistit cílový adresář
boolean. 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
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ů Všechny
Nastavitelné proměnné Všechny
Verze agenta Všechny podporované verze agenta.
Kategorie úloh Nástroj
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
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta Všechny podporované verze agenta.
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ů.