Environnement d'exécution Node.js 8

L'environnement d'exécution Node.js 8 a été abandonné le 5 juin 2020. Pour vous assurer que vos fonctions s'exécutent sur une version compatible de Node.js, migrez-les vers Node.js 10.

Pour découvrir comment préparer votre ordinateur local pour le développement Node.js, consultez la page Configurer un environnement de développement Node.js.

Pour commencer à utiliser Node.js avec Cloud Run Functions, consultez le démarrage rapide.

Sélectionner l'environnement d'exécution

Vous pouvez sélectionner l'environnement d'exécution Node.js 8 pour votre fonction lors du déploiement.

gcloud

Si vous utilisez Google Cloud CLI, vous pouvez spécifier l'environnement d'exécution à l'aide du paramètre --runtime. Exemple :

gcloud functions deploy NAME --runtime nodejs8 --trigger-http

Pour connaître les arguments qu'il est possible de spécifier lors du déploiement, consultez la page Déployer à l'aide de l'outil gcloud.

Console

Si vous utilisez la console Google Cloud, vous pouvez sélectionner la région lorsque vous créez et déployez une fonction.

1. Dans la console Google Cloud, accédez à la page de présentation de Cloud Run Functions.

   Accéder à la page de présentation de Cloud Run Functions

   Vérifiez que le projet pour lequel vous avez activé Cloud Run Functions est sélectionné.

2. Cliquez sur Créer une fonction.

3. Sous Environnement d'exécution, sélectionnez Node.js 8.

Environnement d'exécution

L'environnement d'exécution comprend l'environnement, le système d'exploitation, les packages et une bibliothèque appelant votre fonction.

Node.js 8 utilise un environnement d'exécution basé sur Ubuntu 18.04 avec Node.js version 8.15.0. Pour plus d'informations, consultez la section Environnement d'exécution des fonctions Cloud Run.

Structure du code source

Pour que Cloud Run Functions trouve la définition de votre fonction, chaque environnement d'exécution a certaines exigences en matière de structuration pour votre code source. Pour en savoir plus, consultez la page Écrire des fonctions Cloud Run.

Spécifier des dépendances

Vous pouvez spécifier des dépendances pour vos fonctions en les répertoriant dans un fichier package.json. Pour en savoir plus, consultez la page Spécifier des dépendances dans Node.js.

Remarque : Les dernières versions (latest) des bibliothèques clientes Node.js de Google Cloud ne sont plus compatibles avec Node 8. Les versions historiques sont disponibles pour les environnements d'exécution Node 8. Consultez la section consacrée aux versions compatibles de Node.js pour en savoir plus.

Mots clés async/await

Node.js 8.x est la première version LTS de Node.js à accepter les mots-clés async et await.

Utiliser un middleware pour gérer les requêtes HTTP

Afin de simplifier le traitement des requêtes HTTP, les fonctions Cloud Run HTTP Node.js fournissent des objets request et response compatibles avec ExpressJS. Cloud Run Functions lit automatiquement le corps de la requête, vous recevrez donc toujours le corps d'une requête indépendamment du type de contenu. Ainsi, les requêtes HTTP doivent être considérées comme ayant été entièrement lues au moment de l'exécution de votre code. L'imbrication avec des applications ExpressJS est possible à condition de prendre ce point en compte. En effet, certains composants middleware ne s'attendant pas à ce que le corps d'une requête soit préalablement lu risquent de ne pas se comporter comme prévu.