Démarrage rapide pour Java 8 dans l'environnement standard App Engine

Ce guide de démarrage rapide explique comment déployer un exemple d'application sur App Engine. Si vous souhaitez en savoir plus sur le codage d'une application pour App Engine, consultez la page Concevoir une application.

Coûts

Les procédures de ce guide n'engendrent aucun coût. L'exécution seule de cet exemple d'application ne dépasse pas votre quota gratuit.

Avant de commencer

Dans ce guide de démarrage rapide, nous partons du principe que vous avez installé le kit de développement Java SE 8 (JDK).

Avant d'exécuter et de déployer ce démarrage rapide, installez le SDK Cloud, puis configurez un projet GCP pour App Engine :

  1. Téléchargez et installez le SDK Cloud :

    Télécharger le SDK

    Remarque : Si le SDK Cloud est déjà installé, mettez-le à jour en exécutant la commande suivante :

    gcloud components update
    
  2. Créez un projet :

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Vérifiez que le projet a été créé :

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Vous voyez alors les informations relatives au projet qui peuvent se présenter sous la forme suivante :

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. Initialisez votre application App Engine avec votre projet, puis choisissez sa région :

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Lorsque vous y êtes invité, sélectionnez la région dans laquelle vous souhaitez déployer votre application App Engine.

  4. Installez les composants requis suivants :

    • Télécharger et installer Git.
    • Installer le composant App Engine :

      gcloud components install app-engine-java
      
    • Installer Maven. Ce démarrage rapide utilise la version 3.5 ou une version ultérieure d'Apache Maven pour créer, exécuter et déployer l'exemple d'application. Pour en savoir plus sur l'installation de Maven, consultez la page Utiliser Apache Maven et le plug-in App Engine.

Zones App Engine

App Engine est régional, ce qui signifie que l'infrastructure qui exécute vos applications est située dans une région spécifique et gérée par Google pour être disponible de manière redondante dans toutes les zones de cette région.

Lors de la sélection d'une région dans laquelle exécuter vos applications, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez choisir la région la plus proche des utilisateurs de votre application, mais vous devez aussi tenir compte de l'emplacement des autres produits et services GCP exploités par votre application. L'utilisation des services dans plusieurs emplacements peut affecter la latence et les tarifs de votre application.

App Engine est disponible dans les régions suivantes :

  • northamerica-northeast1 (Montréal)
  • us-central (Iowa)
  • us-west2 (Los Angeles)
  • us-east1 (Caroline du Sud)
  • us-east4 (Virginie du Nord)
  • southamerica-east1 (São Paulo)
  • europe-west (Belgique)
  • europe-west2 (Londres)
  • europe-west3 (Francfort)
  • europe-west6 (Zurich)
  • asia-northeast1 (Tokyo)
  • asia-northeast2 (Osaka)
  • asia-east2 (Hong Kong)
  • asia-south1 (Mumbai)
  • australia-southeast1 (Sydney)

Une fois définie, vous ne pouvez plus modifier la région d'une application.

Si vous avez déjà créé une application App Engine, vous pouvez afficher la région en exécutant la commande gcloud app describe ou en ouvrant le tableau de bord App Engine dans la console GCP. La région de votre application App Engine est indiquée sous http://[YOUR_PROJECT_ID].appspot.com.

Télécharger l'application Hello World

Nous avons créé une application Hello World simple pour l'environnement d'exécution Java 8 afin que vous puissiez rapidement avoir une idée du processus de déploiement d'une application dans l'environnement standard App Engine.

Téléchargez l'exemple d'application, puis accédez au répertoire de l'application :

  1. Clonez le dépôt de l'exemple d'application Hello World sur votre ordinateur local :

    git clone https://github.com/GoogleCloudPlatform/getting-started-java.git
    

    Vous pouvez également télécharger l'exemple sous forme de fichier zip et l'extraire.

  2. Accédez au répertoire qui contient l'exemple de code :

    cd getting-started-java/appengine-standard-java8/helloworld
    

Exécuter Hello World sur un ordinateur local

