LimeSurvey Common — Configuration d'application partagée
LimeSurvey_Common est la couche d'application partagée pour LimeSurvey. Elle n'est pas
déployée seule ; elle fournit plutôt la configuration spécifique à LimeSurvey sur laquelle
LimeSurvey_GKE et
LimeSurvey_CloudRun s'appuient, de sorte que les deux variantes de plateforme
se comportent de manière identique là où cela compte. Les utilisateurs finaux ne configurent jamais cette couche directement —
elle n'a pas d'entrées d'interface utilisateur de déploiement propres — mais comprendre ce qu'elle fournit
explique les valeurs par défaut que vous voyez dans la documentation de la plateforme.
Pour l'infrastructure qui provisionne et exécute réellement LimeSurvey, consultez les guides de plateforme (LimeSurvey_GKE, LimeSurvey_CloudRun) et les guides de socle (App_GKE, App_CloudRun, App_Common).
1. Ce que cette couche fournit
| Domaine | Fourni par LimeSurvey_Common | Où cela apparaît |
|---|---|---|
| Identifiant administrateur | Génère le mot de passe super-administrateur (20 caractères) et le stocke dans Secret Manager ; l'injecte comme variable d'environnement secrète ADMIN_PASSWORD | Récupérer via Secret Manager (voir ci-dessous) |
| Image de conteneur | Encapsule l'image amont martialblog/limesurvey (Apache) avec un point d'entrée cloud léger ; construit via Cloud Build et met en miroir la base dans Artifact Registry | Sortie container_image du déploiement de la plateforme |
| Moteur de base de données | Fixe Cloud SQL pour MySQL 8.0 comme moteur et force le moteur de stockage InnoDB | §Base de données dans les guides de plateforme |
| Amorçage de la base de données | Définit le job de premier déploiement (db-init) qui crée la base de données, l'utilisateur et les autorisations | Sortie initialization_jobs |
| Stockage d'objets | Déclare le bucket Cloud Storage limesurvey-uploads | Sortie storage_buckets |
| Paramètres de base | Définit l'environnement LimeSurvey de base : DB_TYPE, DB_PORT, moteur de stockage, URL_FORMAT, identité administrateur, PUBLIC_URL | Comportement de l'application dans les guides de plateforme |
| Sondes de santé | Fournit la sonde de démarrage TCP par défaut et la sonde de vivacité HTTP ciblant le point d'entrée racine / | §Observabilité dans les guides de plateforme |
2. Identifiant administrateur dans Secret Manager
Le point d'entrée amont martialblog/limesurvey requiert ADMIN_PASSWORD — il
se termine avec le code 1 si la variable est manquante — et initialise le compte super-administrateur
initial avec celui-ci au premier démarrage. LimeSurvey_Common génère un mot de passe de 20 caractères
une fois et le stocke dans Secret Manager afin qu'il soit stable lors des redémarrages et ne se retrouve jamais
en clair dans la configuration :
ADMIN_PASSWORD— le mot de passe super-administrateur pour le compteadmin. Stocké commesecret-<resource_prefix>-<application_name>-admin-password. Il est exposé au conteneur en cours d'exécution comme variable d'environnement secrèteADMIN_PASSWORDvia la sortiesecret_ids. L'identité du compte elle-même est fixée par des variables d'environnement statiques dans cette couche :ADMIN_USER = admin,ADMIN_NAME = Administrator,ADMIN_EMAIL = admin@techequity.cloud.
Le mot de passe de la base de données est généré et géré séparément par le socle ; son
nom de secret est indiqué dans les sorties de déploiement de la plateforme (database_password_secret).
Récupérez le mot de passe administrateur après le déploiement :
# Find the secret for this deployment (name includes the resource prefix):
gcloud secrets list --project "$PROJECT" --filter="name~admin-password"
# Read the current value:
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Une fois que vous vous êtes connecté et que vous avez (éventuellement) créé des comptes supplémentaires, vous pouvez faire pivoter
la valeur dans Secret Manager et redéployer — le point d'entrée réapplique tout ce que
ADMIN_PASSWORD est présent. Voir App_Common pour le secret partagé
et le modèle Workload Identity.
3. Moteur de base de données et amorçage
LimeSurvey nécessite MySQL 8.0 ; le moteur est fixé à MYSQL_8_0 et d'autres
moteurs ne sont pas pris en charge par ce module. Lors du premier déploiement, un job unique
(db-init) s'exécute en utilisant mysql:8.0-debian et de manière idempotente :
- Localise la connexion Cloud SQL — le socket Unix du proxy d'authentification Cloud SQL sous
/cloudsqllorsqu'un volume de socket est monté, sinon une connexion TCP via l'IP privée de l'instance (DB_IP), - Attend que le port MySQL 3306 soit accessible (chemin TCP),
- Crée (ou met à jour) l'utilisateur de l'application avec le mot de passe généré
(
CREATE USER IF NOT EXISTS … / ALTER USER …), - Crée la base de données de l'application (
CREATE DATABASE IF NOT EXISTS), - Accorde tous les privilèges sur cette base de données à l'utilisateur de l'application,
- Vérifie que l'utilisateur de l'application peut réellement se connecter — faisant échouer le job tôt en cas de
mot de passe ou de non-concordance des autorisations, et réchauffant le cache d'authentification
côté serveur
caching_sha2_password, - Signale au sidecar du proxy d'authentification Cloud SQL de s'arrêter gracieusement (via
quitquitquit) afin que le conteneur du job se termine proprement.
Le job peut être réexécuté en toute sécurité. Notez que MySQL 8.0 utilise caching_sha2_password par
défaut ; sur TCP simple, le script ajoute --get-server-public-key pour l'échange de clés RSA
lorsque le client le prend en charge.
Aucun job de migration séparé n'existe. Le schéma LimeSurvey réel (les
tables settings_global, surveys, users, …) est créé au démarrage du conteneur par le
point d'entrée amont martialblog/limesurvey, qui exécute l'installateur de console LimeSurvey /
updatedb une fois que db-init a provisionné une base de données et un utilisateur vides.
Pourquoi InnoDB est forcé. Cloud SQL MySQL 8.0 désactive le moteur de stockage MyISAM
(disabled_storage_engines=MyISAM). Le point d'entrée martialblog/limesurvey définit
son moteur par défaut sur MyISAM et l'écrit dans config.php, de sorte que l'installateur de console essaierait
CREATE TABLE … ENGINE=MyISAM et Cloud SQL le rejetterait (3161 Storage engine MyISAM is disabled). Cette couche définit donc à la fois DB_MYSQL_ENGINE = InnoDB et
DBENGINE = InnoDB afin que la création de table réussisse au premier démarrage.
Inspectez la base de données directement avec :
gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"
Les noms d'instance, de base de données et d'utilisateur se trouvent dans les sorties de déploiement de la plateforme.
4. Image de conteneur et point d'entrée
L'image personnalisée est un wrapper léger FROM martialblog/limesurvey:<tag> (Apache,
s'exécutant sur le port 8080 en tant que www-data avec WORKDIR /var/www/html). Le tag de base est
indexé sur un argument de build spécifique à l'application LIMESURVEY_VERSION — pas le générique
APP_VERSION, que le socle injecte dans build_args et qui écraserait en
latest. LimeSurvey_Common mappe application_version == "latest" sur un tag épinglé connu et bon
(6-apache) et le passe comme LIMESURVEY_VERSION. L'image est construite via
Cloud Build ; enable_image_mirroring = true met en miroir la base publique de Docker Hub dans
Artifact Registry.
Le wrapper insère un cloud-entrypoint.sh qui s'exécute avant le point d'entrée amont
et maintient son travail minimal :
- Définit le backend de la base de données par défaut —
DB_TYPE = mysql,DB_PORT = 3306. - Alias les noms de base de données à portée locataire — mappe de manière défensive
DB_USER → DB_USERNAMEetDB_DATABASE → DB_NAMEsi un nom est manquant (la variantemain.tfrenomme déjà les valeurs injectées par le socle enDB_USERNAME/DB_NAME/DB_PASSWORD). - Définit
PUBLIC_URL— à partir de l'URL de service exportée par le socle (CLOUDRUN_SERVICE_URL/GKE_SERVICE_URL) lorsqu'elle n'est pas définie, afin que les liens générés et les actifs se résolvent sur l'hôte réel. - Passe la main au
/usr/local/bin/entrypoint.shamont, qui génèreapplication/config/config.phpà partir de l'environnement, provisionne/met à jour le schéma, et exécute enfinapache2-foreground. - Conserve les sessions PHP dans MySQL — juste avant le démarrage d'Apache, il active le
gestionnaire de sessions de base de données (
DbHttpSession, que LimeSurvey livre commenté dans le fichierconfig.phpgénéré). Par défaut, les sessions se trouveraient dans le répertoire éphémère/tmpdu conteneur ; pour une enquête sans sauvegarde et reprise, la session contient les réponses non soumises du répondant, de sorte qu'une mise à l'échelle à zéro ou un remplacement de pod les perdrait autrement.
5. Paramètres d'application de base
LimeSurvey_Common établit l'environnement LimeSurvey de base afin que l'application
démarre correctement au premier démarrage :
- Base de données —
DB_TYPE = mysql,DB_PORT = 3306,DB_MYSQL_ENGINE = InnoDB,DBENGINE = InnoDB.DB_HOST,DB_USERNAME,DB_NAME, etDB_PASSWORDsont injectés par le socle (renommés en noms natifs de LimeSurvey viadb_*_env_var_name). - Format d'URL —
URL_FORMAT = pathpour des URL d'enquête propres et basées sur le chemin. - Identité administrateur —
ADMIN_USER = admin,ADMIN_NAME = Administrator,ADMIN_EMAIL = admin@techequity.cloud;ADMIN_PASSWORDde Secret Manager. - URL publique —
PUBLIC_URLà partir de l'URL de service prédite/réelle afin que les liens et les actifs se résolvent sur l'hôte réel. - Port — le conteneur écoute sur
8080(Apache).
Ajustement spécifique à la plateforme géré ici :
- GKE surcharge
DB_HOST = 127.0.0.1car le proxy d'authentification Cloud SQL s'exécute en tant que sidecar lié à la boucle locale. Sur Cloud Run, l'application compose l'IP privée de Cloud SQL sur TCP (MySQL sur IP privée TCP n'a pas besoin de SSL).
6. Comportement de la sonde de santé
LimeSurvey sert un HTTP 200 non authentifié au point d'entrée racine (/), donc
les sondes ciblent / :
- Sonde de démarrage — TCP contre le port du conteneur, délai initial de 30 secondes, période de 15 secondes, 20 échecs autorisés — une fenêtre généreuse pour l'installateur de console au premier démarrage qui provisionne le schéma.
- Sonde de vivacité — HTTP
GET /, délai initial de 300 secondes, période de 60 secondes, 3 échecs autorisés.
7. Stockage d'objets et persistance des fichiers
Un bucket Cloud Storage dédié (limesurvey-uploads) est déclaré ici et
provisionné par le socle, qui accorde également l'accès au compte de service de la charge de travail :
gcloud storage buckets list --project "$PROJECT"
Notez que la persistance du répertoire de téléchargement d'exécution de LimeSurvey
(/var/www/html/upload — images d'actifs téléchargées, signatures, codes-barres) lors des
redémarrages du conteneur est fournie par le montage NFS (Cloud Filestore), que les deux
variantes de plateforme activent par défaut (enable_nfs = true). Le bucket GCS limesurvey-uploads
est provisionné pour un stockage d'objets supplémentaire mais n'est pas monté FUSE par
défaut.
Pour la configuration spécifique à LimeSurvey et destinée à l'utilisateur (variables par groupe, sorties, et comment explorer chaque service depuis la Console et la CLI), consultez les guides de plateforme : LimeSurvey_GKE et LimeSurvey_CloudRun.
Guides associés
- LimeSurvey sur Google Cloud Run — cette configuration déployée sur Cloud Run.
- LimeSurvey sur GKE Autopilot — cette configuration déployée sur GKE.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.