Déployer une application App Engine sur l'environnement d'exécution Java avec Eclipse

Cette page décrit comment déployer votre projet Maven sur l'environnement d'exécution flexible Java App Engine à l'aide d'Eclipse.

Cet environnement d'exécution fournit un JDK et n'inclut pas de serveur Web. Votre application doit générer un fichier Fat JAR exécutable à l'aide de la commande mvn package qui inclut toutes les dépendances nécessaires et s'exécute à l'aide de la méthode main().

Avant de commencer

  1. Vous devez disposer d'un projet Google Cloud comprenant une application App Engine sur lequel effectuer le déploiement. Si vous n'en possédez pas déjà un, utilisez la console Google Cloud pour configurer votre projet Google Cloud:

    Accéder à la console Google Cloud

    1. Sélectionnez ou créez un projet Google Cloud.

  2. Connectez-vous à un compte Google utilisé pour déployer votre projet sur App Engine.

    1. Exécutez la commande suivante :

      gcloud auth application-default login

    2. Le navigateur de votre système s'ouvre en dehors de la CLI et vous demande les autorisations nécessaires pour gérer vos applications App Engine:

      1. Afficher et gérer les données dans les services Google Cloud

    3. Cliquez sur Allow (Autoriser) et fermez la fenêtre. Eclipse est désormais connecté à votre compte.

Déployer votre projet

Pour déployer votre projet sur un environnement flexible, procédez comme suit :

  1. Dans l'explorateur de projets, cliquez avec le bouton droit sur le projet à déployer.

  2. Ouvrez le menu contextuel et sélectionnez Properties (Propriétés).

  3. Dans la barre latérale, sélectionnez Project Facets (Attributs du projet).

    1. Si votre projet ne dispose pas d'attributs, cliquez sur le lien Convert to faceted form… (Passer en mode projet avec attributs…) pour afficher les attributs disponibles.

  4. Cochez la case d'attribut App Engine Java Flexible Environment (JAR) (Environnement flexible Java App Engine (JAR)).

    Une boîte de dialogue permettant de sélectionner les attributs du projet. Elle contient une liste des attributs disponibles pour le projet. Dans la capture d'écran, les attributs "App Engine Java Flexible Environment (JAR)" (Environnement flexible Java App Engine (JAR)) et JAVA sont sélectionnés.

  5. Cliquez sur OK.

  6. Dans l'explorateur de packages ou l'explorateur de projets, sélectionnez le projet à déployer.

  7. Dans la barre d'outils Google Cloud, cliquez sur le bouton suivant : Logo Google Cloud..

  8. Sélectionnez Déployer vers l'environnement flexible App Engine dans le menu déroulant.

    Une boîte de dialogue s'affiche.

    Une boîte de dialogue permettant de configurer le déploiement. Elle contient un menu déroulant permettant de sélectionner un compte et une liste de projets sur lesquels effectuer le déploiement. Elle comprend également un champ indiquant le chemin d'accès au fichier app.yaml, ainsi qu'un bouton "Browse" (Parcourir) permettant de rechercher un nouveau fichier app.yaml. De plus, elle contient plusieurs cases à cocher, permettant respectivement de passer à la version déployée pour recevoir tout le trafic, d'interrompre la version précédente et d'inclure des fichiers de configuration App Engine facultatifs. Enfin, elle contient un panneau à développer permettant d'accéder aux options avancées, ainsi qu'un champ permettant de saisir un bucket de préproduction.

  9. Dans le champ Account, sélectionnez le compte que vous souhaitez déployer ou ajoutez un nouveau compte.

  10. Dans le champ Project (Projet), sélectionnez le projet Google Cloud sur lequel vous souhaitez effectuer le déploiement.

  11. Dans le champ app.yaml, cliquez sur Browse (Parcourir) pour sélectionner votre fichier app.yaml s'il ne se trouve pas dans le répertoire src/main/appengine/ par défaut.

  12. Si vous souhaitez maintenir l'exécution de la version actuelle et passer à la nouvelle version ultérieurement en mode manuel à l'aide de gcloud ou de la console Google Cloud, décochez la case Promote the deployed version to receive all traffic (Passer à la version déployée pour recevoir tout le trafic).

  13. Si vous ne souhaitez pas interrompre la version précédente, décochez la case Stop previous version (Interrompre la version précédente).

  14. Cliquez sur Deploy (Déployer).

Une tâche en arrière-plan est lancée afin de déployer le projet sur App Engine. Les résultats de la tâche s'affichent dans la vue de la console Eclipse.

Étape suivante

  • Explorez le code du plug-in ou signalez des problèmes sur GitHub, ou posez une question sur Stack Overflow.