Aller au contenu principal

OpenSourcePOS sur Google Cloud Run

Open Source Point of Sale (OSPOS) est un système de point de vente (POS) de détail gratuit, open source et basé sur le web : enregistrez les ventes, gérez les articles, les clients et les fournisseurs, imprimez les reçus et exécutez des rapports de ventes et d'inventaire depuis un navigateur. Ce module déploie OpenSourcePOS sur Cloud Run v2 sur la base de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

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


Ce que coûte OpenSourcePOS sur RAD, et comment cela se compare​

Pour un seul magasin, OpenSourcePOS sur le module Cloud Run de RAD coûte environ 70 $ US par mois, sans licence par utilisateur. Un serveur autogéré est moins cher en espèces, mais vous devez alors gérer vous-même la base de données, les sauvegardes, les correctifs de sécurité et les mises à niveau. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 70 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement75 crédits (7,50 $ US au prix de la recharge)67,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 (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 61 crédits par jour, soit environ 1 830 par mois (environ 183 $ US au prix de la recharge)
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

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : 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 ponctuelle, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données 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
Cloud Run, 1x vCPU / 2 Gio (scaleToZero)13,16 $ US
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 70 $ US
  • Cloud SQL et Cloud Run coûtent le même prix en africa-south1 (Johannesburg).
  • La mise à l'échelle à zéro est la valeur par défaut. La ligne Cloud Run ci-dessus reflète déjà ce coût ; le réglage min_instance_count = 1 maintient une instance chaude et augmente cette ligne, en échange de l'absence de démarrages à froid.

Comment cela se compare​

  • Aucun fournisseur de point de vente open source ne vend de version hébergée officielle de ce projet exact avec des prix publics, donc cette comparaison se fait avec un serveur nu.
  • OpenSourcePOS n'a besoin que de 1 vCPU / 2 Gio — plus petit que la classe de comparaison ci-dessous, donc un niveau de VPS moins cher ferait probablement l'affaire. Les chiffres les plus petits vérifiés indépendamment sont : Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $/mois, ou un GCP Compute Engine e2-standard-2 à environ 49 $/mois.
  • Une seule caisse ou un stand saisonnier est exactement le cas où Mettez-le en pause gratuitement, ci-dessous, est le plus important : un magasin qui ne fait du commerce que quelques mois par an n'a pas besoin de payer pour une base de données inactive le reste du temps.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin​

Si OpenSourcePOS s'exécute dans un projet que RAD gère pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, un environnement de démonstration, une activité saisonnière — que de faire fonctionner OpenSourcePOS en continu.

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

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 183 $ US par mois pour le maintenir en fonctionnement. Déployez OpenSourcePOS, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour le temps où OpenSourcePOS était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : le bucket de sauvegarde ne survit pas. Les sauvegardes d'OpenSourcePOS sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez apporté des modifications à OpenSourcePOS que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 $ US), car RAD recrée le projet et les services partagés avant OpenSourcePOS. La suppression ne permet d'économiser de l'argent que si OpenSourcePOS devait rester inutilisé pendant environ 4 jours ou plus, à la fois dans votre propre projet (environ 2,34 $ US par jour) et dans un projet géré par RAD (61 crédits par jour).
  • La majeure partie du coût d'exécution est généralement la base de données. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression d'OpenSourcePOS alors que quelque chose d'autre partage le projet n'économise que la partie calcul d'OpenSourcePOS.
  • Conservez d'abord les données. Les sauvegardes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lors du déploiement.

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 sont reversés 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 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 ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle.


1. Vue d'ensemble​

OpenSourcePOS s'exécute comme un conteneur PHP / CodeIgniter 4 (un seul processus Apache sur le port 80) sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Apache + PHP, 1 vCPU / 2 Gio par défaut ; mise à l'échelle à zéro par défaut
Base de donnéesCloud SQL pour MySQL 8.0Requis — OpenSourcePOS_Common fixe le moteur. Contient toutes les données POS et les sessions utilisateur
Stockage d'objetsCloud StorageUn bucket storage, monté via GCS-Fuse à /app/public/uploads pour les images d'articles et le logo de l'entreprise ; plus un bucket générique data que l'application n'utilise pas
SecretsSecret ManagerMot de passe de la base de données uniquement — OpenSourcePOS n'a pas de secret de signature d'application
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

Valeurs par défaut judicieuses à connaître à l'avance :

  • MySQL 8.0 est obligatoire. Le moteur est fixé par OpenSourcePOS_Common.
  • enable_cloudsql_volume = false. OpenSourcePOS lit un hôte TCP simple (MYSQL_HOST_NAME), donc le service se connecte directement à l'IP privée de l'instance. Il n'y a pas de remplacement de port dans OpenSourcePOS — le port est toujours 3306.
  • La mise à l'échelle à zéro est la valeur par défaut livrée (min_instance_count = 0, max_instance_count = 1). Pour une caisse en utilisation quotidienne, définissez min_instance_count = 1 : un caissier n'attendra pas un démarrage à froid.
  • Plusieurs instances sont sûres. Les sessions vivent dans MySQL (DatabaseHandler, table ospos_sessions) et les téléchargements vivent sur le bucket GCS partagé, donc augmenter max_instance_count ne déconnecte pas les caissiers et ne perd pas les images.
  • Les téléchargements persistent sur GCS. enable_gcs_storage_volume = true monte le bucket storage à /app/public/uploads. L'image amont ne déclare aucun volume là, donc sans le montage, les images téléchargées seraient perdues à chaque démarrage à froid.
  • NFS est désactivé et non nécessaire (enable_nfs = false).
  • La version est épinglée (application_version = "3.4.1"). N'utilisez jamais latest.
  • Le test de disponibilité est désactivé par défaut (uptime_check_config.enabled = false).

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service OpenSourcePOS​

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

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

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

B. Cloud SQL pour MySQL 8.0​

OpenSourcePOS stocke tout — ventes, articles, clients, fournisseurs, réceptions, configuration et sessions — dans une instance Cloud SQL pour MySQL 8.0 gérée. Le service se connecte via l'IP privée de l'instance via TCP. Lors du premier déploiement, un job db-init crée la base de données et l'utilisateur de l'application, suivi de schema-load, qui charge le schéma livré dans l'image OpenSourcePOS.

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

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

C. Cloud Storage​

Deux buckets d'application sont provisionnés :

  • storage — ajouté par OpenSourcePOS_Common et monté via GCS Fuse à /app/public/uploads, où OpenSourcePOS écrit les images d'articles et le logo de l'entreprise (uniquement lorsque enable_gcs_storage_volume = true).
  • data — la valeur par défaut générique de la Fondation à partir de storage_buckets ; non lu ni écrit par OpenSourcePOS.

La Fondation crée également un bucket de sauvegardes pour le job de sauvegarde planifié.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<storage-bucket-name>/

D. Secret Manager​

OpenSourcePOS n'a pas de secret au niveau de l'application : OpenSourcePOS_Common ne renvoie aucun secret propre. La seule information d'identification est le mot de passe de la base de données, que la Fondation génère et stocke dans Secret Manager (son nom est la sortie database_password_secret).

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<database-password-secret> --project "$PROJECT"

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

E. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés.

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

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring. Le test de disponibilité est désactivé par défaut et les stratégies d'alerte sont vides jusqu'à leur configuration.

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

3. Comportement de l'application OpenSourcePOS​

  • Chaîne d'initialisation en deux étapes. db-init (mysql:8.0-debian, max_retries = 3) crée l'utilisateur et la base de données de l'application et accorde les privilèges, puis vérifie que l'utilisateur de l'application peut se connecter. schema-load dépend de db-init et s'exécute sur l'image de l'application (image = null), car le fichier de schéma n'est livré que dans jekkos/opensourcepos à /app/app/Database/database.sql. Il compte d'abord les tables de la base de données : si elles existent, il se termine sans modifications, et après le chargement, il échoue si la base de données n'a toujours pas de tables. Les deux jobs s'exécutent lors de l'apply et peuvent être réexécutés en toute sécurité.
  • Pourquoi un job, pas le point d'entrée. Cloud Run peut démarrer à froid plusieurs instances à la fois ; deux d'entre elles exécutant le même ensemble CREATE TABLE produiraient un schéma à moitié chargé sans erreur. Un job s'exécute une fois, avant que le service ne serve.
  • Ligne de journal de démarrage. À chaque démarrage, le wrapper imprime [startup] OpenSourcePOS pointed at <ip>:3306/<db> as <user>. Si l'un des DB_IP, DB_USER, DB_PASSWORD ou DB_NAME est vide, il imprime à la place un message FATAL: et se termine — OpenSourcePOS reviendrait sinon silencieusement aux informations d'identification intégrées dans .env de l'image et s'exécuterait contre la mauvaise base de données.
  • Correctifs d'image. L'image du wrapper écrit un vrai date.timezone (UTC) dans le timezone.ini de PHP (l'amont le livre vide), définit CI_ENVIRONMENT = production (le development de l'amont affiche les traces de pile et la barre d'outils de débogage dans le navigateur), et ajoute une garde X-Forwarded-Proto à la réécriture de suppression de www dans public/.htaccess, qui autrement 301 https://www.<domain> à http:// sur un domaine personnalisé.
  • Tests de santé. Les sondes de démarrage et de vivacité GET /, la racine du document où OpenSourcePOS sert sa page de connexion — le même chemin que le HEALTHCHECK de l'image amont utilise.
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/"
  • Compte administrateur. L'administrateur est créé par le schéma fourni avec le nom d'utilisateur admin ; le module ne le crée ni ne le modifie, et l'entrée admin_email n'est pas appliquée. Changez le mot de passe de l'administrateur après la première connexion.
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

4. Variables de configuration​

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

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
tenant_iddemoSuffixe court (1 à 7 caractères alphanumériques minuscules) qui rend les noms de ressources uniques par environnement.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
support_users[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameosposNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameOpenSourcePOSNom lisible par l'homme affiché dans la console.
application_version3.4.1Tag jekkos/opensourcepos, passé au build comme OSPOS_VERSION. La valeur par défaut de cette variante est celle qui prend effet. Épinglez une version exacte.
php_memory_limit512MInjecté comme variable d'environnement simple memory_limit.
admin_emailadmin@example.comNon appliqué — l'administrateur provient du schéma fourni.
enable_gcs_storage_volumetrueMonte le bucket storage à /app/public/uploads (la description de la variable nomme /opt/ospos/var/data ; le chemin monté est /app/public/uploads).

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit l'image du wrapper via Cloud Build. prebuilt ignore le wrapper — pas de mappage MYSQL_*, pas de correctifs d'image.
cpu_limit1000mCPU par instance.
memory_limit2GiMémoire par instance.
min_instance_count00 active la mise à l'échelle à zéro ; utilisez 1 pour une caisse en cours d'utilisation.
max_instance_count1Limite supérieure de l'autoscaling. Le multi-instance est sûr.
container_port80Apache écoute sur le port 80.
execution_environmentgen2Requis pour le montage des téléchargements GCS Fuse.
timeout_seconds300Délai d'expiration de la requête ; augmentez-le pour les importations ou les rapports volumineux.
enable_cloudsql_volumefalseTCP IP privée au lieu du socket Auth Proxy.
enable_image_mirroringtrueMettre en miroir l'image dans Artifact Registry.
container_protocolhttp1HTTP/1.1.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallIngress public par défaut.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google avant la page de connexion POS.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Ne définissez pas les variables de connexion MYSQL_* ici — le wrapper les exporte depuis DB_* au démarrage.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
protect_sensitive_environment_variablestrueLes clés nommées d'informations d'identification dans environment_variables sont déplacées vers Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Âge du cycle de vie appliqué au bucket de sauvegardes.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 8 — CI/CD et Binary Authorization​

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

Groupe 9 — Scripts SQL personnalisés et instance NFS​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Ce groupe contient également nfs_instance_name / nfs_instance_base_name, pertinents uniquement si enable_nfs est activé. Voir App_CloudRun.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner l'équilibreur de charge HTTPS global + Cloud Armor WAF.
admin_ip_ranges[]Liste blanche CIDR pour l'accès administratif.
application_domains[]Noms de domaine personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days7 / true / 30Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer les buckets du module.
storage_buckets[{ name_suffix = "data" }]Bucket générique de la Fondation ; non utilisé par OpenSourcePOS.
enable_nfsfalseNon nécessaire — les téléchargements persistent sur GCS.
nfs_mount_path/var/lib/osposUtilisé uniquement si enable_nfs = true ; rien dans l'image n'y écrit.
gcs_volumes[]Montages GCS Fuse supplémentaires, fusionnés avec le volume de téléchargements storage.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Fixé par OpenSourcePOS_Common.
db_name / db_userosposPréfixé par le locataire au moment du déploiement. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16-64). Ne pas modifier sur un déploiement en cours.
enable_auto_password_rotationfalseRotation automatique du mot de passe.
db_host_env_var_nameDB_IPGarder comme DB_IP — le point d'entrée du wrapper le lit.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser la chaîne intégrée db-init → schema-load. Fournir un job remplace les deux.
cron_jobs[]Pas de tâches planifiées par défaut ; OpenSourcePOS n'en a pas besoin.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP GET /, délai 30s, période 15s, 20 tentativesAttend qu'Apache serve la page de connexion.
liveness_probeHTTP GET /, délai 60s, période 30s, 3 tentativesRacine du document.
uptime_check_config{ enabled = false, path = "/" }Activer pour la surveillance de production.
alert_policies[]Stratégies d'alerte métrique.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redisfalseOpenSourcePOS n'a pas d'intégration Redis ; laisser désactivé.
redis_host / redis_port / redis_auth"" / 6379 / ""Non utilisé par OpenSourcePOS.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

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

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

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

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

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'apply ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence si incorrect
application_versionUne version exacte (par défaut 3.4.1)Critiquelatest se résout en une image avec une disposition différente ; l'historique du module enregistre son échec de déploiement. Un tag flottant se reconstruit également sous une chaîne inchangée, de sorte qu'aucune nouvelle révision n'est déployée et que le conteneur en cours d'exécution conserve silencieusement l'ancienne image.
container_image_sourcecustomCritiqueprebuilt ignore le wrapper : pas de mappage DB_* → MYSQL_* (OpenSourcePOS revient alors aux informations d'identification localhost intégrées et ne peut pas atteindre Cloud SQL), et aucun des correctifs de fuseau horaire / CI_ENVIRONMENT / réécriture TLS.
db_host_env_var_nameDB_IPCritiqueLe point d'entrée du wrapper lit DB_IP ; il refuse de démarrer si celui-ci est vide.
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et perd toutes les données de vente.
database_password_lengthLaisser à 32 après le déploiementÉlevéLe modifier sur un déploiement en cours écrit un nouveau secret de mot de passe tandis que la base de données conserve l'ancien ; les connexions échouent jusqu'à ce que le job db-init soit réexécuté.
enable_gcs_storage_volumetrueÉlevéSans le montage, les images d'articles et le logo de l'entreprise sont écrits dans le système de fichiers éphémère du conteneur et perdus à chaque démarrage à froid ou nouvelle révision.
initialization_jobs[]ÉlevéFournir un job remplace toute la chaîne par défaut, y compris schema-load ; l'application démarre alors avec une base de données vide.
min_instance_count1 pour une caisse en cours d'utilisationMoyenLa mise à l'échelle à zéro (0) fait attendre la première vente après l'inactivité pour un démarrage à froid.
Mot de passe administrateur (schéma fourni, utilisateur admin)Changer après la première connexionÉlevéLe compte est créé par le schéma amont, pas par ce module, et n'est pas aléatoire.
enable_cloud_armor / enable_iapActiver pour la productionMoyenLa page de connexion POS est accessible publiquement par défaut.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
enable_redis / enable_nfsfalseFaible / coûtOpenSourcePOS n'utilise ni l'un ni l'autre ; les activer provisionne des ressources que rien ne lit.

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

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