Firexport / Blog

Le 30 octobre 2026, l’environnement d’exécution Node.js 20 de Cloud Functions a été mis hors service (decommission). Vous ne pouvez plus déployer ni mettre à jour de fonctions sur Node.js 20, si bien que firebase deploy s’arrête sur l’erreur ci-dessous. La correction tient en une ligne de functions/package.json. Si vous n’avez que des fonctions de 2e génération, passez à Node.js 24 ; si vous avez des fonctions de 1re génération, passez à Node.js 22.

Error: Runtime Node.js 20 was decommissioned on 2026-10-30. To deploy you must
first upgrade your runtime version.

Les dates et leur sens

Voici le calendrier de prise en charge des environnements d’exécution de Google Cloud. Pendant la période d’obsolescence (deprecation), vous pouvez encore déployer ; après la mise hors service (decommission), vous ne pouvez plus ni créer ni mettre à jour de fonctions sur cet environnement d’exécution.

Voici ce qui change à la mise hors service.

La politique ne fixe aucune date de désactivation. Une fonction qui tourne bien aujourd’hui ne peut plus être redéployée au moment où vous devez corriger un bug, et vous ne savez pas quand elle risque de s’arrêter. Impossible non plus de contourner le blocage : même si vous désactivez la vérification d’environnement d’exécution de la CLI, le serveur bloque de son côté (code source de la CLI).

Passer à Node.js 24 ou 22

1. Vérifiez la génération et l’environnement d’exécution de chaque fonction. Exécutez firebase functions:list. Dans la colonne Version, v1 correspond à la 1re génération et v2 à la 2e ; la colonne Runtime indique l’environnement d’exécution actuel.
2. Choisissez une version. L’environnement d’exécution se définit par codebase (en général le dossier functions), et non par fonction. Si au moins une fonction est de 1re génération, choisissez 22 ; si toutes sont de 2e génération, choisissez 24. Node.js 24 reste utilisable jusqu’au 31 octobre 2028, mais n’est pas compatible avec la 1re génération. La liste des versions de la documentation Firebase ne mentionne pas encore 24, mais le calendrier de Cloud l’indique pour la 2e génération, et la Firebase CLI le prend en charge depuis la version 14.26.0.
3. Changez une ligne dans package.json. La valeur est un seul numéro de version majeure. Avec une plage comme >=22 ou 22.x, la CLI échoue avec l’erreur Detected node engine ... which is not a supported version.

   {
     "engines": {
       "node": "24"
     }
   }

   Si firebase.json contient runtime, la CLI utilise d’abord cette valeur : c’est alors elle qu’il faut modifier.

   {
     "functions": {
       "source": "functions",
       "runtime": "nodejs24"
     }
   }

4. Utilisez la même version de Node.js en local et en CI. L’émulateur exécute vos fonctions avec le Node.js installé sur la machine. Si les versions diffèrent, il affiche seulement l’avertissement Your requested "node" version "24" doesn't match your global version "20" et les exécute quand même sous Node.js 20 : vos tests tournent alors sur une autre version que la production.
5. Déployez. Exécutez firebase deploy --only functions, puis vérifiez que la colonne Runtime de firebase functions:list indique désormais nodejs24 (ou nodejs22).

Versions des SDK

Si vous mettez à jour les SDK en même temps que Node.js, vérifiez les points suivants.

Si vous utilisez encore functions.config(), gardez firebase-functions en 6.x et ne changez que Node.js. Les déploiements avec functions.config() échoueront aussi après mars 2027 : d’ici là, passez aux variables d’environnement ou à Secret Manager.

Fonctions de 1re génération

Le dernier environnement d’exécution utilisable par les fonctions de 1re génération est Node.js 22, qui sera mis hors service le 31 octobre 2027. D’ici là, elles doivent passer à la 2e génération. Les avertissements de la Firebase CLI 15.35.0 donnent 2028-10-31 comme date de mise hors service de Node.js 22, mais c’est la date du calendrier de Google Cloud, 2027-10-31, qui fait foi (code source de la CLI). Comme on ne peut pas convertir directement une fonction en gardant le même nom, Firebase recommande de déployer la fonction de 2e génération sous un nouveau nom, d’y migrer le trafic, puis de supprimer celle de 1re génération (guide de mise à niveau). Voici les points qui peuvent coincer pendant la migration.

• Les URL changent. Pour les fonctions HTTP, appelables et de file d’attente de tâches, un nouveau nom signifie une nouvelle URL. Faites pointer vos applications et vos webhooks vers la nouvelle URL, puis supprimez l’ancienne fonction avec firebase functions:delete.
• Les événements sont traités deux fois. Tant que les deux fonctions coexistent, les déclencheurs d’événements comme ceux de Firestore ou de Storage exécutent les deux pour un même événement. Faites en sorte que deux exécutions donnent le même résultat.
• Certaines choses manquent. La 2e génération n’a ni functions.config() ni déclencheurs d’événements Analytics, et les déclencheurs Authentication de création et de suppression d’utilisateurs (onUserCreated, onUserDeleted) sont encore en version Preview.
• Les valeurs par défaut diffèrent. Une instance traite par défaut jusqu’à 80 requêtes à la fois, et le compte de service par défaut devient le compte de service par défaut Compute Engine. Si vous stockez dans des variables globales des valeurs propres à chaque requête, ou si vous avez accordé des autorisations IAM au compte de service par défaut App Engine, vous devez corriger cela.

Extensions

Les extensions installées tournent elles aussi sur Cloud Functions, et c’est la version de l’extension qui détermine leur environnement d’exécution. Firebase recommande de mettre à jour les extensions vers leur dernière version.

firebase ext:update <instance-id>
firebase deploy --only extensions

Le service d’extensions Firebase sera arrêté le 31 mars 2027. Les extensions installées continueront de s’exécuter ensuite, mais les fonctionnalités de gestion, comme les mises à jour, ne seront plus disponibles. La plupart reposent sur des fonctions de 1re génération : elles peuvent s’arrêter ou être désactivées une fois leur environnement d’exécution mis hors service. Si vous comptez continuer à utiliser ce que fait une extension, prévoyez aussi de le reprendre dans votre propre fonction.

Sources

• Calendrier de prise en charge des environnements d’exécution, notes de version de Cloud Functions : dates, sens de l’obsolescence et de la mise hors service, prise en charge de Node.js 22 en 1re génération et de Node.js 24 en 2e génération
• Gérer les fonctions (définir la version de Node.js), questions fréquentes sur Cloud Functions : engines et runtime, environnement d’exécution des extensions
• Code source de la Firebase CLI 15.35.0 : vérification de l’environnement d’exécution et message d’erreur, dates des environnements d’exécution, lecture d’engines, choix de Node.js par l’émulateur, vérifications côté serveur
• Notes de version de firebase-tools, firebase-functions et firebase-admin 14.0.0, configuration de l’environnement
• Passer de la 1re à la 2e génération, comparaison des générations, déclencheurs Authentication, questions fréquentes sur les extensions, référence d’extension.yaml