Gradle è uno strumento di automazione delle build open source incentrato su flessibilità e prestazioni. App Engine fornisce un plug-in Gradle che puoi utilizzare per creare ed eseguire il deployment della tua app in App Engine.
L'esempio di codice mostra come configurare il filebuild.gradle
per aggiungere App Engine
Attività Gradle, repository Maven, plug-in Gradle di App Engine e dipendenze per Java 8.
Per Java 11 e versioni successive, consulta Runtime Java
per ulteriori informazioni sull'utilizzo di versioni più recenti.
Prima di iniziare
Installa Gradle (v3.4.1 o versioni successive)
Se non lo hai già fatto, segui i passaggi in questa guida per scaricare gcloud CLI, creare il tuo progetto Google Cloud inizializza l'app di App Engine.
Installa il componente
app-engine-java
della gcloud CLI:gcloud components install app-engine-java
Crea un nuovo progetto Gradle
Puoi creare un nuovo progetto Gradle da zero utilizzando la shell. In alternativa, per provare il plug-in, puoi scaricarlo, eseguirlo localmente del progetto hello world.
Per creare un nuovo progetto:
Crea una nuova directory e vai alla directory.
Per inizializzare un nuovo progetto:
Corsa di
gradle init
:gradle init --type java-library
Crea la cartella
WEB-INF
:mkdir -p src/main/webapp/WEB-INF
Crea la cartella
appengine
:mkdir -p src/main/appengine
Rimuovi i file stub generati da
gradle init
:rm src/main/java/Library.java src/test/java/LibraryTest.java
Aggiungi quanto segue al file
build.gradle
per aggiungere App Engine attività Gradle, repository Maven, plug-in Gradle di App Engine delle dipendenze e configurazione delle attività:Devi inoltre aggiungere al progetto i file seguenti utilizzando un file un editor o un ambiente di sviluppo integrato (IDE):
src/main/appengine/app.yaml
src/main/webapp/WEB-INF/web.xml
(a meno che l'app non utilizzi annotazioni di Servlet 3.1)- src/main/docker/Dockerfile (facoltativo per runtime personalizzati)
- Classi Java
- Classi di test Java
Consulta Configurare l'ambiente di sviluppo per una di un progetto Java App Engine.
scarica l'app Hello World
Clona il repository dell'app di esempio Hello World nella tua macchina locale:
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
In alternativa, puoi scaricare l'anteprima come file ZIP ed estrarlo.
Passa alla directory che contiene il codice di esempio:
cd java-docs-samples/flexible/java-8/helloworld
Test dell'applicazione con il server di sviluppo
Per accedere alle risorse Google dal tuo progetto quando vengono eseguite localmente: imposta le credenziali predefinite dell'applicazione eseguendo:
gcloud auth application-default login
Passa alla directory principale della directory dell'applicazione.
Durante la fase di sviluppo, puoi eseguire e testare l'applicazione in qualsiasi nel server di sviluppo richiamando Gradle:
gradle jettyRun
In alternativa, puoi eseguire Gradle senza installarlo utilizzando il wrapper Gradle.
Attendi l'avvio del server. Il server viene avviato con dell'applicazione in esecuzione. Quando viene visualizzato un messaggio simile a questo:
:prepareInplaceWebAppFolder :createInplaceWebAppFolder :compileJava :processResources UP-TO-DATE :classes :prepareInplaceWebAppClasses :prepareInplaceWebApp :jettyRun 17:40:05 INFO Jetty 9.2.15.v20160210 started and listening on port 8080 17:40:05 INFO runs at: 17:40:05 INFO http://localhost:8080/
Controlla che la tua app sia in esecuzione su
http://localhost:8080
.
Per ulteriori informazioni sul plug-in Gratty, consulta la sezione Configurazione di Gratty. e Attività rapide.
Esegui il deployment dell'applicazione
Per eseguire il deployment della tua applicazione:
gradle appengineDeploy
L'attività appengineDeploy
e tutte le altre attività Gradle hanno proprietà associate
che puoi utilizzare. Per un elenco completo di attività e proprietà, consulta
Attività e proprietà di App Engine Gradle.
Utilizzare il wrapper Gradle
Gradle fornisce un meccanismo per scaricare ed eseguire la versione richiesta di Gradle senza installazione:
Linux/macOS
Passa alla directory codice campione.
Esegui gradlew:
./gradlew jettyRun
Windows
Passa alla directory codice campione.
Esegui gradlew:
./gradlew.bat jettyRun
Puoi trovare ulteriori informazioni su Gradle in Attività e proprietà di App Engine Gradle.
Passaggi successivi
- Esplora il codice del plug-in e segnala eventuali problemi su GitHub.
- Scopri come specificare le proprietà per le attività facendo riferimento a Attività e proprietà di App Engine Gradle.