Come installare Azure Command Launcher per Java

L'utilità di avvio dei comandi Azure per Java è disponibile in Linux sia per x64 che per arm64. I metodi di installazione supportati sono:

Immagini dei contenitori

Lo strumento è incluso nelle immagini dei contenitori per Microsoft Build di OpenJDK. Non è necessaria alcuna configurazione.

Ad esempio, il Dockerfile seguente usa jaz per eseguire un'applicazione Java da un jar file:

# 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"]

Installare in Azure Linux

Per le macchine virtuali e altri ambienti Linux Azure, è possibile installare lo strumento usando gestione tdnf pacchetti. Installare il jaz pacchetto con il comando seguente:

sudo tdnf install jaz

Altre distribuzioni Linux

Se è già stato configurato il repository software Linux per Microsoft Products, eseguire il comando di gestione pacchetti appropriato per la distribuzione per installare il jaz pacchetto.

Ad esempio, nelle distribuzioni basate su Ubuntu o Debian eseguire:

sudo apt-get install jaz

Se non è configurato il repository software Linux per prodotti Microsoft, seguire le istruzioni per la distribuzione linux.

Per eseguire l'installazione in Ubuntu, aprire un terminale ed eseguire i comandi seguenti:

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

Dopo aver aggiunto il repository, installare jaz eseguendo i seguenti comandi:

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

Versioni certificate del JDK

L'utilità di avvio dei comandi Azure per Java richiede un'installazione JDK basata su OpenJDK (versione 8 o successiva) nel sistema.

Important

L'utilità di avvio dei comandi di Azure per Java richiede un'installazione completa di JDK. Non è completamente testato con installazioni JRE solo o con runtime jlink personalizzati. Per altre informazioni, vedere "Perché non funziona con i runtime JRE o jlink?".

Azure Command Launcher per Java è certificato per i seguenti JDK, che ricevono la serie completa di regolazioni e ottimizzazioni sia su x64 che su arm64:

Con altri JDK basati su OpenJDK, lo strumento fa del suo meglio per avviare l'applicazione, ma potrebbe non applicare il set completo di regolazioni di ottimizzazione o ottimizzazioni specifiche della versione. Alcune ottimizzazioni sono specifiche anche per Microsoft Build di OpenJDK e non vengono applicate ad altre distribuzioni.

Quando lo strumento rileva un JDK non certificato, visualizza l'avviso seguente in caso di errore standard e continua ad avviare l'applicazione:

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

Per ottenere risultati ottimali, usare uno dei JDK certificati elencati in precedenza.

Configuration

Il jaz comando non utilizza argomenti della riga di comando per la propria configurazione. Invece, per impostazione predefinita, passa tutti gli argomenti direttamente al comando java. Per assicurarsi che jaz la configurazione non interferisca con gli argomenti dell'applicazione, jaz accetta solo la configurazione tramite variabili di ambiente.

È possibile configurare il jaz comando usando queste variabili di ambiente:

Variabile di ambiente Descrizione
JAZ_HELP Impostare 1 per stampare un messaggio di aiuto e uscire con il codice 0.
JAZ_PRINT_VERSION Impostare su 1 per stampare versione jaz su stdout e terminare con il codice 0.
JAZ_DRY_RUN Impostare su 1 per stampare il comando java che verrebbe eseguito e uscire con il codice 1.
JAZ_BYPASS Impostare su 1 per ignorare jaz le regolazioni dell'ottimizzazione. Nessun effetto sui dati di telemetria.
JAZ_IGNORE_USER_TUNING Impostare su 1 per ignorare tutti i flag di ottimizzazione forniti dall'utente e applicare invece l'ottimizzazione jaz. In caso contrario, jaz ottimizza la JVM solo se non rileva flag di ottimizzazione forniti dall'utente. Vedere "Cosa accade se sono già state impostate alcune opzioni JVM nell'ambiente?" per altre informazioni sul jaz comportamento con e senza abilitare questa impostazione.
JAZ_EXIT_WITHOUT_FLUSH Impostare su 1 per ignorare lo scaricamento dei dati di telemetria all'uscita. Questa impostazione evita potenziali ritardi (fino a 30 secondi) jaz potrebbe introdurre durante lo scaricamento dei dati, ma jaz potrebbe comunque inviare dati di telemetria.

L'uso di variabili di ambiente anziché argomenti della riga di comando semplifica anche la configurazione jaz in alcuni casi. Quando si distribuisce un'applicazione in contenitori, talvolta è più semplice impostare le variabili di ambiente rispetto alla modifica degli script di avvio. L'esperimento con JAZ_IGNORE_USER_TUNING e JAZ_BYPASS può essere utile durante la valutazione di jaz.

  • Last updated on