Créer une application Node.js dans l'environnement standard App Engine
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
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.
La plate-forme App Engine représente-t-elle l'option de calcul qui vous correspond ? Découvrez d'autres options pour héberger votre application sur Google Cloud.
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
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez Cloud Build API.
- Installez Google Cloud CLI.
-
Pour initialiser gcloudCLI, exécutez la commande suivante :
gcloud init
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez Cloud Build API.
- Installez Google Cloud CLI.
-
Pour initialiser gcloudCLI, exécutez la commande suivante :
gcloud init
Conditions préalables supplémentaires
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 localiser votre application App Engine.
Installez les composants requis suivants :
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 la console Google Cloud. La région apparaît en haut de la page.
Ce guide de démarrage rapide présente une application Node.js simple, écrite à l'aide du framework Express.js.
Télécharger l'exemple de code
Utilisez notre application simple Hello World pour obtenir un aperçu rapide du déploiement d'un service Web sur App Engine. Pour télécharger le code dans votre environnement de développement, procédez comme suit :
Téléchargez le dépôt de l'exemple d'application Node.js :
Cloud Shell
Ouvrez le dépôt dans Cloud Shell :
Machine locale
Téléchargez le dépôt en tant que fichier ZIP, puis extrayez-le.
Vous pouvez également cloner le dépôt avec
git
:git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
Accédez au répertoire contenant l'application Hello World :
cd nodejs-docs-samples/appengine/hello-world/standard
Exécuter Hello World en local
Installez les dépendances pour le projet :
npm install
Démarrez le serveur HTTP :
npm start
Affichez l'application dans votre navigateur Web :
Cloud Shell
Dans la barre d'outils Cloud Shell, cliquez sur Aperçu sur le Web et sélectionnez Prévisualiser sur le port 8080.
Machine locale
Dans votre navigateur Web, accédez à l'URL
http://localhost:8080
.Le message "Hello, world!" s'affiche sur la page.
Arrêtez le serveur HTTP en appuyant sur Ctrl+C dans la fenêtre de terminal.
Déployer et exécuter Hello World sur App Engine
Pour déployer l'application Hello World sur App Engine, exécutez la commande suivante depuis le répertoire
hello-world/standard
:gcloud app deploy
Affichez l'application en direct à l'adresse
https://PROJECT_ID.REGION_ID.r.appspot.com
:gcloud app browse
Le message "Hello, world!" est maintenant diffusé par un serveur Web exécuté sur une instance App Engine.
Félicitations ! Vous avez déployé un service Web Node.js sur App Engine.
Nettoyer
Si vous souhaitez continuer à vous familiariser avec App Engine, vous pouvez conserver votre projet Cloud et suivre les étapes de la page Créer une application.
Vous pouvez également supprimer votre projet Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.
- Dans la console Google Cloud, 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.
Étape suivante
Maintenant que vous savez comment déployer un service Web sur App Engine, accédez à un tutoriel plus détaillé concernant Node.js sur App Engine en lisant la page Concevoir une application.
Pour plus d'informations sur l'environnement d'exécution Node.js dans l'environnement standard App Engine, consultez la page Environnement d'exécution Node.js.