Aller au contenu principal

Module Xibo GKE — Guide de configuration

Ce guide décrit toutes les variables de configuration disponibles dans le module Xibo_GKE. Xibo_GKE est un module enveloppe qui combine le module d'infrastructure générique App_GKE avec la configuration d'application partagée Xibo_Common pour déployer le CMS Xibo — un affichage dynamique open-source qui planifie et distribue des mises en page, des listes de lecture et des médias à des réseaux de lecteurs d'affichage — sur Google Kubernetes Engine (GKE) Autopilot.

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

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

GKE uniquement : La bibliothèque de médias de Xibo (/var/www/cms/library) contient tous les fichiers téléchargés et les certificats de signature OAuth du lecteur, et Apache la sert avec XSendFile, ce qui nécessite une sémantique de fichier POSIX réelle. C'est pourquoi Xibo est proposé sur GKE, où la bibliothèque peut résider sur un volume persistant, plutôt que sur Cloud Run.

Lisez le Groupe 7 avant votre premier déploiement. Avec les valeurs par défaut du module, la bibliothèque de médias n'est pas persistante.


Ce que coûte Xibo sur RAD, et comparaison​

L'exécution de Xibo sur des pods GKE Autopilot dans votre propre projet Google Cloud coûte environ 110,13 $/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 110 crédits facturé une fois au moment du déploiement. Xibo nécessite une base de données MySQL et une VM de bibliothèque de médias partagée (son stockage de fichiers persistant pour les mises en page et les médias), qui, avec le pod lui-même, représentent les 110,13 $ ci-dessus. Dans un projet géré par RAD, les frais de module sont réduits à 99 crédits (10 % de moins) et le coût d'exécution est mesuré à l'heure en crédits au lieu d'être facturé directement par Google — voir Mettez-le en pause gratuitement ci-dessous pour le seul avantage d'un projet géré par RAD qu'un VPS auto-hébergé ne peut égaler. Xibo n'est proposé que sur GKE — sa bibliothèque de médias nécessite une sémantique de fichier POSIX réelle que les montages NFS de Cloud Run ne fournissent pas, il n'y a donc pas de variante Cloud Run de ce module.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)110 crédits99 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 pour le temps de build à la minuteIdentique
Coût d'exécution Google Cloud110,13 $/mois, facturé par Google au prix catalogue~118 crédits/jour, mesuré 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 : 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)
Pod GKE Autopilot, 1 vCPU / 2 Gio39,68 $
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Serveur de fichiers NFS/cache (petite VM)13,43 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total110,13 $

Les frais de gestion de cluster GKE sont exclus du total ci-dessus car ils sont partagés entre toutes les applications GKE du projet — 0 $ si c'est le seul, sinon environ 73 $/mois répartis entre le nombre d'applications que vous exécutez.

Comment ça se compare​

  • Xibo vend un SaaS hébergé "Xibo in the Cloud", mais les prix de ses plans actuels ne sont pas publiés sur sa page de tarification (vérifié le 8 octobre 2026) — seulement une inscription à un essai gratuit — donc aucun chiffre ne peut être cité ici avec certitude ; considérez ceci comme une comparaison auto-gérée à la place.
  • Une comparaison auto-gérée : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte le même 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — suffisant pour exécuter le CMS Xibo, sa base de données MySQL et la VM de bibliothèque de médias partagée ensemble, à un prix affiché inférieur à celui de la pile GKE gérée par RAD.
  • Ce que ce prix n'inclut pas : les sauvegardes, les correctifs de sécurité, le renouvellement TLS et le temps d'administration pour maintenir un CMS en ligne face aux lecteurs — Cloud SQL, Secret Manager et la surveillance gérés par RAD absorbent cela pour vous.

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

C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, aucune VM, ni 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.

Ce qu'il faut pour cela : vous devez être propriétaire du projet (pas un projet dont RAD ne gère que la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi 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 niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). 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é Xibo 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.

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

