Déployer votre service Web

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 CLI gcloud pour déployer votre service Web Node.js sur App Engine. Pour en savoir plus sur l'environnement d'exécution Node.js, consultez la page Environnement d'exécution Node.js.

Avant de commencer

  1. Créez un projet Google Cloud avec une application App Engine.
  2. Écrivez un serveur Web Node.js prêt à être déployé sur App Engine.
  3. Installez Google Cloud CLI, qui fournit l'outil de ligne de commande gcloud. Assurez-vous que gcloud 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 et gcloud app browse pour déployer et afficher votre service.

Déployer votre service

Dans le dossier my-nodejs-service, où se trouve le fichier app.yaml, exécutez la commande suivante dans votre terminal :

gcloud app deploy

Vos fichiers sources sont alors importés dans Google Cloud Storage. Cloud Build compile votre application et la déploie sur App Engine.

Pour en savoir plus sur les autres méthodes de compilation et de déploiement des applications, consultez la page Tester et déployer une application.

Si vous n'en avez pas, un fichier .gcloudignore est créé pour assurer que votre dossier node_modules n'est pas importé.

Les modules Node.js sont installés dans le cloud, tels qu'ils sont répertoriés dans les fichiers package.json et package-lock.json, et votre service est lancé en utilisant npm start.

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 :

  1. Affichez vos services App Engine dans la console Google Cloud :

    Voir les services

    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

  2. Affichez vos versions :

    Afficher les 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.

Étape suivante

Maintenant que vous disposez d'un serveur Node.js s'exécutant sur App Engine, découvrez comment mettre à jour votre service Web.