JavaToolInstaller@0 - Attività del programma di installazione dello strumento Java v0

  • Articolo

Usare questa attività per acquisire una versione specifica di Java da un BLOB di Azure fornito dall'utente o dalla cache degli strumenti e impostare JAVA_HOME.

Sintassi

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

Input

versionSpec - Versione di JDK
string. Obbligatorio. Valore predefinito: 8.

Specifica la versione JDK da rendere disponibile nel percorso. Usare una versione numero intero, ad esempio 10.


jdkArchitectureOption - Architettura JDK
string. Obbligatorio. Valori consentiti: x64, x86.

Specifica l'architettura (x86, x64) del JDK.


jdkSourceOption - Origine JDK
string. Obbligatorio. Valori consentiti: AzureStorage (Archiviazione di Azure), LocalDirectory (Directory locale), PreInstalled (preinstallato).

Specifica l'origine per il JDK compresso. L'origine può essere l'archiviazione BLOB di Azure o una directory locale nell'agente o nel repository di origine oppure è possibile usare la versione preinstallata di Java (disponibile per gli agenti ospitati da Microsoft). Vedere l'esempio seguente su come usare la versione preinstallata di Java.


jdkSourceOption - Origine JDK
string. Obbligatorio. Valori consentiti: AzureStorage (Archiviazione di Azure), LocalDirectory (Directory locale).

Specifica l'origine per il JDK compresso. L'origine può essere l'archiviazione BLOB di Azure o una directory locale nell'agente o nel repository di origine oppure è possibile usare la versione preinstallata di Java (disponibile per gli agenti ospitati da Microsoft). Vedere l'esempio seguente su come usare la versione preinstallata di Java.


jdkFile - File JDK
string. Obbligatorio quando jdkSourceOption == LocalDirectory.

Specifica il percorso del file di archivio JDK che contiene il JDK compresso. Il percorso potrebbe trovarsi nel repository di origine o in un percorso locale nell'agente. Il file deve essere un archivio (.zip, .tar.gz, .7z) contenente la cartella bin a livello radice o all'interno di una singola directory. MacOS supporta i file con estensione pkg e dmg contenenti un solo file con estensione pkg all'interno.


azureResourceManagerEndpoint - Sottoscrizione di Azure
string. Obbligatorio quando jdkSourceOption == AzureStorage.

Specifica la sottoscrizione di Azure Resource Manager per JDK.


azureStorageAccountName - Nome dell'account di archiviazione
string. Obbligatorio quando jdkSourceOption == AzureStorage.

Specifica gli account di archiviazione classici o Resource Manager di Azure. Selezionare il nome dell'account di archiviazione in cui si trova JDK.


azureContainerName - Nome del contenitore
string. Obbligatorio quando jdkSourceOption == AzureStorage.

Specifica il nome del contenitore nell'account di archiviazione in cui si trova JDK.


azureCommonVirtualFile - Percorso virtuale comune
string. Obbligatorio quando jdkSourceOption == AzureStorage.

Specifica il percorso del JDK all'interno del contenitore di archiviazione di Azure.


jdkDestinationDirectory - Directory di destinazione
string. Obbligatorio quando jdkSourceOption != PreInstalled.

Specifica la directory di destinazione in cui deve essere estratto JDK. In Linux e Windows questo viene usato come directory di destinazione per l'installazione di JDK. In macOS questa directory viene usata come cartella temporanea per l'estrazione di .dmg perché macOS non supporta l'installazione di JDK in una directory specifica.


jdkDestinationDirectory - Directory di destinazione
string. Obbligatorio.

Specifica la directory di destinazione in cui deve essere estratto JDK. In Linux e Windows questo viene usato come directory di destinazione per l'installazione di JDK. In macOS questa directory viene usata come cartella temporanea per l'estrazione di .dmg perché macOS non supporta l'installazione di JDK in una directory specifica.


azureResourceGroupName - Nome gruppo di risorse
string. Facoltativa. Usare quando jdkSourceOption == AzureStorage.

Nome del gruppo di risorse dell'account di archiviazione.


cleanDestinationDirectory - Pulire la directory di destinazione
boolean. Facoltativa. Usare quando jdkSourceOption != PreInstalled. Valore predefinito: true.

Specifica l'opzione per pulire la directory di destinazione prima dell'estrazione di JDK.


cleanDestinationDirectory - Pulire la directory di destinazione
boolean. Valore predefinito: true.

Specifica l'opzione per pulire la directory di destinazione prima dell'estrazione di JDK.


createExtractDirectory - Creare la directory per l'estrazione
boolean. Facoltativa. Usare quando jdkSourceOption != PreInstalled. Valore predefinito: true.

Per impostazione predefinita, l'attività crea una directory simile a JAVA_HOME_8_X64_OpenJDK_zip per l'estrazione di JDK. Questa opzione disabilita la creazione di tale cartella e, se impostata su false, JDK si trova nella radice di jdkDestinationDirectory .


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per acquisire una versione specifica di Java da un BLOB di Azure fornito dall'utente, da un percorso nell'origine o nell'agente o dalla cache degli strumenti. L'attività imposta anche la JAVA_HOME variabile di ambiente. Usare questa attività per modificare la versione di Java usata nelle attività Java.

Nota

Per eseguire l'attività Programma di installazione strumenti Java in macOS, è necessario per l'utente con cui l'agente è in esecuzione per avere l'autorizzazione per eseguire il comando sudo senza password. È possibile seguire i passaggi successivi per abilitare questa autorizzazione:

  1. Eseguire il comando sudo visudo . Verrà aperto il file sudoers per la modifica.
  2. Passare alla fine del file e aggiungere la riga seguente: user ALL=NOPASSWD: /usr/sbin/installer (Sostituire l'utente con l'alias utente effettivo).
  3. Salvare e chiudere il file.

Esempio

Ecco un esempio di recupero del file di archivio da una directory locale in Linux. Il file deve essere un archivio (.zip, gz) della JAVA_HOME directory, quindi include le bindirectory , lib, include, jree così via.

  - 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

Ecco un esempio di download del file di archivio da Archiviazione di Azure. Il file deve essere un archivio (.zip, gz) della JAVA_HOME directory, quindi include le bindirectory , lib, include, jree così via.

- 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

Ecco un esempio di uso della funzionalità "preinstallata". Questa funzionalità consente di usare le versioni Java preinstallate nell'agente ospitato da Microsoft. È possibile trovare le versioni preinstallate di Java nella colonna software inclusa nella tabella agenti ospitati.

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

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities L'esecuzione di questa attività soddisfa le richieste seguenti per le attività successive nello stesso processo: Java, JDK
Restrizioni dei comandi Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: PATH, JAVA_HOME*
Versione agente 2.182.1 o versione successiva
Categoria attività Strumento
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities L'esecuzione di questa attività soddisfa le richieste seguenti per le attività successive nello stesso processo: Java, JDK
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Strumento
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Nessuno
Capabilities L'esecuzione di questa attività soddisfa le richieste seguenti per le attività successive nello stesso processo: Java
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente Tutte le versioni dell'agente supportate.
Categoria attività Strumento

Vedi anche

Per una spiegazione dei programmi di installazione degli strumenti e degli esempi, vedere Programmi di installazione degli strumenti.