Dans votre propre projet, ou une fois que 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources définitivement, et ramener Xibo signifie redéployer à partir de zéro. Cela coûte 110 crédits (les frais de module ; les builds sont inclus).

La suppression ne permet d'économiser de l'argent que si Xibo devait rester inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour Xibo, c'est environ 4 jours ou plus. La majeure partie de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée — celles-ci ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de cette application pendant que quelque chose d'autre partage le projet n'économise que sa propre part de calcul.

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l' application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.

Environnements gérés, pour les cabinets 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 frais propres à RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration.

Référence de configuration standard​

Les zones de configuration suivantes sont fournies par le module sous-jacent App_GKE. Consultez les sections liées du Guide de configuration App_GKE pour une documentation complète.

Zone de configurationSection du guide App_GKENotes spécifiques à Xibo
Projet et identitéGroupe 1 — Projet et identitéIdentique.
Identité de l'applicationGroupe 3 — Identité de l'applicationLes valeurs par défaut des noms d'affichage sont des résidus d'échafaudage ; voir Groupe 3.
Exécution et mise à l'échelleGroupe 4 — Exécution et mise à l'échelleBuild personnalisé à partir de ghcr.io ; container_port = 80 ; voir Groupe 4.
Variables d'environnement et secretsGroupe 5 — Variables d'environnement et secretsVariables MYSQL_* / CMS_* définies par le module ; voir Groupe 5.
Configuration du backend GKEGroupe 6 — Configuration du backend GKEservice_type = "ClusterIP" ; voir Groupe 6.
Charges de travail avec étatGroupe 7 — StatefulSet / PVCRequis pour persister la bibliothèque de médias ; voir Groupe 7.
Jobs d'initialisation et CronJobsGroupe 11 — Automatisation des charges de travaildb-init fourni par Xibo Common ; voir Groupe 11.
Stockage — NFSGroupe 13 — Stockage NFSMonté par défaut à /mnt/nfs, inutilisé par Xibo ; voir Groupe 13.
Stockage — GCSGroupe 14 — Cloud StorageDeux buckets créés, inutilisés par Xibo ; voir Groupe 14.
Configuration de la base de donnéesGroupe 16 — Configuration de la base de donnéesMySQL 8.0, fixe ; voir Groupe 16.
Plan de sauvegarde et rétentionGroupe 17 — Sauvegarde et maintenanceIdentique.
Scripts SQL personnalisésGroupe 18 — Scripts SQL personnalisésIdentique.
Observabilité et vérifications de santéGroupe 10 — ObservabilitéSondes sur /login, et elles atteignent le conteneur déployé ; voir Groupe 10.
Cloud Armor WAFGroupe 21 — Cloud Armor et CDNIdentique.
Proxy conscient de l'identité (IAP)Groupe 20 — Proxy conscient de l'identitéLes lecteurs doivent toujours atteindre le CMS ; voir Groupes 20-22.
Autorisation binaireGroupe 12 — CI/CDIdentique.
Contrôles de service VPCGroupe 22 — Contrôles de service VPC et journalisation d'auditIdentique.
Pilote CSI du magasin de secretsGroupe 5 — Variables d'environnement et secretsToujours activé — aucune configuration requise.
Trafic et IngressGroupe 19 — Accès et réseauIdentique.
Domaine personnalisé et IP statiqueGroupe 19 — Accès et réseauDéfinissez CMS_SERVER_NAME pour un domaine personnalisé ; voir Groupe 19.
Déclencheurs Cloud BuildGroupe 12 — CI/CDIdentique.
Pipeline Cloud DeployGroupe 12 — CI/CDIdentique.
Mise en miroir d'imagesGroupe 4 — Exécution et mise à l'échelleIdentique.
Budgets d'interruption de podGroupe 9 — FiabilitéActivé par défaut.
Rotation automatique des mots de passeGroupe 16 — Configuration de la base de donnéesVoir Groupe 16.
Cache RedisGroupe 15 — Cache RedisNon utilisé par Xibo.
Importation de sauvegardeGroupe 17 — Sauvegarde et maintenanceIdentique.

