Partager via

Résoudre les problèmes courants de build dans Azure Spring Apps

  • Article

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ❎ Essentiel/Standard ✅ Entreprise

Cet article explique comment résoudre les problèmes de build rencontrés avec votre déploiement d’Azure Spring Apps.

Codes de sortie de build

Le plan Azure Spring Apps Enterprise utilise Tanzu Buildpacks pour transformer le code source de votre application en images. Pour plus d’informations, consultez Buildpacks Tanzu.

Lorsque vous déployez votre application dans Azure Spring Apps à l’aide de Azure CLI, vous voyez un journal de génération dans la console Azure CLI. Si la build échoue, Azure Spring Apps affiche un code de sortie et un message d’erreur dans la console CLI indiquant pourquoi l’exécution du buildpack a échoué à différentes phases du cycle de vie du buildpack.

La liste suivante décrit certains codes de sortie courants :

  • 20 : les groupes de buildpack n’ont pas pu être détectés.

    Examinez les causes possibles suivantes d’un code de sortie 20 :

    • Le générateur de build que vous utilisez ne prend pas en charge le langage utilisé par votre projet.

      Si vous utilisez le générateur par défaut, vérifiez le langage qu’il prend en charge. Pour plus d’informations, consultez la section Types APM pris en charge de Comment configurer les certificats d’intégration et d’autorité de certification APM.

      Si vous utilisez le générateur personnalisé, vérifiez que le buildpack du générateur prend en charge le langage utilisé par votre projet.

    • Le chemin d’exécution n’est pas correct : par exemple, le fichier pom.xml de votre projet Maven ne se trouve pas dans le chemin racine.

      Définissez BP_MAVEN_POM_FILE pour spécifier l’emplacement du fichier pom.xml du projet.

    • Il y a un problème avec votre application : par exemple, le fichier .jar n’a pas de fichier /META-INF/MANIFEST.MF contenant une entrée Main-Class.

  • 51 : erreur de build de buildpack.

    Examinez les causes possibles suivantes d’un code de sortie 51 :

    • Si Azure Spring Apps affiche le message d’erreur Build failed in stage build with reason OOMKilled dans la console Azure CLI, cela signifie que la build a échoué en raison d’une mémoire insuffisante.

      Utilisez la commande suivante pour augmenter la mémoire définie avec la variable d’environnement build-memory :

      az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-app-name> \
    --build-memory 3Gi

    • La build a échoué en raison d’une erreur de code source d’application : par exemple, il y a une erreur de compilation dans votre code source.

      Examinez le journal de build pour identifier la cause racine.

    • La build a échoué en raison d’une erreur de téléchargement d’une dépendance : par exemple, un problème réseau a provoqué l’échec du téléchargement de la dépendance Maven.

    • La build a échoué en raison d’une version JDK non prise en charge. Par exemple, le fichier JAR a été compilé à l’aide de versions non Java LTS, qui ne sont pas prises en charge par le buildpack. Pour connaître les versions prises en charge, consultez la section Déployer des applications Java de Comment déployer des applications polyglottes dans le plan Azure Spring Apps Enterprise.

  • 62 : échec de l’écriture de l’image dans Azure Container Registry.

    Examinez la cause possible suivante d’un code de sortie 62 :

    • Si Azure Spring Apps affiche le message d’erreur Failed to write image to the following tags dans le journal de build, cela signifie que la build a échoué en raison d’un problème réseau.

      Faites une nouvelle tentative pour résoudre le problème.

Si votre application est un fichier statique ou une application front-end dynamique servie par un serveur web, consultez la section Erreurs de génération et de déploiement courantes de Déployer des fichiers web statiques.

Étapes suivantes