JavaToolInstaller@0 - Attività del programma di installazione dello strumento Java v0
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.
Ingressi
versionSpec
-
versione di JDK
string. Obbligatorio. Valore predefinito: 8.
Specifica la versione JDK da rendere disponibile nel percorso. Usare una versione numerica intera, ad esempio 10.
jdkArchitectureOption
-
architettura JDK
string. Obbligatorio. Valori consentiti: x64, x86.
Specifica l'architettura (x86, x64) di JDK.
jdkSourceOption
-
di 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
-
di 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 può 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 .pkg e .dmg file contenenti un solo file .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 di Azure classico o Resource Manager. Selezionare il nome dell'account di archiviazione in cui si trova il JDK.
azureContainerName
-
Nome 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 di 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 estrarre .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 estrarre .dmg perché macOS non supporta l'installazione di JDK in una directory specifica.
azureResourceGroupName
-
nome del gruppo di risorse
string. Opzionale. Usare quando jdkSourceOption == AzureStorage.
Nome del gruppo di risorse dell'account di archiviazione.
cleanDestinationDirectory
-
della directory di destinazione pulita
boolean. Opzionale. Usare quando jdkSourceOption != PreInstalled. Valore predefinito: true.
Specifica l'opzione per pulire la directory di destinazione prima dell'estrazione di JDK.
cleanDestinationDirectory
-
della directory di destinazione pulita
boolean. Valore predefinito: true.
Specifica l'opzione per pulire la directory di destinazione prima dell'estrazione di JDK.
createExtractDirectory
-
Creare una directory per l'estrazione di
boolean. Opzionale. 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 attività
Tutte le attività hanno opzioni di controllo oltre ai relativi input di 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, un percorso nell'origine o nell'agente o nella cache degli strumenti. L'attività imposta anche la variabile di ambiente JAVA_HOME.
Usare questa attività per modificare la versione di Java usata nelle attività Java.
Nota
Per eseguire l'attività programma di installazione dello strumento Java
- Eseguire il comando sudo visudo
. Verrà aperto il file sudoers per la modifica. - Passare alla fine del file e aggiungere la riga seguente:
user ALL=NOPASSWD: /usr/sbin/installer(Sostituire l'utente con l'alias utente effettivo).- Salvare e chiudere il file.
Esempi
Ecco un esempio di recupero del file di archivio da una directory locale in Linux. Il file deve essere un archivio (.zip, .gz) della directory JAVA_HOME, quindi include le directory bin, 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 directory JAVA_HOME, quindi include le directory bin, 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 versioni Java preinstallate nell'agente ospitato da Microsoft. È possibile trovare le versioni preinstallate di Java disponibili in la colonna software inclusa nella tabella agenti ospitati.
- task: JavaToolInstaller@0
inputs:
versionSpec: '8'
jdkArchitectureOption: 'x64'
jdkSourceOption: 'PreInstalled'
Fabbisogno
| Requisito | Descrizione |
|---|---|
| Tipi di pipeline | YAML, build classica, versione classica |
| Viene eseguito in | Agente, DeploymentGroup |
| richieste | Nessuno |
| funzionalità di |
L'esecuzione di questa attività soddisfa le richieste di seguenti per le attività successive nello stesso processo: Java, JDK |
| restrizioni dei comandi | Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni |
| variabili impostabili | Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: PATH, JAVA_HOME* |
| Versione dell'agente | 2.182.1 o versione successiva |
| Categoria attività | Strumento |
| Requisito | Descrizione |
|---|---|
| Tipi di pipeline | YAML, build classica, versione classica |
| Viene eseguito in | Agente, DeploymentGroup |
| richieste | Nessuno |
| funzionalità di |
L'esecuzione di questa attività soddisfa le richieste di seguenti per le attività successive nello stesso processo: Java, JDK |
| restrizioni dei comandi | Qualunque |
| variabili impostabili | Qualunque |
| Versione dell'agente | Tutte le versioni dell'agente supportate. |
| Categoria attività | Strumento |
| Requisito | Descrizione |
|---|---|
| Tipi di pipeline | YAML, build classica, versione classica |
| Viene eseguito in | Agente, DeploymentGroup |
| richieste | Nessuno |
| funzionalità di |
L'esecuzione di questa attività soddisfa le richieste di seguenti per le attività successive nello stesso processo: Java |
| restrizioni dei comandi | Qualunque |
| variabili impostabili | Qualunque |
| Versione dell'agente | Tutte le versioni dell'agente supportate. |
| Categoria attività | Strumento |
Vedere anche
Per una spiegazione dei programmi di installazione e degli esempi degli strumenti, vedere programmi di installazione degli strumenti di .