Comment Xibo GKE est lié à App GKE​

Xibo GKE transmet ses variables à App GKE et ajoute un sous-module Xibo Common qui fournit une configuration spécifique à Xibo. Les principaux effets sont les suivants :

  1. Une image personnalisée légère de ghcr.io. Xibo Common fournit un Dockerfile, FROM ghcr.io/xibosignage/xibo-cms:${XIBO_VERSION}, qui ajoute un point d'entrée wrapper. XIBO_VERSION est défini à partir de application_version (un argument de build spécifique à l'application, de sorte que le générique APP_VERSION de la Fondation ne peut pas le remplacer). xibosignage/xibo-cms de Docker Hub est abandonné (tag le plus récent release23, 2023) et n'a jamais reçu Xibo 4.x.
  2. MySQL 8.0 est fixe. Xibo Common définit database_type = "MYSQL_8_0" dans la configuration de l'application, ce qui est ce que App GKE provisionne, quelle que soit la valeur de database_type du wrapper.
  3. TCP vers l'IP privée, pas le socket. Le point d'entrée du wrapper exporte MYSQL_HOST = $DB_IP, MYSQL_PORT = ${DB_PORT:-3306}, MYSQL_DATABASE, MYSQL_USER et MYSQL_PASSWORD, puis passe la main au propre /entrypoint.sh de Xibo. DB_HOST peut être un répertoire de socket, que Xibo ne peut pas utiliser. Xibo Common corrige donc enable_cloudsql_volume = false.
  4. Installation non interactive. Le point d'entrée de Xibo crée la base de données si elle est absente et exécute l'installation/mise à niveau complète de phinx à chaque démarrage. Le job db-init n'existe que pour créer l'utilisateur et la base de données MySQL avec caching_sha2_password de Cloud SQL MySQL 8 géré correctement.
  5. Trois valeurs par défaut d'image corrigées. MYSQL_ATTR_SSL_VERIFY_SERVER_CERT = "false" (l'image exige une vérification sans CA, donc PDO refuse Cloud SQL tel qu'il est livré) ; CMS_PHP_COOKIE_SECURE = "On" (le conteneur ne voit que HTTP derrière la passerelle de terminaison TLS) ; CMS_SERVER_NAME dérivé de l'URL du service au lieu de localhost livré.
  6. Sondes sur /login. Xibo n'a pas de point de terminaison de santé ; le générique /healthz de la Fondation renvoie 404 et redémarrerait un pod sain. /login renvoie 200 et prouve que le CMS a été rendu. Xibo GKE transmet startup_probe_config/health_check_config dans Xibo Common, ce sont donc les sondes réellement déployées.
  7. Le service web est ClusterIP. Le CMS est publié via la passerelle L7 ; un service LoadBalancer dépenserait une deuxième IP externe sur la même surface HTTP.

Groupe 1 : Projet et identité​

Identique à App_GKE. Voir App_GKE. project_id (obligatoire), tenant_id ("demo"), region ("us-central1", repli lorsque la découverte de sous-réseau ne trouve rien).


Groupe 2 : Environnement de déploiement​

Identique à App_GKE : support_users ([]), resource_labels ({}).


Groupe 3 : Identité de l'application​

VariableValeur par défaut Xibo GKENotes
application_name"xibo"Nom de base pour toutes les ressources. Ne pas modifier après le déploiement.
application_display_name"Wiki.js"Résidu d'échafaudage du module dont ce wrapper a été cloné. Il est transmis à Xibo Common comme display_name et devient le nom d'affichage de l'application. Définissez-le sur quelque chose comme "Xibo CMS".
application_description"Wiki.js - The most powerful and extensible open source Wiki software"Également résidu d'échafaudage ; modifiez-le librement.
application_version"release-4.5.2"Tag sur ghcr.io/xibosignage/xibo-cms, utilisé comme XIBO_VERSION du build. Épinglez une version exacte : une reconstruction sous un tag inchangé ne produit pas de diff Terraform et donc pas de déploiement.

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

