Comment installer Azure lanceur de commandes pour Java

Le lanceur de commandes Azure pour Java est disponible sur Linux pour x64 et arm64. Les méthodes d’installation prises en charge sont les suivantes :

Images de conteneur

L’outil est inclus dans les images de conteneur pour la build Microsoft d’OpenJDK. Aucune configuration supplémentaire n’est nécessaire.

Par exemple, le fichier Dockerfile suivant utilise jaz pour exécuter une application Java à partir d’un fichier 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"]

Installer sur Azure Linux

Pour les machines virtuelles et d’autres environnements Linux Azure, vous pouvez installer l’outil à l’aide du gestionnaire de tdnf package. Installez le jaz package avec la commande suivante :

sudo tdnf install jaz

Autres distributions Linux

Si vous avez déjà configuré le référentiel logiciel Linux pour les produits Microsoft, exécutez la commande de gestionnaire de package appropriée pour votre distribution pour installer le jaz package.

Par exemple, sur les distributions Ubuntu ou Debian, exécutez :

sudo apt-get install jaz

Si vous n’avez pas configuré le référentiel logiciel Linux pour les produits Microsoft, suivez les instructions de votre distribution Linux.

Pour l’installer sur Ubuntu, ouvrez un terminal et exécutez les commandes suivantes :

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

Une fois le référentiel ajouté, installez-le jaz en exécutant les commandes suivantes :

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

Versions de JDK certifiées

Le lanceur de commandes Azure pour Java nécessite une installation JDK basée sur OpenJDK (version 8 ou ultérieure) sur le système.

Important

Le lanceur de commandes Azure pour Java nécessite une installation complète de JDK. Il n’est pas entièrement testé avec des installations JRE uniquement ou des runtimes jlink personnalisés. Pour plus d’informations, consultez « Pourquoi ne fonctionne-t-il pas avec les runtimes JRE ou jlink ? ».

Le lanceur de commandes Azure pour Java est certifié avec les kits JDK suivants, qui reçoivent le jeu complet d’ajustements et d’optimisations sur x64 et arm64 :

Avec d’autres JDK basés sur OpenJDK, l’outil fait de son mieux pour lancer votre application, mais peut ne pas appliquer l’ensemble complet d’ajustements ou d’optimisations spécifiques à la version. Certaines optimisations sont également spécifiques à Build Microsoft d’OpenJDK et ne sont pas appliquées à d'autres distributions.

Lorsque l’outil détecte un JDK qui n’est pas certifié, il affiche l’avertissement suivant en cas d’erreur standard et continue de lancer votre application :

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

Pour obtenir de meilleurs résultats, utilisez l’un des JDK certifiés répertoriés précédemment.

Configuration

La jaz commande ne consomme aucun argument de ligne de commande pour sa propre configuration. Au lieu de cela, par défaut, il transmet tous les arguments directement à la java commande. Pour vous assurer que la jaz configuration n’interfère pas avec les arguments de votre application, jaz accepte uniquement la configuration via des variables d’environnement.

Vous pouvez configurer la commande à l’aide jaz de ces variables d’environnement :

Variable d'environnement Description
JAZ_HELP Définissez 1 pour imprimer un message d’aide et quitter avec le code 0.
JAZ_PRINT_VERSION Définir à 1 pour imprimer la version jaz sur stdout et quitter avec le code 0.
JAZ_DRY_RUN Définissez 1 pour imprimer la commande java qui serait exécutée et quitter avec le code 1.
JAZ_BYPASS Définissez 1 pour contourner jaz les ajustements d’optimisation. Aucun effet sur la télémétrie.
JAZ_IGNORE_USER_TUNING Définissez sur 1 pour ignorer tous les indicateurs de réglage fournis par l'utilisateur et appliquer à la place le réglage jaz. Sinon, jaz ajuste les paramètres de la JVM uniquement s’il ne détecte aucune option de réglage fournie par l’utilisateur. Consultez « Que se passe-t-il si j’ai déjà défini certaines options JVM dans mon environnement ? » pour plus d’informations sur jaz le comportement et sans activer ce paramètre.
JAZ_EXIT_WITHOUT_FLUSH Définissez la valeur à 1 pour ignorer le vidage des données de télémétrie lors de la sortie. Ce paramètre évite les retards potentiels (jusqu’à 30 secondes) que jaz pourrait entraîner lors de la purge des données ; cependant, jaz peut toujours envoyer des données de télémétrie.

L’utilisation de variables d’environnement plutôt que d’arguments de ligne de commande facilite également la configuration jaz dans certains cas. Lors du déploiement d’une application conteneurisée, il est parfois plus facile de définir des variables d’environnement que de modifier les scripts de lancement. L’expérience avec JAZ_IGNORE_USER_TUNING et JAZ_BYPASS peut être utile lors de l’évaluation jaz.

  • Last updated on