ID de la 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. Pour les applications créées après février 2020, REGION_ID.r
est inclus dans les URL App Engine. Pour les applications existantes créées avant cette date, l'ID de région est facultatif dans l'URL.
En savoir plus sur les ID de région
Cette section du guide explique comment utiliser la gcloud CLI pour déployer votre service Web Java sur App Engine. Pour en savoir plus sur l'environnement d'exécution Java, consultez la page Environnement d'exécution Java.
Avant de commencer
- Créez un projet Google Cloud avec une application App Engine.
- Écrivez un serveur Web Java prêt à être déployé sur App Engine.
- Installez Google Cloud CLI, qui fournit l'outil de ligne de commande
gcloud
. Assurez-vous quegcloud
est configuré pour utiliser le projet Google Cloud sur lequel vous souhaitez effectuer le déploiement.
Points essentiels
- Exécutez les commandes
gcloud app deploy
etgcloud app browse
pour déployer et afficher votre service.
Déployer votre service
Dans votre dossier my-java-service
où se trouvent les fichiers de compilation POM Maven ou Gradle, exécutez la commande suivante dans votre terminal :
gcloud app deploy
Vos fichiers sources sont alors importés dans Cloud Storage. Cloud Build compile votre application et la déploie sur App Engine.
Déployer plusieurs services
Vous pouvez ajouter plusieurs services dans votre projet en créant un fichier app.yaml
pour chaque service. Incluez l'attribut service
dans chaque fichier app.yaml
pour spécifier le nom du service.
Pour savoir comment structurer votre application à l'aide de plusieurs services, consultez la page Structurer des services Web dans App Engine.
Pour déployer plusieurs services, suivez ces instructions.
Chaque service déployé dispose de sa propre URL.
Afficher votre service
Pour lancer rapidement votre navigateur et accéder à votre service Web à l'adresse https://PROJECT_ID.REGION_ID.r.appspot.com
, exécutez la commande suivante :
gcloud app browse
Services et versions
Vous venez de créer et de déployer un service sur App Engine.
Vous pouvez spécifier le nom de votre service dans le fichier app.yaml
. Si le nom est omis, le service est traité en tant que service par défaut (default
). Le premier service que vous déployez doit être le service par défaut.
Vous pouvez mettre à jour votre service à tout moment en exécutant à nouveau la commande gcloud app deploy
. Chaque fois que vous déployez votre application, une version est créée et le trafic est automatiquement acheminé vers la dernière version.
Pour confirmer que votre service a été créé et qu'une version a été déployée :
Affichez vos services App Engine dans la console Google Cloud :
Un service nommé
default
doit s'afficher. Le service par défaut est accessible au public depuis l'URL suivante :https://PROJECT_ID.REGION_ID.r.appspot.com
Affichez vos versions :
Une version horodatée correspondant à votre déploiement doit s'afficher dans la liste.
Pour savoir comment envoyer des requêtes à des services et à des versions spécifiques, consultez la page Mode de routage des requêtes.
Étapes suivantes
Félicitations ! Vous avez créé une application permettant de stocker et de classer des images importées. Pour savoir comment ajouter d'autres fonctionnalités à votre application, consultez les pages suivantes :
- Consultez d'autres exemples de code Java pour l'environnement standard App Engine dans le dépôt GitHub de Google Cloud. Ces exemples peuvent être utilisés pour Java.
- Pour en savoir plus sur l'écriture des journaux d'application et l'interprétation des journaux système, consultez la page Lire et écrire des journaux d'application.
- Pour en savoir plus sur le fonctionnement d'App Engine, consultez la page Environnement d'exécution Java.