Aller au contenu principal

Module Invoice Ninja GKE — Guide de configuration

Module Invoice Ninja GKE — Guide de configuration

Ce guide décrit toutes les variables de configuration disponibles dans le module InvoiceNinja_GKE. InvoiceNinja_GKE est un module wrapper qui combine le module d'infrastructure générique App_GKE avec la configuration d'application partagée InvoiceNinja_Common pour déployer Invoice Ninja — la plateforme open-source de facturation — sur Google Kubernetes Engine (GKE) Autopilot.

Invoice Ninja fournit une suite complète de facturation auto-hébergée : devis, factures, reçus, paiements clients, facturation récurrente, suivi des dépenses, suivi du temps, gestion de projet et un portail client en libre-service. C'est une alternative auto-hébergée à FreshBooks ou QuickBooks.

La plupart des options de configuration dans InvoiceNinja GKE correspondent directement aux mêmes options dans App GKE. Lorsqu'une variable a un comportement identique, ce guide fait référence au guide App GKE plutôt que de répéter la même documentation. Seules les variables et les valeurs par défaut spécifiques à Invoice Ninja sont décrites en détail ici.

Note : Les variables marquées comme gérées par la plateforme sont définies et maintenues par la plateforme. Vous n'avez normalement pas besoin de les modifier.


Ce que coûte Invoice Ninja sur RAD et comparaison​

