Il runtime Java è lo stack software responsabile dell'installazione il codice e le sue dipendenze ed eseguire il servizio.
Dichiara il runtime Java per l'ambiente standard di App Engine nel file app.yaml
. Ad esempio:
runtime: javaVERSION
Dove VERSION è il numero di versione di MAJOR
Java. Per
Ad esempio, per utilizzare l'ultima versione di Java, Java 21, specifica
21
.
Per altre versioni di Java supportate e la versione Ubuntu corrispondente per il tuo Versione Java, consulta la pianificazione del supporto del runtime.
Prima di iniziare
Scarica l'ultima versione di Google Cloud CLI oppure aggiorna gcloud CLI alla versione corrente:
gcloud components update
Per eseguire il deployment tramite Maven, dovrai aggiungere Plug-in Maven per App Engine al tuo file
pom.xml
:<plugin> <groupId>com.google.cloud.tools</groupId> <artifactId>appengine-maven-plugin</artifactId> <version>2.7.0</version> </plugin>
Altre opzioni per il deployment includono l'uso del comando
gcloud app deploy
o il plug-in Gradle di App Engine.Segui le istruzioni relative al framework dell'applicazione per configurare la build di un file
JAR
eseguibile.
Compatibilità del framework
Con il runtime Java di App Engine, puoi eseguire il deployment dell'eseguibile JAR . I runtime non includono alcun framework per la pubblicazione sul web, il che significa che non devi limitarti a usando framework o librerie basati su servlet. Usa le tue dipendenze native oppure come la libreria Netty.
Sono disponibili hello world
esempi che utilizzano i framework web Java più diffusi sulla
Repository GitHub di Google Cloud:
Non sei limitato a questi framework e ti invitiamo a provare preferito, come Grails, Blade, Play!, Vaadin o jHipster.
esegui il deployment di progetti di origine Maven nel runtime Java
Puoi eseguire il deployment del tuo progetto Maven come codice sorgente e fare in modo che venga creato e sottoposto a deployment. utilizzando i buildpack di Google Cloud.
Per eseguire il deployment di un progetto Maven come codice sorgente, vai al livello superiore del progetto directory e digita:
gcloud app deploy pom.xml
I log di build ed deployment verranno trasmessi in flusso e puoi vedere i log dettagliati nel Sezione della cronologia di Cloud Build nella console Cloud.
Utilizzo degli eseguibili GraalVM
Il runtime Java dell'ambiente standard di App Engine supporta l'immagine nativa GraalVM
eseguibili. Dopo aver compilato l'app Java in un ambiente GraalVM nativo
immagine, puoi utilizzare l'impostazione entrypoint
nel tuo
File app.yaml
in modo che punti all'eseguibile.
Ad esempio, un eseguibile con il nome file myexecutable
potrebbe avere la classe
seguenteapp.yaml
:
runtime: java17 # or another supported runtime entrypoint: ./myexecutable
Le librerie client di Google Cloud possono essere utilizzate per compilare le applicazioni un'immagine nativa GraalVM. Per ulteriori informazioni, consulta la documentazione su come Compila immagini native.
Versione Java
Il runtime Java utilizza l'ultima release stabile della versione
è specificato nel file app.yaml
. App Engine si aggiorna automaticamente
alle nuove versioni delle patch, ma non aggiornerà automaticamente
completamente gestita.
Ad esempio, il deployment dell'applicazione potrebbe essere eseguito in Java 11.0.4 e aggiornato automaticamente alla versione Java 11.0.5 in un deployment successivo del ma non verrà aggiornata automaticamente a Java 12.
Per informazioni su come eseguire l'upgrade della tua versione di Java, consulta Eseguire l'upgrade di un'applicazione esistente.
L'ambiente aperto JDK del runtime
App Engine esegue app Java in un container protetto da gVisor su un la distribuzione aggiornata di Ubuntu Linux e il suo supporto openjdk-11-jdk per Java 11 o openjdk-17-jdk per Java 17 runtime.
Per le versioni Ubuntu supportate per la tua versione Java, vedi Pianificazione del supporto dell'esecuzione.
App Engine mantiene l'immagine di base e aggiorna i pacchetti OpenJDK 11 e OpenJDK 17 senza dover eseguire nuovamente il deployment dell'app.
L'app di cui hai eseguito il deployment si trova nella directory /workspace
del runtime. È
accessibile anche tramite un link simbolico all'indirizzo /srv
.
Versioni Java di App Engine
Tutti gli artefatti rilasciati che iniziano con la versione 2.x.x
utilizzano
open source
meccanismo di rilascio. Gli artefatti rilasciati che iniziano con la versione 1.9.9xx
o precedenti utilizzano la classe
un sistema di compilazione interno. Consulta le
Repository GitHub
per ulteriori dettagli.
Dipendenze
Per ulteriori informazioni sulla dichiarazione e la gestione delle dipendenze, consulta Specifica delle dipendenze.
Avvio dell'applicazione
I framework come Spring Boot, Micronaut e Ktor creano un uber eseguibile JAR
per impostazione predefinita. Se il file di build Maven o Gradle produce un JAR Uber eseguibile,
il runtime avvia l'applicazione eseguendo un'applicazione Uber JAR.
In alternativa, App Engine utilizzerà i contenuti dell'interfaccia
Campo entrypoint
nel file app.yaml
. Ad esempio:
runtime: java21 # or another supported runtime entrypoint: java -Xmx64m -jar YOUR-ARTIFACT.jar
Dove il jar dell'applicazione YOUR-ARTIFACT.jar di esempio deve:
- Trova il file
app.yaml
nella directory root. - Contenere una voce
Main-Class
nel relativo file di metadatiMETA-INF/MANIFEST.MF
. - Facoltativamente, contiene una voce
Class-Path
con un elenco di percorsi relativi a altri jar dipendenti. Questi verranno caricati automaticamente con l'applicazione.
Affinché la tua app riceva richieste HTTP, il tuo punto di ingresso deve avviare un server web
che rimane in ascolto sulla porta specificata dalla variabile di ambiente PORT
. Il valore
della variabile di ambiente PORT
viene impostato in modo dinamico
dall'ambiente di gestione di App Engine. Questo valore
non può essere impostato nella sezione env_variables
del file app.yaml
.
Con un punto di ingresso personalizzato, puoi creare e pacchettizzare la tua applicazione come file JAR sottile contenente solo il codice dell'applicazione e delle dipendenze. Quando esegui il deployment della tua applicazione, Il plug-in del motore caricherà solo i file modificati, anziché l'intero pacchetto JAR uber.
Accertati di utilizzare la variabile di ambiente PORT
Se vedi gli avvisi relativi alla porta 8080 e NGINX nei file di log delle app,
il server web dell'app rimane in ascolto sulla porta predefinita 8080. In questo modo
ad App Engine di usare il proprio livello NGINX per comprimere le risposte HTTP. Me
di configurare il server web in modo che risponda alle richieste HTTP
specificata dalla variabile di ambiente PORT
, in genere 8081. Ad esempio:
Compatibilità con le versioni precedenti di Java
Per le differenze tra Java 8 e l'ultima versione di Java supportata, vedi Differenze principali tra i runtime Java 8 e Java 11+.
Variabili di ambiente
Le seguenti variabili di ambiente sono impostate dal runtime:
Variabile di ambiente | Descrizione |
---|---|
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto dal prefisso "region code~" ad esempio "e~" per le applicazioni distribuite in Europa. |
GAE_DEPLOYMENT_ID |
L'ID del deployment attuale. |
GAE_ENV |
L'ambiente App Engine. Impostata su standard . |
GAE_INSTANCE |
L'ID dell'istanza su cui è attualmente in esecuzione il servizio. |
GAE_MEMORY_MB |
La quantità di memoria disponibile per il processo di richiesta, in MB. |
GAE_RUNTIME |
Il tempo di esecuzione specificato nel file app.yaml . |
GAE_SERVICE |
Il nome del servizio specificato nel file app.yaml . Se non viene specificato alcun nome di servizio, viene impostato su default . |
GAE_VERSION |
L'etichetta della versione corrente del servizio. |
GOOGLE_CLOUD_PROJECT |
L'ID progetto Google Cloud associato alla tua applicazione. |
PORT |
La porta che riceve le richieste HTTP. |
NODE_ENV (disponibile solo nel runtime Node.js) |
Imposta su production quando viene eseguito il deployment del servizio. |
Puoi
definisci altre variabili di ambiente nel file app.yaml
,
ma non è possibile eseguire l'override dei valori precedenti, ad eccezione di NODE_ENV
.
Proxy HTTPS e di forwarding
App Engine termina le connessioni HTTPS al bilanciatore del carico
inoltra le richieste alla tua applicazione. Alcune applicazioni devono determinare
l'IP e il protocollo della richiesta originale. L'indirizzo IP dell'utente è disponibile in
l'intestazione X-Forwarded-For
standard. Applicazioni che lo richiedono
le informazioni devono configurare il framework web per considerare attendibile il proxy.
Accesso al file system
Il runtime include una directory /tmp
accessibile in scrittura, con tutte le altre directory
con accesso di sola lettura. La scrittura su /tmp
occupa memoria di sistema.
Server metadati
Ogni istanza dell'applicazione può utilizzare il server di metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul tuo progetto.
Puoi accedere al server di metadati tramite i seguenti endpoint:
http://metadata
http://metadata.google.internal
Le richieste inviate al server dei metadati devono includere l'intestazione della richiesta
Metadata-Flavor: Google
. Questa intestazione indica che la richiesta è stata inviata con
l'intenzione di recuperare i valori dei metadati.
La tabella seguente elenca gli endpoint per i quali è possibile effettuare richieste HTTP metadati specifici:
Endpoint metadati | Descrizione |
---|---|
/computeMetadata/v1/project/numeric-project-id |
Il numero del progetto assegnato al tuo progetto. |
/computeMetadata/v1/project/project-id |
L'ID progetto assegnato al progetto. |
/computeMetadata/v1/instance/region |
La regione in cui è in esecuzione l'istanza. |
/computeMetadata/v1/instance/service-accounts/default/aliases |
|
/computeMetadata/v1/instance/service-accounts/default/email |
L'indirizzo email dell'account di servizio predefinito assegnato al progetto. |
/computeMetadata/v1/instance/service-accounts/default/ |
Elenca tutti gli account di servizio predefiniti per il tuo progetto. |
/computeMetadata/v1/instance/service-accounts/default/scopes |
Elenca tutti gli ambiti supportati per gli account di servizio predefiniti. |
/computeMetadata/v1/instance/service-accounts/default/token |
Restituisce il token di autenticazione che può essere utilizzato per autenticare l'applicazione in altre API Google Cloud. |
Ad esempio, per recuperare l'ID progetto, invia una richiesta a
http://metadata.google.internal/computeMetadata/v1/project/project-id
.