Pour exécuter l'application Hello World sur votre ordinateur local, procédez comme suit :

  1. Démarrez le serveur Web Jetty local à l'aide du plug-in Jetty Maven :

    mvn appengine:run
    
  2. Dans votre navigateur Web, accédez à l'adresse suivante :

    http://localhost:8080
    
  3. Le message Hello World de l'exemple d'application s'affiche sur la page.

  4. Dans votre fenêtre de terminal, appuyez sur Ctrl+C pour quitter le serveur Web.

Déployer et exécuter Hello World sur App Engine

Pour déployer votre application dans l'environnement standard App Engine, procédez comme suit :

  1. Déployez l'application Hello World en exécutant la commande suivante à partir du répertoire getting-started-java/appengine-standard-java8/helloworld :
    mvn appengine:deploy
    Patientez jusqu'à la fin du déploiement.
  2. Lancez votre navigateur pour afficher l'application à l'adresse http://YOUR_PROJECT_ID.appspot.com en exécutant la commande suivante :
    gcloud app browse

Cette fois, la page qui affiche le message Hello World est diffusée par un serveur Web exécuté sur une instance App Engine.

Félicitations ! Vous avez déployé votre première application Java 8 dans l'environnement standard App Engine.

Consultez les sections suivantes pour en savoir plus sur le nettoyage et découvrir les prochaines étapes que vous pourriez effectuer.

Étapes suivantes

En savoir plus sur Google Cloud Platform

Maintenant que vous savez comment développer et déployer des applications App Engine, vous pouvez découvrir le reste de Google Cloud Platform. Le SDK Google Cloud étant déjà installé, vous possédez donc les outils nécessaires pour interagir avec des produits tels que Google Cloud SQL, Google Cloud Storage, Google Cloud Datastore, et plus encore. Pour obtenir une présentation guidée de la création d'applications qui utilise l'ensemble de Google Cloud Platform, et pas uniquement App Engine, consultez notre guide de démarrage rapide sur la création de l'application Bookshelf.

En savoir plus sur l'environnement standard App Engine

Voici quelques articles qui vous aideront à mieux connaître App Engine :

Examiner le code Hello World

Hello World est l'application App Engine la plus simple qui soit : elle ne contient qu'un seul service, ne possède qu'une version, et tout le code se trouve dans le répertoire racine de l'application. Cette section décrit chacun des fichiers de l'application en détail.

HelloAppEngine.java

Le fichier HelloServlet.java spécifie un modèle d'URL qui décrit l'emplacement où l'application écoutera les requêtes, et répond à toutes les requêtes comportant le message "Hello World".

import com.google.appengine.api.utils.SystemProperty;

import java.io.IOException;
import java.util.Properties;

import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

// With @WebServlet annotation the webapp/WEB-INF/web.xml is no longer required.
@WebServlet(name = "HelloAppEngine", value = "/hello")
public class HelloAppEngine extends HttpServlet {

  @Override
  public void doGet(HttpServletRequest request, HttpServletResponse response)
      throws IOException {
    Properties properties = System.getProperties();

    response.setContentType("text/plain");
    response.getWriter().println("Hello App Engine - Standard using "
            + SystemProperty.version.get() + " Java "
            + properties.get("java.specification.version"));
  }

  public static String getInfo() {
    return "Version: " + System.getProperty("java.version")
          + " OS: " + System.getProperty("os.name")
          + " User: " + System.getProperty("user.name");
  }

}

pom.xml

Hello World inclut également un fichier pom.xml , qui contient des informations sur le projet, telles que ses dépendances et la cible de compilation, ainsi que les lignes requises pour utiliser le plug-in Maven :

<plugin>
  <groupId>com.google.cloud.tools</groupId>
  <artifactId>appengine-maven-plugin</artifactId>
  <version>1.3.1</version>
</plugin>

appengine-web.xml

Le fichier appengine-web.xml contient certains paramètres obligatoires, tels que le paramètre java8 pour l'élément <runtime> qui demande à App Engine d'exécuter cette application dans l'environnement d'exécution Java 8 :

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <runtime>java8</runtime>
  <threadsafe>true</threadsafe>
</appengine-web-app>
Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement standard App Engine pour Java