Поделиться через


Устранение распространенных проблем сборки в Azure Spring Apps

Примечание.

Планы Basic, Standardи Enterprise вступили в период вывода из обращения 17 марта 2025 года. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

План стандартного потребления и выделенный план вошли в период вывода из эксплуатации 30 сентября 2024 года, с полным завершением работы к концу марта 2025 года. Для получения дополнительной информации см. Миграция потребительского и выделенного плана Azure Spring Apps Standard в Azure Container Apps.

Эта статья относится к: ❎ Basic/Standard ✅ Enterprise

В этой статье описывается, как устранять проблемы со сборкой при развертывании Azure Spring Apps.

Коды выхода сборки

План Azure Spring Apps Enterprise использует Tanzu Buildpacks для преобразования исходного кода приложения в образы. Дополнительные сведения см. в разделе Tanzu Buildpacks.

При развертывании приложения в Azure Spring Apps с помощью Azure CLI вы увидите журнал сборки в консоли Azure CLI. Если сборка завершается ошибкой, Azure Spring Apps отображает код выхода и сообщение об ошибке в консоли CLI, указывающее, почему выполнение пакета сборки завершилось сбоем во время различных этапов жизненного цикла пакета сборки.

В следующем списке описаны некоторые распространенные коды выхода:

  • 20 . Не удалось обнаружить все группы buildpack.

    Рассмотрим следующие возможные причины кода 20выхода:

    • Построитель, который вы используете, не поддерживает язык, используемый проектом.

      Если вы используете построитель по умолчанию, проверьте язык, поддерживаемый построителем по умолчанию. Для получения дополнительной информации см. раздел «Поддерживаемые типы APM» в документе «Настройка интеграции APM и сертификатов ЦС».

      Если вы используете пользовательский построитель, проверьте, поддерживает ли ваш пользовательский пакет сборки построителя язык, используемый проектом.

    • Вы используете неправильный путь; например, файл pom.xml вашего проекта Maven не находится в корневой директории.

      Задайте BP_MAVEN_POM_FILE для указания расположения файла pom.xml проекта.

    • Есть что-то неправильное с приложением; Например, файл .jar не имеет файла /META-INF/MANIFEST. MF-файл , содержащий Main-Class запись.

  • 51 . Ошибка сборки buildpack.

    Рассмотрим следующие возможные причины кода 51выхода:

    • Если Azure Spring Apps отображает сообщение Build failed in stage build with reason OOMKilled об ошибке в консоли Azure CLI, сборка завершилась ошибкой из-за нехватки памяти.

      Используйте следующую команду, чтобы увеличить память с помощью переменной 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
      
    • Сбой сборки из-за ошибки исходного кода приложения; Например, в исходном коде возникает ошибка компиляции.

      Проверьте журнал сборки, чтобы найти первопричину.

    • Сбой сборки произошел из-за ошибки при загрузке зависимостей; например, сетевая проблема привела к сбою при загрузке зависимостей Maven.

    • Сбой сборки из-за неподдерживаемой версии JDK. Например, JAR-файл компилируется с помощью версий LTS, отличных от Java, которые не поддерживаются пакетом сборки. Сведения о поддерживаемых версиях см. в разделе "Развертывание приложений Java" в разделе "Как развертывать многозначные приложения в плане Azure Spring Apps Enterprise".

  • 62. Не удалось написать изображение в Реестр контейнеров Azure.

    Рассмотрим следующую возможную причину кода 62выхода:

    • Если Azure Spring Apps отображает сообщение Failed to write image to the following tags об ошибке в журнале сборки, сборка завершилась ошибкой из-за проблемы с сетью.

      Повторите попытку, чтобы устранить проблему.

Если приложение является статическим файлом или динамическим интерфейсным приложением, обслуживаемым веб-сервером, см. раздел "Распространенные ошибки сборки и развертывания" статьи "Развертывание статических веб-файлов".

Следующие шаги