Gradle est un outil Open Source d'automatisation de la compilation axé sur la flexibilité et les performances. App Engine fournit un plug-in Gradle que vous pouvez utiliser pour créer et déployer votre application sur App Engine.
Avant de commencer
Installer Gradle (version 3.4.1 ou ultérieure)
Si vous ne l'avez pas déjà fait, suivez la procédure de ceguide pour télécharger gcloud CLI, créer votre projet Google Cloud et initialiser votre application App Engine.
Installez le composant gcloud CLI
app-engine-java
:gcloud components install app-engine-java
Créer un projet Gradle
Vous pouvez créer entièrement un projet Gradle à l'aide de l'interface système. Pour essayer le plug-in, vous pouvez également télécharger, exécuter en local et déployer le projet hello world.
Pour créer un projet :
Créez un nouveau répertoire et accédez à celui-ci.
Pour initialiser un nouveau projet :
Exécutez
gradle init
:gradle init --type java-library
Créez le dossier
WEB-INF
:mkdir -p src/main/webapp/WEB-INF
Créez le dossier
appengine
:mkdir -p src/main/appengine
Supprimez les fichiers de simulation générés par
gradle init
:rm src/main/java/Library.java src/test/java/LibraryTest.java
Insérez les lignes suivantes dans le fichier
build.gradle
afin d'ajouter des tâches Gradle pour App Engine, des dépôts Maven, le plug-in Gradle pour App Engine, des dépendances et la configuration des tâches :Vous devez également ajouter les fichiers suivants à votre projet, à l'aide d'un éditeur de texte ou d'un environnement de développement intégré (IDE) :
- src/main/docker/Dockerfile (facultatif pour les environnements d'exécution personnalisés)
- Classes Java
- Classes de test Java
Pour découvrir une présentation du projet Java App Engine, consultez la page Configurer votre environnement de développement.
Télécharger l'application Hello World
Clonez le dépôt de l'exemple d'application Hello World sur votre ordinateur :
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Vous pouvez également télécharger l'exemple en tant que fichier zip et l'extraire.
Accédez au répertoire qui contient l'exemple de code :
cd java-docs-samples/flexible/java-8/helloworld
Tester votre application avec un serveur de développement
Pour accéder aux ressources Google de votre projet lors de l'exécution en local, définissez les identifiants par défaut de l'application en exécutant la commande suivante :
gcloud auth application-default login
Accédez à la racine du répertoire de votre application.
À tout moment pendant la phase de développement, vous pouvez exécuter et tester votre application sur le serveur de développement en appelant Gradle, à l'aide de la commande suivante :
gradle jettyRun
Vous pouvez également exécuter Gradle sans l’installer à l’aide du wrapper Gradle.
Attendez que le serveur démarre. Une fois le serveur démarré et votre application en cours d'exécution, un message semblable à celui-ci s'affiche :
: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/
Accédez à l'adresse
http://localhost:8080
pour visualiser l'exécution de votre application.
Pour en savoir plus sur le plug-in Gretty, consultez les sections Gretty Configuration (Configuration Gretty) et Gretty tasks (Tâches Gretty).
Déployer votre application
Pour déployer votre application, procédez comme suit :
gradle appengineDeploy
La tâche appengineDeploy
et toutes les autres tâches Gradle sont associées à des propriétés que vous pouvez utiliser. Pour obtenir la liste complète des tâches et des propriétés disponibles, consultez la page Tâches et propriétés Gradle pour App Engine.
Utiliser le wrapper Gradle
Gradle fournit un mécanisme permettant de télécharger et exécuter la version requise de Gradle sans l'installer :
Linux/macOS
Accédez au répertoire de l'exemple de code :
Exécutez gradlew :
./gradlew jettyRun
Windows
Accédez au répertoire de l'exemple de code :
Exécutez gradlew :
./gradlew.bat jettyRun
Pour en savoir plus sur Gradle, consultez la section Tâches et propriétés Gradle pour App Engine.
Étapes suivantes
- Explorez le code du plug-in et signalez les problèmes sur GitHub.
- Accédez à la page Tâches et propriétés Gradle pour App Engine pour découvrir comment spécifier des propriétés de tâches.