Postup instalace spouštěče příkazů Azure pro Java

Spouštěč příkazů Azure pro Java je k dispozici v Linuxu pro platformu x64 i arm64. Podporované metody instalace:

Obrázky kontejnerů

Nástroj je součástí kontejnerových imagí Microsoft Build OpenJDK. Další nastavení není nutné.

Například následující soubor Dockerfile používá jaz ke spuštění aplikace Java ze souboru jar:

# Use any Microsoft Build of OpenJDK base image
FROM mcr.microsoft.com/openjdk/jdk:25-ubuntu

# Add your application.jar
COPY application.jar /application.jar

# Use jaz to launch your Java application
CMD ["jaz", "-jar", "application.jar"]

Instalace v Azure Linuxu

Pro virtuální počítače a další Azure linuxová prostředí můžete nástroj nainstalovat pomocí tdnf správce balíčků. jaz Nainstalujte balíček pomocí následujícího příkazu:

sudo tdnf install jaz

Další linuxové distribuce

Pokud jste už nastavili úložiště softwaru pro Linux pro Microsoft Products, spusťte příslušný příkaz správce balíčků pro vaši distribuci a nainstalujte jaz balíček.

Například v distribucích založených na Ubuntu nebo Debianu spusťte:

sudo apt-get install jaz

Pokud nemáte nastavené úložiště softwaru pro Linux pro produkty Microsoft, postupujte podle pokynů pro distribuci Linuxu.

Pokud chcete nainstalovat na Ubuntu, otevřete terminál a spusťte následující příkazy:

wget "https://packages.microsoft.com/config/ubuntu/$(. /etc/os-release; echo $VERSION_ID)/packages-microsoft-prod.deb" -O packages-microsoft-prod.deb && \
  sudo dpkg -i packages-microsoft-prod.deb

Po přidání úložiště nainstalujte jaz spuštěním následujících příkazů:

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install jaz

Certifikované verze sady JDK

Spouštěč příkazů Azure pro Java vyžaduje instalaci sady JDK založenou na openJDK (verze 8 nebo novější) v systému.

Important

Spouštěč příkazů Azure pro Javu vyžaduje úplnou instalaci sady JDK. Není plně testováno s instalacemi pouze JRE nebo s vlastním jlink runtime prostředím. Další informace najdete v tématu "Proč to nefunguje s runtime JRE nebo jlink?".

Azure Command Launcher pro Javu je certifikován pro následující sady JDK, pro které je k dispozici úplná sada úprav ladění a optimalizací na architekturách x64 i arm64:

U jiných JDK založených na OpenJDK nástroj udělá maximum pro spuštění vaší aplikace, ale nemusí použít úplnou sadu úprav vyladění ani optimalizace specifické pro danou verzi. Některé optimalizace jsou také specifické pro Microsoft Build pro OpenJDK a nepoužívají se u jiných distribucí.

Když nástroj zjistí sadu JDK, která není certifikovaná, vytiskne následující upozornění na standardní chybu a pokračuje ve spuštění aplikace:

jaz: WARNING: Detected a version of Java that has not been certified by jaz.

Nejlepších výsledků dosáhnete, když použijete některou z certifikovaných sad JDK uvedených výše.

Configuration

Tento jaz příkaz nepoužívá žádné argumenty příkazového řádku pro vlastní konfiguraci. Místo toho ve výchozím nastavení předává všechny argumenty přímo do java příkazu. Pokud chcete zajistit, aby jaz konfigurace nenarušovala argumenty vaší aplikace, jaz přijímá konfiguraci pouze prostřednictvím proměnných prostředí.

Příkaz jaz můžete nakonfigurovat pomocí těchto proměnných prostředí:

Proměnná prostředí Description
JAZ_HELP Nastavit na 1 pro tisk zprávy nápovědy a ukončení s kódem 0.
JAZ_PRINT_VERSION Nastavte na 1 pro tisk jaz verze na stdout a ukončete s kódem 0.
JAZ_DRY_RUN Nastavte na 1 pro tisk příkazu java, který by se spustil a proces by se ukončil s kódem 1.
JAZ_BYPASS Nastavte na 1 pro obejití úprav jaz optimalizace. Žádný vliv na telemetrii.
JAZ_IGNORE_USER_TUNING Nastavte na 1, abyste ignorovali všechny ladicí příznaky poskytnuté uživatelem a místo toho použili ladění jaz. V opačném případě jaz upraví nastavení JVM pouze tehdy, pokud nezjistí žádné uživatelsky zadané parametry ladění. Více informací o tom, jak funguje s povolením a bez povolení tohoto nastavení, najdete v tématu jaz.
JAZ_EXIT_WITHOUT_FLUSH Nastavte na 1, aby se při ukončení vynechalo vyprázdnění telemetrie. Toto nastavení zabraňuje potenciálním prodlevám (až 30 sekund), které může jaz způsobit při zápisu dat, nicméně jaz může stále odesílat telemetrii.

Použití proměnných prostředí místo argumentů příkazového řádku usnadňuje konfiguraci jaz v některých případech. Při nasazování kontejnerizované aplikace je někdy jednodušší nastavit proměnné prostředí než upravovat spouštěcí skripty. Experimentování s JAZ_IGNORE_USER_TUNING a JAZ_BYPASS může být užitečné při vyhodnocování jaz.