Le sezioni seguenti illustrano gli errori di inizializzazione e pubblicazione dell'app.
Errore di autorizzazione durante la creazione di un'app con il account di servizio predefinito
Quando crei un'app dopo aver attivato l'API App Engine per la prima volta, l'operazione non va a buon fine con i seguenti errori:
Interfaccia a riga di comando gcloud
An internal error occurred while calling service consumer manager for service account.
Creating App Engine application in project [PROJECT__ID] and [REGION]....failed. DEBUG: (gcloud.app.create) Error Response: [13] an internal error has occurred
Richiedere log
Service account creation is not allowed on this project.
Console
Error while initialising App Engine.
Questo errore può verificarsi a causa dell'applicazione del vincolo del criterio dell'organizzazione constraints/iam.disableServiceAccountCreation
durante la creazione dell'app. Questo criterio impedisce il provisioning del service account predefinito di App Engine PROJECT_ID@appspot.gserviceaccount.com
.
Per risolvere il problema, devi rimuovere temporaneamente il vincolo constraints/iam.disableServiceAccountCreation
del criterio dell'organizzazione per consentire la creazione e il deployment dell'account di servizio predefinito di App Engine. L'account di servizio predefinito è necessario per la creazione dell'app e non può essere ignorato. Questo vale anche quando utilizzi un account di servizio per versione.
L'account di servizio predefinito di App Engine può quindi essere eliminato o sostituito con un account di servizio creato dopo il deployment riuscito.
Se utilizzi un account di servizio che hai creato, consulta la Panoramica dei consigli sui ruoli per capire come applicare le autorizzazioni limitate, ad esempio fornire un ruolo di creatore di token all'account di servizio che crei per l'agente di servizio.
Nginx non riesce a connettersi o a contattare il contenitore dell'app
Il seguente errore si verifica solo nell'ambiente flessibile di App Engine e in genere viene restituito con errori 502 immediatamente dopo l'errore:
recv() failed (104: Connection reset by peer) while reading response header from upstream
Questo errore indica che il proxy inverso nginx (nginx sidecar) non è in grado di raggiungere il contenitore dell'app. Nei log, puoi confrontare il momento di chiusura dell'errore 502 nel log di nginx con il momento del log nginx.error. Un messaggio nginx.error seguito immediatamente da un errore nginx 502 è probabilmente la causa dell'errore nginx 502.
Questo errore si verifica spesso quando il timeout keepalive della connessione dell'applicazione è inferiore al timeout keepalive di nginx. Poiché nginx nell'ambiente flessibile di App Engine ha un keepalive_timeout
di 650 secondi, le applicazioni devono mantenere attive le connessioni per almeno questo periodo di tempo. Per impostazione predefinita, le applicazioni Node.js hanno un valore keepAliveTimeout
di 5000 millisecondi. In questo caso, puoi impostare server.keepAliveTimeout
su 700000 millisecondi.
Per risolvere il problema, controlla i log scritti dal codice in esecuzione nel contenitore dell'app collegandoti all'istanza VM e, se necessario, aggiungi altro logging per trovare la causa principale.
Memoria insufficiente
Il seguente errore si verifica nell'ambiente flessibile di App Engine e in genere viene restituito con errori 502:
kernel: [ 133.706951] Out of memory: Kill process 4490 (java) score 878 or sacrifice child kernel: [ 133.714468] Killed process 4306 (java) total-vm:5332376kB, anon-rss:2712108kB, file-rss:0kB
Questo errore indica che App Engine ha terminato l'applicazione.
Questo errore si verifica quando l'istanza ha memoria insufficiente. Per impostazione predefinita, l'ambiente flessibile App Engine ha 1 GB di memoria, con solo 600 MB disponibili per il contenitore dell'applicazione.
Per risolvere il problema, controlla i log e se viene visualizzata una voce Memoria insufficiente. Aggiorna
la configurazione di memory_gb
e esegui nuovamente il deployment.
Connessioni aperte insufficienti per gestire le richieste in arrivo
Le app potrebbero riscontrare un errore 502 se il numero massimo di connessioni in attesa è uguale o superiore al 75% del numero di connessioni attive.
Per risolvere il problema, controlla le metriche di monitoraggio cloud per il numero massimo di connessioni attive e in attesa e riduci il numero di connessioni in attesa per assicurarti che il numero massimo di connessioni in attesa sia inferiore o uguale al 75% del numero di connessioni attive.