Aracılığıyla paylaş

JavaToolInstaller@0 - Java araç yükleyicisi v0 görevi

  • Makale

Kullanıcı tarafından sağlanan azure blobundan veya araç önbelleğinden belirli bir Java sürümünü almak ve JAVA_HOMEayarlamak için bu görevi kullanın.

Sözdizimi

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

Giriş

JDK sürüm
string. Gerekli. Varsayılan değer: 8.

Yolda kullanılabilir hale getirilebilecek JDK sürümünü belirtir. 10 gibi bir tamsayı sürümü kullanın.


jdkArchitectureOption - JDK mimarisi
string. Gerekli. İzin verilen değerler: x64, x86.

JDK'nin mimarisini (x86, x64) belirtir.


JDK kaynak
string. Gerekli. İzin verilen değerler: AzureStorage (Azure Depolama), LocalDirectory (Yerel Dizin), PreInstalled (Önceden yüklenmiş).

Sıkıştırılmış JDK kaynağını belirtir. Kaynak Azure blob depolama veya aracı ya da kaynak deposundaki yerel bir dizin olabilir veya Java'nın önceden yüklenmiş sürümünü (Microsoft tarafından barındırılan aracılar için kullanılabilir) kullanabilirsiniz. Java'nın önceden yüklenmiş sürümünü kullanma hakkında aşağıdaki örniğe bakın.


JDK kaynak
string. Gerekli. İzin verilen değerler: AzureStorage (Azure Depolama), LocalDirectory (Yerel Dizin).

Sıkıştırılmış JDK kaynağını belirtir. Kaynak Azure blob depolama veya aracı ya da kaynak deposundaki yerel bir dizin olabilir veya Java'nın önceden yüklenmiş sürümünü (Microsoft tarafından barındırılan aracılar için kullanılabilir) kullanabilirsiniz. Java'nın önceden yüklenmiş sürümünü kullanma hakkında aşağıdaki örniğe bakın.


JDK dosyası
string. jdkSourceOption == LocalDirectorygerekir.

Sıkıştırılmış JDK'yi içeren JDK arşiv dosyasının yolunu belirtir. Yol kaynak deponuzda veya aracıdaki yerel bir yolda olabilir. Dosya, kök düzeyde veya tek bir dizin içindeki bin klasörünü içeren bir arşiv (.zip, .tar.gz, .7z) olmalıdır. MacOS, içinde yalnızca bir .pkg dosyası içeren .pkg ve .dmg dosyalarını destekler.


Azure aboneliği
string. jdkSourceOption == AzureStoragegerekir.

JDK için Azure Resource Manager aboneliğini belirtir.


depolama hesabı adı
string. jdkSourceOption == AzureStoragegerekir.

Klasik Azure veya Resource Manager depolama hesaplarını belirtir. JDK'nin bulunduğu depolama hesabı adını seçin.


kapsayıcı adı
string. jdkSourceOption == AzureStoragegerekir.

JDK'nin bulunduğu depolama hesabında kapsayıcının adını belirtir.


azureCommonVirtualFile - Ortak sanal yol
string. jdkSourceOption == AzureStoragegerekir.

Azure depolama kapsayıcısının içindeki JDK yolunu belirtir.


hedef dizin
string. jdkSourceOption != PreInstalledgerekir.

JDK'nin ayıklanması gereken hedef dizini belirtir. Linux ve Windows'da bu, JDK yüklemesi için hedef dizin olarak kullanılır. macOS'ta, macOS belirli bir dizine JDK yüklemeyi desteklemediğinden, bu dizin .dmg ayıklamak için geçici bir klasör olarak kullanılır.


hedef dizin
string. Gerekli.

JDK'nin ayıklanması gereken hedef dizini belirtir. Linux ve Windows'da bu, JDK yüklemesi için hedef dizin olarak kullanılır. macOS'ta, macOS belirli bir dizine JDK yüklemeyi desteklemediğinden, bu dizin .dmg ayıklamak için geçici bir klasör olarak kullanılır.


kaynak grubu adı
string. Opsiyonel. jdkSourceOption == AzureStorageolduğunda kullanın.

