Aller au contenu principal

FreeScout sur Google Cloud Run

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 projetProjet géré par RAD
Frais de module110 crédits (une fois)99 crédits (une fois, 10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients 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

RessourceUS$/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 SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total83,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 CloudNotes
CalculCloud Run v2Conteneur PHP sur le port 80, 1 vCPU / 2 Gio par défaut, autoscaling sans serveur ; scale-to-zero pris en charge
Base de donnéesCloud SQL pour MySQL 8.0Requis — FreeScout ne prend pas en charge PostgreSQL ou d'autres moteurs
Fichiers persistantsCloud Filestore (NFS)Activé par défaut ; monté à /var/lib/freescout pour les pièces jointes et les données d'exécution
Stockage d'objetsCloud StorageUn bucket de téléchargement (gcs-freescout<tenant-prefix>-freescout-uploads) provisionné automatiquement
Cache (optionnel)RedisCache d'objets optionnel ; désactivé par défaut
SecretsSecret ManagerAPP_KEY Laravel et ADMIN_PASS de première exécution auto-générés ; mot de passe de la base de données
IngressURL Cloud Run / Cloud Load BalancingURL 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_KEY Laravel 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éfaut admin@techequity.cloud) avec le secret généré ADMIN_PASS cré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_URL sont définis sur l'URL du service. FreeScout construit des liens absolus et son flux / → tableau de bord/connexion à partir de APP_URL ; le point d'entrée du conteneur le résout à partir du CLOUDRUN_SERVICE_URL réel au moment de l'exécution.
  • Cloud SQL est accessible via TCP (IP privée), pas un socket. enable_cloudsql_volume par défaut à false sur Cloud Run ; l'application se connecte à l'IP injectée DB_IP sur 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éfinissez min_instance_count = 1 pour 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é est GET /.

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.sh en utilisant mysql:8.0-debian. Il se connecte à Cloud SQL (socket si monté, sinon TCP via DB_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 de application_version applique 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_NAME avec le secret ADMIN_PASS. Connectez-vous et changez le mot de passe immédiatement.
  • APP_KEY est 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_URL doit correspondre à l'hôte du navigateur. FreeScout construit des liens absolus et son routage / à partir de APP_URL ; le point d'entrée le définit à partir de CLOUDRUN_SERVICE_URL injecté. Si vous placez un domaine personnalisé devant le service, définissez APP_URL/SITE_URL (via environment_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​

VariableValeur par défautDescription
application_namefreescoutNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameFreeScoutNom lisible par l'homme affiché dans la console.
application_versionlatestTag 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_limit512MLimite de mémoire PHP ; à augmenter pour le traitement de pièces jointes volumineuses.
upload_max_filesize / post_max_size64MTaille maximale de téléchargement de pièce jointe / POST.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomFreeScout se déploie comme un build personnalisé léger ; laissez comme custom.
cpu_limit1000mCPU par instance ; minimum 1 vCPU.
memory_limit2GiMémoire par instance ; minimum 512 Mio (plancher gen2), 2 Gio recommandés.
min_instance_count00 active le scale-to-zero ; définissez 1 pour éviter les démarrages à froid.
max_instance_count1Gardez à 1 sauf si le NFS partagé et la gestion de session sont confirmés comme sûrs pour plusieurs instances.
container_port80FreeScout (nginx/php-fpm) écoute sur le port 80.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
enable_cloudsql_volumefalseCloud Run se connecte à MySQL via TCP (IP privée) ; laissez false.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
ingress_settingsallAccès public à l'interface utilisateur du service d'assistance.
enable_iapfalseExiger 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​

VariableValeur par défautDescription
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_delay30Secondes à attendre après la création du secret.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueNFS est activé par défaut — persiste les pièces jointes/fichiers d'exécution.
nfs_mount_path/var/lib/freescoutChemin de montage à l'intérieur du conteneur.
create_cloud_storagetrueCré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​

VariableValeur par défautDescription
database_typeMYSQL_8_0MySQL 8.0 fixe ; ne changez pas de moteur.
db_namefreescoutNom de la base de données MySQL (injecté comme DB_DATABASE). Immuable après le premier déploiement.
db_userfreescoutUtilisateur de la base de données de l'application (injecté comme DB_USERNAME). Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP / 30 s de délai, 20 échecsFenêtre généreuse pour les migrations au premier démarrage.
liveness_probeHTTP GET / 300 s de délaiGET / 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​

VariableValeur par défautDescription
enable_redisfalseActiver 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_port6379Port 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.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'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 / port de la base de données.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
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 du socle App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un environnement d'exécution gen1 avec des montages NFS/GCS, un database_type qui ne correspond pas à l'application, un container_port/backup_retention_days hors 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ètreValeur judicieuseRisqueConséquence si erreur
APP_KEY (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueLe 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_typeMYSQL_8_0CritiqueFreeScout est uniquement MySQL ; un moteur Postgres/autre interrompt le démarrage.
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 détruit toutes les données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
APP_URL / SITE_URLURL 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_nfstrueÉ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_volumefalse (Cloud Run)ÉlevéForcer le socket sans un fichier socket réel laisse l'application sans hôte TCP — la connexion échoue.
memory_limit2Gi (≥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_count1É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_iapuniquement 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 connexionMoyenLe 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_count1 pour la productionMoyenLe 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 productionMoyenlatest peut déplacer l'image de base sous vous entre les déploiements.
backup_retention_days7 (augmenter pour la production)MoyenTrop 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.

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