VariableValeur par défaut Xibo GKENotes
container_image_source"custom"Construit l'image du wrapper via Cloud Build.
container_image"ghcr.io/xibosignage/xibo-cms"Référence de l'image de base.
container_port80Fixé par Xibo Common — Apache sur 80 ; le point d'entrée ne lit jamais $PORT.
container_resources{ cpu_limit = "1000m", memory_limit = "2Gi" }Seules les limites sont transmises.
min_instance_count1—
max_instance_count3Défini sur 1. Chaque réplica aurait sa propre bibliothèque (voir Groupe 7).
enable_cloudsql_volumetrueN'a aucun effet. Xibo Common fixe la configuration de l'application à false et Xibo se connecte via TCP.

Les variables d'exécution restantes (deploy_application, container_build_config, enable_image_mirroring, cloudsql_volume_mount_path, service_annotations, service_labels) se comportent comme décrit dans App_GKE.


Groupe 5 : Variables d'environnement et secrets​

Xibo Common les définit sur le conteneur ; les entrées environment_variables sont fusionnées par-dessus, vous pouvez donc les remplacer.

VariableValeurObjectif
MYSQL_PORT"3306"Port de la base de données (le point d'entrée le réexporte de DB_PORT lorsqu'il est défini).
MYSQL_ATTR_SSL_VERIFY_SERVER_CERT"false"Le certificat IP privée de Cloud SQL ne peut pas être vérifié depuis le conteneur ; le true livré avec l'image sans CA fait que PDO refuse la connexion. Le trafic reste sur la plage privée du VPC.
CMS_PHP_COOKIE_SECURE"On"Cookies de session sécurisés derrière la passerelle de terminaison TLS.
CMS_PHP_MEMORY_LIMIT"512M"Limite de mémoire PHP (les 256 Mo livrés échouent sur les importations de grandes mises en page).
CMS_PHP_CLI_MEMORY_LIMIT"512M"Idem, pour PHP CLI.

Définies par le point d'entrée du wrapper au démarrage :

VariableSource
MYSQL_HOSTDB_IP (IP privée)
MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORDDB_NAME, DB_USER, DB_PASSWORD (injectées par App GKE)
CMS_SERVER_NAMEUniquement si non défini ou localhost : la partie hôte de CLOUDRUN_SERVICE_URL, GKE_SERVICE_URL ou SERVICE_URL (la première présente)

Le point d'entrée échoue rapidement si DB_IP, DB_NAME, DB_USER ou DB_PASSWORD est manquant.

Remplacements utiles :

VariableQuand
CMS_SERVER_NAMEServir sur un domaine personnalisé — Xibo l'écrit dans la configuration du lecteur et les liens sortants.
CMS_PHP_MEMORY_LIMIT / CMS_PHP_CLI_MEMORY_LIMITTrès grandes importations.
XMR_HOSTUniquement si vous exécutez le serveur push XMR de Xibo séparément — ce module n'en déploie pas.

Secrets. Xibo ne crée pas ses propres secrets d'application. Les seules informations d'identification sont le mot de passe de la base de données (DB_PASSWORD) et le mot de passe root utilisé par db-init, tous deux créés et injectés par App GKE. secret_environment_variables, secret_rotation_period, secret_propagation_delay et protect_sensitive_environment_variables se comportent comme décrit dans App_GKE.


Groupe 6 : Configuration du backend GKE​

VariableValeur par défaut Xibo GKENotes
service_type"ClusterIP"La passerelle fournit déjà l'adresse externe. Un LoadBalancer ici dépense une deuxième IP externe — ce qui, sur un projet à son quota d'adresses, peut laisser le <pending> du répartiteur de charge d'un autre module.
workload_typenullRésout en "StatefulSet" lorsque stateful_pvc_enabled = true, sinon "Deployment".
session_affinity"ClientIP"—
deployment_strategynullDéclaré mais non référencé — aucun effet.