Invoice Ninja sur le module GKE de RAD coûte environ 143 $ US par mois dans votre propre projet, plus des frais de module de 175 crédits (18 $ US) une fois par déploiement. Si vous n'en avez besoin que de manière 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 disponible en tant que module Cloud Run, qui est l'option la moins chère ici (environ 99 $ US/mois) — consultez le guide Cloud Run, 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édezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement175 crédits (17,50 $ US)157,5 crédits (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 sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 142,62 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 142 crédits par jour, soit environ 4 260 par mois (environ 426 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD 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

10 crédits coûtent 1 $ US pour une recharge ponctuelle, moins sur 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 une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (valeur par défaut du module)Par mois
Pod GKE Autopilot, 2x vCPU / 2 GiB72,16 $ US
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Totalenviron 142,62 $ 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 propre projet de RAD ici (environ 99 $/mois) est un coût d'infrastructure fixe qui ne change 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 compétitif que 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 enregistrements 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 quand vous en avez besoin​

Si Invoice Ninja fonctionne dans un projet géré par RAD pour vous et que vous prévoyez d'y revenir — une pause entre les cours, un creux saisonnier, ou simplement ne pas savoir si vous en aurez besoin le mois prochain — c'est la meilleure option, et elle 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, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable 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 délie 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à délié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 être propriétaire du projet (pas un projet dont RAD gère uniquement 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, donc 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 convient). Google indique que la plupart des services sont de 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. 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 voulez 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 resterait inutilisé pendant environ 4 jours ou plus dans votre propre projet (environ 2 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, donc la suppression d'Invoice Ninja seul 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 obtient 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 retournent au formateur.
  • Environnements gérés, pour les sociétés 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 interrompue 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.


Référence de configuration standard​

Les zones de configuration suivantes sont fournies par le module sous-jacent App_GKE.

Zone de configurationNotes spécifiques à Ghost
Projet et identitéIdentique à App_GKE.
Identité de l'applicationValeurs par défaut spécifiques à Invoice Ninja pour application_name, application_display_name et application_version ; voir Groupe 3 : Identité de l'application.
Exécution et mise à l'échelleValeurs par défaut spécifiques à Invoice Ninja pour container_port, cpu_limit, memory_limit et container_resources ; voir Groupe 4 : Exécution et mise à l'échelle.
Variables d'environnement et secretsVariables DB_CONNECTION=mysql, TRUSTED_PROXIES=* et snappdf injectées automatiquement ; voir Groupe 5 : Variables d'environnement et secrets.
Réseau et stratégies réseauIdentique à App_GKE.
Jobs d'initialisation et CronJobsJob MySQL db-init et artisan-migrate fournis automatiquement par InvoiceNinja Common ; voir Groupe 11 : Jobs et tâches planifiées.
Stockage — NFSenable_nfs par défaut à true ; voir Groupe 16 : Stockage — NFS.
Stockage — GCSBucket GCS data provisionné automatiquement ; voir Groupe 17 : Stockage — GCS.
Configuration de la base de donnéesMySQL 8.0 requis ; voir Groupe 18 : Configuration de la base de données.
Planification et rétention des sauvegardesIdentique à App_GKE.
Scripts SQL personnalisésIdentique à App_GKE.
Observabilité et santéRéglage des sondes Invoice Ninja ; voir Groupe 13 : Observabilité et santé.
Cloud Armor WAFIdentique à App_GKE.
Proxy conscient de l'identitéIdentique à App_GKE.
Autorisation binaireIdentique à App_GKE.
Contrôles de service VPCIdentique à App_GKE.
Cache RedisInvoice Ninja requiert Redis ; enable_redis = true par défaut ; voir Groupe : Cache Redis.

Comment InvoiceNinja GKE est lié à App GKE​

InvoiceNinja GKE transmet toutes les variables à App GKE et ajoute un sous-module InvoiceNinja Common qui fournit des valeurs par défaut et une configuration d'application spécifiques à Invoice Ninja. Les principaux effets sont les suivants :

  1. MySQL 8.0 est requis. L'application Laravel d'Invoice Ninja ne prend en charge que MySQL. La valeur par défaut database_type est "MYSQL_8_0".
  2. DB_CONNECTION=mysql est injecté automatiquement. Laravel nécessite cette variable d'environnement pour sélectionner le pilote PDO MySQL.
  3. TRUSTED_PROXIES=* est injecté automatiquement. Sans cela, Laravel génère des liens http:// derrière l'équilibreur de charge GKE même lorsque les clients accèdent via HTTPS, ce qui rompt les liens de facture.
  4. Les variables de génération de PDF snappdf sont injectées. PDF_GENERATOR=snappdf et SNAPPDF_EXECUTABLE_PATH=/usr/local/bin/chrome sont définis automatiquement. Le conteneur invoiceninja/invoiceninja:5 contient Chromium à ce chemin.
  5. APP_KEY est auto-généré et stocké dans Secret Manager. InvoiceNinja Common crée la clé de chiffrement Laravel lors du premier apply et l'injecte au moment de l'exécution. Elle n'est jamais écrite en clair dans l'état.
  6. Un bucket GCS data est provisionné automatiquement. InvoiceNinja Common fournit une définition de bucket data pour le stockage de documents.
  7. Deux jobs d'initialisation s'exécutent lors du premier déploiement. db-init crée le schéma et l'utilisateur MySQL ; artisan-migrate exécute les migrations Laravel, y compris les données d'amorçage initiales. Les deux s'exécutent à chaque apply (execute_on_apply = true) afin que les mises à niveau de version appliquent automatiquement les modifications de schéma.
  8. Les valeurs par défaut des ressources sont dimensionnées pour Invoice Ninja. Le cpu_limit (2 vCPU) et le memory_limit (2 Gi) par défaut tiennent compte de la génération de PDF Chromium. 4 Gi sont recommandés pour les déploiements à volume élevé.
  9. Redis est requis et activé par défaut. Invoice Ninja utilise Redis pour QUEUE_CONNECTION, CACHE_DRIVER et SESSION_DRIVER. Sans Redis, la génération de PDF en arrière-plan et la livraison d'e-mails bloquent le cycle de requête HTTP et échouent sous une charge concurrente.
  10. L'affinité de session est par défaut "ClientIP". Invoice Ninja utilise des sessions PHP côté serveur. Sans routage persistant, les utilisateurs administrateurs sont déconnectés lors des requêtes qui sont acheminées vers un pod différent.

Groupe 1 : Projet et identité​

Identique à App_GKE.

VariableValeur par défautDescription
project_id—ID du projet GCP. Requis.
region"us-central1"Région GCP. Utilisé comme solution de repli lorsque la découverte réseau ne peut pas déterminer la région à partir des sous-réseaux VPC existants.

Groupe 2 : Identité du déploiement​

VariableValeur par défautDescription
tenant_id"demo"Court suffixe ajouté à tous les noms de ressources.
support_users[]Adresses e-mail pour les alertes de surveillance et l'accès IAM.
resource_labels{}Étiquettes appliquées à toutes les ressources provisionnées.

Groupe 3 : Identité de l'application​

Valeurs par défaut spécifiques à Invoice Ninja :

VariableValeur par défaut InvoiceNinja GKEValeur par défaut App GKENotes
application_name"invoiceninja""gkeapp"Nom de base pour les ressources GCP et Kubernetes. Ne pas modifier après le déploiement.
application_display_name"Invoice Ninja""App GKE Application"Affiché dans l'interface utilisateur et les tableaux de bord de la plateforme.
application_description"Invoice Ninja Invoicing on GKE Autopilot""App GKE Custom Application…"Étiquette descriptive.
application_version"5""1.0.0"La version de publication d'Invoice Ninja à déployer.
display_name"Invoice Ninja"(pas dans App GKE)Alias lisible par l'homme.
description"Invoice Ninja - Open-source invoicing platform on GKE Autopilot"(pas dans App GKE)Description transmise à InvoiceNinja Common pour les métadonnées du job d'initialisation.

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

Valeurs par défaut et comportement spécifiques à Invoice Ninja :

VariableValeur par défaut InvoiceNinja GKEValeur par défaut App GKENotes
container_port808080Invoice Ninja utilise nginx sur le port 80. Ne pas modifier sauf si votre Dockerfile personnalisé lie nginx à un port différent.
container_resources{ cpu_limit = "2000m", memory_limit = "2Gi" }{ cpu_limit = "1000m", memory_limit = "512Mi" }Invoice Ninja nécessite un minimum de 2 vCPU / 2 Gi pour la génération de PDF Chromium.
cpu_limit"2000m"—Alias abrégé pour container_resources.cpu_limit. Transmis à InvoiceNinja Common.
memory_limit"2Gi"—Alias abrégé pour container_resources.memory_limit. Minimum 2 Gi pour Chromium.
min_instance_count11Identique à la valeur par défaut de App_GKE — Invoice Ninja est maintenu chaud. Les démarrages à froid impliquent PHP-FPM + bootstrap Laravel + migration optionnelle.
max_instance_count53Plafond plus élevé pour les pics de traitement des factures.
container_image_source"prebuilt""custom"L'image officielle invoiceninja/invoiceninja:5 est prête pour la production sans personnalisation.
enable_cloudsql_volumetruetrueSidecar Cloud SQL Auth Proxy requis pour la connexion au socket Unix MySQL.
session_affinity"ClientIP""None"Important pour Invoice Ninja. Sans "ClientIP", les utilisateurs administrateurs sont déconnectés lors des requêtes acheminées vers un pod différent car les sessions PHP ne sont pas partagées entre les réplicas.
timeout_seconds300300Augmenter à 600 pour les déploiements à volume élevé où la génération de PDF ou les exportations de rapports par lots peuvent prendre plus de temps.

Les variables deploy_application, container_image, container_build_config, enable_image_mirroring, enable_vertical_pod_autoscaling, container_protocol, cloudsql_volume_mount_path, service_annotations, service_labels et enable_cloudsql_volume se comportent comme décrit dans la documentation App_GKE.


Groupe 5 : Variables d'environnement et secrets​

Variables d'environnement auto-injectées spécifiques à Invoice Ninja :

Les variables suivantes sont injectées automatiquement par InvoiceNinja Common et n'ont pas besoin d'être définies manuellement dans environment_variables :

VariableValeur auto-injectéeObjectif
APP_ENV"production"Mode d'environnement Laravel.
APP_DEBUG"false"Désactive la sortie de débogage Laravel.
DB_CONNECTION"mysql"Pilote de base de données Laravel.
TRUSTED_PROXIES"*"Gestion correcte de X-Forwarded-For et X-Forwarded-Proto derrière l'équilibreur de charge GKE.
PDF_GENERATOR"snappdf"Sélection du moteur de rendu PDF d'Invoice Ninja.
SNAPPDF_EXECUTABLE_PATH"/usr/local/bin/chrome"Chemin vers Chromium intégré dans le conteneur.
MAIL_FROM_NAMEvar.mail_from_nameNom d'affichage de l'expéditeur de l'e-mail.
MAIL_FROM_ADDRESSvar.mail_from_addressAdresse de l'expéditeur de l'e-mail.

Le APP_KEY est injecté en tant que référence Secret Manager via secret_environment_variables, et non en tant que variable d'environnement en texte clair. Il est résolu au démarrage du pod et n'est jamais écrit dans l'état Terraform.

Variables configurables par l'utilisateur :

VariableValeur par défautDescription
environment_variables{}Variables d'environnement en texte clair supplémentaires injectées dans le pod. À utiliser pour la configuration SMTP : MAIL_MAILER, MAIL_HOST, MAIL_PORT, MAIL_USERNAME. Les variables principales sont définies automatiquement.
secret_environment_variables{}Références Secret Manager. À utiliser pour MAIL_PASSWORD et d'autres valeurs sensibles.
secret_rotation_period"2592000s"Fréquence de notification de rotation des secrets. Par défaut : 30 jours.
secret_propagation_delay30Secondes à attendre après la création du secret avant le démarrage du pod. Augmenter si les déploiements échouent avec des erreurs de secret introuvable.

Exemple de configuration SMTP :

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-secret"
}

Groupe 6 : Sauvegarde et maintenance​

Valeurs par défaut spécifiques à Invoice Ninja :

VariableValeur par défautNotes
backup_schedule"0 2 * * *"Quotidiennement à 02:00 UTC. Ajuster pour correspondre à votre objectif de point de récupération.
backup_retention_days7Rétention de 7 jours. Augmenter significativement pour les données de facturation — de nombreuses juridictions exigent une rétention de 5 à 7 ans des enregistrements de factures. Minimum recommandé : 90 jours.

Importation de sauvegarde :

VariableValeur par défautDescription
enable_backup_importfalseLorsque true, exécute un job Kubernetes d'importation unique pendant le déploiement pour restaurer la sauvegarde spécifiée.
backup_source"gcs""gcs" importe à partir d'un URI Cloud Storage ; "gdrive" importe à partir d'un ID de fichier Google Drive.
backup_uri""URI GCS complet (par exemple, "gs://my-bucket/invoiceninja.sql") ou ID de fichier Google Drive.
backup_file"backup.sql"Nom de fichier d'une sauvegarde dans le bucket de sauvegardes GCS géré par le module. Alternative à backup_uri.
backup_format"sql"Format du fichier de sauvegarde : sql, tar, gz, tgz, tar.gz, zip, auto.

Groupe 7 : CI/CD et intégration GitHub​

Identique à App_GKE. Variables disponibles : enable_cicd_trigger, github_repository_url, github_token, github_app_installation_id, cicd_trigger_config, enable_cloud_deploy, cloud_deploy_stages.

Cas d'utilisation typique : container_image_source = "prebuilt" est la valeur par défaut, donc les déclencheurs CI/CD sont plus utiles lors du passage à "custom" pour construire une image Invoice Ninja avec une configuration spécifique à l'entreprise, des éléments de marque ou des plugins étendus intégrés dans l'image.


Groupe 9 : Politiques de fiabilité​

Identique à App_GKE.

Variables disponibles : enable_pod_disruption_budget (par défaut true), pdb_min_available (par défaut "1"), enable_topology_spread (par défaut false), topology_spread_strict (par défaut false).

Note : Avec pdb_min_available = "1" et un seul réplica, le PDB empêche les interruptions volontaires indéfiniment. Utilisez au moins 2 réplicas en production pour permettre une maintenance continue.


Groupe 10 : Configuration du backend GKE​

Valeurs par défaut et comportement spécifiques à Invoice Ninja :

VariableValeur par défautNotes
service_type"LoadBalancer"Expose Invoice Ninja via un équilibreur de charge externe GKE.
workload_typenullPar défaut à Deployment. La définition de stateful_pvc_enabled = true se résout automatiquement en StatefulSet.
session_affinity"ClientIP"Requis pour Invoice Ninja. Les sessions PHP sont stockées par pod. Sans "ClientIP", les utilisateurs administrateurs sont déconnectés lors des requêtes acheminées vers un réplica différent.
namespace_name""Auto-généré à partir de application_name et tenant_id lorsqu'il est vide.
gke_cluster_name""Laisser vide pour découvrir automatiquement un cluster géré par Services_GCP.
deployment_timeout1800Délai d'expiration de déploiement de 30 minutes. Invoice Ninja peut nécessiter un temps prolongé pour les migrations initiales de grandes bases de données.
enable_network_segmentationfalseDéfinir true pour créer des ressources Kubernetes NetworkPolicy limitant le trafic inter-pod.
termination_grace_period_seconds30Kubernetes attend 30 secondes après SIGTERM avant de forcer SIGKILL. Augmenter à 60 si Invoice Ninja a besoin de temps pour vider les requêtes de génération de PDF en cours.

Groupe 11 : Jobs et tâches planifiées​

Jobs d'initialisation par défaut d'Invoice Ninja :

Lorsque initialization_jobs est laissé par défaut (liste vide []), InvoiceNinja Common fournit deux jobs automatiquement :

JobImageObjectifS'exécute à chaque apply
db-initmysql:8.0-debianCrée la base de données et l'utilisateur MySQL avec le jeu de caractères et les privilèges correctsOui
artisan-migrateinvoiceninja/invoiceninja:5Exécute php artisan migrate --seed --force pour appliquer le schéma et les données d'amorçageOui

artisan-migrate dépend de db-init et s'exécute après sa complétion. L'exécution à chaque apply est intentionnelle — les mises à niveau de version d'Invoice Ninja incluent des migrations de base de données qui doivent être appliquées lorsque application_version est incrémenté.

Remplacez initialization_jobs par une liste non vide pour remplacer les deux jobs par défaut par des jobs personnalisés.

Les CronJobs sont disponibles et se comportent comme décrit dans la documentation App_GKE. Les champs CronJob utilisent la sémantique CronJob de Kubernetes (restart_policy, concurrency_policy, failed_jobs_history_limit, successful_jobs_history_limit, starting_deadline_seconds, suspend) plutôt que les champs de style Cloud Run.

Des services supplémentaires (conteneurs sidecar) sont également disponibles via additional_services.


Groupe 13 : Observabilité et santé​

Valeurs par défaut des sondes spécifiques à Invoice Ninja :

L'initialisation de PHP-FPM d'Invoice Ninja, le bootstrap de Laravel et la migration de la base de données au premier démarrage en font une application à démarrage lent. Les valeurs par défaut des sondes de santé sont ajustées pour tenir compte de cela.

InvoiceNinja_GKE déclare deux ensembles de variables de sonde, mais un seul atteint réellement la spécification de pod Kubernetes :

  • startup_probe / liveness_probe — ce sont ELLES qui contrôlent la vraie sonde K8s. main.tf fusionne inconditionnellement un objet codé en dur dans application_config, remplaçant tout ce que Invoice Ninja Common fournit :

    VariableValeur
    startup_probe{ enabled=true, type="HTTP", path="/", initial_delay_seconds=90, timeout_seconds=10, period_seconds=15, failure_threshold=20 }
    liveness_probe{ enabled=true, type="HTTP", path="/", initial_delay_seconds=120, timeout_seconds=10, period_seconds=30, failure_threshold=3 }

    Invoice Ninja n'a pas de point de terminaison de santé dédié ; le chemin racine / renvoyant HTTP 200 (une fois que PHP-FPM/nginx servent) est le signal de disponibilité. 20 × 15s = 300s de tolérance supplémentaire après le délai initial de 90s pour les migrations au premier démarrage.

  • startup_probe_config / health_check_config — déclarées avec des valeurs par défaut TCP (leur propre description explique pourquoi : / d'Invoice Ninja redirige parfois 302 vers https://<app_url>/, et une sonde kubelet HTTP qui suit la redirection atteint https://<pod-ip>:443 sans rien écouter, provoquant un faux échec). Cependant, le traçage du câblage montre que ces deux variables ne sont jamais lues par le chemin de sonde K8s réel de App_GKE pour ce module — la surcharge codée en dur startup_probe/liveness_probe ci-dessus l'emporte toujours. Considérez-les comme actuellement inertes pour GKE ; ne comptez pas sur leur modification pour altérer le type de sonde déployé.

VariableValeur par défaut
startup_probe_config{ enabled=true, type="TCP", path="/", initial_delay_seconds=90, timeout_seconds=10, period_seconds=15, failure_threshold=20 }
health_check_config{ enabled=true, type="TCP", path="/", initial_delay_seconds=120, timeout_seconds=10, period_seconds=30, failure_threshold=3 }

uptime_check_config : Par défaut à { enabled = false, path = "/" } — les tests de disponibilité sont désactivés par défaut dans la variante GKE. Activez-les explicitement pour la surveillance en production.

VariableValeur par défautDescription
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring à partir des emplacements de sonde globaux. Activer pour la production.
alert_policies[]Politiques d'alerte de métriques Cloud Monitoring personnalisées.

Groupe 14 : Quota de ressources​

Identique à App_GKE.

Variables disponibles : enable_resource_quota, quota_cpu_requests, quota_cpu_limits, quota_memory_requests, quota_memory_limits, quota_max_pods, quota_max_services, quota_max_pvcs.

Critique : quota_memory_requests et quota_memory_limits doivent utiliser des suffixes d'unité binaire (Gi, Mi) lorsqu'ils sont définis. Les entiers nus sont traités comme des octets par Kubernetes et empêchent la planification de tous les pods.


Groupe 16 : Stockage — NFS​

Valeurs par défaut spécifiques à Invoice Ninja :

VariableValeur par défautNotes
enable_nfstrueNFS est activé par défaut. Invoice Ninja écrit les documents téléchargés, les logos clients et les PDF générés dans le système de fichiers du conteneur. Sans NFS, les fichiers sont isolés par pod et perdus lors du redémarrage ou de la replanification du pod.
nfs_mount_path"/var/www/app/public/storage"Chemin du conteneur où le volume NFS est monté.
nfs_volume_name"nfs-data-volume"Nom du volume Kubernetes pour le montage NFS.
nfs_instance_name""Nom d'une VM GCE NFS existante. Laisser vide pour la découverte automatique.
nfs_instance_base_name"app-nfs"Nom de base pour la VM NFS intégrée. L'ID de déploiement est ajouté.

Groupe 17 : Stockage — GCS​

InvoiceNinja Common provisionne automatiquement un bucket GCS data en plus de tous les buckets définis dans storage_buckets. Vous n'avez pas besoin de le définir manuellement.

Bucketname_suffixObjectif
Auto-provisionnédataStockage de documents Invoice Ninja (fichiers téléchargés, logos, PDF générés)
VariableValeur par défautDescription
create_cloud_storagetrueDéfinir false pour ignorer la création du bucket GCS.
storage_buckets[{ name_suffix = "data" }]Buckets GCS supplémentaires à provisionner.
gcs_volumes[]Buckets GCS à monter via le pilote CSI GCS Fuse.
manage_storage_kms_iamfalseCrée la clé KMS CMEK et active CMEK sur tous les buckets de stockage.
enable_artifact_registry_cmekfalseCrée la clé KMS Artifact Registry pour le chiffrement des images au repos.

Groupe 18 : Configuration de la base de données​

Valeurs par défaut et restrictions spécifiques à Invoice Ninja :

VariableValeur par défaut InvoiceNinja GKEValeur par défaut App GKENotes
database_type"MYSQL_8_0""POSTGRES"Invoice Ninja requiert MySQL 8.0. Ne pas modifier — le pilote PDO d'Invoice Ninja est uniquement MySQL.
application_database_name"invoiceninja""gkeappdb"Nom de la base de données MySQL. Immuable après le premier déploiement — la modification recrée la base de données et détruit toutes les données de facturation.
application_database_user"invoiceninja""gkeappuser"Utilisateur de l'application MySQL. Immuable après le premier déploiement.
db_name"invoiceninja"(pas dans App GKE)Raccourci transmis à InvoiceNinja Common pour les jobs db-init et artisan-migrate. Doit correspondre à application_database_name.
db_user"invoiceninja"(pas dans App GKE)Raccourci transmis à InvoiceNinja Common. Doit correspondre à application_database_user.
database_password_length3232Plage : 16–64 caractères.

Découverte d'instance Cloud SQL :

VariableValeur par défautDescription
sql_instance_name""Nom d'une instance Cloud SQL existante. Laisser vide pour la découverte automatique.
sql_instance_base_name"app-sql"Nom de base pour l'instance Cloud SQL intégrée. L'ID de déploiement est ajouté.

Rotation automatique des mots de passe :

VariableValeur par défautDescription
enable_auto_password_rotationfalseDéploie un CronJob et un déclencheur Eventarc pour la rotation automatisée des mots de passe.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer les pods.

Groupe 19 : Domaine personnalisé et IP statique​

Identique à App_GKE.

Note de configuration d'URL Invoice Ninja : Invoice Ninja stocke l'URL de son application dans la base de données lors de la configuration initiale. Lors de l'utilisation d'un domaine personnalisé, la variable d'environnement APP_URL doit être définie sur l'URL du domaine avant le premier démarrage. Définissez-la via environment_variables :

environment_variables = {
APP_URL = "https://invoices.example.com"
}

Invoice Ninja utilise APP_URL pour générer des liens dans les factures envoyées et les e-mails du portail client. Une configuration d'URL incorrecte entraîne des liens brisés dans les documents destinés aux clients.

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne une ressource Kubernetes Ingress pour les noms d'hôtes dans application_domains. Activé par défaut.
application_domains[]Noms de domaine personnalisés. Le DNS doit pointer vers l'IP de l'équilibreur de charge après le déploiement.
reserve_static_iptrueProvisionne une IP externe statique globale pour un mappage DNS stable.
static_ip_name""Nom de l'IP réservée. Auto-généré lorsqu'il est vide.
network_tags["nfsserver"]Tags réseau appliqués aux nœuds GKE. Le tag nfsserver est requis pour les règles de pare-feu NFS lorsque enable_nfs = true.

Groupe 20 : Identity-Aware Proxy (IAP)​

Lorsque enable_iap = true, IAP exige une authentification Google Identity avant que les utilisateurs puissent accéder à Invoice Ninja. Utile pour restreindre le système de facturation aux employés authentifiés.

VariableValeur par défautDescription
enable_iapfalseActive IAP sur l'équilibreur de charge.
iap_authorized_users[]Utilisateurs individuels ou comptes de service. Format : 'user:email@example.com'.
iap_authorized_groups[]Groupes Google. Format : 'group:name@example.com'.
iap_oauth_client_id""ID client OAuth 2.0. Requis lorsque enable_iap = true.
iap_oauth_client_secret""Secret client OAuth 2.0. Sensible.
iap_support_email""E-mail d'assistance affiché sur l'écran de consentement OAuth.

Groupe 21 : Cloud Armor WAF et CDN​

VariableValeur par défautNotes
enable_cloud_armorfalseAttache une politique Cloud Armor WAF au backend GKE Ingress.
admin_ip_ranges[]Plages CIDR autorisées par les règles Cloud Armor WAF.
cloud_armor_policy_name"default-waf-policy"Nom de la politique de sécurité Cloud Armor à attacher.
enable_cdnfalseRoute le trafic via l'API Gateway pour la préparation de Cloud CDN. Remarque : après le déploiement, le CDN doit être activé sur le service backend hors bande via gcloud compute backend-services update --enable-cdn. Cloud CDN et IAP sont mutuellement exclusifs sur la même Gateway. Nécessite enable_custom_domain = true.

Cache Redis​

Redis est obligatoire pour les déploiements Invoice Ninja en production et est activé par défaut. Invoice Ninja utilise Redis pour trois rôles critiques :

  • QUEUE_CONNECTION=redis — Génération de PDF en arrière-plan, livraison d'e-mails et traitement de webhooks. Sans Redis, ceux-ci bloquent le cycle de requête HTTP et provoquent des délais d'attente sous une charge concurrente.
  • CACHE_DRIVER=redis — Mise en cache au niveau de l'application pour les paramètres de l'entreprise, les données client et les calculs de taxes.
  • SESSION_DRIVER=redis — Stockage de session. Combiné à session_affinity = "ClientIP", cela permet aux sessions d'administration de survivre aux redémarrages de pods (car les données de session résident dans Redis, et non sur le pod).

Remarque : Dans InvoiceNinja GKE, les variables Redis se trouvent dans le groupe 15.

VariableValeur par défautDescription
enable_redistrueActive Redis pour la file d'attente, le cache et la session. Obligatoire pour la production. Désactiver uniquement dans les environnements de développement où le traitement des jobs en arrière-plan n'est pas nécessaire.
redis_host"" (par défaut, IP du serveur NFS)Nom d'hôte ou IP du serveur Redis. Laisser vide pour utiliser l'IP du serveur NFS découverte automatiquement. Remplacer par une instance Memorystore pour Redis pour une fiabilité en production. Exemple : "10.128.0.10".
redis_port"6379"Chaîne du port TCP Redis.
redis_auth""Mot de passe d'authentification Redis. Sensible — jamais stocké en clair dans l'état. Définir pour les instances Memorystore avec AUTH activé.

Validation de la connectivité Redis :

# List Memorystore Redis instances (if using dedicated Memorystore)
gcloud redis instances list \
--region=REGION \
--project=PROJECT_ID \
--format="table(name,host,port,state,memorySizeGb,authEnabled)"

# Confirm Redis environment variables are set in the Invoice Ninja pod
kubectl exec -n NAMESPACE POD_NAME -- env | grep -iE "redis|queue|cache|session"

# Test Redis TCP connectivity from inside the pod
kubectl exec -n NAMESPACE POD_NAME -- \
nc -zv REDIS_HOST 6379

# Check that Invoice Ninja queues are processing (look for queue worker logs)
kubectl logs -n NAMESPACE -l app=invoiceninja --tail=50 | grep -i queue

Groupe 22 : VPC Service Controls​

Identique à App_GKE.

VariableValeur par défautDescription
enable_vpc_scfalseApplique un périmètre VPC-SC autour des appels d'API GCP. Nécessite un périmètre existant.
vpc_cidr_ranges[]Plages CIDR de sous-réseau VPC pour le niveau d'accès VPC-SC. Découvertes automatiquement si vides.
vpc_sc_dry_runtrueEnregistre les violations sans bloquer. Définir false pour appliquer.
organization_id""ID d'organisation GCP. Découvert automatiquement à partir du projet. Requis pour les projets imbriqués dans des dossiers.
enable_audit_loggingfalseActive les journaux d'audit Cloud détaillés DATA_READ, DATA_WRITE et ADMIN_READ.

Groupe 23 : Paramètres de l'application Invoice Ninja​

Ces variables sont spécifiques à Invoice Ninja et ne sont pas présentes dans App_GKE.

VariableValeur par défautDescription
invoiceninja_admin_email"admin@example.com"Adresse e-mail de l'administrateur. Utilisée pour la connexion et les notifications système. À remplacer par une adresse réelle avant la mise en production.
mail_from_name"Invoice Ninja"Nom d'affichage figurant comme expéditeur sur les e-mails Invoice Ninja sortants (livraison de factures, confirmations de paiement, devis).
mail_from_address"ninja@example.com"Adresse e-mail utilisée comme expéditeur. Doit correspondre à un domaine d'envoi vérifié pour la délivrabilité.

Charges de travail avec état​

Pour les déploiements où un stockage persistant par pod est requis en plus de NFS (par exemple, chaque pod met en cache les PDF générés localement avant de les télécharger), Invoice Ninja GKE prend en charge le mode StatefulSet.

La définition de stateful_pvc_enabled = true résout automatiquement workload_type en "StatefulSet". Ne définissez pas workload_type = "Deployment" en même temps que stateful_pvc_enabled = true — cela échouera au moment de la planification.

VariableValeur par défautDescription
stateful_pvc_enablednullActive les modèles PVC dans le StatefulSet. Sélectionne automatiquement StatefulSet lorsque true.
stateful_pvc_size"10Gi"Stockage par réplica de pod. Le stockage temporaire de PDF d'Invoice Ninja peut augmenter rapidement — prévoyez 20 à 50 Gio pour les déploiements actifs. La taille du PVC peut être étendue mais pas réduite.
stateful_pvc_mount_path"/data"Chemin du conteneur pour le PVC par pod.
stateful_pvc_storage_class"standard-rwo"Kubernetes StorageClass. "standard-rwo" (PD équilibré, ReadWriteOnce) est la valeur par défaut de GKE Autopilot.
stateful_headless_servicenullCrée un service sans tête pour un DNS de pod stable. Définir lorsque les pods Invoice Ninja nécessitent une découverte de pairs.
stateful_pod_management_policynull"OrderedReady" ou "Parallel". Par défaut "OrderedReady".
stateful_update_strategynull"RollingUpdate" ou "OnDelete". Par défaut "RollingUpdate".

Sorties du module​

InvoiceNinja GKE expose les sorties suivantes :

SortieDescription
service_nameNom du service Kubernetes.
service_urlURL du service.
service_external_ipAdresse IP externe de l'équilibreur de charge.
project_idID du projet GCP.
deployment_idSuffixe de l'ID de déploiement.
namespaceEspace de noms Kubernetes.
database_instance_nameNom de l'instance Cloud SQL MySQL.
database_nameNom de la base de données de l'application.
database_userNom de l'utilisateur de la base de données de l'application.
database_password_secretNom du secret Secret Manager pour le mot de passe de la base de données.
storage_bucketsBuckets de stockage GCS créés.
container_imageImage de conteneur utilisée pour le déploiement.
cicd_enabledIndique si le pipeline CI/CD est activé.
github_repository_urlURL du dépôt GitHub connecté pour le CI/CD.
kubernetes_readytrue lorsque le point de terminaison du cluster GKE est accessible et que toutes les ressources Kubernetes sont déployées. false lors du premier apply d'un nouveau cluster intégré — relancer l'apply pour terminer le déploiement.

Exploration avec la console GCP​

Charges de travail GKE

  • Accédez à Kubernetes Engine → Charges de travail.
  • Filtrez par l'espace de noms Invoice Ninja (généré automatiquement comme invoiceninja-<deployment-id> lorsque namespace_name est vide).
  • Le déploiement ou le StatefulSet pour invoiceninja affiche le nombre actuel de pods en cours d'exécution, l'état du déploiement et l'image du conteneur.
  • Cliquez sur le nom de la charge de travail pour voir les conditions des pods, les événements et l'utilisation des ressources. Surveillez les événements OOMKilled sous 2 Gio de mémoire — ils indiquent que la génération de PDF Chromium atteint les limites de mémoire.

Services et Ingress GKE

  • Accédez à Kubernetes Engine → Services et Ingress.
  • Trouvez le service invoiceninja (type LoadBalancer par défaut). Notez l'adresse IP externe — c'est le point de terminaison public d'Invoice Ninja.
  • Si enable_custom_domain = true, trouvez la ressource Ingress et vérifiez que l'état du certificat SSL affiche ACTIVE.

Pods de charge de travail GKE

  • Accédez à Kubernetes Engine → Charges de travail → sélectionnez la charge de travail invoiceninja → Pods gérés.
  • Cliquez sur n'importe quel pod pour afficher ses journaux, ses variables d'environnement (non secrètes), ses montages de volume et ses limites de ressources.
  • L'onglet Journaux diffuse les journaux d'accès PHP-FPM, les journaux d'application Laravel et les journaux d'accès nginx. Recherchez les erreurs fatales PHP, les échecs de connexion à la file d'attente et les rapports de plantage de Chromium.

Jobs Kubernetes (Initialisation)

  • Accédez à Kubernetes Engine → Jobs (ou Charges de travail filtrées sur Jobs).
  • Filtrez par l'espace de noms Invoice Ninja.
  • Trouvez les jobs db-init et artisan-migrate. Leur statut affiche Complete après un déploiement réussi ou Failed si l'initialisation a rencontré une erreur.
  • Cliquez sur un job pour voir son historique d'exécution, les journaux des pods et les codes de sortie. La sortie de la migration Artisan est la plus utile pour déboguer les problèmes liés au schéma après les mises à niveau de version.

Cloud SQL

  • Accédez à SQL → sélectionnez l'instance MySQL 8.0.
  • Vue d'ensemble : surveillez l'utilisation du CPU, de la mémoire et du stockage. Les fonctionnalités de rapport d'Invoice Ninja sont gourmandes en lecture — surveillez les IOPS de lecture sous une charge d'exportation par lots.
  • Onglet Connexions : affichez les connexions actives. Chaque pod GKE avec enable_cloudsql_volume = true maintient des connexions via le sidecar Auth Proxy.
  • Bases de données : vérifiez que la base de données invoiceninja existe.
  • Opérations : affichez les opérations CREATE, ALTER et DROP récentes du job artisan-migrate.

Secret Manager

  • Accédez à Sécurité → Secret Manager.
  • Trouvez les secrets Invoice Ninja (préfixés par le préfixe de ressource de déploiement) :
    • Secret du mot de passe de la base de données
    • Secret du mot de passe root de la base de données
    • Secret APP_KEY (clé de chiffrement Laravel)
  • Vérifiez que tous les secrets ont une dernière version ENABLED. Une version DISABLED ou DESTROYED entraîne l'échec du démarrage des pods Invoice Ninja avec une erreur Kubernetes CreateContainerConfigError.

Surveillance

  • Accédez à Surveillance → Explorateur de métriques.
  • Sélectionnez la métrique kubernetes.io/container/memory/used_bytes filtrée sur l'espace de noms Invoice Ninja. Surveillez la pression mémoire pendant la génération de PDF.
  • Accédez à Surveillance → Tests de disponibilité pour voir l'état de disponibilité (si uptime_check_config.enabled = true).
  • Accédez à Surveillance → Alertes pour les politiques d'alerte configurées.

Exploration avec gcloud​

Utilisez ces commandes pour inspecter et dépanner le déploiement GKE d'Invoice Ninja. Remplacez PROJECT_ID, CLUSTER_NAME, REGION, NAMESPACE et DEPLOYMENT_ID par vos valeurs réelles.

Inspecter le cluster GKE et les charges de travail

# List GKE clusters in the project
gcloud container clusters list \
--project=PROJECT_ID \
--format="table(name,location,status,currentMasterVersion,currentNodeVersion)"

# Get credentials for the cluster
gcloud container clusters get-credentials CLUSTER_NAME \
--region=REGION \
--project=PROJECT_ID

# List all pods in the Invoice Ninja namespace
kubectl get pods -n NAMESPACE \
-o wide \
--sort-by='.status.startTime'

# Describe the Invoice Ninja deployment
kubectl describe deployment invoiceninja -n NAMESPACE

# View resource usage per pod
kubectl top pods -n NAMESPACE

Diffuser et filtrer les journaux des pods

# Stream Invoice Ninja application logs
kubectl logs -n NAMESPACE \
-l app=invoiceninja \
--tail=100 \
--follow

# Filter for PHP errors
kubectl logs -n NAMESPACE \
-l app=invoiceninja \
--tail=200 | grep -iE "error|exception|fatal|warning"

# Filter for PDF generation events
kubectl logs -n NAMESPACE \
-l app=invoiceninja \
--tail=200 | grep -iE "pdf|snappdf|chromium|chrome"

# Filter for queue processing events
kubectl logs -n NAMESPACE \
-l app=invoiceninja \
--tail=200 | grep -iE "queue|job|dispatch"

Inspecter les jobs d'initialisation

# List all jobs in the namespace
kubectl get jobs -n NAMESPACE \
-o wide \
--sort-by='.metadata.creationTimestamp'

# Describe the artisan-migrate job
kubectl describe job artisan-migrate -n NAMESPACE

# Get logs from the artisan-migrate pod (useful for debugging migration errors)
MIGRATE_POD=$(kubectl get pods -n NAMESPACE \
-l job-name=artisan-migrate \
-o jsonpath='{.items[-1].metadata.name}')
kubectl logs -n NAMESPACE $MIGRATE_POD

# Get logs from db-init
DBINIT_POD=$(kubectl get pods -n NAMESPACE \
-l job-name=db-init \
-o jsonpath='{.items[-1].metadata.name}')
kubectl logs -n NAMESPACE $DBINIT_POD

Inspecter les services et Ingress Kubernetes

# Get the external IP of the Invoice Ninja LoadBalancer service
kubectl get service -n NAMESPACE invoiceninja \
-o jsonpath='{.status.loadBalancer.ingress[0].ip}'

# List all services in the namespace
kubectl get services -n NAMESPACE \
-o wide

# Describe the Ingress (if custom domain is enabled)
kubectl describe ingress -n NAMESPACE

# Check TLS certificate status on the Ingress
kubectl get managedcertificate -n NAMESPACE

Inspecter l'autoscaler horizontal de pods

# Get HPA status for Invoice Ninja
kubectl get hpa -n NAMESPACE

# Describe HPA with current metrics and scaling targets
kubectl describe hpa invoiceninja -n NAMESPACE

Inspecter Cloud SQL

# List Cloud SQL instances
gcloud sql instances list \
--project=PROJECT_ID \
--format="table(name,databaseVersion,state,ipAddresses[0].ipAddress)"

# Check active connections
gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID \
--format="json(name,state,settings.ipConfiguration,serverCaCert)"

# List databases
gcloud sql databases list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

# List users
gcloud sql users list \
--instance=INSTANCE_NAME \
--project=PROJECT_ID \
--format="table(name,host,passwordPolicy.status)"

Inspecter Secret Manager

# List Invoice Ninja secrets
gcloud secrets list \
--project=PROJECT_ID \
--filter="name~invoiceninja" \
--format="table(name,replication.automatic,createTime)"

# Check APP_KEY secret versions
gcloud secrets versions list APP_KEY_SECRET_NAME \
--project=PROJECT_ID \
--format="table(name,state,createTime)"

# Verify the secret is accessible (tests IAM permissions)
gcloud secrets versions access latest \
--secret=APP_KEY_SECRET_NAME \
--project=PROJECT_ID \
--format=json | head -c 20

Inspecter Memorystore Redis (si utilisation d'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 the Redis instance
gcloud redis instances describe REDIS_INSTANCE_NAME \
--region=REGION \
--project=PROJECT_ID

# Test Redis connectivity from inside a running pod
kubectl exec -n NAMESPACE \
$(kubectl get pods -n NAMESPACE -l app=invoiceninja -o jsonpath='{.items[0].metadata.name}') \
-- nc -zv REDIS_HOST 6379

Inspecter le stockage GCS

# List storage buckets for this deployment
gcloud storage ls --project=PROJECT_ID | grep invoiceninja

# List objects in the data bucket
gcloud storage ls gs://BUCKET_NAME/

# Check bucket IAM
gcloud storage buckets get-iam-policy gs://BUCKET_NAME

# View lifecycle rules
gcloud storage buckets describe gs://BUCKET_NAME \
--format="json(lifecycle)"

Vérifier la surveillance et les alertes

# List uptime checks
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)"

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

Niveaux de risque : Critique (perte de données, panne totale, faille de sécurité) — Élevé (service indisponible ou dégradation significative) — Moyen (fonction dégradée ou coût accru) — Faible (impact mineur).

VariableValeur par défaut judicieuseRisqueConséquence d'une valeur incorrecte
project_id(obligatoire)CritiquePas de valeur par défaut — le déploiement échoue immédiatement.
database_type"MYSQL_8_0"CritiqueInvoice Ninja nécessite exclusivement MySQL. La définition à POSTGRES entraîne l'échec de l'application au démarrage avec une erreur de pilote PDO. Le module GKE connecte automatiquement les identifiants MySQL — un type de base de données non concordant interrompt toute injection d'identifiants.
application_database_name"invoiceninja"CritiqueImmuable 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 facture, de client et de paiement.
application_database_user"invoiceninja"CritiqueImmuable après le premier déploiement. La modification de cette valeur recrée l'utilisateur MySQL, invalide les identifiants et interrompt la connexion de l'application.
enable_redistrueCritiqueInvoice Ninja NÉCESSITE Redis pour le traitement des files d'attente en arrière-plan. Sans Redis, la génération de PDF et la livraison d'e-mails sont synchrones — elles bloquent les requêtes HTTP, provoquent des délais d'attente côté client et échouent sous une charge concurrente. La livraison des factures devient peu fiable.
redis_host""ÉlevéSe résout automatiquement en IP du serveur NFS. Si NFS est désactivé et qu'aucun redis_host explicite n'est défini, Invoice Ninja ne peut pas se connecter à son backend de file d'attente au démarrage. Les pods démarrent mais les jobs de file d'attente échouent silencieusement.
enable_nfstrueÉ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, le répertoire /var/www/app/public/storage est isolé par pod — le contenu téléchargé sur un pod est invisible pour les autres et perdu au redémarrage du pod.
session_affinity"ClientIP"ÉlevéInvoice Ninja utilise des sessions PHP côté serveur stockées dans Redis. Sans "ClientIP", les requêtes d'administration peuvent être acheminées vers un pod sans le contexte de session actif, déconnectant les utilisateurs en cours de session. Gardez toujours "ClientIP" pour tout déploiement multi-réplica.
container_resources.memory_limit"2Gi"ÉlevéEn dessous de 1 Gio, Chromium tue les processus OOM pendant la génération de PDF, renvoyant des PDF vierges ou corrompus aux clients. Les environnements de facturation actifs avec des rendus PDF concurrents nécessitent 4 Gio.
invoiceninja_admin_email"admin@example.com"MoyenL'espace réservé par défaut doit être remplacé par une adresse réelle. L'administrateur ne peut pas recevoir de notifications système ni effectuer de réinitialisation de mot de passe avec un e-mail d'espace réservé.
mail_from_address"ninja@example.com"ÉlevéLes e-mails de livraison de factures provenant d'un domaine non vérifié sont 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_days7MoyenGravement insuffisant pour les données de facturation. De nombreuses juridictions exigent une conservation des enregistrements de factures de 5 à 7 ans. Augmentez à un minimum de 90 jours ; envisagez 365 jours ou plus pour la conformité.
pdb_min_available"1"MoyenAvec un seul réplica, PDB empêche les perturbations volontaires indéfiniment — les mises à niveau de nœuds et la maintenance du cluster stagnent. Utilisez au moins 2 réplicas en production pour permettre une maintenance progressive.
startup_probe initial_delay_seconds90ÉlevéInvoice Ninja exécute le démarrage PHP + des migrations facultatives au premier démarrage. Réduire en dessous de 60 secondes entraîne le redémarrage du pod par Kubernetes avant qu'Invoice Ninja ne soit prêt, créant une boucle de redémarrage avec un backoff croissant.
enable_cloud_armorfalseMoyenSans Cloud Armor, le panneau d'administration d'Invoice Ninja (/) est protégé uniquement par une authentification au niveau de l'application. Le trafic de bots et les attaques par bourrage d'identifiants contre le formulaire de connexion sont courants. Activez-le pour tout déploiement accessible publiquement.
quota_memory_requests / quota_memory_limits""Critique (spécifique à GKE)Doit utiliser des suffixes binaires (Gi, Mi) lorsqu'il est défini. Les entiers bruts sont traités comme des octets, empêchant la planification de tous les pods et provoquant une panne complète du déploiement.
enable_topology_spreadfalseMoyenSans répartition topologique, tous les réplicas peuvent atterrir dans la même zone GKE. Une défaillance de zone entraîne la panne de l'ensemble du déploiement Invoice Ninja. Activez-le pour les déploiements de production avec min_instance_count > 1.
APP_URL env var(non défini par défaut)MoyenSi Invoice Ninja s'initialise sans un APP_URL correct, tous les liens dans les factures envoyées et les e-mails du portail client référencent localhost ou une URL incorrecte. Définissez APP_URL dans environment_variables avant le premier démarrage.

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