JavaToolInstaller@0 – Java-eszköz telepítője v0-feladat

Ezzel a feladattal beszerezheti a Java egy adott verzióját egy felhasználó által megadott Azure-blobból vagy az eszköz gyorsítótárából, és beállíthatja a következőt 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.

Bevitelek

versionSpec - JDK-verzió
string. Kötelező. Alapértelmezett érték: 8.

Megadja az elérési úton elérhetővé tenni kívánt JDK-verziót. Használjon egész számverziót, például 10-et.

jdkArchitectureOption - JDK-architektúra
string. Kötelező. Engedélyezett értékek: x64, x86.

A JDK architektúráját (x86, x64) adja meg.

jdkSourceOption - JDK-forrás
string. Kötelező. Engedélyezett értékek: AzureStorage (Azure Storage), LocalDirectory (Helyi könyvtár) PreInstalled (előre telepítve).

Megadja a tömörített JDK forrását. A forrás lehet Azure Blob Storage vagy egy helyi könyvtár az ügynökön vagy a forrásadattárban, vagy használhatja a Java előre telepített verzióját (amely a Microsoft által üzemeltetett ügynökök számára érhető el). Tekintse meg az alábbi példát a Java előre telepített verziójának használatáról.

jdkFile - JDK-fájl
string. Akkor szükséges, ha jdkSourceOption == LocalDirectory.

Megadja a tömörített JDK-t tartalmazó JDK archív fájl elérési útját. Az elérési út lehet a forrásadattárban vagy az ügynök helyi elérési útja. A fájlnak egy archívumnak (.zip, .tar.gz, .7z) kell lennie, amely a gyökérszintű vagy egyetlen könyvtárban lévő bin mappát tartalmazza. A MacOS támogatja a .pkg és a .dmg fájlokat, amelyekben csak egy .pkg fájl található.

azureResourceManagerEndpoint - Azure-előfizetés
string. Akkor szükséges, ha jdkSourceOption == AzureStorage.

Meghatározza a JDK Azure Resource Manager-előfizetését.

azureStorageAccountName - Tárfiók neve
string. Akkor szükséges, ha jdkSourceOption == AzureStorage.

A klasszikus Azure-tárfiókokat vagy Resource Manager tárfiókokat adja meg. Válassza ki a tárfiók nevét, amelyben a JDK található.

azureContainerName - Tároló neve
string. Akkor szükséges, ha jdkSourceOption == AzureStorage.

Megadja a tároló nevét abban a tárfiókban, ahol a JDK található.

azureCommonVirtualFile - Gyakori virtuális elérési út
string. Akkor szükséges, ha jdkSourceOption == AzureStorage.

Megadja a JDK elérési útját az Azure Storage-tárolóban.

jdkDestinationDirectory - Célkönyvtár
string. Akkor szükséges, ha jdkSourceOption != PreInstalled.

Megadja azt a célkönyvtárat, ahol a JDK-t ki kell nyerni. Linux és Windows rendszeren ez a JDK telepítésének célkönyvtára. MacOS rendszeren ez a könyvtár ideiglenes mappaként használható a .dmg-ek kinyeréséhez, mivel a macOS nem támogatja a JDK telepítését egy adott könyvtárba.

azureResourceGroupName - Erőforráscsoport neve
string. Választható. Használja a következőt: jdkSourceOption == AzureStorage.

A tárfiók erőforráscsoport-neve.

cleanDestinationDirectory - Célkönyvtár tisztítása
boolean. Választható. Használja a következőt: jdkSourceOption != PreInstalled. Alapértelmezett érték: true.

Megadja a célkönyvtár tisztításának lehetőségét, mielőtt a JDK ki lesz nyerve.

createExtractDirectory - Könyvtár létrehozása kinyeréshez
boolean. Választható. Használja a következőt: jdkSourceOption != PreInstalled. Alapértelmezett érték: true.

Alapértelmezés szerint a feladat létrehoz egy, a JAVA_HOME_8_X64_OpenJDK_zip JDK kinyeréséhez hasonló könyvtárat. Ez a beállítás letiltja a mappa létrehozását, és ha a értékre falsevan állítva, a JDK a gyökérkönyvtárában jdkDestinationDirectory található.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal beszerezheti a Java egy adott verzióját egy felhasználó által megadott Azure-blobból, a forrásban vagy az ügynökben lévő helyről vagy az eszközök gyorsítótárából. A tevékenység a környezeti változót JAVA_HOME is beállítja. Ezzel a feladatsal módosíthatja a Java-feladatokban használt Java-verziót.

Megjegyzés

A Java-eszköztelepítő feladat macOS rendszeren való futtatásához a felhasználónak, aki alatt az ügynök fut, jelszó nélkül kell végrehajtania a sudo parancsot. Az engedély engedélyezéséhez kövesse a következő lépéseket:

1. Futtassa a sudo visudo parancsot. Megnyílik a sudoers fájl szerkesztésre.
2. Lépjen a fájl aljára, és adja hozzá a következő sort: user ALL=NOPASSWD: /usr/sbin/installer (Cserélje le a felhasználót a tényleges felhasználói aliasra).
3. Mentse és zárja be a fájlt.

Példák

Íme egy példa az archív fájl linuxos helyi könyvtárból való lekérésére. A fájlnak a könyvtár archívumának JAVA_HOME (.zip, .gz) kell lennie, így tartalmazza a bin, lib, include, jrestb. könyvtárakat.

  - 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

Íme egy példa az archív fájl Azure Storage-ból való letöltésére. A fájlnak a könyvtár archívumának JAVA_HOME (.zip, .gz) kell lennie, így tartalmazza a bin, lib, include, jrestb. könyvtárakat.

- 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

Íme egy példa az "előre telepített" funkció használatára. Ez a funkció lehetővé teszi a Microsoft által üzemeltetett ügynökön előre telepített Java-verziók használatát. A Java elérhető előre telepített verzióit az üzemeltetett ügynökök táblázatának belefoglalt szoftveroszlopában találja.

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

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás	Ügynök, DeploymentGroup
Igények	None
Képességek	A feladat futtatása megfelel a következő követelményeknek az ugyanabban a feladatban lévő további tevékenységekre vonatkozóan: Java, JDK
Parancskorlátozások	Ez a feladat a következő parancskorlátozásokkal fut: korlátozott
Változók beállítása	Ez a feladat a következő változók beállítására jogosult: PATH, JAVA_HOME*
Ügynök verziója	2.182.1 vagy újabb
Feladatkategória	Eszköz

Lásd még

Az eszköztelepítők és példák magyarázatáért lásd: Eszköztelepítők.