Aller au contenu principal

n8n sur Google Cloud Run

n8n sur Google Cloud Run

n8n est une plateforme d'automatisation de flux de travail "fair-code" qui connecte des API, des bases de données et des services avec un éditeur de nœuds visuel. Ce module déploie n8n sur Cloud Run v2 sur la base de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par n8n et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications Cloud Run — identité de service, entrée et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Coût de N8N sur RAD et comparaison​

L'exécution de N8N dans votre propre projet GCP coûte environ 117,79 $/mois en frais Google Cloud ; les frais de module de RAD sont de 110 crédits uniques (ou 99 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD facture à l'heure en crédits dans un projet géré par RAD. Ou consultez le guide GKE pour la cible de déploiement alternative ; dans tous les cas, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits, une fois99 crédits, une fois (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients font exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google Cloud~117,79 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~85 crédits/jour, facturé à l'heure par RAD au prix catalogue plus marge

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

Coût d'exécution par défaut dans votre propre projet

RessourceUS$/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 1 GiB (toujours actif)47,34 $
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Serveur de fichiers NFS/cache (petite VM)13,43 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Total117,79 $

Comparaison​

  • Le cloud géré officiel de n8n (n8n Cloud) commence à 20 €/mois facturé annuellement pour le plan Starter (2 500 exécutions de flux de travail) (source : https://n8n.io/pricing), géré par le projet lui-même sans infrastructure à exploiter — la comparaison qui importe ici est moins le prix affiché que de savoir si vous voulez le cloud du fournisseur ou votre propre projet GCP avec RAD qui le gère.
  • L'exécuter vous-même sur un VPS nu dimensionné pour cette charge de travail (une machine plus petite suffit — Hetzner CX11 ou un Droplet DigitalOcean 1 vCPU/1-2 Go coûte 6-12 $/mois — mais il faut toujours quelqu'un pour le patcher, le sauvegarder et le surveiller, ce que le Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent pour vous) est l'option la moins chère en termes d'argent, car l'empreinte de ce module est faible — mais vous êtes de nouveau responsable de la mise à jour et de la sauvegarde.
  • Dans tous les cas, il s'agit de l'épine dorsale de l'automatisation des flux de travail d'une équipe, de sorte que le coût d'exécution ci-dessus est ce qui génère réellement la facture, pas les frais de module — et ce coût d'exécution est celui que vous pouvez mettre en pause (voir ci-dessous).

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin​

C'est le point clé pour un projet géré par RAD. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, une VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.

Ce dont cela a besoin : vous devez être propriétaire du projet (pas un projet que RAD gère uniquement pour la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé l'application et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de la supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer N8N purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits.

La suppression ne permet d'économiser de l'argent que si N8N reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet ci-dessus, cela représente environ 3 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données et la VM de fichier/cache partagée ; elles ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

Conserver les données d'abord : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration ; https://n8n.io/pricing pour le prix du concurrent nommé.

1. Vue d'ensemble​

n8n s'exécute en tant que conteneur Node.js sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 1 vCPU / 1 GiB par défaut, toujours actif (facturation basée sur l'instance, min_instance_count = 1) afin que les déclencheurs cron/planifiés et l'exécution de la file d'attente se déclenchent sans requête entrante
Base de donnéesCloud SQL pour PostgreSQL 15Requis — n8n utilise PostgreSQL pour toutes les données de flux de travail et d'informations d'identification
Fichiers partagésFilestore (NFS)Données de fichiers binaires partagées entre toutes les instances ; sert également de point de terminaison Redis par défaut
Stockage d'objetsCloud StorageUn bucket de données dédié
File d'attente et coordinationRedisActivé par défaut ; active le mode file d'attente n8n pour la mise à l'échelle horizontale
SecretsSecret ManagerClé de chiffrement et espace réservé au mot de passe SMTP générés automatiquement
EntréeURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

Valeurs par défaut judicieuses à connaître d'emblée :

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixe ; la sélection de tout autre moteur ou NONE entraîne un échec au démarrage.
  • Redis est activé par défaut. Le mode file d'attente permet à plusieurs instances n8n de distribuer l'exécution des flux de travail. Sans Redis, une seule instance peut fonctionner de manière fiable.
  • La clé de chiffrement est irremplaçable. N8N_ENCRYPTION_KEY est générée une seule fois et stockée dans Secret Manager. Toutes les informations d'identification de flux de travail sont chiffrées avec elle. Si la clé est modifiée ou supprimée, toutes les informations d'identification enregistrées deviennent définitivement illisibles.
  • min_instance_count est défini par défaut sur 1. n8n maintient une instance chaude afin que les webhooks et le déclencheur de planification/file d'attente se déclenchent sans délai de démarrage à froid. Ne le définissez sur 0 que si une latence occasionnelle des webhooks au démarrage à froid est acceptable.
  • WEBHOOK_URL et N8N_EDITOR_BASE_URL sont prédéfinis sur l'URL de service Cloud Run prévue afin que les webhooks se résolvent correctement dès le premier démarrage. Si un domaine personnalisé est ajouté ultérieurement, redéployez pour mettre à jour ces valeurs.
  • L'environnement d'exécution Gen2 est requis pour les montages NFS. execution_environment est défini par défaut sur "gen2".
  • Le secret du mot de passe SMTP est initialisé avec une valeur factice ; mettez-le à jour dans Secret Manager avant de configurer l'envoi d'e-mails.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources sont signalés dans les Sorties du déploiement.

A. Cloud Run — le service n8n​

n8n s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement à la charge de requêtes entre le nombre minimum et maximum d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

n8n stocke toutes les définitions de flux de travail, l'historique d'exécution et les informations d'identification chiffrées dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé via le proxy d'authentification Cloud SQL via un socket Unix (pas d'adresse IP publique). Le script entrypoint.sh traduit les variables DB_* injectées par la plateforme en variables DB_POSTGRESDB_* natives de n8n au moment de l'exécution. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Filestore (NFS) et Cloud Storage​

Les fichiers binaires téléchargés ou produits par les flux de travail sont écrits dans un partage Filestore (NFS) monté dans le service afin que toutes les instances partagent les mêmes données (N8N_DEFAULT_BINARY_DATA_MODE=filesystem). L'adresse IP de l'hôte NFS sert également de point de terminaison Redis par défaut lorsqu'aucun redis_host explicite n'est configuré. Un bucket Cloud Storage dédié est provisionné pour une persistance des données plus large.

  • Console : Filestore → Instances ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour le montage NFS, GCS Fuse et CMEK.

D. File d'attente Redis​

Redis active le mode file d'attente de n8n, distribuant les exécutions de flux de travail sur plusieurs instances à l'aide de Bull. En mode file d'attente, une ou plusieurs instances "worker" récupèrent les exécutions de la file d'attente tandis que l'instance principale gère l'éditeur et l'enregistrement des webhooks. Lorsqu'aucun hôte Redis externe n'est configuré et que NFS est activé, l'adresse IP de l'hôte NFS est utilisée comme point de terminaison Redis.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    redis-cli -h <redis-host> info keyspace

E. Secret Manager​

La clé de chiffrement n8n et l'espace réservé au mot de passe SMTP sont stockés dans Secret Manager et injectés dans le service au moment de l'exécution.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
    # Update the SMTP password with the real credential:
    echo -n "my-real-smtp-password" | \
    gcloud secrets versions add <smtp-secret-name> --data-file=- --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

F. Réseau et entrée​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être superposé ; les paramètres d'entrée et de sortie VPC contrôlent la connectivité.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

Les journaux des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des stratégies d'alerte facultatifs.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application n8n​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation (db-init) utilise postgres:15-alpine pour créer la base de données et l'utilisateur n8n avant le démarrage du service. Il est idempotent.
  • Traduction des variables d'environnement. entrypoint.sh mappe DB_HOST, DB_NAME, DB_USER et DB_PASSWORD (injectées par la plateforme) aux équivalents DB_POSTGRESDB_* natifs de n8n au démarrage du conteneur.
  • Fonctionnement en mode file d'attente. Avec enable_redis = true (par défaut), n8n démarre en mode file d'attente. L'instance principale gère l'enregistrement des webhooks, l'interface utilisateur de l'éditeur et la coordination de l'exécution ; des instances supplémentaires agissent comme des workers.
  • Stabilité de l'URL du webhook. WEBHOOK_URL et N8N_EDITOR_BASE_URL sont définis sur l'URL de service Cloud Run prévue avant le déploiement. L'ajout ultérieur d'un domaine personnalisé nécessite un redéploiement pour mettre à jour ces valeurs.
  • Mise à l'échelle à zéro et webhooks. min_instance_count est défini par défaut sur 1, ce qui maintient une instance chaude pour les charges de travail de webhook. Le définir sur 0 signifie qu'aucune instance n'est en cours d'exécution au repos — les services externes appelant des webhooks subiront une latence de démarrage à froid et des délais d'attente si le service appelant a un délai d'attente court.
  • Stockage des données binaires. N8N_DEFAULT_BINARY_DATA_MODE=filesystem indique à n8n d'écrire les fichiers binaires sur le système de fichiers monté NFS plutôt que sur la base de données, ce qui est requis pour les déploiements multi-instances.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent la racine n8n (/), qui renvoie HTTP 200 uniquement une fois l'application entièrement initialisée. La sonde de démarrage utilise un délai initial de 120 secondes pour la configuration du premier démarrage.
  • Criticité de la clé de chiffrement. N8N_ENCRYPTION_KEY chiffre toutes les informations d'identification de flux de travail. Si elle change, toutes les informations d'identification enregistrées deviennent définitivement illisibles.

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour n8n sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec leur comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namen8nNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameN8N Workflow AutomationNom convivial affiché dans la console.
description(défini)Description du service Cloud Run.
application_version2.4.7Tag de version de l'image n8n.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner l'infrastructure uniquement sans déployer le conteneur.
cpu_limit1000mCPU par instance.
memory_limit1GiMémoire par instance.
min_instance_count1Instances minimales. Maintient une instance chaude pour les charges de travail de webhook par défaut ; définissez 0 pour une mise à l'échelle à zéro.
cpu_always_allocatedtrueCPU alloué en permanence (facturation basée sur l'instance) — les déclencheurs cron/planifiés de n8n et l'exécution de la file d'attente se déclenchent sans requête entrante.
max_instance_count1Instances maximales (plafond de coût).
container_port5678n8n écoute sur le port 5678.
execution_environmentgen2Génération d'exécution Cloud Run. Gen2 requise pour les montages NFS.
timeout_seconds300Durée maximale de la requête en secondes.
enable_cloudsql_volumetrueProxy d'authentification Cloud SQL pour les connexions socket.
enable_image_mirroringtrueMettre en miroir l'image n8n dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.
max_revisions_to_retain7Nombre d'anciennes révisions Cloud Run à conserver.

Groupe 5 — Accès et contrôle d'entrée​

VariableValeur par défautDescription
ingress_settingsallQuels réseaux peuvent atteindre le service (all / internal / internal-and-cloud-load-balancing).
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variablesValeurs par défaut de l'espace réservé SMTPParamètres supplémentaires non secrets. Les valeurs principales N8N_* et DB_TYPE sont définies automatiquement. La carte par défaut inclut SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_SSL et EMAIL_FROM prêts à être remplacés.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay / secret_rotation_period(défini)Attente de réplication / cadence de rotation.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 8 — CI/CD et autorisation binaire​

Intégration standard de Cloud Build / Cloud Deploy d'App_CloudRun — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

Groupe 9 — SQL personnalisé​

VariableValeur par défautDescription
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootdésactivéExécuter SQL à partir d'un bucket GCS après le provisionnement.

Groupe 10 — Domaine, CDN, Cloud Armor et rétention d'images​

VariableValeur par défautDescription
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge externe.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge.
enable_cloud_armor / admin_ip_rangesdésactivéAttacher une politique WAF / restreindre l'accès privilégié.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueVolume Filestore partagé pour les données de fichiers binaires. Nécessite gen2.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
nfs_instance_name / nfs_instance_base_name(défini)Instance NFS existante / nom de base pour une instance intégrée.
create_cloud_storage / storage_buckets / gcs_volumes(défini)Bucket de données / buckets supplémentaires / montages GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — ne pas modifier.
db_namen8n_dbNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_usern8n_userUtilisateur de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16-64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.
db_host_env_var_name / db_name_env_var_name / db_user_env_var_name / db_port_env_var_name / service_url_env_var_name(défini)Noms sous lesquels les détails de connexion sont injectés.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job de configuration de base de données db-init intégré.
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler. Le planificateur intégré de n8n gère les déclencheurs de flux de travail ; utilisez-les pour les opérations externes.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / startup_probe_configHTTP GET /, délai initial de 120sLa sonde de démarrage cible la racine n8n.
liveness_probe / health_check_configHTTP GET /, délai initial de 30sSonde de vivacité.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring facultatif.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — File d'attente Redis​

VariableValeur par défautDescription
enable_redistrueUtiliser Redis pour l'exécution de flux de travail en mode file d'attente.
redis_host""Point de terminaison Redis. Laisser vide pour utiliser l'adresse IP de l'hôte NFS.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis facultatif (sensible).

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom de la base de données / utilisateur de l'application.
database_password_secretSecret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence si incorrect
N8N_ENCRYPTION_KEY(généré automatiquement, ne jamais faire pivoter)CritiqueLa rotation ou la suppression de cette clé détruit définitivement toutes les informations d'identification de flux de travail enregistrées.
db_name / db_userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données de flux de travail.
enable_nfstrueCritiqueSans stockage partagé, les fichiers binaires ne sont pas partagés entre les instances et le mode binaire filesystem échoue.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans backup_uri valide échoue le job d'importation.
enable_redistrueÉlevéSans le mode file d'attente Redis, l'exécution de plus d'une instance entraîne des conflits d'exécution de flux de travail.
redis_host"" (NFS) ou expliciteÉlevéPas de point de terminaison valide si Redis est activé mais NFS est désactivé et aucun hôte n'est défini.
min_instance_count1 (par défaut) pour les charges de travail de webhookÉlevéLa définition de 0 entraîne des délais d'attente de démarrage à froid sur les appels de webhook provenant de services avec des délais d'attente courts.
execution_environmentgen2 (par défaut)ÉlevéLes montages NFS nécessitent Gen2 ; les instances Gen1 ne peuvent pas monter de volumes NFS.
memory_limit4GiÉlevéTrop peu de mémoire provoque des OOM lors de grands lots d'exécution de flux de travail.
enable_iap / enable_cloud_armoractiver pour la productionMoyenL'éditeur n8n est autrement accessible publiquement et expose toutes les informations d'identification enregistrées.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, entrée et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à n8n partagée avec la variante GKE est décrite dans N8N_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.