Compartilhar via

Solucionar problemas comuns de compilação em Aplicativos Spring do Azure

  • Artigo

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano consumo e dedicado Standard será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo se aplica a: ❎ Básico/Padrão ✅ Enterprise

Este artigo descreve como solucionar problemas de compilação com a implantação do Aplicativos Spring do Azure.

Compilar códigos de saída

O plano Enterprise de Aplicativos Spring do Azure usa o Tanzu Buildpacks para transformar o código-fonte do aplicativo em imagens. Para obter mais informações, confira Tanzu Buildpacks.

Quando implanta seu aplicativo em Aplicativos Spring do Azure usando a CLI do Azure, você visualiza um log de build no console da CLI do Azure. Se a compilação falhar, o Aplicativos Spring do Azure exibirá um código de saída e uma mensagem de erro no console da CLI indicando por que a execução do buildpack falhou durante diferentes fases do ciclo de vida do buildpack.

A lista a seguir descreve alguns códigos de saída comuns:

  • 20 – Todos os grupos do buildpack falharam em detectar.

    Considere as seguintes causas possíveis de um código de saída de 20:

    • O construtor que você está usando não dá suporte à linguagem usada pelo projeto.

      Se você estiver usando o construtor padrão, verifique a linguagem compatível com o construtor padrão. Para obter mais informações, consulte Tipos de APM compatíveis e Como configurar a integração do APM e os certificados de AC.

      Se estiver usando o construtor personalizado, verifique se o buildpack do construtor personalizado dá suporte à linguagem usada pelo projeto.

    • Você está executando com base no caminho errado; por exemplo, o arquivo pom.xml do projeto Maven não está no caminho raiz.

      Defina BP_MAVEN_POM_FILE para especificar o local do arquivo pom.xml do projeto.

    • Há algo de errado com seu aplicativo; por exemplo, o arquivo .jar não tem um arquivo /META-INF/MANIFEST.MF que contenha uma entrada Main-Class.

  • 51 – Erro de compilação do Buildpack.

    Considere as seguintes causas possíveis de um código de saída de 51:

    • Se o Aplicativos Spring do Azure exibir a mensagem de erro Build failed in stage build with reason OOMKilled no console da CLI do Azure, a compilação falhará devido a memória insuficiente.

      Use o seguinte comando para aumentar a memória usando a variável de ambiente 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

    • A compilação falhou devido a um erro de código-fonte do aplicativo; por exemplo, há um erro de compilação no código-fonte.

      Verifique o log de build para localizar a causa raiz.

    • Falha na compilação devido a um erro de dependência de download; por exemplo, um problema de rede fez com que o download de dependência do Maven falhasse.

    • O build falhou devido a uma versão do JDK incompatível. Por exemplo, o arquivo JAR foi compilado usando versões LTS não Java, que não são compatíveis com o buildpack. Para versões compatíveis, consulte a seção Implantar aplicativos Java de Como implantar aplicativos poliglotas no plano Enterprise de Aplicativos Spring do Azure.

  • 62 – Falha ao gravar a imagem no Registro de Contêiner do Azure.

    Considere a seguinte causa possível de um código de saída de 62:

    • Se o Aplicativos Spring do Azure exibir a mensagem de erro Failed to write image to the following tags no log de build, a compilação falhará devido a um problema de rede.

      Tente novamente para corrigir o problema.

Se seu aplicativo for um arquivo estático ou um aplicativo front-end dinâmico atendido por um servidor web, consulte a seção Erros comuns de build e implantação em Implantar arquivos estáticos da web.

Próximas etapas