namespace_name, enable_network_segmentation et termination_grace_period_seconds (30) se comportent comme décrit dans App_GKE.


Groupe 7 : Charges de travail avec état​

Ce groupe décide si les médias téléchargés survivent à un redémarrage de pod.

Xibo conserve tout ce qui est important sur le disque sous /var/www/cms/library : tous les médias téléchargés, le répertoire certs/ contenant les clés de signature OAuth du lecteur, brand/, playersoftware/ et temp/. La base de données stocke l'emplacement ; les fichiers eux-mêmes ne sont que sur le disque.

Avec les valeurs par défaut du module, rien n'est monté à ce chemin :

VariableValeur par défautEffet de la valeur par défaut
stateful_pvc_enablednullRésout en false → le CMS s'exécute comme un Deployment sans PVC.
stateful_pvc_mount_path"/data"Même avec un PVC activé, il serait monté à /data, et non à la bibliothèque.

Paramètres recommandés, appliqués lors du premier déploiement :

stateful_pvc_enabled       = true
stateful_pvc_mount_path = "/var/www/cms/library"
stateful_pvc_size = "20Gi" # size for your media
stateful_pvc_storage_class = "standard-rwo"
max_instance_count = 1

Le modèle de revendication de volume d'un StatefulSet ne peut pas être modifié sur place, il faut donc choisir la taille et la classe dès le départ. L'activation du PVC sur un déploiement existant remplace le Deployment par un StatefulSet dont la bibliothèque démarre vide — téléchargez à nouveau les médias par la suite. GCS Fuse (gcs_volumes) n'est pas un substitut approprié pour la bibliothèque car XSendFile nécessite une sémantique POSIX.

stateful_pvc_storage_class ("standard-rwo"), stateful_headless_service, stateful_pod_management_policy, stateful_update_strategy et stateful_fs_group (0) se comportent comme décrit dans App_GKE.


Groupe 9 : Politiques de fiabilité​

enable_pod_disruption_budget est par défaut true et pdb_min_available est par défaut "1". Avec un seul réplica, les évictions volontaires (mises à niveau de nœuds) attendent le pod de remplacement.


Groupe 10 : Observabilité et santé​

startup_probe_config et health_check_config sont transmis à Xibo Common comme startup_probe/liveness_probe du conteneur, ce sont donc les sondes réellement déployées.

SondeCheminDélai initialDélai d'expirationPériodeSeuil d'échec
Démarrage (startup_probe_config)/login (HTTP)60s5s10s3
Vivacité (health_check_config)/login (HTTP)60s5s30s3

Ne changez pas le chemin vers /healthz — Xibo renvoie 404 à cet endroit. / passe également (302 → /login), mais /login renvoie 200 et prouve que le CMS a été rendu.

uptime_check_config est par défaut { enabled = false, path = "/" } ; alert_policies se comporte comme décrit dans App_GKE.


Groupe 11 : Automatisation des charges de travail​

Lorsque initialization_jobs est vide, Xibo Common fournit un job :

ChampValeur
Nom du jobdb-init
Imagemysql:8.0-debian
ScriptXibo_Common/scripts/db-init.sh
ExécutionsLors de l'apply (execute_on_apply = true)
Délai d'expiration / tentatives600s / 3
CPU / Mémoire1000m / 512Mi

Il attend MySQL sur le port 3306, crée (ou réinitialise le mot de passe de) l'utilisateur xibo, crée la base de données xibo, accorde tous les privilèges sur celle-ci, vérifie que l'utilisateur peut se connecter, puis signale à tout sidecar Cloud SQL Proxy dans le pod du Job de quitter afin que le Job puisse se terminer. Une liste initialization_jobs non vide remplace ce job. cron_jobs et additional_services se comportent comme décrit dans App_GKE.


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

Identique à App_GKE. Voir App_GKE.


