FreeScout sur Google Cloud Run
FreeScout est une plateforme de service d'assistance et de boîte de réception partagée gratuite et auto-hébergée, basée sur Laravel (PHP). Elle transforme les boîtes de réception e-mail partagées en une file d'attente de tickets collaborative avec des conversations, des tags, des réponses enregistrées, un profil client, une API REST et un système de plugins. Ce module déploie FreeScout sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par FreeScout et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications Cloud Run — identité de service, 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 — veuillez vous référer au guide du socle App_CloudRun plutôt que de les répéter ici.
Ce que FreeScout coûte sur RAD, et comment cela se compare
L'exécution de FreeScout dans votre propre projet Google Cloud coûte environ 83,61 $ US/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 110 crédits (99 crédits — 10 % de moins — dans un projet géré par RAD). FreeScout est un service d'assistance et de boîte de réception partagée gratuit et open source, basé sur Laravel. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et reprendre plus tard — voir « Mettre en pause gratuitement » ci-dessous.
FreeScout est également disponible sur GKE — consultez le guide GKE si vous avez besoin d'une orchestration basée sur Kubernetes ; ce guide couvre l'option Cloud Run, moins coûteuse.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 110 crédits (une fois) | 99 crédits (une fois, 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 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 build. | Idem |
| Coût d'exécution Google Cloud | ~83,61 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue | ~67 crédits/jour (~6,70 $ US/jour), mesuré à l'heure au prix catalogue plus la marge de RAD |
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).
Coût d'exécution par défaut dans votre propre projet
| Ressource | US$/mois (prix catalogue Google, us-central1) |
|---|---|
| Cloud Run, 1x vCPU / 2 Gio (scaleToZero) | 13,16 $ US |
| Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | 83,61 $ US |
Comment cela se compare
- Il n'existe pas de version officiellement hébergée/cloud de FreeScout à comparer, la comparaison honnête se fait donc avec une infrastructure autogérée, et non avec un SaaS concurrent.
- Un VPS nu d'environ 1 vCPU / 2 Gio — un Hetzner CPX22 (2 vCPU/4 Go, ~24 $ US/mois), un DigitalOcean 2 vCPU/4 Go Droplet (24 $ US/mois), ou le propre Compute Engine e2-standard-2 de GCP (2 vCPU/8 Go, ~49 $ US/mois) — est généralement moins cher que le prix affiché de RAD ; un VPS d'une ou deux tailles inférieures le serait encore plus.
- Ce prix inférieur n'inclut pas le temps de l'administrateur : patcher le système d'exploitation, faire tourner les sauvegardes de bases de données, renouveler les certificats TLS et surveiller les temps d'arrêt. Cloud SQL géré par RAD, Secret Manager et la surveillance le font pour vous, ce qui est le véritable échange, et non le prix aff'iché.
- RAD ne prétend pas être moins cher qu'un VPS nu en termes monétaires — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.
Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin
Si FreeScout est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la propre suppression logicielle récupérable de Google pendant 30 jours. Contrairement à la suppression du module FreeScout seul, cela ne supprime pas Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.
Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être invoquée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter la 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. Les frais de module de 99 crédits ne sont pas facturés à nouveau.
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, 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 qui convient à la plupart des utilisations d'étude/démo). 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. Si vous avez personnalisé FreeScout et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer
Si FreeScout se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.
Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 110 crédits (11,00 $ US) dans votre propre projet, ou 99 crédits sur un projet géré par RAD.
La suppression ne permet d'économiser de l'argent que si FreeScout reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution : environ 5 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 83,61 $ US/mois), ou environ 4 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~67 crédits/jour).
La majeure partie du coût d'exécution de FreeScout est la base de données et la VM de fichier/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la part de calcul de cette application du total ci-dessus.
Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde 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 dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
- Environnements gérés, pour les 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les mécanismes de pause/restauration.
1. Vue d'ensemble
FreeScout s'exécute comme un conteneur PHP unique (nginx + php-fpm) sur Cloud Run v2, construit comme une image personnalisée légère FROM tiredofit/freescout. Le déploiement connecte un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur PHP sur le port 80, 1 vCPU / 2 Gio par défaut, autoscaling sans serveur ; scale-to-zero pris en charge |
| Base de données | Cloud SQL pour MySQL 8.0 | Requis — FreeScout ne prend pas en charge PostgreSQL ou d'autres moteurs |
| Fichiers persistants | Cloud Filestore (NFS) | Activé par défaut ; monté à /var/lib/freescout pour les pièces jointes et les données d'exécution |
| Stockage d'objets | Cloud Storage | Un bucket de téléchargement (gcs-freescout<tenant-prefix>-freescout-uploads) provisionné automatiquement |
| Cache (optionnel) | Redis | Cache d'objets optionnel ; désactivé par défaut |
| Secrets | Secret Manager | APP_KEY Laravel et ADMIN_PASS de première exécution auto-générés ; mot de passe de la base de données |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- MySQL 8.0 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée (
MYSQL_8_0) ; la sélection de tout autre moteur interrompt le démarrage. - La
APP_KEYLaravel est générée automatiquement et stockée dans Secret Manager. Elle chiffre les données de session et toutes les colonnes de base de données chiffrées (informations d'identification de boîte aux lettres stockées, jetons OAuth). Ne la faites jamais pivoter après le premier démarrage — cela invaliderait de manière permanente toutes les données précédemment chiffrées. - Un administrateur de première exécution est automatiquement initialisé.
ADMIN_EMAIL(par défautadmin@techequity.cloud) avec le secret généréADMIN_PASScrée le premier administrateur au premier démarrage. Changez le mot de passe dans l'interface utilisateur après la première connexion. APP_URL/SITE_URLsont définis sur l'URL du service. FreeScout construit des liens absolus et son flux/→ tableau de bord/connexion à partir deAPP_URL; le point d'entrée du conteneur le résout à partir duCLOUDRUN_SERVICE_URLréel au moment de l'exécution.- Cloud SQL est accessible via TCP (IP privée), pas un socket.
enable_cloudsql_volumepar défaut àfalsesur Cloud Run ; l'application se connecte à l'IP injectéeDB_IPsur le port 3306. MySQL via l'IP privée ne nécessite pas de SSL client. - NFS est activé par défaut afin que les pièces jointes et les fichiers d'exécution survivent au recyclage des conteneurs et aux démarrages à froid (scale-to-zero). Nécessite l'environnement d'exécution
gen2. - Le scale-to-zero est activé (
min_instance_count = 0,max_instance_count = 1). Les démarrages à froid ajoutent plusieurs secondes à la première requête après l'inactivité ; définissezmin_instance_count = 1pour maintenir le service toujours chaud. - La santé est signalée sur
GET /. Il n'y a pas de point de terminaison de santé JSON dédié ; la sonde de démarrage est TCP et la sonde de vivacité estGET /.
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 FreeScout
FreeScout s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement à la charge de requêtes entre le nombre minimal et maximal 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" \
--filter="metadata.name~freescout"
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
FreeScout stocke toutes les données de l'application (conversations, boîtes aux lettres, utilisateurs, clients, paramètres) dans une instance Cloud SQL gérée pour MySQL 8.0. Sur Cloud Run, le service se connecte via l'IP privée de l'instance (TCP, port 3306) — enable_cloudsql_volume par défaut à false. Lors du premier déploiement, le Job db-init crée la base de données de l'application, l'utilisateur et les autorisations ; l'application exécute ensuite ses propres migrations de schéma au démarrage.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
- CLI :
gcloud sql instances list --project "$PROJECT" --filter="name~freescout"
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 Filestore (NFS)
Les pièces jointes et les fichiers d'exécution de FreeScout sont persistés sur un volume NFS monté à /var/lib/freescout (activé par défaut). Cela assure la durabilité des téléchargements lors des changements de révision et du scale-to-zero. NFS nécessite l'environnement d'exécution gen2.
- Console : Filestore → Instances (une instance gérée par Services_GCP ou intégrée).
- CLI :
gcloud filestore instances list --project "$PROJECT"
# Confirm the mount in the running revision:
gcloud run services describe <service-name> --region "$REGION" \
--format='value(spec.template.spec.volumes)'
Voir App_CloudRun pour le modèle de découverte NFS partagé.
D. Cloud Storage
Un bucket de téléchargement Cloud Storage dédié (gcs-freescout<tenant-prefix>-freescout-uploads) est provisionné automatiquement. Des buckets supplémentaires peuvent être déclarés via storage_buckets.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~freescout"
gcloud storage ls gs://<bucket-name>/ # bucket name is in the Outputs
Voir App_CloudRun pour les options GCS Fuse et CMEK.
E. Redis (cache d'objets optionnel)
Redis est désactivé par défaut. Lorsque enable_redis = true, REDIS_HOST/REDIS_PORT sont injectés dans le conteneur comme backend de cache d'objets. Lorsque redis_host est laissé vide et enable_nfs est vrai, l'IP de la VM du serveur NFS est utilisée comme point de terminaison Redis.
- Console : Memorystore → Redis (si vous utilisez une instance gérée).
- CLI :
redis-cli -h <redis-host> ping
gcloud run services describe <service-name> --region "$REGION" \
--format='value(spec.template.spec.containers[0].env)'
F. Secret Manager
Deux secrets sont générés automatiquement et stockés dans Secret Manager : la APP_KEY Laravel (chiffre les données de session et les colonnes de base de données chiffrées) et ADMIN_PASS (le mot de passe de l'administrateur de première exécution initialisé). Le mot de passe de la base de données est géré séparément par le socle.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~freescout"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_CloudRun pour les détails d'injection et de rotation.
G. Réseau et ingress
Le service est accessible par son URL run.app par défaut (ingress_settings = "all"), ce qui permet un accès public à l'interface utilisateur du service d'assistance. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de contrôle d'égression VPC contrôlent la connectivité.
- Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
- CLI :
gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
gcloud compute addresses list --project "$PROJECT"
Voir App_CloudRun.
H. 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, avec des vérifications de disponibilité et des stratégies d'alerte optionnelles.
- 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 FreeScout
- Configuration de la base de données au premier déploiement. Un Job d'initialisation exécute
db-init.shen utilisantmysql:8.0-debian. Il se connecte à Cloud SQL (socket si monté, sinon TCP viaDB_IP), crée de manière idempotente la base de données et l'utilisateur de l'application, accorde les privilèges et vérifie que l'utilisateur de l'application peut se connecter. Le job s'exécute lors de l'apply et peut être réexécuté en toute sécurité. - Les migrations s'exécutent au démarrage du conteneur. Il n'y a pas de job de migration séparé — l'image tiredofit exécute
php artisan migrate --forceà chaque démarrage de conteneur, donc la mise à niveau deapplication_versionapplique les changements de schéma au prochain démarrage. - L'administrateur de première exécution est initialisé. Au premier démarrage, l'image crée l'administrateur défini par
ADMIN_EMAIL/ADMIN_FIRST_NAME/ADMIN_LAST_NAMEavec le secretADMIN_PASS. Connectez-vous et changez le mot de passe immédiatement. APP_KEYest immuable après le premier démarrage. La clé Laravel est générée une fois et écrite dans Secret Manager. La modifier invalide de manière permanente toutes les données précédemment chiffrées (informations d'identification de boîte aux lettres chiffrées, jetons OAuth, cookies chiffrés). Ne la faites pivoter que lors d'une fenêtre de maintenance planifiée avec une reconfiguration complète.APP_URLdoit correspondre à l'hôte du navigateur. FreeScout construit des liens absolus et son routage/à partir deAPP_URL; le point d'entrée le définit à partir deCLOUDRUN_SERVICE_URLinjecté. Si vous placez un domaine personnalisé devant le service, définissezAPP_URL/SITE_URL(viaenvironment_variables) sur cet hôte afin que les liens et les redirections se résolvent correctement. Inspectez la révision en cours d'exécution :gcloud run services describe <service-name> \
--region "$REGION" --project "$PROJECT" --format='value(status.url)'- Chemin de santé. La sonde de démarrage est TCP sur le port du conteneur (délai de 30 s, 20 échecs) et la sonde de vivacité est HTTP
GET /(délai initial de 300 s). Attendez plusieurs minutes au premier démarrage pendant que les migrations s'exécutent avant que le service ne signale qu'il est sain. - 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 comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour FreeScout sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | freescout | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | FreeScout | Nom lisible par l'homme affiché dans la console. |
application_version | latest | Tag de l'image de base pour le build léger (latest épingle à php8.3-1.17.159) ; définissez un tag explicite tel que 1.8.170 en production. |
php_memory_limit | 512M | Limite de mémoire PHP ; à augmenter pour le traitement de pièces jointes volumineuses. |
upload_max_filesize / post_max_size | 64M | Taille maximale de téléchargement de pièce jointe / POST. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
container_image_source | custom | FreeScout se déploie comme un build personnalisé léger ; laissez comme custom. |
cpu_limit | 1000m | CPU par instance ; minimum 1 vCPU. |
memory_limit | 2Gi | Mémoire par instance ; minimum 512 Mio (plancher gen2), 2 Gio recommandés. |
min_instance_count | 0 | 0 active le scale-to-zero ; définissez 1 pour éviter les démarrages à froid. |
max_instance_count | 1 | Gardez à 1 sauf si le NFS partagé et la gestion de session sont confirmés comme sûrs pour plusieurs instances. |
container_port | 80 | FreeScout (nginx/php-fpm) écoute sur le port 80. |
execution_environment | gen2 | Gen2 requis pour les montages NFS et GCS Fuse. |
enable_cloudsql_volume | false | Cloud Run se connecte à MySQL via TCP (IP privée) ; laissez false. |
Groupe 5 — Accès et contrôle d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Accès public à l'interface utilisateur du service d'assistance. |
enable_iap | false | Exiger la connexion Google devant FreeScout (IAP natif de Cloud Run). |
iap_authorized_users / iap_authorized_groups | [] | Qui peut accéder via IAP. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres non secrets supplémentaires (par exemple MAIL_*, ou un APP_URL personnalisé pour un domaine personnalisé). Les valeurs principales de la base de données et de l'administrateur sont définies automatiquement. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. APP_KEY et ADMIN_PASS sont câblés automatiquement — ne les définissez pas ici. |
secret_propagation_delay | 30 | Secondes à attendre après la création du secret. |
Groupe 11 — Stockage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | NFS est activé par défaut — persiste les pièces jointes/fichiers d'exécution. |
nfs_mount_path | /var/lib/freescout | Chemin de montage à l'intérieur du conteneur. |
create_cloud_storage | true | Crée les buckets GCS déclarés. |
storage_buckets | [{ name_suffix = "data" }] | Buckets GCS supplémentaires au-delà du bucket de téléchargement auto-provisionné. |
gcs_volumes | [] | Montages de volume GCS Fuse (nécessite gen2). |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | MYSQL_8_0 | MySQL 8.0 fixe ; ne changez pas de moteur. |
db_name | freescout | Nom de la base de données MySQL (injecté comme DB_DATABASE). Immuable après le premier déploiement. |
db_user | freescout | Utilisateur de la base de données de l'application (injecté comme DB_USERNAME). Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | TCP / 30 s de délai, 20 échecs | Fenêtre généreuse pour les migrations au premier démarrage. |
liveness_probe | HTTP GET / 300 s de délai | GET / renvoie 200 une fois démarré ; pas de point de terminaison de santé dédié. |
uptime_check_config | { enabled = false, path = "/" } | Vérification de disponibilité Cloud Monitoring optionnelle. |
alert_policies | [] | Stratégies d'alerte métrique. |
Groupe 21 — Cache Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Activer un cache d'objets Redis. |
redis_host | "" | Point de terminaison Redis. Laissez vide pour utiliser l'IP du serveur NFS (nécessite enable_nfs = true). |
redis_port | 6379 | Port Redis. |
Toutes les autres entrées suivent le comportement standard de App_CloudRun.
5. Sorties
Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL run.app par défaut du service. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison / port de la base de données. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | État de la surveillance, canaux, vérifications de disponibilité. |
initialization_jobs | Noms des jobs de configuration (db-init). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_id | Registre 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_enabled | Journalisation 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 du socle App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un environnement d'exécution
gen1avec des montages NFS/GCS, undatabase_typequi ne correspond pas à l'application, uncontainer_port/backup_retention_dayshors plage, IAP sans identités autorisées. 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ètre | Valeur judicieuse | Risque | Conséquence si erreur |
|---|---|---|---|
APP_KEY (auto-généré) | Ne jamais faire pivoter après le premier démarrage | Critique | Le faire pivoter invalide de manière permanente toutes les données précédemment chiffrées — les informations d'identification de boîte aux lettres chiffrées et les jetons OAuth ne peuvent plus être déchiffrés. |
database_type | MYSQL_8_0 | Critique | FreeScout est uniquement MySQL ; un moteur Postgres/autre interrompt le démarrage. |
db_name / db_user | Définir une fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données. |
enable_backup_import | false sauf restauration | Critique | L'activation sans backup_uri valide fait échouer le job d'importation. |
APP_URL / SITE_URL | URL réelle du service/domaine | Élevé | Un hôte incorrect rompt les liens absolus, le routage / et les liens de réinitialisation de mot de passe/e-mail. |
enable_nfs | true | Élevé | La désactivation entraîne la perte de toutes les pièces jointes et des fichiers d'exécution lors du recyclage du conteneur / du scale-to-zero. |
enable_cloudsql_volume | false (Cloud Run) | Élevé | Forcer le socket sans un fichier socket réel laisse l'application sans hôte TCP — la connexion échoue. |
memory_limit | 2Gi (≥512 Mio) | Élevé | En dessous du plancher gen2 de 512 Mio est rejeté au moment de la planification ; trop bas, cela provoque des OOM-kills sous charge. |
max_instance_count | 1 | Élevé | La mise à l'échelle au-delà de 1 sans gestion confirmée du stockage partagé/des sessions peut entraîner un état incohérent entre les instances. |
enable_iap | uniquement pour les déploiements privés | Élevé | IAP bloque toutes les requêtes non authentifiées, y compris les intégrations de type webhook d'e-mail entrant. |
ADMIN_PASS (auto-généré) | Modifier dans l'interface utilisateur après la première connexion | Moyen | Le mot de passe généré se trouve dans Secret Manager ; faites-le pivoter dans l'application pour une authentification détenue par un humain. |
min_instance_count | 1 pour la production | Moyen | Le scale-to-zero (0) ajoute un délai de démarrage à froid à la première requête après l'inactivité. |
application_version | Épingler en production | Moyen | latest peut déplacer l'image de base sous vous entre les déploiements. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
Pour le comportement du socle 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 à FreeScout partagée avec la variante GKE est décrite dans FreeScout_Common.
Guides associés
- Lab pratique : FreeScout sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- FreeScout sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- FreeScout Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Chatwoot sur Google Cloud Run, BookStack sur Google Cloud Run, Fider sur Google Cloud Run, Gotify sur Google Cloud Run dans la solution Customer Support Desk.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.