JavaToolInstaller@1 — zadanie instalatora narzędzia Java w wersji 1

Artykuł
12/20/2024

Uzyskaj określoną wersję języka Java z obiektu blob platformy Azure dostarczonego przez użytkownika lub pamięci podręcznej narzędzi i ustawia JAVA_HOME.

Składnia

# Java tool installer v1
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@1
  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.

Wejścia

wersji zestawu JDK
string. Wymagane. Wartość domyślna: 8.

Określa wersję zestawu JDK, która ma być dostępna w ścieżce. Użyj wersji liczb całkowitej, takiej jak 10.

architektura zestawu jdkArchitectureOption - JDK
string. Wymagane. Dozwolone wartości: x64, x86.

Określa architekturę (x86, x64) zestawu JDK.

źródła zestawu JDK
string. Wymagane. Dozwolone wartości: AzureStorage (Azure Storage), LocalDirectory (katalog lokalny), PreInstalled (wstępnie zainstalowane).

Określa źródło skompresowanego zestawu JDK. Źródłem może być usługa Azure Blob Storage lub katalog lokalny w agencie lub repozytorium źródłowym albo możesz użyć wstępnie zainstalowanej wersji języka Java (dostępnej dla agentów hostowanych przez firmę Microsoft). Zapoznaj się z poniższym przykładem dotyczącym używania wstępnie zainstalowanej wersji języka Java.

Nuta

Ta wersja zadania uzyskuje dostęp do usługi Azure Storage przy użyciu połączenia usługi Azure Resource Manager skonfigurowane przy użyciu federacji tożsamości obciążenia i kontroli dostępu opartej na rolach platformy Azure. Aby uzyskać więcej informacji, zobacz Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob.

pliku JDK
string. Wymagane, gdy jdkSourceOption == LocalDirectory.

Określa ścieżkę do pliku archiwum JDK zawierającego skompresowany zestaw JDK. Ścieżka może znajdować się w repozytorium źródłowym lub w ścieżce lokalnej agenta. Plik powinien być archiwum (.zip, .tar.gz, .7z) zawierający folder bin na poziomie głównym lub wewnątrz pojedynczego katalogu. System MacOS obsługuje pliki .pkg i .dmg zawierające tylko jeden plik .pkg wewnątrz.

subskrypcji platformy Azure
string. Wymagane, gdy jdkSourceOption == AzureStorage.

Określa subskrypcję usługi Azure Resource Manager dla zestawu JDK.

azureStorageAccountName - nazwa konta magazynu
string. Wymagane, gdy jdkSourceOption == AzureStorage.

Określa klasyczne lub klasyczne konta magazynu usługi Resource Manager platformy Azure. Wybierz nazwę konta magazynu, w którym znajduje się zestaw JDK.

azureContainerName - nazwa kontenera
string. Wymagane, gdy jdkSourceOption == AzureStorage.

Określa nazwę kontenera na koncie magazynu, na którym znajduje się zestaw JDK.

azureCommonVirtualFile - typową ścieżkę wirtualną
string. Wymagane, gdy jdkSourceOption == AzureStorage.

Określa ścieżkę do zestawu JDK wewnątrz kontenera usługi Azure Storage.

katalogu docelowego
string. Wymagane, gdy jdkSourceOption != PreInstalled.

Określa katalog docelowy, w którym ma zostać wyodrębniony zestaw JDK. W systemach Linux i Windows jest to używane jako katalog docelowy instalacji zestawu JDK. W systemie macOS ten katalog jest używany jako folder tymczasowy do wyodrębniania .dmg, ponieważ system macOS nie obsługuje instalowania zestawu JDK w określonym katalogu.

azureResourceGroupName - nazwa grupy zasobów
string. Fakultatywny. Użyj polecenia , gdy jdkSourceOption == AzureStorage.

Nazwa grupy zasobów konta magazynu.

cleanDestinationDirectory - Wyczyść katalog docelowy
boolean. Fakultatywny. Użyj polecenia , gdy jdkSourceOption != PreInstalled. Wartość domyślna: true.

Określa opcję czyszczenia katalogu docelowego przed wyodrębnieniem do niego zestawu JDK.

createExtractDirectory - Tworzenie katalogu na potrzeby wyodrębniania
boolean. Fakultatywny. Użyj polecenia , gdy jdkSourceOption != PreInstalled. Wartość domyślna: true.

Domyślnie zadanie tworzy katalog podobny do JAVA_HOME_8_X64_OpenJDK_zip do wyodrębniania zestawu JDK. Ta opcja wyłącza tworzenie tego folderu, a jeśli ustawiono wartość false, zestaw JDK znajduje się w katalogu głównym jdkDestinationDirectory.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Użyj tego zadania, aby uzyskać określoną wersję języka Java z obiektu blob platformy Azure dostarczonego przez użytkownika, lokalizacji w źródle lub na agencie albo pamięci podręcznej narzędzi. Zadanie ustawia również zmienną środowiskową JAVA_HOME. Użyj tego zadania, aby zmienić wersję języka Java używaną w zadaniach Java.

Nuta

Aby uruchomić zadanie Java Tool Installer w systemie macOS, jest wymagane dla użytkownika, w ramach którego agent jest uruchomiony, aby mieć uprawnienia do wykonywania polecenia sudo bez hasła. Aby włączyć to uprawnienie, możesz wykonać następujące kroki:

Uruchom polecenie sudo visudo. Plik sudoers zostanie otwarty do edycji.

Przejdź do dołu pliku i dodaj następujący wiersz: user ALL=NOPASSWD: /usr/sbin/installer (Zastąp użytkownika rzeczywistym aliasem użytkownika).

Zapisz i zamknij plik.

Przykłady

Oto przykład pobierania pliku archiwum z katalogu lokalnego w systemie Linux. Plik powinien być archiwum (.zip, .gz) katalogu JAVA_HOME, dlatego zawiera katalogi bin, lib, include, jreitp.

  - task: JavaToolInstaller@1
    inputs:
      versionSpec: "11"
      jdkArchitectureOption: x64
      jdkSourceOption: LocalDirectory
      jdkFile: "/builds/openjdk-11.0.2_linux-x64_bin.tar.gz"
      jdkDestinationDirectory: "/builds/binaries/externals"
      cleanDestinationDirectory: true

Oto przykład pobierania pliku archiwum z usługi Azure Storage. Plik powinien być archiwum (.zip, .gz) katalogu JAVA_HOME, dlatego zawiera katalogi bin, lib, include, jreitp.

Nuta

- task: JavaToolInstaller@1
  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

Oto przykład użycia funkcji "wstępnie zainstalowanej". Ta funkcja umożliwia korzystanie ze wstępnie zainstalowanych wersji języka Java w agencie hostowanym przez firmę Microsoft. Dostępne wstępnie zainstalowane wersje języka Java można znaleźć w dołączonej kolumnie oprogramowania w tabeli hostowanych agentów.

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

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	Uruchomienie tego zadania spełnia następujące wymagania dla wszystkich kolejnych zadań w tym samym zadaniu: Java, JDK
ograniczenia poleceń	To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń : ograniczone
zmienne ustawiane	To zadanie ma uprawnienia do ustawić następujące zmienne: PATH, JAVA_HOME*
Wersja agenta	2.182.1 lub nowsza
Kategoria zadań	Narzędzie

Udostępnij za pośrednictwem

JavaToolInstaller@1 — zadanie instalatora narzędzia Java w wersji 1

Składnia

Wejścia

Opcje sterowania zadaniami

Zmienne wyjściowe

Uwagi

Przykłady

Wymagania

Opinia

Dodatkowe zasoby