Invoice Ninja sur Google Cloud Run
Ce document fournit une référence complète pour le module modules/InvoiceNinja_CloudRun. Il couvre l'architecture, la gestion des identités et des accès (IAM), les variables de configuration, les comportements spécifiques à Invoice Ninja et les modèles opérationnels pour le déploiement d'Invoice Ninja sur Google Cloud Run (v2).
Coût d'Invoice Ninja sur RAD et comparaison
Invoice Ninja sur le module Cloud Run de RAD coûte environ 99 $ US par mois dans votre propre projet, plus des frais de module de 110 crédits (11 $ US) une fois par déploiement, sans licence par utilisateur. Si vous n'en avez besoin que de façon saisonnière, consultez la section "Mettez-le en pause gratuitement" ci-dessous pour arrêter de payer sans perdre vos factures. Invoice Ninja est également proposé sous forme de module GKE, qui coûte plus cher ici (environ 143 $ US/mois) en raison des frais de gestion du cluster — Cloud Run est le choix le moins cher, sauf si vous utilisez déjà GKE Autopilot pour d'autres applications.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 110 crédits (11,00 $ US) | 99 crédits (10 % de moins) |
| Builds | Inclus 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 un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de build | Identique |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 98,82 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 $ US au prix de la recharge) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve |
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).
10 crédits coûtent 1 $ US pour une recharge unique, moins cher avec un abonnement. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas de deuxième base de données.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (module par défaut) | Par mois |
|---|---|
| Cloud Run, 2x vCPU / 2 GiB (scaleToZero) | 28,37 $ US |
| Cloud SQL pour MySQL, 1 vCPU / 3,75 GB, zonal, 10 GB SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5,00 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ US |
| Total | environ 98,82 $ US |
Comparaison
- Les plans hébergés d'Invoice Ninja sont Ninja Pro à 14 $/mois et Enterprise à partir de 18 $/mois pour 1 à 2 utilisateurs de compte, augmentant avec la taille de l'équipe — 94 $/mois pour 11 à 20 utilisateurs et jusqu'à 300 $/mois pour 51 à 100 utilisateurs (invoiceninja.com/pricing-plans, 8 octobre 2026).
- Le coût d'exécution du projet propre à RAD ici (environ 99 $/mois) est un coût d'infrastructure fixe qui ne varie pas lorsque vous ajoutez du personnel en contact avec les clients. Il coûte donc plus cher que Ninja Pro pour un seul utilisateur, mais est plus avantageux qu'Enterprise dès qu'une poignée de personnes ont besoin de comptes.
- Un VPS nu (Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go, environ 24 $/mois) est moins cher en espèces, mais vous devez alors gérer MySQL, les sauvegardes, les correctifs de sécurité et les dépendances de rendu PDF vous-même — sur un système qui contient les dossiers de paiement et de facturation des clients, où ce compromis est réel.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Invoice Ninja s'exécute dans un projet géré par RAD pour vous et que vous prévoyez d'y revenir — une pause entre les cours, une accalmie saisonnière, ou simplement ne pas savoir si vous en aurez besoin le mois prochain — c'est la meilleure option, et cela ne coûte presque rien.
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, sera utilisable après sa restauration. Par conséquent, 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 suppression d'un projet géré par RAD dissocie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement : la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'Invoice Ninja en tant que module unique, cela ne supprime pas le service Cloud Run/GKE, la base de données Cloud SQL, le serveur de fichiers NFS et le réseau un par un — l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà dissociée.
La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de restaurer 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 qu'il faut : vous devez posséder le projet (pas un projet dont RAD ne gère que 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 palier (100 crédits pour le palier sandbox que la plupart utilisent). Google indique que la plupart des services sont à nouveau pleinement opérationnels 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. L'exportation nocturne de la base de données et des documents téléchargés d'Invoice Ninja est conservée dans ce bucket ; copiez-la d'abord si vous souhaitez un instantané restaurable au-delà des 30 jours du projet.
Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
Dans votre propre projet, ou une fois que la fenêtre de 30 jours ci-dessus est passée, la solution de repli consiste à supprimer Invoice Ninja purement et simplement et à le redéployer plus tard.
- Ce que coûte un redéploiement : les frais de module à nouveau (les builds sont inclus) — les frais de module indiqués ci-dessus.
- Quand cela en vaut la peine : la suppression ne permet d'économiser de l'argent que si Invoice Ninja devait rester inutilisé pendant environ 3 jours ou plus dans votre propre projet (environ 3 jours ou plus dans un projet géré par RAD). La base de données et le serveur de fichiers NFS représentent la majeure partie du coût d'exécution ici, de sorte que la suppression d'Invoice Ninja seule permet d'économiser la totalité de la facture ci-dessus, à moins que quelque chose d'autre dans le projet ne les partage.
- Conservez les données en premier. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du déploiement, et ce bucket est supprimé avec lui — copiez la dernière sauvegarde (vers Google Drive, ou un bucket que vous conservez) avant de 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 reçoit 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 Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Google Cloud : supprimer et restaurer des projets pour le mécanisme de pause/restauration ; Tarification Invoice Ninja pour la comparaison Ninja Pro/Enterprise hébergée. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble du module
Invoice Ninja est une plateforme de facturation professionnelle open-source utilisée par les freelances et les petites entreprises. Elle propose des devis, des factures, des reçus, des paiements clients, une facturation récurrente, le suivi des dépenses, le suivi du temps, la gestion de projet et un portail client en libre-service. InvoiceNinja CloudRun est un module enveloppe construit au-dessus de App CloudRun. Il utilise App CloudRun pour toutes les provisions d'infrastructure GCP et injecte la configuration d'application spécifique à Invoice Ninja, l'initialisation de la base de données et la configuration du stockage via InvoiceNinja Common.
Capacités clés :
- Calcul : Cloud Run v2 (Gen2), conteneur Laravel PHP + nginx, 2 vCPU / 2 Gi par défaut.
min_instance_count = 0par défaut (mise à l'échelle à zéro, identique à la valeur par défaut de la fondationApp_CloudRun) — remplacez par1pour maintenir une instance chaude et éviter la latence de démarrage à froid lors du traitement des factures. - Persistance des données : Cloud SQL MySQL 8.0 (pas PostgreSQL). Volumes GCS via GCS Fuse pour les PDF de factures partagés, les logos clients et les documents téléchargés. NFS activé en option pour le stockage persistant partagé.
- Génération de PDF : Invoice Ninja intègre snappdf (Chromium sans tête) à
/usr/local/bin/chrome. La génération de PDF est gourmande en CPU et en mémoire — 2 vCPU / 2 Gi est le minimum recommandé. - Sécurité : Hérite de Cloud Armor WAF, IAP, Binary Authorization et VPC Service Controls de
App CloudRun. Le secretAPP_KEYest auto-généré parInvoiceNinja Commonet stocké dans Secret Manager. - File d'attente et cache : Redis activé par défaut (
enable_redis = true) — Invoice Ninja utilise Redis pourQUEUE_CONNECTION,CACHE_DRIVERetSESSION_DRIVER. La génération de PDF en arrière-plan et la mise en file d'attente des e-mails nécessitent Redis en production. - CI/CD : Image
invoiceninja/invoiceninja:5pré-construite déployée par défaut (container_image_source = 'prebuilt'). Pipeline d'images personnalisées Cloud Build disponible. - Fiabilité : Les sondes de santé ciblent
/avec un délai initial généreux de 90 secondes et un seuil d'échec de 30 tentatives pour s'adapter à l'initialisation PHP d'Invoice Ninja et aux migrations de base de données au premier démarrage.
Identité du projet et de l'application
| Variable | Groupe | Type | Valeur par défaut | Description |
|---|---|---|---|---|
project_id | 1 | string | — | ID du projet GCP. Obligatoire. |
tenant_id | 2 | string | 'demo' | Suffixe court ajouté à tous les noms de ressources. |
support_users | 2 | list(string) | [] | Destinataires des alertes de surveillance par e-mail. |
resource_labels | 2 | map(string) | {} | Libellés appliqués à toutes les ressources provisionnées. |
application_name | 3 | string | 'invoiceninja' | Nom de ressource de base. Ne pas modifier après le déploiement initial. |
application_display_name | 3 | string | 'Invoice Ninja' | Nom lisible par l'homme affiché dans la console GCP. |
application_description | 3 | string | 'Invoice Ninja - Open-source invoicing platform' | Description du service Cloud Run. |
application_version | 3 | string | '5' | Balise de version de l'image Invoice Ninja. Incrémenter pour déployer une nouvelle version. |
Architecture enveloppe : InvoiceNinja CloudRun appelle InvoiceNinja Common pour construire un objet application_config contenant des variables d'environnement spécifiques à Invoice Ninja, la configuration de la sonde, et les définitions de job db-init et artisan-migrate. Le module injecte DB_CONNECTION=mysql et la configuration du générateur de PDF snappdf automatiquement. module_storage_buckets contient le bucket de stockage GCS provisionné par InvoiceNinja Common. scripts_dir est résolu en abspath("${module.invoiceninja_app.path}/scripts") au moment de l'apply.
Note MySQL : Invoice Ninja nécessite MySQL 8.0, pas PostgreSQL. database_type = "MYSQL_8_0" est la valeur par défaut et ne doit pas être modifiée.
2. IAM et contrôle d'accès
InvoiceNinja_CloudRun délègue toutes les provisions IAM à App_CloudRun. Les ensembles de rôles du compte de service Cloud Run, du compte de service Cloud Build, de l'agent de service IAP et de la rotation des mots de passe sont identiques à ceux d'App_CloudRun.
Secret d'application : InvoiceNinja Common génère automatiquement le secret APP_KEY (clé de chiffrement d'application Laravel — une valeur aléatoire de 32 octets encodée en base64, stockée sous la forme base64:<value>) dans Secret Manager et l'expose à la fois via sa propre sortie secret_ids et intégré dans config.secret_environment_variables. La variante InvoiceNinja_CloudRun, cependant, ne consomme pas directement l'un de ces éléments pour le conteneur de service — elle calcule le même ID de secret elle-même (secret-<resource_prefix>-<app>-app-key) dans sa propre variable locale module_secret_env_vars, spécifiquement pour éviter un cycle de dépendance Terraform "connu après l'apply" qui se produirait autrement lorsque le secret est remplacé. L'effet net est le même : APP_KEY n'atteint le conteneur qu'en tant que référence Secret Manager, jamais en tant que variable d'environnement en texte clair.
Identité d'initialisation de la base de données : Les jobs Cloud Run db-init et artisan-migrate s'exécutent sous le compte de service Cloud Run. Ils se connectent à Cloud SQL MySQL via le socket Unix du proxy d'authentification (depuis enable_cloudsql_volume = true par défaut), en utilisant DB_HOST (le chemin du socket sous /cloudsql), DB_USER et ROOT_PASSWORD (depuis Secret Manager).
Délai de propagation IAM de 120 secondes : Hérité de App CloudRun — le service Invoice Ninja n'est pas déployé tant que le délai n'est pas écoulé, ce qui empêche les échecs de lecture de secrets au premier démarrage de la révision.
3. Configuration du service principal
A. Calcul (Cloud Run)
Invoice Ninja est une application Laravel PHP avec Chromium intégré pour la génération de PDF. Ces deux composants imposent des exigences importantes en matière de ressources. InvoiceNinja CloudRun expose cpu_limit et memory_limit comme des variables de niveau supérieur dédiées.
La mise à l'échelle à zéro est activée par défaut (min_instance_count = 0, correspondant à la valeur par défaut de la fondation App_CloudRun). Le démarrage à froid d'Invoice Ninja implique l'initialisation de PHP-FPM, le démarrage de Laravel et la migration facultative de la base de données — cela peut prendre 20 à 40 secondes. Définissez min_instance_count = 1 pour maintenir une instance chaude et éviter cette latence de démarrage à froid en production.
Le boost CPU au démarrage est toujours activé (codé en dur dans App CloudRun).
Image du conteneur : container_image_source utilise par défaut 'prebuilt', déployant directement l'image officielle invoiceninja/invoiceninja:5. Définissez sur 'custom' pour construire une image modifiée à l'aide de Cloud Build avec un Dockerfile personnalisé à partir de InvoiceNinja_Common.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
deploy_application | 4 | true | Définissez false pour un déploiement uniquement d'infrastructure (SQL, stockage, secrets). |
container_image_source | 4 | 'prebuilt' | 'prebuilt' déploie l'image officielle. 'custom' construit via Cloud Build. |
container_image | 4 | "" | Remplace l'URI de l'image. Laissez vide pour l'image Invoice Ninja par défaut. |
min_instance_count | 4 | 0 | Instances minimales en cours d'exécution (mise à l'échelle à zéro par défaut). Définissez 1 pour éviter la latence de démarrage à froid lors du traitement des factures. |
max_instance_count | 4 | 3 | Instances maximales en cours d'exécution. Agit comme un plafond de coût. |
cpu_limit | 4 | '2000m' | CPU par instance. 2 vCPU minimum pour la génération de PDF avec Chromium. |
memory_limit | 4 | '2Gi' | Mémoire par instance. 2 Gi minimum pour Chromium ; 4 Gi recommandés pour la production. |
container_port | 4 | 80 | Invoice Ninja écoute sur le port 80 via nginx. |
execution_environment | 4 | 'gen2' | Gen2 requis pour les montages NFS et GCS Fuse. |
timeout_seconds | 4 | 300 | Durée maximale de la requête. Augmentez pour la génération de PDF ou l'exportation de rapports. |
enable_cloudsql_volume | 4 | true | Monte le socket du proxy d'authentification Cloud SQL. |
cpu_always_allocated | 4 | false | Facturation basée sur les requêtes par défaut (coût-premier, s'associe à min_instance_count=0). Compromis : la file d'attente/planificateur Laravel s'arrête lorsqu'il est inactif, de sorte que les factures récurrentes et les e-mails planifiés ne se déclenchent pas — externalisez-les via Cloud Scheduler en atteignant le point de terminaison cron, ou définissez true avec min_instance_count >= 1 pour un fonctionnement continu. |
traffic_split | 4 | [] | Allocation de trafic canari/bleu-vert basée sur un pourcentage. |
service_annotations | 4 | {} | Annotations Cloud Run avancées. |
service_labels | 4 | {} | Libellés appliqués au service Cloud Run. |
Différences par rapport aux valeurs par défaut de App CloudRun :
| Variable | App CloudRun | InvoiceNinja CloudRun | Raison |
|---|---|---|---|
container_port | 8080 | 80 | Invoice Ninja utilise nginx sur le port 80. |
cpu_limit | '1000m' | '2000m' | La génération de PDF Chromium snappdf nécessite ≥2 vCPU pour un fonctionnement fiable. |
memory_limit | '512Mi' | '2Gi' | Le processus Chromium nécessite 1 à 2 Gi en plus de l'empreinte mémoire de PHP-FPM. |
container_image_source | 'custom' | 'prebuilt' | L'image officielle invoiceninja/invoiceninja est prête pour la production sans personnalisation. |
enable_image_mirroring | false | true | Invoice Ninja met en miroir son image de base vers Artifact Registry par défaut. |
B. Base de données (Cloud SQL — MySQL 8.0)
Invoice Ninja nécessite MySQL 8.0. PostgreSQL, SQL Server et d'autres moteurs ne sont pas pris en charge et entraîneront l'échec d'Invoice Ninja au démarrage avec une erreur de pilote de base de données.
Connexion par socket Unix : enable_cloudsql_volume utilise par défaut true. App CloudRun injecte le sidecar Auth Proxy et définit DB_HOST sur le chemin du socket sous /cloudsql. Invoice Ninja lit cela via les variables d'environnement standard DB_*.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
database_type | 12 | 'MYSQL_8_0' | Moteur Cloud SQL. Doit rester MYSQL_8_0 — Invoice Ninja ne prend pas en charge PostgreSQL. |
application_database_name | 12 | 'invoiceninja' | Nom de la base de données MySQL. Ne pas modifier après le déploiement initial. |
application_database_user | 12 | 'invoiceninja' | Utilisateur de l'application MySQL. Mot de passe auto-généré et stocké dans Secret Manager. |
database_password_length | 12 | 32 | Longueur du mot de passe auto-généré. Plage : 16–64. |
enable_auto_password_rotation | 12 | false | Rotation automatisée des mots de passe sans interruption. |
rotation_propagation_delay_sec | 12 | 90 | Secondes à attendre après la rotation avant de redémarrer le service. |
db_nameetdb_usersont transmis àInvoiceNinja Commonpour injection dans leapplication_config. Ceux-ci s'alignent avecapplication_database_nameetapplication_database_userdans le chemin de provisionnement de Cloud SQL — les deux doivent être définis sur la même valeur.
C. Stockage (NFS et GCS)
NFS est activé par défaut (enable_nfs = true). Invoice Ninja stocke les documents téléchargés, les logos clients, les PDF de factures et d'autres actifs sur le partage NFS afin que toutes les instances Cloud Run accèdent à un système de fichiers cohérent. Nécessite execution_environment = 'gen2'.
Bucket de stockage GCS : Un bucket GCS data est provisionné par défaut via storage_buckets. Les volumes GCS Fuse peuvent être configurés séparément pour monter des buckets directement dans le conteneur pour le stockage de documents.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_nfs | 11 | true | Provisionne NFS pour le stockage partagé de documents et de fichiers. Nécessite gen2. |
nfs_mount_path | 11 | '/mnt/nfs' | Chemin du conteneur où le partage NFS est monté. |
create_cloud_storage | 11 | true | Définissez false pour ignorer la création du bucket GCS. |
storage_buckets | 11 | [{ name_suffix = "data" }] | Buckets GCS à provisionner. |
gcs_volumes | 11 | [] | Buckets GCS à monter via GCS Fuse (nécessite gen2). Chaque entrée : name, bucket_name, mount_path, readonly, mount_options. |
manage_storage_kms_iam | 11 | false | Crée un trousseau de clés/clé KMS CMEK et active CMEK sur tous les buckets de stockage. |
enable_artifact_registry_cmek | 11 | false | Crée une clé KMS Artifact Registry pour le chiffrement d'images au repos. |
D. Réseau
Cloud Run utilise Direct VPC Egress pour atteindre l'IP interne de Cloud SQL. Comme enable_cloudsql_volume = true est la valeur par défaut, le sidecar Auth Proxy gère la connexion Cloud SQL via un socket Unix. Invoice Ninja a besoin d'un accès Internet sortant pour la livraison d'e-mails SMTP — assurez-vous que vpc_egress_setting = 'PRIVATE_RANGES_ONLY' pour autoriser la sortie publique directe.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
ingress_settings | 5 | 'all' | 'all' — Internet public ; 'internal' — VPC uniquement ; 'internal-and-cloud-load-balancing' — force le trafic via l'équilibreur de charge HTTPS. |
vpc_egress_setting | 5 | 'PRIVATE_RANGES_ONLY' | Acheminement du trafic RFC 1918 uniquement via le VPC. 'ALL_TRAFFIC' achemine tout le trafic sortant via le VPC. |
E. Initialisation et amorçage
Deux jobs Cloud Run sont provisionnés par InvoiceNinja Common lorsque initialization_jobs est laissé comme liste vide par défaut ([]) :
1. db-init — Utilise l'image mysql:8.0-debian. Opérations idempotentes :
- Se connecte à Cloud SQL MySQL via le socket Unix du proxy d'authentification.
- Crée l'utilisateur de base de données
invoiceninjaavec le mot de passe de Secret Manager. - Crée la base de données
invoiceninjasi elle n'existe pas. - Accorde à l'utilisateur
invoiceninjatous les privilèges sur la base de données.
2. artisan-migrate — Utilise l'image de l'application Invoice Ninja. Exécute les migrations de base de données Laravel, y compris la création initiale du schéma et les données d'amorçage (artisan migrate --seed). Dépend de la réussite de db-init. execute_on_apply = true afin qu'il s'exécute à chaque déploiement pour appliquer les modifications de schéma des mises à niveau de version.
Des tâches cron récurrentes supplémentaires peuvent être définies via cron_jobs :
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
initialization_jobs | 13 | [] | Jobs Cloud Run à exécution unique. Laissez vide pour que InvoiceNinja Common fournisse les jobs par défaut db-init et artisan-migrate. |
cron_jobs | 13 | [] | Jobs récurrents déclenchés par Cloud Scheduler. |
4. Sécurité avancée
A. Cloud Armor WAF
Lorsque enable_cloud_armor = true, un équilibreur de charge HTTPS global avec une politique Cloud Armor WAF (OWASP Top 10, DDoS adaptatif, limitation de débit de 500 requêtes/min) est provisionné devant Cloud Run.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_cloud_armor | 10 | false | Provisionne un équilibreur de charge HTTPS global + Cloud Armor WAF. Requis pour les domaines personnalisés, le CDN et la protection DDoS. |
admin_ip_ranges | 10 | [] | Plages CIDR exemptées des règles WAF (par exemple, VPN de bureau, adresses IP de sortie CI/CD). |
B. Proxy conscient de l'identité (IAP)
Lorsque enable_iap = true, l'intégration IAP native de Cloud Run est activée directement sur le service. Utile pour restreindre l'accès à Invoice Ninja aux employés authentifiés dans les flux de travail de facturation internes.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_iap | 5 | false | Active IAP nativement sur le service Cloud Run. |
iap_authorized_users | 5 | [] | Utilisateurs/comptes de service ayant accès. Format : 'user:email' ou 'serviceAccount:sa@...'. |
iap_authorized_groups | 5 | [] | Groupes Google ayant accès. Format : 'group:name@example.com'. |
C. Autorisation binaire
Lorsque enable_binary_authorization = true, Cloud Run impose que les images déployées portent une attestation cryptographique valide.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_binary_authorization | 8 | false | Applique l'attestation d'image. Nécessite une politique d'autorisation binaire et un attestateur préconfigurés dans le projet. |
D. Contrôles de service VPC
Lorsque enable_vpc_sc = true, tous les appels d'API GCP de ce module sont liés à un périmètre VPC-SC existant.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_vpc_sc | 22 | false | Enregistre les appels d'API du module dans le périmètre VPC-SC du projet. Un périmètre doit déjà exister avant l'activation. |
E. Intégration de Secret Manager
Les secrets d'Invoice Ninja sont stockés dans Secret Manager et injectés nativement par Cloud Run au démarrage de la révision — le texte en clair n'est jamais écrit dans l'état.
Secrets auto-générés : InvoiceNinja Common génère la clé de chiffrement Laravel APP_KEY et l'injecte via secret_environment_variables. Les secrets DB_PASSWORD et ROOT_PASSWORD sont provisionnés automatiquement par App CloudRun.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
secret_environment_variables | 6 | {} | Mappage nom de variable d'environnement → ID de secret Secret Manager. Résolu à l'exécution. (par exemple, { MAIL_PASSWORD = "smtp-password-secret" }) |
secret_rotation_period | 6 | '2592000s' | Fréquence à laquelle Secret Manager émet des notifications de rotation. Par défaut : 30 jours. |
secret_propagation_delay | 6 | 30 | Secondes à attendre après la création du secret avant que les ressources dépendantes ne continuent. |
5. Trafic et entrée
A. Équilibreur de charge HTTPS
Lorsque enable_cloud_armor = true, un équilibreur de charge HTTPS global soutenu par un NEG sans serveur est provisionné. Le trafic circule : Internet → Cloud Armor → Équilibreur de charge HTTPS global → NEG sans serveur → Cloud Run.
La définition de ingress_settings = 'internal-and-cloud-load-balancing' force tout le trafic Invoice Ninja à passer par l'équilibreur de charge, empêchant l'accès direct à l'URL *.run.app.
B. Cloud CDN
Lorsque enable_cdn = true (nécessite enable_cloud_armor = true), Cloud CDN est attaché au backend de l'équilibreur de charge HTTPS. Invoice Ninja sert un mélange d'actifs statiques et de données de facture dynamiques. Cloud CDN est bien adapté aux actifs CSS, JS et logos d'Invoice Ninja. Assurez-vous que les réponses PDF de facture et du portail client incluent les en-têtes Cache-Control appropriés avant d'activer le CDN pour les chemins d'API.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_cdn | 10 | false | Active Cloud CDN sur le backend de l'équilibreur de charge HTTPS. N'est efficace que lorsque enable_cloud_armor = true. |
max_images_to_retain | 10 | 7 | Nombre maximal d'images de conteneurs récentes à conserver dans Artifact Registry. |
delete_untagged_images | 10 | true | Supprime automatiquement les images non taguées (pendantes) d'Artifact Registry. |
image_retention_days | 10 | 30 | Jours après lesquels les images sont éligibles à la suppression. |
C. Domaines personnalisés
Les domaines personnalisés sont attachés à l'équilibreur de charge HTTPS global via application_domains. Les certificats SSL gérés par Google sont provisionnés automatiquement. Le DNS doit pointer vers l'adresse IP de l'équilibreur de charge après l'apply.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
application_domains | 10 | [] | Noms de domaine personnalisés pour l'équilibreur de charge HTTPS. Certificats SSL gérés par Google provisionnés par domaine. (par exemple, ['invoices.example.com']) |
6. CI/CD et livraison
A. Déclencheurs Cloud Build
Lorsque enable_cicd_trigger = true, une connexion GitHub Cloud Build et un déclencheur de push sont provisionnés. Étant donné que container_image_source = 'prebuilt' est la valeur par défaut, les déclencheurs CI/CD sont plus utiles lors du passage à 'custom' pour créer une image Invoice Ninja modifiée avec des fichiers de thème ou des plugins spécifiques à l'entreprise.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_cicd_trigger | 8 | false | Provisionne un déclencheur GitHub Cloud Build. |
github_repository_url | 8 | "" | URL HTTPS complète du dépôt GitHub. |
github_token | 8 | "" | PAT GitHub (repo, étendues admin:repo_hook). Requis lors du premier apply. Sensible. |
github_app_installation_id | 8 | "" | ID d'installation de l'application GitHub (préféré pour les dépôts d'organisation). |
cicd_trigger_config | 8 | { branch_pattern = "^main$" } | Configuration avancée du déclencheur : branch_pattern, included_files, ignored_files, trigger_name, substitutions. |
B. Pipeline Cloud Deploy
Lorsque enable_cloud_deploy = true (nécessite enable_cicd_trigger = true), le pipeline CI/CD est mis à niveau vers un pipeline de livraison Cloud Deploy géré avec des étapes de promotion séquentielles.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_cloud_deploy | 8 | false | Provisionne un pipeline Cloud Deploy. Nécessite enable_cicd_trigger = true. |
cloud_deploy_stages | 8 | [dev, staging, prod(approval)] | Étapes de promotion ordonnées. Chaque : name, target_name, service_name, require_approval, auto_promote. |
7. Fiabilité et planification
A. Mise à l'échelle et concurrence
min_instance_count = 0 par défaut (mise à l'échelle à zéro, correspondant à la valeur par défaut de la fondation App_CloudRun) — définissez sur 1 pour maintenir une instance chaude en permanence. max_instance_count = 3 offre une mise à l'échelle horizontale pendant les périodes de pointe de traitement des factures ou d'exportation par lots. Les deux valeurs sont configurables par l'utilisateur.
Invoice Ninja utilise une file d'attente basée sur Redis, de sorte que plusieurs instances peuvent traiter différents jobs de file d'attente sans conflit. Les sessions sont stockées dans Redis lorsque enable_redis = true, ce qui rend la mise à l'échelle horizontale sûre.
B. Répartition du trafic
La répartition du trafic est prise en charge via traffic_split. Les sessions et les files d'attente d'Invoice Ninja basées sur Redis sont partagées entre les instances, ce qui rend les déploiements canaris sûrs — les sessions client existantes persistent quelle que soit l'instance qui gère les requêtes ultérieures.
C. Sondes de santé et surveillance de la disponibilité
Invoice Ninja n'expose pas de point de terminaison de santé dédié. Les sondes de démarrage et de vivacité ciblent / (la page de connexion ou le tableau de bord d'Invoice Ninja), qui renvoie HTTP 200 lorsque l'application est entièrement initialisée.
Le tableau ci-dessous liste la valeur par défaut déclarée de var.startup_probe — mais startup_probe est actuellement inerte. Le locals.invoiceninja_module de InvoiceNinja_CloudRun/main.tf fusionne inconditionnellement une surcharge codée en dur après module.invoiceninja_app.config, de sorte que toute valeur fournie pour var.startup_probe est silencieusement ignorée au moment de l'apply. La sonde réellement déployée est :
startup_probe = {
enabled = true
type = "TCP" # port-open check — Cloud Run health checks arrive over plain HTTP
path = "/" # ignored for a TCP probe
initial_delay_seconds = 60
timeout_seconds = 10
period_seconds = 15
failure_threshold = 36
}
c'est-à-dire TCP / 60s de délai initial / 36 tentatives (540 secondes de tolérance totale), et non la valeur par défaut HTTP/90s/30 tentatives indiquée dans le tableau des entrées. Ne comptez pas sur la modification de startup_probe pour modifier le type ou le timing de la sonde déployée — modifiez plutôt le bloc codé en dur dans main.tf. liveness_probe est également codé en dur dans la même fusion, mais aux valeurs identiques que sa variable déclare (HTTP / / / 120s de délai initial / 10s de délai d'attente / 30s de période / 3 échecs), donc — contrairement à startup_probe — sa valeur par défaut documentée correspond bien à ce qui est déployé.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
startup_probe | 14 | { enabled=true, type="HTTP", path="/", initial_delay_seconds=90, timeout_seconds=10, period_seconds=15, failure_threshold=30 } | Inerte — main.tf remplace inconditionnellement cette valeur par une sonde TCP codée en dur (initial_delay_seconds=60, failure_threshold=36) quelle que soit la valeur de cette variable. Voir ci-dessus. |
liveness_probe | 14 | { enabled=true, type="HTTP", path="/", initial_delay_seconds=120, timeout_seconds=10, period_seconds=30, failure_threshold=3 } | Sonde de vivacité. Le conteneur est redémarré après failure_threshold échecs consécutifs. main.tf code en dur cette valeur aux mêmes valeurs, de sorte que la valeur par défaut déclarée correspond à la sonde déployée. |
uptime_check_config | 14 | { enabled=false, path="/" } | Test de disponibilité Cloud Monitoring (désactivé par défaut). Lorsqu'il est activé, des alertes notifient support_users si inaccessible. |
alert_policies | 14 | [] | Politiques d'alerte métrique Cloud Monitoring. |
D. Rotation automatique des mots de passe
Lorsque enable_auto_password_rotation = true, un pipeline de rotation de mot de passe sans interruption est provisionné :
- Secret Manager émet une notification de rotation à chaque intervalle
secret_rotation_period. - Eventarc déclenche un job de rotation Cloud Run.
- Le job génère un nouveau mot de passe, met à jour l'utilisateur MySQL de Cloud SQL, écrit une nouvelle version du secret.
- Après
rotation_propagation_delay_secsecondes, le job redémarre le service Invoice Ninja.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_auto_password_rotation | 12 | false | Active la rotation automatique des mots de passe. |
rotation_propagation_delay_sec | 12 | 90 | Secondes à attendre après l'écriture du nouveau secret avant de redémarrer le service. |
8. Intégrations
A. File d'attente et cache Redis
Redis est obligatoire pour les déploiements Invoice Ninja en production (enable_redis = true par défaut). Invoice Ninja utilise Redis pour trois fonctions essentielles :
QUEUE_CONNECTION=redis— Traitement des tâches en arrière-plan, y compris la génération de PDF, l'envoi d'e-mails et l'expédition de webhooks. Sans Redis, ces opérations bloquent le cycle de requête HTTP, ce qui entraîne des délais d'attente.CACHE_DRIVER=redis— Mise en cache au niveau de l'application pour les paramètres, les données d'entreprise et les calculs de taxes.SESSION_DRIVER=redis— Stockage des sessions garantissant que les utilisateurs restent connectés sur plusieurs instances Cloud Run.
Lorsque enable_redis = true et redis_host ne sont pas fournis, le module utilise par défaut l'adresse IP du serveur NFS comme hôte Redis (une instance Redis légère colocalisée sur la VM GCE NFS). Pour les déploiements en production, pointez redis_host vers une instance Google Cloud Memorystore for Redis dédiée.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
enable_redis | 21 | true | Active Redis. Requis pour la génération de PDF en arrière-plan et la mise en file d'attente des e-mails en production. |
redis_host | 21 | "" | Nom d'hôte ou adresse IP du serveur Redis. Laissez vide pour utiliser l'adresse IP du serveur NFS. |
redis_port | 21 | '6379' | Port TCP du serveur Redis (chaîne). |
redis_auth | 21 | "" | Mot de passe d'authentification Redis. Sensible — jamais stocké dans l'état. |
B. SMTP et e-mail
Invoice Ninja envoie des e-mails transactionnels pour la livraison de factures aux clients, les approbations de devis, les confirmations de paiement et les notifications de factures récurrentes. Le SMTP doit être configuré avant la mise en service.
Variables spécifiques à Invoice Ninja (Groupe 23) :
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
invoiceninja_admin_email | 23 | 'admin@example.com' | Adresse e-mail de l'administrateur pour la connexion et les notifications système. |
mail_from_name | 23 | 'Invoice Ninja' | Nom affiché comme expéditeur sur les e-mails sortants. |
mail_from_address | 23 | 'ninja@example.com' | Adresse e-mail de l'expéditeur. Doit correspondre à votre domaine d'envoi vérifié. |
Les identifiants SMTP (hôte, port, utilisateur, mot de passe) sont transmis via environment_variables et secret_environment_variables :
environment_variables = {
MAIL_MAILER = "smtp"
MAIL_HOST = "smtp.mailgun.org"
MAIL_PORT = "587"
MAIL_USERNAME = "postmaster@mg.example.com"
}
secret_environment_variables = {
MAIL_PASSWORD = "invoiceninja-smtp-password"
}
C. Génération de PDF (snappdf / Chromium)
Invoice Ninja intègre snappdf avec un exécutable Chromium sans interface graphique à /usr/local/bin/chrome. Les variables d'environnement suivantes sont définies automatiquement par InvoiceNinja Common :
PDF_GENERATOR=snappdfSNAPPDF_EXECUTABLE_PATH=/usr/local/bin/chrome
Exigences en matière de CPU et de mémoire pour la génération de PDF : Chromium génère un processus distinct pour chaque rendu PDF. Sous une charge concurrente (plusieurs clients visualisant des factures simultanément), chaque génération de PDF peut consommer jusqu'à 500 Mo de RAM et 1 vCPU. L'allocation par défaut de 2 vCPU / 2 Gi prend en charge environ 2 à 4 rendus PDF simultanés. Augmentez memory_limit à '4Gi' pour les environnements de facturation à volume élevé.
D. Importation et récupération de sauvegarde
Lorsque enable_backup_import = true, un job Cloud Run dédié restaure une sauvegarde de base de données existante dans l'instance Cloud SQL MySQL provisionnée pendant l'apply.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
backup_schedule | 7 | '0 2 * * *' | Expression Cron (UTC) pour les sauvegardes quotidiennes automatisées. |
backup_retention_days | 7 | 7 | Jours de rétention des fichiers de sauvegarde dans GCS. |
enable_backup_import | 7 | false | Déclenche une restauration unique lors de l'apply. Définissez false après une importation réussie. |
backup_source | 7 | 'gcs' | 'gcs' (URI GCS complet) ou 'gdrive' (ID de fichier Drive). |
backup_uri | 7 | "" | URI GCS complet (par exemple, 'gs://my-bucket/invoiceninja-2024-01.sql') ou ID de fichier Google Drive. |
backup_format | 7 | 'sql' | Format du fichier de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip. |
E. Observabilité et alertes
Un test de disponibilité Cloud Monitoring interroge le point de terminaison Invoice Ninja depuis plusieurs emplacements mondiaux. Des stratégies d'alerte personnalisées peuvent surveiller les métriques Cloud Run (latence, taux d'erreur, nombre d'instances) et notifier support_users.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
uptime_check_config | 14 | { enabled=false, path="/" } | Configuration du test de disponibilité. Désactivé par défaut. |
alert_policies | 14 | [] | Stratégies d'alerte métriques. |
support_users | 2 | [] | Adresses e-mail notifiées par les déclencheurs de test de disponibilité et de stratégie d'alerte. |
9. Comportements gérés par la plateforme
Les comportements suivants sont appliqués automatiquement par InvoiceNinja CloudRun, quelles que soient les valeurs des variables.
| Comportement | Implémentation | Détail |
|---|---|---|
| MySQL 8.0 requis | database_type = "MYSQL_8_0" par défaut | L'application Laravel d'Invoice Ninja cible exclusivement MySQL. |
| APP_KEY auto-générée | InvoiceNinja Common génère et injecte via secret_environment_variables | Une clé de chiffrement Laravel aléatoire de 32 octets encodée en base64 est générée une fois et stockée dans Secret Manager. Elle n'est PAS régénérée lors des applys ultérieurs. |
| Générateur de PDF snappdf | PDF_GENERATOR=snappdf et SNAPPDF_EXECUTABLE_PATH=/usr/local/bin/chrome injectés automatiquement | Chromium est intégré dans le conteneur invoiceninja/invoiceninja:5. |
| TRUSTED_PROXIES=* | Injecté automatiquement | Requis pour que le proxy inverse de Cloud Run transmette correctement les adresses IP des clients et les en-têtes HTTPS à Laravel. |
| DB_CONNECTION=mysql | Injecté automatiquement | Sélection du pilote de base de données Laravel. |
| Redis requis pour les files d'attente | enable_redis = true par défaut | Les jobs en arrière-plan d'Invoice Ninja (génération de PDF, e-mail) échouent silencieusement ou expirent sans Redis. |
| Jobs db-init + artisan-migrate par défaut | Fournis par InvoiceNinja Common lorsque initialization_jobs = [] | La base de données, l'utilisateur et le schéma MySQL sont créés automatiquement. artisan-migrate s'exécute à chaque apply pour gérer les mises à niveau de version. |
| NFS activé par défaut | enable_nfs = true par défaut | Invoice Ninja stocke les téléchargements de documents, les logos des clients et les PDF générés dans le système de fichiers du conteneur. Sans NFS, ces fichiers sont perdus à chaque nouvelle révision. |
| min_instance_count = 0 | Par défaut (correspond à App_CloudRun) | Invoice Ninja s'adapte à zéro par défaut ; définissez min_instance_count = 1 pour maintenir une instance active et éviter la latence de démarrage à froid lors de la livraison des factures aux clients. |
10. Exploration avec la console GCP
Après le déploiement, accédez à ces emplacements dans la console GCP pour explorer l'infrastructure Invoice Ninja.
Service Cloud Run
- Accédez à Cloud Run → sélectionnez le service
invoiceninja-<deployment-id>. - Onglet Révisions : affiche toutes les révisions déployées, l'allocation du trafic et les digests des images de conteneur. Chaque exécution
artisan-migratecrée une nouvelle révision. - Onglet Journaux : diffuse les journaux d'application. Filtrez sur
severity=ERRORpour trouver les exceptions PHP et les jobs de file d'attente ayant échoué. Recherchez les entrées de journalLaravelet les messages de plantage de Chromium. - Onglet Métriques : affiche le nombre de requêtes, la latence des requêtes, le nombre d'instances de conteneur, l'utilisation du CPU et l'utilisation de la mémoire. Surveillez l'utilisation de la mémoire pendant la génération de PDF — les pics supérieurs à 1,8 Gi indiquent une pression sur la marge de manœuvre.
- Onglet YAML : inspectez la configuration complète du service Cloud Run, y compris toutes les variables d'environnement (en texte brut uniquement — les secrets s'affichent comme des références), les montages de volume et la configuration des sondes.
Jobs Cloud Run
- Accédez à Cloud Run → Jobs. Recherchez :
invoiceninja-<deployment-id>-db-init— le job d'initialisation de la base de données MySQL.invoiceninja-<deployment-id>-artisan-migrate— le job de migration Laravel.
- Sélectionnez un job et cliquez sur Exécutions pour voir l'historique de chaque exécution, les codes de sortie et la sortie du journal.
- Cliquez sur une exécution individuelle pour diffuser ses journaux — recherchez la sortie de migration de Laravel confirmant les tables créées ou ignorées.
Cloud SQL
- Accédez à SQL → sélectionnez l'instance Cloud SQL MySQL 8.0 (nommée
app<name><deploymentid>ou similaire). - Vue d'ensemble : affiche l'utilisation du CPU, de la mémoire et du stockage. Le modèle de requête d'Invoice Ninja est à forte lecture (génération de rapports) — surveillez les IOPS de lecture.
- Onglet Connexions : confirme les connexions actives depuis le proxy d'authentification Cloud Run. Chaque instance Cloud Run maintient un pool de connexions via le sidecar.
- Bases de données : vérifiez que la base de données
invoiceninjaexiste et a été créée par le jobdb-init. - Utilisateurs : vérifiez que l'utilisateur
invoiceninjaexiste avec les privilèges appropriés. - Sauvegardes : affichez les instantanés de sauvegarde automatisés et leur état de rétention.
Secret Manager
- Accédez à Sécurité → Secret Manager.
- Trouvez les secrets suivants (le préfixe varie selon le déploiement) :
app<name><id>-db-password— le mot de passe de l'utilisateur MySQL d'Invoice Ninja.app<name><id>-db-root-password— le mot de passe root MySQL utilisé pardb-init.app<name><id>-app-key— la clé de chiffrementAPP_KEYde Laravel.
- Cliquez sur n'importe quel secret pour afficher les versions, l'historique d'accès et la configuration de rotation.
- Onglet Versions : confirmez que la dernière version est
ENABLED. Une versionDESTROYEDouDISABLEDentraîne l'échec d'Invoice Ninja au démarrage avec une erreur d'accès au secret.
Cloud Storage
- Accédez à Cloud Storage → Buckets.
- Trouvez le bucket
app<name><id>-dataprovisionné pour le stockage des documents Invoice Ninja. - Parcourez le contenu du bucket pour voir les logos des clients téléchargés, les pièces jointes des factures et les fichiers PDF générés.
- Vérifiez les règles de Cycle de vie pour confirmer que les stratégies de rétention des sauvegardes sont appliquées.
Artifact Registry
- Accédez à Artifact Registry → Dépôts.
- Trouvez le dépôt pour ce déploiement. L'image
invoiceninja/invoiceninja:5(ou une build personnalisée) y est stockée après la mise en miroir. - Affichez les balises d'image, les valeurs de digest et les résultats d'analyse de vulnérabilité.
- Vérifiez que la stratégie de nettoyage supprime les images non balisées et les images au-delà de
max_images_to_retain.
Monitoring
- Accédez à Monitoring → Tests de disponibilité pour afficher l'état de disponibilité du point de terminaison Invoice Ninja depuis les emplacements de sonde mondiaux.
- Accédez à Monitoring → Alertes pour afficher les stratégies d'alerte configurées pour ce déploiement. Les alertes sont envoyées à
support_userslorsque le test de disponibilité échoue. - Accédez à Monitoring → Tableaux de bord → sélectionnez le tableau de bord Cloud Run pour les métriques par service.
11. Exploration avec gcloud
Utilisez ces commandes pour inspecter et dépanner le déploiement Invoice Ninja depuis la ligne de commande. Remplacez PROJECT_ID, REGION, SERVICE_NAME et DEPLOYMENT_ID par vos valeurs réelles.
Inspecter le service Cloud Run
# List all Cloud Run services in the project
gcloud run services list \
--project=PROJECT_ID \
--region=REGION \
--format="table(metadata.name,status.url,status.conditions[0].status)"
# Describe the Invoice Ninja service in full detail
gcloud run services describe invoiceninja-DEPLOYMENT_ID \
--project=PROJECT_ID \
--region=REGION \
--format=yaml
# Show the current revision serving traffic
gcloud run revisions list \
--service=invoiceninja-DEPLOYMENT_ID \
--project=PROJECT_ID \
--region=REGION \
--format="table(metadata.name,status.conditions[0].type,spec.containers[0].image)"
Diffuser et filtrer les journaux Cloud Run
# Tail Invoice Ninja application logs
gcloud logging read \
'resource.type="cloud_run_revision" AND resource.labels.service_name="invoiceninja-DEPLOYMENT_ID"' \
--project=PROJECT_ID \
--limit=100 \
--format="table(timestamp,severity,textPayload)" \
--freshness=1h
# Filter for errors only
gcloud logging read \
'resource.type="cloud_run_revision" AND resource.labels.service_name="invoiceninja-DEPLOYMENT_ID" AND severity>=ERROR' \
--project=PROJECT_ID \
--limit=50 \
--format="table(timestamp,textPayload)"
# Watch for Chromium/PDF generation events
gcloud logging read \
'resource.type="cloud_run_revision" AND resource.labels.service_name="invoiceninja-DEPLOYMENT_ID" AND textPayload=~"pdf|chromium|snappdf"' \
--project=PROJECT_ID \
--limit=20 \
--format="table(timestamp,textPayload)"
Inspecter les jobs Cloud Run (db-init, artisan-migrate)
# List all Cloud Run jobs
gcloud run jobs list \
--project=PROJECT_ID \
--region=REGION \
--format="table(metadata.name,status.conditions[0].type)"
# View recent executions of the artisan-migrate job
gcloud run jobs executions list \
--job=invoiceninja-DEPLOYMENT_ID-artisan-migrate \
--project=PROJECT_ID \
--region=REGION \
--format="table(metadata.name,status.conditions[0].type,status.conditions[0].lastTransitionTime)"
# Stream logs from the most recent artisan-migrate execution
gcloud logging read \
'resource.type="cloud_run_job" AND resource.labels.job_name="invoiceninja-DEPLOYMENT_ID-artisan-migrate"' \
--project=PROJECT_ID \
--limit=100 \
--format="table(timestamp,textPayload)" \
--freshness=1d
Inspecter Cloud SQL
# List all Cloud SQL instances in the project
gcloud sql instances list \
--project=PROJECT_ID \
--format="table(name,databaseVersion,state,ipAddresses[0].ipAddress)"
# Describe the Invoice Ninja MySQL instance
gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID \
--format="yaml(name,databaseVersion,state,settings.tier,settings.dataDiskSizeGb,settings.ipConfiguration)"
# List databases on the instance
gcloud sql databases list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID
# List Cloud SQL users
gcloud sql users list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID \
--format="table(name,host,passwordPolicy.status)"
# Check current active connections
gcloud sql operations list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID \
--limit=10 \
--format="table(name,operationType,status,startTime)"
Inspecter Secret Manager
# List all secrets for this deployment
gcloud secrets list \
--project=PROJECT_ID \
--filter="name~invoiceninja" \
--format="table(name,replication.automatic,createTime)"
# Check the APP_KEY secret versions
gcloud secrets versions list app-key-SECRET_NAME \
--project=PROJECT_ID \
--format="table(name,state,createTime)"
# Access the APP_KEY value (requires secretAccessor role — use with care)
gcloud secrets versions access latest \
--secret=APP_KEY_SECRET_NAME \
--project=PROJECT_ID
Inspecter le stockage GCS
# List storage buckets for this deployment
gcloud storage ls --project=PROJECT_ID | grep invoiceninja
# List top-level objects in the data bucket
gcloud storage ls gs://BUCKET_NAME/
# Check bucket IAM bindings
gcloud storage buckets get-iam-policy gs://BUCKET_NAME
# View lifecycle rules
gcloud storage buckets describe gs://BUCKET_NAME \
--format="json(lifecycle)"
Inspecter les images Artifact Registry
# List images in the repository
gcloud artifacts docker images list \
REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/invoiceninja \
--project=PROJECT_ID \
--format="table(image,tags,createTime)"
# Show vulnerability scan results
gcloud artifacts docker images scan \
REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/invoiceninja:5 \
--project=PROJECT_ID \
--format="json"
Vérifier Memorystore Redis (si vous utilisez une instance dédiée)
# List Redis instances
gcloud redis instances list \
--region=REGION \
--project=PROJECT_ID \
--format="table(name,host,port,state,memorySizeGb,authEnabled)"
# Describe a specific Redis instance
gcloud redis instances describe REDIS_INSTANCE_NAME \
--region=REGION \
--project=PROJECT_ID
Tests de disponibilité et alertes
# List uptime checks for this project
gcloud monitoring uptime list-configs \
--project=PROJECT_ID \
--format="table(displayName,monitoredResource.labels.host,period,timeout)"
# List alert policies
gcloud alpha monitoring policies list \
--project=PROJECT_ID \
--format="table(displayName,enabled,conditions[0].conditionThreshold.filter)"
12. Référence des variables
Toutes les variables configurables par l'utilisateur exposées par InvoiceNinja CloudRun, triées par groupe d'interface utilisateur puis par ordre.
| Variable | Groupe | Valeur par défaut | Description |
|---|---|---|---|
project_id | 1 | — | ID du projet GCP. Obligatoire. |
region | 1 | 'us-central1' | Région GCP pour le déploiement des ressources. |
tenant_id | 2 | 'demo' | Court suffixe ajouté à tous les noms de ressources. |
support_users | 2 | [] | Adresses e-mail pour les alertes de surveillance. |
resource_labels | 2 | {} | Libellés appliqués à toutes les ressources provisionnées. |
application_name | 3 | 'invoiceninja' | Nom de ressource de base. Ne pas modifier après le déploiement initial. |
application_display_name | 3 | 'Invoice Ninja' | Nom lisible par l'homme affiché dans la console GCP. |
application_description | 3 | 'Invoice Ninja - Open-source invoicing platform' | Description du service. |
application_version | 3 | '5' | Balise d'image de conteneur Invoice Ninja. |
deploy_application | 4 | true | Définissez false pour un déploiement uniquement d'infrastructure. |
container_image_source | 4 | 'prebuilt' | 'prebuilt' (image officielle) ou 'custom' (Cloud Build). |
container_image | 4 | "" | Remplace l'URI de l'image. Laissez vide pour l'image Invoice Ninja par défaut. |
min_instance_count | 4 | 0 | Instances minimales (mise à l'échelle à zéro par défaut). Définissez 1 pour maintenir Invoice Ninja actif. |
max_instance_count | 4 | 3 | Instances maximales. Agit comme un plafond de coût. |
cpu_limit | 4 | '2000m' | CPU par instance. 2 vCPU minimum pour la génération de PDF. |
memory_limit | 4 | '2Gi' | Mémoire par instance. 2 Gi minimum pour Chromium. |
container_port | 4 | 80 | Port Nginx d'Invoice Ninja. |
execution_environment | 4 | 'gen2' | Gen2 requis pour les montages NFS et GCS Fuse. |
timeout_seconds | 4 | 300 | Durée maximale de la requête. Augmentez pour la génération de PDF. |
enable_cloudsql_volume | 4 | true | Monte le socket Unix du proxy d'authentification Cloud SQL. |
cpu_always_allocated | 4 | false | Facturation basée sur les requêtes par défaut. Voir §3.A pour le compromis file d'attente/planificateur. |
cloudsql_volume_mount_path | 4 | '/cloudsql' | Chemin du conteneur pour le socket Unix du proxy d'authentification. |
container_protocol | 4 | 'http1' | 'http1' ou 'h2c'. |
enable_image_mirroring | 4 | true | Met en miroir l'image Invoice Ninja dans Artifact Registry. |
traffic_split | 4 | [] | Allocation de trafic Canary/bleu-vert. |
max_revisions_to_retain | 4 | 7 | Nombre maximal de révisions Cloud Run à conserver. |
service_annotations | 4 | {} | Annotations Cloud Run avancées. |
service_labels | 4 | {} | Libellés appliqués au service Cloud Run. |
ingress_settings | 5 | 'all' | 'all', 'internal' ou 'internal-and-cloud-load-balancing'. |
vpc_egress_setting | 5 | 'PRIVATE_RANGES_ONLY' | 'PRIVATE_RANGES_ONLY' ou 'ALL_TRAFFIC'. |
enable_iap | 5 | false | Active IAP nativement sur le service Cloud Run. |
iap_authorized_users | 5 | [] | Utilisateurs/SA autorisés à accéder à IAP. |
iap_authorized_groups | 5 | [] | Groupes Google autorisés à accéder à IAP. |
environment_variables | 6 | {} | Variables d'environnement en texte brut. Utilisez-les pour l'hôte SMTP, le port, le nom d'utilisateur et la configuration de la messagerie. |
secret_environment_variables | 6 | {} | Références Secret Manager (par exemple, { MAIL_PASSWORD = "smtp-password-secret" }). |
explicit_secret_values | 6 | {} | Valeurs sensibles brutes écrites directement dans Secret Manager pendant le déploiement. |
secret_propagation_delay | 6 | 30 | Secondes à attendre après la création du secret. |
secret_rotation_period | 6 | '2592000s' | Fréquence de notification de rotation de Secret Manager. |
backup_schedule | 7 | '0 2 * * *' | Expression Cron (UTC) pour les sauvegardes automatisées. |
backup_retention_days | 7 | 7 | Jours de rétention des fichiers de sauvegarde dans GCS. |
enable_backup_import | 7 | false | Déclenche une restauration unique lors de l'apply. |
backup_source | 7 | 'gcs' | 'gcs' (URI complet) ou 'gdrive' (ID de fichier). |
backup_uri | 7 | "" | URI GCS complet ou ID de fichier Google Drive. |
backup_format | 7 | 'sql' | Format de sauvegarde. Options : sql, tar, gz, tgz, tar.gz, zip. |
enable_cicd_trigger | 8 | false | Provisionne un déclencheur Cloud Build GitHub. |
github_repository_url | 8 | "" | URL HTTPS complète du dépôt GitHub. |
github_token | 8 | "" | PAT GitHub. Requis lors du premier apply. Sensible. |
github_app_installation_id | 8 | "" | ID d'installation de l'application GitHub. |
cicd_trigger_config | 8 | { branch_pattern = "^main$" } | Configuration avancée du déclencheur Cloud Build. |
enable_cloud_deploy | 8 | false | Provisionne un pipeline de livraison progressive Cloud Deploy. |
cloud_deploy_stages | 8 | [dev, staging, prod(approval)] | Étapes de promotion Cloud Deploy ordonnées. |
enable_binary_authorization | 8 | false | Applique l'attestation d'image lors du déploiement. |
enable_custom_sql_scripts | 9 | false | Exécute des scripts SQL depuis GCS après le provisionnement. |
custom_sql_scripts_bucket | 9 | "" | Bucket GCS contenant les scripts SQL. |
custom_sql_scripts_path | 9 | "" | Préfixe de chemin dans le bucket. |
custom_sql_scripts_use_root | 9 | false | Exécute les scripts en tant qu'utilisateur root de la base de données. |
enable_cloud_armor | 10 | false | Provisionne un équilibreur de charge HTTPS global + Cloud Armor WAF. |
admin_ip_ranges | 10 | [] | Plages CIDR exemptées des règles WAF. |
application_domains | 10 | [] | Domaines personnalisés avec certificats SSL gérés par Google. |
enable_cdn | 10 | false | Active Cloud CDN sur le backend de l'équilibreur de charge HTTPS. |
max_images_to_retain | 10 | 7 | Nombre maximal d'images de conteneur récentes à conserver dans Artifact Registry. |
delete_untagged_images | 10 | true | Supprime automatiquement les images non balisées d'Artifact Registry. |
image_retention_days | 10 | 30 | Jours après lesquels les images sont éligibles à la suppression. |
create_cloud_storage | 11 | true | Définissez false pour ignorer la création du bucket GCS. |
storage_buckets | 11 | [{ name_suffix = "data" }] | Buckets GCS à provisionner. |
enable_nfs | 11 | true | Provisionne le stockage partagé NFS. Nécessite gen2. |
nfs_mount_path | 11 | '/mnt/nfs' | Chemin du conteneur où NFS est monté. |
nfs_instance_name | 9 | "" | Nom d'une VM GCE NFS existante. Laissez vide pour la découverte automatique. |
nfs_instance_base_name | 9 | 'app-nfs' | Nom de base pour la VM NFS intégrée. L'ID de déploiement est ajouté. |
gcs_volumes | 11 | [] | Buckets GCS à monter via GCS Fuse. |
manage_storage_kms_iam | 11 | false | Crée une clé KMS CMEK et active CMEK sur les buckets de stockage. |
enable_artifact_registry_cmek | 11 | false | Crée une clé KMS Artifact Registry pour le chiffrement des images au repos. |
database_type | 12 | 'MYSQL_8_0' | Moteur Cloud SQL. Doit rester MYSQL_8_0 pour Invoice Ninja. |
application_database_name | 12 | 'invoiceninja' | Nom de la base de données MySQL. Ne pas modifier après le déploiement initial. |
application_database_user | 12 | 'invoiceninja' | Utilisateur de l'application MySQL. |
database_password_length | 12 | 32 | Longueur du mot de passe auto-généré. Plage : 16–64. |
enable_auto_password_rotation | 12 | false | Rotation automatisée du mot de passe sans interruption. |
rotation_propagation_delay_sec | 12 | 90 | Secondes à attendre après la rotation avant de redémarrer le service. |
initialization_jobs | 13 | [] | Jobs Cloud Run ponctuels. Laissez vide pour les valeurs par défaut db-init et artisan-migrate. |
cron_jobs | 13 | [] | Jobs Cloud Run planifiés récurrents. |
startup_probe | 14 | { path="/", initial_delay_seconds=90, failure_threshold=30, ... } | Inerte — la valeur par défaut déclarée ici n'est jamais déployée ; main.tf remplace inconditionnellement par une sonde type="TCP", initial_delay_seconds=60, failure_threshold=36 codée en dur. Voir §7C. |
liveness_probe | 14 | { path="/", initial_delay_seconds=120, failure_threshold=3, ... } | Sonde de vivacité. main.tf la code en dur avec les mêmes valeurs que la valeur par défaut déclarée, elle est donc effectivement toujours celle-ci. |
uptime_check_config | 14 | { enabled=false, path="/" } | Test de disponibilité Cloud Monitoring (désactivé par défaut). |
alert_policies | 14 | [] | Stratégies d'alerte métriques Cloud Monitoring. |
enable_redis | 21 | true | Activé par défaut. Requis pour la génération de PDF et la mise en file d'attente des e-mails. |
redis_host | 21 | "" | Nom d'hôte/IP Redis. Par défaut, l'adresse IP du serveur NFS si vide. |
redis_port | 21 | '6379' | Port TCP Redis (chaîne). |
redis_auth | 21 | "" | Mot de passe d'authentification Redis. Sensible. |
enable_vpc_sc | 22 | false | Enregistre les appels d'API dans le périmètre VPC-SC du projet. |
vpc_cidr_ranges | 22 | [] | Plages CIDR de sous-réseau VPC pour le niveau d'accès VPC-SC. |
vpc_sc_dry_run | 22 | true | Enregistre les violations VPC-SC sans bloquer. Définissez false pour appliquer. |
organization_id | 22 | "" | ID d'organisation GCP pour VPC-SC. Découvert automatiquement si vide. |
enable_audit_logging | 22 | false | Active les journaux d'audit Cloud détaillés. |
invoiceninja_admin_email | 23 | 'admin@example.com' | E-mail de l'administrateur pour la connexion et les notifications. |
mail_from_name | 23 | 'Invoice Ninja' | Nom d'affichage pour les e-mails sortants. |
mail_from_address | 23 | 'ninja@example.com' | Adresse e-mail de l'expéditeur pour les e-mails sortants. |
13. Sorties
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL publique du service Cloud Run. |
service_location | Région GCP où le service Cloud Run est déployé. |
project_id | ID du projet GCP. |
deployment_id | Suffixe de l'ID de déploiement utilisé dans les noms de ressources. |
database_instance_name | Nom de l'instance Cloud SQL MySQL. |
database_name | Nom de la base de données de l'application. |
database_user | Nom de l'utilisateur de la base de données de l'application. |
database_password_secret | Nom du secret Secret Manager pour le mot de passe de la base de données. |
storage_buckets | Buckets de stockage GCS créés. |
container_image | Image de conteneur utilisée pour le déploiement. |
cicd_enabled | Indique si le pipeline CI/CD est activé. |
github_repository_url | URL du dépôt GitHub connecté pour le CI/CD. |
14. Pièges de configuration et valeurs par défaut judicieuses
Niveaux de risque : Critique (perte de données, panne complète, faille de sécurité) — Élevé (service indisponible ou dégradation significative) — Moyen (fonction dégradée ou coût accru) — Faible (impact mineur).
| Variable | Valeur par défaut judicieuse | Risque | Conséquence d'une valeur incorrecte |
|---|---|---|---|
project_id | (obligatoire) | Critique | Pas de valeur par défaut — le déploiement échoue immédiatement. |
database_type | "MYSQL_8_0" | Critique | L'application Laravel d'Invoice Ninja utilise exclusivement MySQL. La définition sur POSTGRES entraîne l'échec d'Invoice Ninja au démarrage avec une erreur de pilote PDO. |
application_database_name | "invoiceninja" | Critique | Immuable après le premier déploiement. La modification de cette valeur entraîne la recréation de la base de données par Terraform, détruisant toutes les données de factures, de clients et de paiements. |
application_database_user | "invoiceninja" | Critique | Immuable après le premier déploiement. La modification de cette valeur recrée l'utilisateur MySQL, invalidant les identifiants stockés et faisant planter l'application. |
memory_limit | "2Gi" | Élevé | Invoice Ninja génère un processus Chromium pour chaque rendu PDF. En dessous de 1 Gi, Chromium tue le processus par manque de mémoire pendant la génération de PDF, renvoyant des PDF vierges ou des erreurs 500 aux clients. Le minimum pour Chromium est d'environ 512 Mi par rendu concurrent. |
cpu_limit | "2000m" | Élevé | En dessous de 1 vCPU, le rendu PDF de Chromium ralentit considérablement et peut expirer. timeout_seconds pourrait devoir être augmenté en même temps que toute réduction de CPU. |
enable_redis | true | Critique | Invoice Ninja REQUIERT Redis pour le traitement des files d'attente en arrière-plan. Sans Redis, la génération de PDF de factures et la livraison d'e-mails sont synchrones — elles bloquent la requête HTTP, provoquent des délais d'attente et échouent sous une charge concurrente. La désactivation de Redis en production rend le flux de travail de livraison des factures peu fiable. |
redis_host | "" (se résout automatiquement en IP NFS) | Élevé | Si enable_nfs = false et redis_host restent vides avec enable_redis = true, Invoice Ninja ne peut pas se connecter à Redis au démarrage. L'application démarrera mais les jobs de file d'attente échoueront silencieusement. |
enable_nfs | true | Élevé | Invoice Ninja écrit les documents téléchargés, les logos des clients et les données mises en cache dans le système de fichiers du conteneur. Sans NFS, les fichiers téléchargés sur une instance sont invisibles pour les autres, et tous les téléchargements d'utilisateurs sont perdus à chaque nouveau déploiement de révision Cloud Run. |
min_instance_count | 0 (par défaut) — définissez 1 pour la production | Moyen | La mise à l'échelle à zéro par défaut provoque des démarrages à froid. L'initialisation PHP-FPM d'Invoice Ninja + la vérification de la migration de la base de données prend 10 à 30 secondes. Les clients accédant aux liens de facture pendant le démarrage à froid reçoivent des erreurs de délai d'attente. |
container_image_source | "prebuilt" | Faible | L'image officielle invoiceninja/invoiceninja est prête pour la production. Le passage à "custom" nécessite un Dockerfile valide dans InvoiceNinja_Common/scripts/ — si la build échoue, aucune nouvelle révision n'est déployée. |
invoiceninja_admin_email | "admin@example.com" | Moyen | L'e-mail de l'administrateur doit être une adresse valide et accessible. L'utilisation de l'espace réservé par défaut empêche l'administrateur de recevoir les notifications système et bloque les flux de réinitialisation de mot de passe initiaux. |
mail_from_address | "ninja@example.com" | Élevé | Les e-mails de livraison de factures envoyés depuis un domaine non vérifié sont susceptibles d'être rejetés par les serveurs de messagerie des clients ou marqués comme spam. Configurez un domaine d'expéditeur vérifié avant d'envoyer des factures aux clients. |
backup_retention_days | 7 | Moyen | Sept jours sont insuffisants pour les données de facturation. Les enregistrements de factures et de paiements sont légalement requis d'être conservés dans de nombreuses juridictions. Augmentez à 90+ jours pour les déploiements en production. |
enable_cloud_armor | false | Moyen | Sans Cloud Armor, le panneau d'administration d'Invoice Ninja et le portail client sont exposés au trafic de bots. Les identifiants d'administration d'Invoice Ninja peuvent être ciblés par des attaques de bourrage d'identifiants. |
timeout_seconds | 300 | Moyen | La génération de PDF pour des factures complexes à plusieurs lignes avec une marque personnalisée peut prendre 10 à 30 secondes sous charge. Les exportations de rapports sur de grandes plages de dates peuvent dépasser 300 secondes. Augmentez à 600 pour les déploiements à volume élevé. |
vpc_egress_setting | "PRIVATE_RANGES_ONLY" | Moyen | Invoice Ninja doit atteindre des serveurs SMTP externes pour la livraison d'e-mails. PRIVATE_RANGES_ONLY permet une sortie publique directe pour SMTP. La définition de "ALL_TRAFFIC" avec un pare-feu VPC restrictif bloque le SMTP sortant. |
15. Destruction des ressources
Problème de suppression connu : libération de l'adresse IPv4 sans serveur
Lors de la destruction d'un déploiement Cloud Run, vous pouvez rencontrer une erreur similaire à :
Error: Error waiting for Subnetwork to be deleted: The following serverless IPv4 address(es) on subnet ... are still in use.
Cause : GCP conserve les adresses IPv4 sans serveur sur le sous-réseau VPC de manière asynchrone après la suppression d'un service Cloud Run. Ces adresses sont libérées par GCP environ 20 à 30 minutes après la suppression du service Cloud Run.
Résolution : Attendez 20 à 30 minutes après la tentative de destruction initiale, puis réexécutez la commande de destruction :
tofu destroy
La deuxième exécution réussira une fois que GCP aura libéré les adresses réservées.
Guides associés
- Lab pratique : InvoiceNinja sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Module Invoice Ninja GKE — Guide de configuration — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Module de configuration partagée commune InvoiceNinja — la configuration partagée par les deux cibles de déploiement.
- Déployé avec Dolibarr sur Google Cloud Run, Kimai sur Google Cloud Run, Docuseal sur Google Cloud Run, Nextcloud sur Google Cloud Run dans la solution Small Business Suite.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.