Depolama hesabının Kaynak Grubu adı.


cleanDestinationDirectory - Hedef dizini temizle
boolean. Opsiyonel. jdkSourceOption != PreInstalledolduğunda kullanın. Varsayılan değer: true.

JDK içine ayıklanmasından önce hedef dizini temizleme seçeneğini belirtir.


cleanDestinationDirectory - Hedef dizini temizle
boolean. Varsayılan değer: true.

JDK içine ayıklanmasından önce hedef dizini temizleme seçeneğini belirtir.


createExtractDirectory - ayıklamak için dizin oluşturma
boolean. Opsiyonel. jdkSourceOption != PreInstalledolduğunda kullanın. Varsayılan değer: true.

Varsayılan olarak, görev JDK'yi ayıklamak için JAVA_HOME_8_X64_OpenJDK_zip benzer bir dizin oluşturur. Bu seçenek bu klasörün oluşturulmasını devre dışı bırakır ve falseolarak ayarlanırsa JDK bunun yerine jdkDestinationDirectory kökünde bulunur.


Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz. Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Hiç kimse.

Açıklamalar

Kullanıcı tarafından sağlanan bir Azure blobundan, kaynakta veya aracıda bir konumdan ya da araç önbelleğinden belirli bir Java sürümünü almak için bu görevi kullanın. Görev, JAVA_HOME ortam değişkenini de ayarlar. Java görevlerinde kullanılan Java sürümünü değiştirmek için bu görevi kullanın.

Not

macOS'ta Java Tool Installer görevini çalıştırmak için, aracının çalıştığı kullanıcının parola olmadan sudo komutunu yürütme iznine sahip olması gerekir. Bu izni etkinleştirmek için sonraki adımları izleyebilirsiniz:

  1. sudo visudo komutunu çalıştırın. Sudoers dosyası düzenleme için açılır.
  2. Dosyanın en altına gidin ve şu satırı ekleyin: user ALL=NOPASSWD: /usr/sbin/installer (Kullanıcıyı gerçek kullanıcı diğer adıyla değiştirin).
  3. Dosyayı kaydedin ve kapatın.

Örnekler

Aşağıda, Arşiv dosyasını Linux'ta yerel bir dizinden alma örneği verilmiştır. Dosya, JAVA_HOME dizininin bir arşivi (.zip, .gz) olmalıdır, bu nedenle bin, lib, include, jrevb. dizinleri içerir.

  - 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

Azure Depolama'dan arşiv dosyasını indirme örneği aşağıda verilmiştır. Dosya, JAVA_HOME dizininin bir arşivi (.zip, .gz) olmalıdır, bu nedenle bin, lib, include, jrevb. dizinleri içerir.

- 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

"Önceden yüklenmiş" özelliği kullanma örneği aşağıda verilmiştir. Bu özellik, Microsoft tarafından barındırılan aracıda önceden yüklenmiş Java sürümlerini kullanmanıza olanak tanır. Java'nın önceden yüklenmiş kullanılabilir sürümlerini,barındırılan aracılar tablosundaki dahil edilen yazılım sütununu bulabilirsiniz.

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

Gereksinim -leri

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görevi çalıştırmak, aynı işteki sonraki görevler için aşağıdaki taleplerini karşılar: Java, JDK
Komut kısıtlamaları Bu görev,aşağıdaki komut kısıtlamaları kullanılarak çalışır: restricted
Ayarlanabilir değişkenleri Bu görevin şu değişkenleri ayarlama izni var: PATH, JAVA_HOME*
Aracı sürümü 2.182.1 veya üzeri
Görev kategorisi Alet
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görevi çalıştırmak, aynı işteki sonraki görevler için aşağıdaki taleplerini karşılar: Java, JDK
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü Desteklenen tüm aracı sürümleri.
Görev kategorisi Alet
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görevi çalıştırmak, aynı işteki sonraki görevler için aşağıdaki taleplerini karşılar: Java
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü Desteklenen tüm aracı sürümleri.
Görev kategorisi Alet

Ayrıca bkz.

Araç yükleyicilerinin ve örneklerin açıklaması için bkz. Araç yükleyicileri.