Guide de démarrage rapide pour Node.js dans l'environnement standard App Engine

ID de la région

Le code REGION_ID est attribué par Google en fonction de la région que vous sélectionnez lors de la création de votre application. L'ajout de REGION_ID.r dans les URL App Engine est facultatif pour les applications existantes. Il sera bientôt nécessaire pour toutes les nouvelles applications.

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

Avant d'exécuter et de déployer ce démarrage rapide, installez le SDK Cloud, puis configurez un projet Google Cloud 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. 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.

    Activer la facturation

  5. Installez les composants requis suivants :

Emplacements 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é. En règle générale, vous pouvez sélectionner la région la plus proche des utilisateurs de votre application, mais vous devez également tenir compte de l'emplacement des autres produits et services Google Cloud exploités par votre application. L'utilisation de services dans plusieurs emplacements peut affecter la latence et les coûts associés à 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 Cloud Console. La région de votre application App Engine est indiquée sous http://[YOUR_PROJECT_ID].appspot.com.

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 :

  1. Téléchargez le dépôt de l'exemple d'application Node.js :

    Cloud Shell

    Clonez le dépôt Git :

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

    Machine locale

    Téléchargez le dépôt en tant que fichier ZIP, puis extrayez-le.

    Si vous utilisez Git, vous pouvez également cloner le dépôt à l'aide de la commande suivante :

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Accédez au répertoire contenant l'application Hello World :

    cd nodejs-docs-samples/appengine/hello-world/standard
    

Exécuter Hello World en local

  1. Installez les dépendances pour le projet :

    npm install
    
  2. Démarrez le serveur HTTP :

    npm start
    
  3. Affichez l'application dans votre navigateur Web :

    Cloud Shell

    Dans la barre d'outils Cloud Shell, cliquez sur Aperçu sur le Web 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.

  4. 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

  1. 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
    
  2. 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 s'exécutant 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 Google Cloud et passer à la conception d'une application.

Vous pouvez également supprimer votre projet Google Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.

  1. Dans la console GCP, accédez à la page Gérer les ressources.

    Accéder à la page Gérer les ressources

  2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer .
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étapes suivantes

Maintenant que vous avez de l'expérience dans le déploiement d'un service Web sur App Engine, découvrez une procédure plus détaillée pour Node.js sur App Engine sur la page Concevoir une application.Pour bénéficier d'un tutoriel de bout en bout impliquant divers produits Google Cloud, consultez la page concernant l'application Bookshelf pour Node.js.

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.