Partilhar via

Solucionar problemas comuns de compilação no Azure Spring Apps

Nota

Os planos Basic, Standarde Enterprise entraram em um período de aposentadoria em 17 de março de 2025. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

Este artigo aplica-se a: ❎ Basic/Standard ✅ Enterprise

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

Criar códigos de saída

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

Quando você implanta seu aplicativo no Azure Spring Apps usando a CLI do Azure, você vê um log de compilação no console da CLI do Azure. Se a compilação falhar, o Azure Spring Apps 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 buildpack não conseguiram detetar.

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

    • O construtor que você está usando não suporta a linguagem que seu projeto usou.

      Se você estiver usando o construtor padrão, verifique o idioma suportado pelo construtor padrão. Para obter mais informações, consulte a secção de Tipos de APM suportados de Como configurar a integração APM e certificados CA.

      Se você estiver usando o construtor personalizado, verifique se o buildpack do construtor personalizado suporta o idioma usado pelo projeto.

    • Está no caminho errado; por exemplo, o arquivo pom.xml do seu 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 errado com a sua aplicação; por exemplo, o seu 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 Azure Spring Apps exibir a mensagem Build failed in stage build with reason OOMKilled de erro no console da CLI do Azure, a compilação falhou devido à memória insuficiente.

      Use o seguinte comando para aumentar a memória usando a build-memory variável de ambiente:

      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 compilação para encontrar a causa raiz.

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

    • A compilação falhou devido a uma versão JDK não suportada. Por exemplo, o arquivo JAR foi compilado usando versões LTS não-Java, que não são suportadas pelo buildpack. Para obter versões com suporte, consulte a seção Implantar aplicativos Java de Como implantar aplicativos poliglotas no plano do Azure Spring Apps Enterprise.

  • 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 Azure Spring Apps exibir a mensagem Failed to write image to the following tags de erro no log de compilação, a compilação falhou devido a um problema de rede.

      Tente corrigir novamente o problema.

Se o seu aplicativo for um ficheiro estático ou um aplicativo front-end dinâmico servido por um servidor web, consulte a seção Erros comuns na construção e implementação de Implementar ficheiros estáticos da web.

Próximos passos

  • Last updated on