Share via


Risolvere i problemi di compilazione comuni nelle app Azure Spring

Nota

Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.

Questo articolo si applica a:❌ Basic/Standard ✔️ Enterprise

Questo articolo descrive come risolvere i problemi di compilazione con la distribuzione di Azure Spring Apps.

Compilare i codici di uscita

Il piano Enterprise di Azure Spring Apps usa i buildpack Tanzu per trasformare il codice sorgente dell'applicazione in immagini. Per altre informazioni, vedere Tanzu Buildpacks.

Quando si distribuisce l'app in Azure Spring Apps usando l'interfaccia della riga di comando di Azure, viene visualizzato un log di compilazione nella console dell'interfaccia della riga di comando di Azure. Se la compilazione non riesce, Azure Spring Apps visualizza un codice di uscita e un messaggio di errore nella console dell'interfaccia della riga di comando che indica il motivo per cui l'esecuzione del pacchetto di compilazione non è riuscita durante diverse fasi del ciclo di vita della buildpack.

L'elenco seguente descrive alcuni codici di uscita comuni:

  • 20 - Non è stato possibile rilevare tutti i gruppi buildpack.

    Considerare le possibili cause seguenti di un codice di uscita pari a 20:

    • Il generatore in uso non supporta il linguaggio usato dal progetto.

      Se si usa il generatore predefinito, controllare la lingua supportata dal generatore predefinito. Per altre informazioni, vedere la sezione Tipi di APM supportati di Come configurare l'integrazione di APM e i certificati della CA.

      Se si usa il generatore personalizzato, verificare se il pacchetto di compilazione del generatore personalizzato supporta il linguaggio usato dal progetto.

    • Stai correndo contro il percorso sbagliato; Ad esempio, il file di pom.xml del progetto Maven non si trova nel percorso radice.

      Impostare BP_MAVEN_POM_FILE per specificare il percorso del file di pom.xml del progetto.

    • C'è qualcosa di sbagliato con l'applicazione; Ad esempio, il file .jar non ha un /META-INF/MANIFEST. File MF che contiene una Main-Class voce.

  • 51 - Errore di compilazione buildpack.

    Considerare le possibili cause seguenti di un codice di uscita pari a 51:

    • Se Azure Spring Apps visualizza il messaggio Build failed in stage build with reason OOMKilled di errore nella console dell'interfaccia della riga di comando di Azure, la compilazione non è riuscita a causa di memoria insufficiente.

      Usare il comando seguente per aumentare la memoria usando la build-memory variabile di ambiente:

      az spring app deploy \
          --resource-group <your-resource-group-name> \
          --service <your-Azure-Spring-Apps-name> \
          --name <your-app-name> \
          --build-memory 3Gi
      
    • La compilazione non è riuscita a causa di un errore di codice sorgente dell'applicazione; Ad esempio, si verifica un errore di compilazione nel codice sorgente.

      Controllare il log di compilazione per trovare la causa radice.

    • La compilazione non è riuscita a causa di un errore di dipendenza del download; Ad esempio, un problema di rete ha causato l'esito negativo del download delle dipendenze Maven.

    • La compilazione non è riuscita a causa di una versione JDK non supportata. Ad esempio, il file JAR è stato compilato usando versioni non Java LTS, che non sono supportate dal buildpack. Per le versioni supportate, vedere la sezione Distribuire applicazioni Java di Come distribuire app polyglot nel piano Azure Spring Apps Enterprise.

  • 62 - Impossibile scrivere l'immagine in Registro Azure Container.

    Si consideri la causa seguente di un codice di uscita 62:

    • Se Azure Spring Apps visualizza il messaggio Failed to write image to the following tags di errore nel log di compilazione, la compilazione non è riuscita a causa di un problema di rete.

      Riprovare a risolvere il problema.

Se l'applicazione è un file statico o un'applicazione front-end dinamica servita da un server Web, vedere la sezione Errori comuni di compilazione e distribuzione di Deploy Web static files (Distribuire file statici Web).

Passaggi successivi