ID de région
Le REGION_ID
est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. L'ajout de REGION_ID.r
dans les URL App Engine est facultatif pour les applications existantes. Il sera bientôt obligatoire pour toutes les applications nouvelles.
Pour assurer une transition en douceur, nous mettons lentement à jour App Engine afin d'utiliser les ID de région. Si nous n'avons pas encore mis à jour votre projet Google Cloud, vous ne verrez pas d'ID de région pour votre application. Étant donné que l'ID est facultatif pour les applications existantes, vous n'avez pas besoin de mettre à jour les URL ni d'effectuer d'autres modifications une fois l'ID de région disponible pour vos applications existantes.
En savoir plus sur les ID de région
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 11 (JDK).Avant d'exécuter et de déployer ce guide de démarrage rapide, installez le SDK Cloud, puis configurez un projet Cloud pour App Engine :
Téléchargez et installez le SDK Cloud :
Remarque : Si le SDK Cloud est déjà installé, mettez-le à jour en exécutant la commande suivante :gcloud components update
Créez un projet :
gcloud projects create [YOUR_PROJECT_ID] --set-as-default
Remplacez
[YOUR_PROJECT_ID]
par une chaîne de caractères qui identifie votre projet de manière unique. Exemple :my-project-24
.L'option
--set-as-default
définit votre nouveau projet comme projet par défaut utilisé pargcloud
.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
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.
Assurez-vous que la facturation est activée pour votre projet. Un compte de facturation doit être associé à votre projet pour que l'application puisse être déployée dans App Engine.
Installez les composants requis suivants :
- Téléchargez et installez git.
- Téléchargez et installez Maven 3.5 ou une version ultérieure. Ce guide de démarrage rapide utilise Apache Maven version 3.5 ou une version ultérieure pour créer et exécuter l'exemple d'application sur votre ordinateur.
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 que Google la gère de sorte qu'elle soit 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 généralement sélectionner la région la plus proche des utilisateurs de votre application, mais pensez aussi aux emplacements où App Engine est disponible ainsi qu'aux emplacements des autres produits et services Google Cloud que votre application utilise. L'utilisation de services situés dans des emplacements différents peut avoir des répercussions sur la latence de votre application, ainsi que sur les tarifs.
Une fois que vous avez défini la région d'une application, vous ne pouvez plus la modifier.
Si vous avez déjà créé une application App Engine, vous pouvez afficher sa région en effectuant l'une des opérations suivantes :
Exécutez la commande
gcloud app describe
.Ouvrez le tableau de bord App Engine dans Cloud Console. La région apparaît en haut de la page.
Télécharger l'application Hello World
Nous avons créé une application Hello World simple pour Java 11 afin que vous puissiez comprendre rapidement comment déployer une application sur Google Cloud.
Clonez le dépôt de l'exemple d'application Hello World sur votre ordinateur.
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
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/appengine-java11/springboot-helloworld
Exécuter Hello World sur votre ordinateur local
Pour exécuter l'application Hello World sur votre ordinateur local :
- Démarrez un serveur Web local à l'aide du plug-in Maven Spring Boot.
mvn spring-boot:run
Dans votre navigateur Web, saisissez l'adresse suivante :
http://localhost:8080
Le message Hello World de l'exemple d'application s'affiche sur la page. 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 :-
Déployez l'application Hello World en exécutant la commande suivante à partir du répertoire
springboot-helloworld
:gcloud app deploy
Obtenez plus d'informations sur les options facultatives.
Options de commande
gcloud
courantes-
Incluez l'option
--version
pour spécifier un ID qui identifie de manière unique cette version de votre application, sans quoi un ID est généré automatiquement. Exemple :--version [YOUR_VERSION_ID]
-
Incluez l'option
--project
pour spécifier un ID de projet Cloud différent de celui que vous avez initialisé par défaut dans l'outilgcloud
. Exemple :--project [YOUR_PROJECT_ID]
Exemple :
gcloud app deploy --version pre-prod-5 --project my-sample-app
Pour en savoir plus sur le déploiement de votre application à partir de la ligne de commande, consultez la section Tester et déployer votre application. Pour obtenir la liste de toutes les options de commande, consultez la documentation de référence
gcloud app deploy
. -
Incluez l'option
-
Lancez votre navigateur pour afficher l'application sur
https://PROJECT_ID.REGION_ID.r.appspot.com
gcloud app browse
oùPROJECT_ID
représente l'ID de votre projet Google Cloud.
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 11 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.
Nettoyer
Afin d'éviter que des frais ne vous soient facturés, vous pouvez supprimer votre projet Cloud pour interrompre la facturation de toutes les ressources utilisées dans le projet.
- Dans Cloud Console, accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.
Étapes suivantes
Découvrez la plate-forme dans son ensemble
Maintenant que vous savez comment développer et déployer des applications App Engine, vous pouvez explorer le reste de Google Cloud. Le SDK Cloud est déjà installé et vous permet d'interagir avec des produits tels que Cloud SQL, Cloud Storage, Firestore, etc.
Découvrez l'environnement standard App Engine
Voici quelques articles qui vous aideront à mieux connaître App Engine :