Premiers pas : Configurer votre environnement de développement

Découvrez comment configurer votre environnement de compilation pour développer et déployer des applications dans l'environnement d'exécution Java 8 au sein de l'environnement standard App Engine.

Ce guide vous expliquera comment :

  • installer l'outil de ligne de commande du SDK Google Cloud ;
  • Installer et configurer le plug-in App Engine pour Maven.
    App Engine dispose également de plug-ins pour Gradle, IntelliJ IDEA et Eclipse, mais ce guide se concentre sur le plug-in pour Maven.
  • créer un projet App Engine.
  • accorder à Cloud Build l'autorisation de compiler et de déployer votre application.

Installer les SDK requis

  1. Si vous n'avez pas encore installé le SDK Java SE 8, installez le kit de développement Java SE 8 (JDK).

  2. Installez et initialisez la dernière version du SDK Google Cloud.

    Installez et initialisez le SDK Google Cloud

  3. Installez le composant Java App Engine :

    gcloud components install app-engine-java
    
  4. Autorisez votre compte utilisateur :

    gcloud auth application-default login
    

Configurer Maven au sein de votre environnement de développement

  1. Téléchargez Maven 3.5 ou une version ultérieure depuis le site Web Maven.

  2. Installez Maven 3.5 ou une version ultérieure sur votre ordinateur local.

Créer un projet App Engine

Pour créer une application App Engine :

  1. Créez un répertoire.

  2. Initialisez le nouveau projet dans le répertoire créé :

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Définissez l'option -Dappengine-version sur la version la plus récente du SDK App Engine pour Java, et l'option application-id sur l'ID de votre projet Cloud.

    2. Définissez l'option -Djava8=true pour déployer le projet dans l'environnement d'exécution Java 8.

    3. Définissez l'option -DCloudSDK_Tooling=true pour utiliser les outils du SDK Cloud.

  3. Lorsque vous êtes invité à choisir un archétype, choisissez la valeur 2 pour l'archétype du squelette App Engine. Cela crée un projet vide contenant la structure de répertoire et les fichiers requis.

  4. Lorsque vous êtes invité à indiquer la version, appuyez sur Entrée pour sélectionner la version la plus récente par défaut.

  5. Lorsque l'invite Define value for property 'groupId' s'affiche, indiquez l'espace de noms souhaité pour l'application. Par exemple : com.mycompany.myapp.

  6. Lorsque l'invite Define value for property 'artifactId' s'affiche, indiquez le nom du projet. Par exemple : myapp.

  7. Lorsque l'invite Define value for property 'version' s'affiche, acceptez la valeur par défaut.

  8. Lorsque l'invite Define value for property 'package' s'affiche, indiquez le nom du package souhaité (ou acceptez le nom par défaut). Les fichiers Java générés portent le nom du package que vous spécifiez ici.

  9. Lorsque vous êtes invité à confirmer vos choix, acceptez la valeur par défaut (Y).

  10. Attendez la fin de la génération du projet, puis remplacez les répertoires par le nouveau répertoire du projet, par exemple myapp/.

  11. Ajoutez le plug-in basé sur le SDK Cloud au fichier pom.xml de votre projet.

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>2.2.0</version>
                <configuration>
                    <project>your-project-ID-goes-here</project>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. Spécifiez l'ID du projet Google Cloud Platform cible, ainsi que le service et la version dans la configuration du plug-in.

Accorder une autorisation à Cloud Build

Lorsque vous déployez votre application, App Engine utilise Cloud Build pour créer l'application dans un conteneur et déployer ce conteneur dans l'environnement d'exécution. Par défaut, Cloud Build n'est pas autorisé à déployer des applications Java 8. Vous devez donc accorder à Cloud Build l'autorisation de déployer des applications dans votre projet.

Étapes suivantes

Une fois l'environnement de développement configuré, vous pouvez commencer à développer et déployer des applications Java sur App Engine.