Groupe 13 : NFS​

enable_nfs est par défaut true et monte le partage NFS Services_GCP à nfs_mount_path ("/mnt/nfs"). Xibo ne lit ni n'écrit ce chemin. Les autres variables se comportent comme décrit dans App_GKE.


Groupe 14 : Cloud Storage​

Avec create_cloud_storage = true, deux buckets sont créés : storage (déclaré par Xibo Common) et data (la valeur par défaut storage_buckets du wrapper). Une entrée dans storage_buckets avec le même name_suffix remplace le préréglage. Xibo n'utilise aucun des deux buckets. Les variables de rétention d'image et de CMEK se comportent comme décrit dans App_GKE.


Groupe 15 : Redis​

enable_redis est par défaut false. Xibo n'est pas configuré pour utiliser Redis par ce module.


Groupe 16 : Base de données​

VariableValeur par défaut Xibo GKENotes
database_type"MYSQL_8_0"Alimente uniquement les gardes de validation au moment du plan. Le moteur est fixé à MySQL 8.0 par Xibo Common.
application_database_name"xibo"Passé à Xibo Common comme db_name. Ne pas modifier après le déploiement — une nouvelle base de données vide serait créée.
application_database_user"xibo"Passé comme db_user. Ne pas modifier après le déploiement.
database_password_length32Le modifier régénère le mot de passe d'un utilisateur de base de données en direct.
enable_auto_password_rotationfalseLa rotation redémarre les pods après rotation_propagation_delay_sec (90).

enable_mysql_plugins/mysql_plugins et les alias db_*_env_var_name se comportent comme décrit dans App_GKE. Les variables d'extension PostgreSQL ne s'appliquent pas.


Groupes 17-18 : Sauvegarde et maintenance, SQL personnalisé​

Identique à App_GKE. Les sauvegardes ne couvrent que la base de données — les médias dans la bibliothèque sont sur le volume du pod (lorsque vous en configurez un), pas dans Cloud SQL. backup_schedule ("0 2 * * *"), backup_retention_days (7), enable_backup_import (false), backup_source ("gcs"), backup_file ("backup.sql"), backup_format ("sql"), et les variables custom_sql_scripts_*.


Groupe 19 : Domaine personnalisé et réseau​

Identique à App_GKE. Voir App_GKE. Avec application_domains = [], la passerelle obtient un nom d'hôte nip.io gratuit à partir de son IP réservée, et CMS_SERVER_NAME en est dérivé.

Sur un domaine personnalisé, définissez également CMS_SERVER_NAME = "<your-domain>" dans environment_variables. Le point d'entrée ne le dérive que s'il n'est pas défini ou localhost, et Xibo l'écrit dans la configuration que les lecteurs reçoivent.


Groupes 20-22 : IAP, Cloud Armor, Contrôles de service VPC​

Identique à App_GKE — voir App_GKE. Si vous activez IAP, n'oubliez pas que les lecteurs d'affichage appellent également le CMS et ne peuvent pas effectuer de connexion Google.


Exploration du déploiement​

Console Google Cloud​

  • Kubernetes Engine → Charges de travail, filtré sur l'espace de noms : la charge de travail CMS (un Deployment, ou un StatefulSet lorsqu'un PVC est activé) et le job db-init.
  • Kubernetes Engine → Passerelles, services et Ingress : le service ClusterIP et la passerelle avec son IP externe.
  • SQL : l'instance Cloud SQL MySQL 8.0 et la base de données xibo.
  • Cloud Build → Historique : le build d'image à partir du Dockerfile Xibo_Common.
  • Sécurité → Secret Manager : le secret du mot de passe de la base de données.

gcloud CLI et kubectl​

gcloud container clusters get-credentials CLUSTER_NAME --region=REGION --project=PROJECT_ID

kubectl get deploy,statefulset,pods,pvc,jobs -n NAMESPACE

