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

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

  • Статья

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

Эта статья относится к: ❎ 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" в разделе "Развертывание приложений Java" в плане Azure Spring Apps Enterprise.

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

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

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

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

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

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