# Start-up line printed by the wrapper entrypoint: db host:port/name and server_name
kubectl logs -n NAMESPACE POD_NAME | grep "\[startup\]"

# db-init job output
kubectl logs -n NAMESPACE job/JOB_NAME

# Is anything mounted at the library?
kubectl exec -n NAMESPACE POD_NAME -- df -h /var/www/cms/library

# The login page through the Gateway
curl -s -o /dev/null -w "%{http_code}\n" SERVICE_URL/login

Sorties du module​

Xibo GKE expose les sorties standard App_GKE, y compris :

SortieDescription
service_nameNom du service Kubernetes
service_urlURL du service (l'URL nip.io de la passerelle lorsqu'aucun domaine personnalisé n'est défini)
service_external_ipIP externe du LoadBalancer (si l'IP statique est réservée)
namespaceEspace de noms Kubernetes
database_instance_nameNom de l'instance Cloud SQL
database_name / database_userBase de données et utilisateur de l'application
database_password_secretNom du secret Secret Manager pour le mot de passe de la base de données
storage_bucketsBuckets GCS créés
container_imageImage de conteneur utilisée pour le déploiement
initialization_jobsNoms des jobs d'initialisation créés
kubernetes_readytrue lorsque le point de terminaison du cluster était accessible et que les ressources Kubernetes ont été déployées

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

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

VariableValeur par défaut judicieuseRisqueConséquence d'une valeur incorrecte
project_id(obligatoire)CritiquePas de valeur par défaut — le déploiement échoue immédiatement.
stateful_pvc_enabled + stateful_pvc_mount_pathtrue + "/var/www/cms/library"CritiqueLes valeurs par défaut du module laissent la bibliothèque sur le système de fichiers du conteneur : tous les fichiers téléchargés et les certificats de signature du lecteur sont perdus lorsque le pod est remplacé.
max_instance_count1ÉlevéPlus d'un réplica donne à chacun sa propre bibliothèque ; les médias téléchargés via un pod sont manquants sur les autres.
application_database_name / application_database_user"xibo"CritiqueLa modification après le déploiement pointe le CMS vers une nouvelle base de données vide.
database_password_length32ÉlevéLe modifier régénère une information d'identification en direct ; une non-concordance entre le secret et l'octroi de la base de données bloque le CMS.
application_version"release-4.5.2"ÉlevéDoit exister sur ghcr.io/xibosignage/xibo-cms. La réutilisation d'un tag après une reconstruction ne produit aucun déploiement.
startup_probe_config.path / health_check_config.path"/login"Élevé/healthz renvoie 404 et la sonde redémarre un pod sain en boucle.
environment_variables.MYSQL_ATTR_SSL_VERIFY_SERVER_CERT"false" (défini par le module)ÉlevéLe remplacer par true fait que PDO refuse la connexion Cloud SQL.
CMS_SERVER_NAME sur un domaine personnalisévotre domaineMoyenLaissé dérivé, les lecteurs et les liens sortants utilisent l'hôte nip.io.
Connexion via HTTP simpleutiliser HTTPSMoyenCMS_PHP_COOKIE_SECURE = "On" : le navigateur ne renverra pas le cookie de session via HTTP, de sorte que la connexion semble ne pas fonctionner.
Mot de passe xibo_adminchanger lors de la première connexionCritiqueL'image amorce un compte administrateur fixe ; le module ne définit pas son mot de passe.
application_display_name"Xibo CMS"FaibleLa valeur par défaut "Wiki.js" est affichée sur la plateforme.
service_type"ClusterIP"Moyen"LoadBalancer" dépense une deuxième IP externe pour la même surface HTTP.
enable_cloudsql_volume(n'importe quelle)FaibleN'a aucun effet pour Xibo.
enable_nfs / create_cloud_storagetrue / trueFaibleProvisionné mais inutilisé par Xibo — un petit coût évitable.
backup_retention_days7MoyenSauvegardes de base de données uniquement ; les médias sur le volume de la bibliothèque ne sont pas inclus.

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