Aller au contenu principal

Mixpost sur Google Cloud Run

Mixpost sur Google Cloud Run

Mixpost est une plateforme open source et auto-hébergée de planification et de gestion des médias sociaux — une alternative à Buffer/Hootsuite pour composer, planifier, publier et analyser des publications sur plusieurs comptes sociaux à partir d'un seul tableau de bord. Il est livré sous forme d'une application Laravel unique (nginx + PHP-FPM + supervisord exécutant le worker de file d'attente et le planificateur dans un seul conteneur, l'image officielle inovector/mixpost). Ce module déploie Mixpost sur Cloud Run v2 sur la base de la fondation App_CloudRun, qui provisionne et gère l'infrastructure partagée de Google Cloud.

Ce guide se concentre sur les services cloud utilisés par Mixpost et sur la manière de les explorer et de les exploiter à partir de la console Google Cloud et de 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 — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


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

L'exécution de Mixpost dans votre propre projet GCP coûte environ 98,82 $/mois en frais Google Cloud ; les frais de module de RAD sont de 110 crédits uniques (ou 99 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD facture à l'heure en crédits dans un projet géré par RAD. Ou consultez le guide GKE pour la cible de déploiement alternative ; dans tous les cas, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits, une fois99 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 au temps de build à la minuteIdem
Coût d'exécution Google Cloud~98,82 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~67 crédits/jour, facturé à l'heure par RAD au prix catalogue majoré d'une marge

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)
Cloud Run, 2x vCPU / 2 Gio (scaleToZero)28,37 $
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 $
Total98,82 $

Comparaison​

  • Il n'existe pas de SaaS géré officiel vérifié pour Mixpost à comparer, donc la base de référence honnête est un VPS nu : Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go est également à 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) est à environ 49 $/mois — plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que le Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent pour vous.
  • RAD n'est pas censé être moins cher qu'un VPS en termes monétaires, et ne l'est généralement pas — pour un outil de planification sociale d'une petite équipe, le véritable argument est ce que RAD gère pour vous (sauvegardes, correctifs, secrets, surveillance) plutôt que le prix affiché.
  • Dans tous les cas, il s'agit d'un outil de planification sociale pour une petite équipe, donc le coût d'exécution ci-dessus est ce qui génère réellement la facture, pas les frais de module — et ce coût d'exécution est celui que vous pouvez mettre en pause (voir ci-dessous).

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand vous en avez besoin​

C'est le titre pour un projet géré par RAD. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne détruit 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 considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

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 : vous devez être propriétaire du projet (pas un projet pour lequel RAD ne gère que 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, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude/démo conviennent). Google indique que la plupart des services sont à nouveau pleinement opérationnels 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é l'application 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​

Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer Mixpost purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits.

La suppression ne permet d'économiser de l'argent que si Mixpost devait rester inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet ci-dessus, cela représente environ 3 jours ou plus. La majeure partie du coût d'exécution ici est généralement 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 partie calcul de cette application.

Conserver les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, donc 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 reçoit 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 propres frais de RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Mixpost s'exécute comme un conteneur web unique et autonome sur Cloud Run v2 — aucune étape de build séparée, puisque l'image officielle pré-construite est déployée directement.

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur nginx + PHP-FPM + supervisord écoutant sur le port 80, 2 vCPU / 2 Gio par défaut ; autoscaling sans serveur
Base de donnéesCloud SQL pour MySQL 8.0Requis et fixe — Mixpost_Common code en dur MYSQL_8_0
File d'attente, cache et sessionsRedisActivé par défaut ; pilote QUEUE_CONNECTION/CACHE_DRIVER/SESSION_DRIVER ; utilise par défaut l'IP du serveur NFS colocalisé lorsqu'aucun hôte externe n'est spécifié
Stockage d'objetsCloud StorageUn bucket suffixé storage provisionné automatiquement par Mixpost_Common
SecretsSecret ManagerAPP_KEY Laravel auto-générée ; mot de passe de la base de données
IngressURL Cloud Run / Équilibrage de charge CloudURL 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. Mixpost_Common définit database_type = "MYSQL_8_0" et DB_CONNECTION = "mysql" inconditionnellement ; la valeur nominale de la variable database_type n'est pas réellement transmise depuis le module d'application pour le choix du moteur Mixpost — seul MySQL est pris en charge.
  • La base de données est accessible via un socket Unix Cloud SQL Auth Proxy, pas TCP. enable_cloudsql_volume utilise par défaut false sur ce module (contrairement à la plupart des modules Cloud Run MySQL/Laravel) — vérifiez la révision déployée si l'application ne peut pas atteindre la base de données ; l'activation monte le socket à /cloudsql et db-init.sh détecte automatiquement le type de connexion (-S <socket> vs -h <host> --get-server-public-key).
  • Redis est activé par défaut et effectivement requis. enable_redis = true connecte QUEUE_CONNECTION, CACHE_DRIVER et SESSION_DRIVER à redis (en revenant à sync/file uniquement lorsqu'il est désactivé) — cette fusion se produit dans les variables locales main.tf du module d'application, pas dans Mixpost_Common. Lorsque redis_host est vide, l'IP de la VM du serveur NFS est utilisée comme point de terminaison Redis (nécessite enable_nfs = true).
  • min_instance_count = 0, cpu_always_allocated = false — démarrage à froid, facturation basée sur les requêtes. Contrairement à la variante GKE (qui utilise par défaut min = 1 pour maintenir le planificateur intra-pod en fonctionnement continu), la variante Cloud Run se met à l'échelle zéro entre les requêtes. Compromis : le cron Laravel schedule:run et le worker de file d'attente ne s'exécutent que lorsqu'une instance est chaude/sert une requête, de sorte que les publications sociales planifiées ne se publient pas de manière fiable d'elles-mêmes — externalisez schedule:run avec Cloud Scheduler en atteignant un point de terminaison cron (toutes les minutes), ou définissez cpu_always_allocated = true et min_instance_count >= 1 pour restaurer le fonctionnement continu en cours de processus (reflétant les applications toujours actives documentées dans le CLAUDE.md du dépôt).
  • NFS est activé par défaut (enable_nfs = true, /mnt/nfs) pour le stockage partagé de médias/fichiers, et sert également d'hôte Redis par défaut lorsque redis_host est laissé vide.
  • APP_KEY est généré automatiquement et stocké dans Secret Manager au format natif base64:<value> de Laravel — ne le faites jamais pivoter après le premier démarrage.
  • Le mappage des variables d'environnement de la base de données Laravel est codé en dur dans main.tf. db_user_env_var_name = "DB_USERNAME", db_name_env_var_name = "DB_DATABASE" et service_url_env_var_name = "APP_URL" sont définis dans main.tf du module d'application (non configurable par l'opérateur) afin que les URL DB_USER/DB_NAME/de service spécifiques au locataire de la fondation atterrissent sur les noms de variables d'environnement que env() de Laravel lit réellement.
  • La sonde de démarrage est TCP, la sonde de vivacité est HTTP. main.tf remplace la configuration de Mixpost_Common pour utiliser une sonde de démarrage TCP sur le port 80 (les vérifications de santé Cloud Run arrivent via HTTP simple depuis une adresse interne à Google, et TCP est suffisant pour confirmer que le port écoute) et une sonde de vivacité HTTP contre /, à laquelle Mixpost répond avec 200.
  • container_image_source = "prebuilt" déploie inovector/mixpost:<version> directement ; il n'y a pas de build Dockerfile personnalisé pour ce module.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service Mixpost​

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

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

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

B. Cloud SQL pour MySQL 8.0​

Mixpost stocke toutes les données de l'application (comptes sociaux, publications, métadonnées des médias, utilisateurs) dans une instance gérée de Cloud SQL pour MySQL 8.0. Lors du premier déploiement, le job d'initialisation db-init crée la base de données de l'application (utf8mb4) et l'utilisateur et accorde les privilèges ; la méthode de connexion (socket vs TCP) est détectée automatiquement à partir de $DB_HOST.

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

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

C. Cloud Storage​

Un bucket Cloud Storage dédié suffixé storage est provisionné automatiquement par Mixpost_Common. 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~storage"
    gcloud storage ls gs://<bucket-name>/ # bucket name is in the Outputs

Voir App_CloudRun pour les options GCS Fuse et CMEK.

D. Redis (file d'attente, cache et sessions)​

Redis est activé par défaut (enable_redis = true), pilotant QUEUE_CONNECTION, CACHE_DRIVER et SESSION_DRIVER. Aucune instance Memorystore dédiée n'est provisionnée par ce module — à moins que redis_host ne soit remplacé par une instance externe, Redis est attendu à l'IP de la VM du serveur NFS (la même VM Compute Engine qui sert NFS exécute également Redis dans la convention d'infrastructure partagée de ce dépôt).

  • Console : Memorystore → Redis (uniquement si pointé vers une instance gérée) ; sinon Compute Engine → Instances de VM pour l'hôte NFS/Redis.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)' | grep -E 'QUEUE_CONNECTION|CACHE_DRIVER|SESSION_DRIVER'
    gcloud compute instances list --project "$PROJECT" --filter="name~nfs"

E. Secret Manager​

Un secret spécifique à Mixpost est généré automatiquement : la clé APP_KEY Laravel (secret-<resource_prefix>-<application_name>-app-key), une valeur aléatoire de 32 caractères encodée en base64 au format natif base64:<value> de Laravel. Le mot de passe de la base de données est géré séparément par la fondation.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~mixpost"
    gcloud secrets versions access latest --secret=<app-key-secret-name> --project "$PROJECT"

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

F. Cloud Filestore (NFS)​

Activé par défaut (enable_nfs = true), monté à /mnt/nfs pour la persistance partagée des médias/téléchargements, et — lorsque redis_host est laissé vide — également le point de terminaison Redis par défaut.

  • Console : Filestore → Instances ; ou Compute Engine → Instances de VM si l'hôte Redis/NFS est la VM NFS auto-gérée du dépôt.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud compute instances list --project "$PROJECT" --filter="name~nfs"

G. Réseau et ingress​

Le service est accessible à son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de sortie 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 envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte optionnels.

  • 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 Mixpost​

  • Configuration de la base de données lors du premier déploiement. Le job d'initialisation db-init exécute db-init.sh en utilisant mysql:8.0-debian. Il détecte automatiquement si $DB_HOST est un chemin de socket Unix (-S) ou un hôte TCP (-h ... --get-server-public-key, nécessaire car caching_sha2_password de MySQL 8 refuse d'envoyer un mot de passe via ce qui ressemble à une connexion non chiffrée), crée de manière idempotente la base de données de l'application avec utf8mb4, crée l'utilisateur de l'application et accorde les privilèges. Le job peut être réexécuté en toute sécurité (execute_on_apply = true, max_retries = 1).
  • Pas de job de migration séparé. L'entrée supervisord intégrée de l'image pré-construite inovector/mixpost exécute php artisan migrate --force et initialise le compte administrateur à chaque démarrage, il n'y a donc pas de job d'initialisation de migration distinct — la mise à niveau application_version applique les modifications de schéma automatiquement au prochain démarrage.
  • APP_KEY est immuable après le premier démarrage. Généré une fois par Mixpost_Common et écrit dans Secret Manager sous le nom base64:<32-char value>. Sa rotation invalide les données de session/cookie chiffrées et tous les champs de base de données chiffrés.
  • Les valeurs par défaut du compte administrateur sont intégrées à l'image, non configurables via ce module. mixpost_admin_email est déclaré pour la transmission mais n'est pas actuellement injecté dans la configuration du conteneur en cours d'exécution — l'image initialise son propre compte administrateur par défaut quelle que soit cette variable. Récupérez les identifiants de première connexion réels à partir des valeurs par défaut documentées de l'image et modifiez le mot de passe immédiatement après la première connexion.
  • La publication planifiée dépend du maintien de l'instance en état chaud. Avec le démarrage à froid par défaut (min_instance_count = 0, cpu_always_allocated = false), le planificateur/worker de file d'attente Laravel intégré au conteneur ne s'exécute que lorsqu'une requête est en cours ou que l'instance se trouve dans sa fenêtre de maintien en état chaud. Pour une publication planifiée fiable, soit pointez un job Cloud Scheduler vers un point de terminaison cron/santé toutes les minutes pour maintenir une instance en vie et déclencher schedule:run, soit définissez cpu_always_allocated = true avec min_instance_count >= 1.
  • Chemin de santé. La sonde de démarrage est TCP sur le port 80 (évite toute complication de redirection/authentification HTTP au premier démarrage) ; la sonde de vivacité est HTTP sur /, à laquelle Mixpost/nginx répond directement avec 200. REQUIRE_HTTPS = false est injecté car Cloud Run termine le TLS devant le conteneur.
  • 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"
  • Inspecter la configuration en cours d'exécution :
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)' | grep -E 'DB_|APP_URL|QUEUE_CONNECTION'

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 Mixpost sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec leur comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoCourt suffixe qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail ayant accès au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namemixpostNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameMixpostNom lisible par l'homme affiché dans la console.
application_descriptionMixpost - Open-source social media management platformDescription du service.
application_versionlatestTag d'image inovector/mixpost déployé directement (pré-construit, pas de build personnalisé).

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourceprebuiltDéploie inovector/mixpost directement ; transmis explicitement afin que la Fondation ne le traite pas comme un build personnalisé sans Dockerfile.
container_image""Remplacer par un URI d'image miroir ou personnalisé.
cpu_limit2000m2 vCPU recommandés.
memory_limit2GiMixpost nécessite au moins 2 Gio pour le traitement des médias et les workers de file d'attente.
cpu_always_allocatedfalseFacturation basée sur le démarrage à froid/les requêtes. Définir true (avec min_instance_count >= 1) pour maintenir le planificateur/worker de file d'attente Laravel en fonctionnement continu ; sinon, externaliser schedule:run via Cloud Scheduler.
min_instance_count00 active la mise à l'échelle à zéro ; définir 1+ pour éviter les démarrages à froid et maintenir le planificateur chaud.
max_instance_count3Plafond de coût ; augmenter avec prudence — Mixpost n'a pas de coordination de file d'attente multi-instances intégrée au-delà de Redis.
container_port80nginx + PHP-FPM servent du HTTP simple sur le port 80.
execution_environmentgen2Gen2 requis pour les montages NFS et GCS Fuse.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseSocket Unix Cloud SQL Auth Proxy. Activer pour les connexions basées sur socket ; db-init.sh détecte automatiquement le socket ou le TCP dans tous les cas.
enable_image_mirroringtrueMettre en miroir l'image Mixpost dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour les déploiements progressifs.
max_revisions_to_retain7Déclaré pour la parité de convention ; non référencé par le déploiement de ce module.
container_protocolhttp1h2c disponible si l'application prend en charge HTTP/2 en clair.
cloudsql_volume_mount_path/cloudsqlChemin de montage pour le socket Cloud SQL Auth Proxy.

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

VariableValeur par défautDescription
ingress_settingsallIngress public pour l'interface utilisateur Mixpost et tous les webhooks de plateforme sociale entrants.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les valeurs de base APP_*/DB_*/MAIL_* sont définies automatiquement.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
explicit_secret_values{}Valeurs sensibles brutes écrites directement dans Secret Manager lors du déploiement.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.

Groupe 7 — Sauvegarde et maintenance​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 8 — CI/CD et autorisation binaire​

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

Groupe 9 — Instance NFS et SQL personnalisé​

VariableValeur par défautDescription
nfs_instance_name / nfs_instance_base_name(défini)Instance NFS existante / nom de base pour une instance intégrée.
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootdésactivéExécuter SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Cloud Armor, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner un équilibreur de charge HTTPS global + WAF Cloud Armor.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour l'équilibreur de charge HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS définis dans storage_buckets.
storage_buckets[{ name_suffix = "storage" }]Le bucket auto-provisionné plus tous les buckets supplémentaires.
enable_nfstrueActivé par défaut pour les médias/téléchargements partagés, et sert également de source d'hôte Redis par défaut.
nfs_mount_path/var/www/html/storage/app/publicChemin de montage à l'intérieur du conteneur.
gcs_volumes[]Montages de volume GCS Fuse (nécessite gen2).
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeMYSQL_8_0Fixé par Mixpost_Common ; non modifiable pour un autre moteur.
application_database_namemixpostNom de la base de données. Immuable après le premier déploiement.
application_database_usermixpostUtilisateur de la base de données de l'application ; mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré.
cron_jobs[]Non connecté au propre planificateur de Mixpost — utiliser ceci ou un job Cloud Scheduler externe si schedule:run est externalisé sous le démarrage à froid par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP / port 80, délai 90s, failure_threshold=36Sonde de démarrage remplacée dans main.tf par TCP.
liveness_probeHTTP /, délai 120s, failure_threshold=3Sonde de vivacité ; Mixpost/nginx répond / avec 200.
startup_probe_configHTTP /, délai 90sSonde structurée alternative (valeur par défaut de l'objet de configuration ; remplacée par la surcharge startup_probe ci-dessus pour la révision Cloud Run réelle).
health_check_configHTTP /, délai 120sSonde de vivacité structurée alternative.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring ; désactivé par défaut.
alert_policies[]Politiques d'alerte métriques.

Groupe 21 — Cache et file d'attente Redis​

VariableValeur par défautDescription
enable_redistrueConnecte QUEUE_CONNECTION/CACHE_DRIVER/SESSION_DRIVER à redis ; revient à sync/file lorsqu'il est désactivé.
redis_host""Laisser vide pour utiliser l'IP du serveur NFS (nécessite enable_nfs = true).
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis optionnel (sensible).

Groupe 22 — Contrôles de service VPC et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

Groupe 23 — Paramètres de l'application Mixpost​

VariableValeur par défautDescription
mixpost_admin_emailadmin@example.comDéclaré pour le câblage ; non actuellement injecté dans la configuration en cours d'exécution — l'image initialise son propre compte administrateur par défaut quelle que soit cette variable.
mail_from_nameMixpostNom d'affichage de l'expéditeur sur les e-mails sortants (MAIL_FROM_NAME).
mail_from_addressmixpost@example.comAdresse de l'expéditeur sur les e-mails sortants (MAIL_FROM_ADDRESS) ; MAIL_MAILER = "smtp" est défini automatiquement.

Toutes les autres entrées suivent le comportement standard de App_CloudRun.


5. Sorties​

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

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL par défaut run.app 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'il est 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 Manager secret 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, tests de disponibilité.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants du projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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

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

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de base App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un réplica en lecture sans son primaire, IAP sans identités autorisées, un environnement d'exécution gen1 avec des montages NFS/GCS, un redis_port/backup_retention_days hors limites. 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 en cas d'erreur
database_typeMYSQL_8_0 (fixe)CritiqueNon modifiable pour un autre moteur ; Mixpost_Common code en dur MySQL quelle que soit la valeur nominale de cette variable.
application_database_name / application_database_userDéfinir une seule foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et orpheline toutes les données.
APP_KEY (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueLa rotation de la clé Laravel invalide les données de session/cookie chiffrées et tous les champs de base de données chiffrés.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
cpu_always_allocated / min_instance_counttrue + >=1 si utilisation de la publication planifiéeÉlevéLaisser la valeur par défaut de démarrage à froid (false / 0) signifie que le planificateur et le worker de file d'attente Laravel ne s'exécutent que lorsqu'une instance est chaude — les publications sociales planifiées cessent silencieusement de publier selon un calendrier à moins d'être externalisées via Cloud Scheduler.
enable_redis + redis_host / enable_nfstrue + NFS activé, ou un redis_host expliciteÉlevéL'activation de Redis sans source d'hôte (pas de redis_host, pas de NFS) laisse la connexion Redis vide et l'application échoue à mettre en file d'attente/mettre en cache/gérer la session correctement.
enable_cloudsql_volumeCorrespondre aux attentes de connexion à la base de données de l'applicationÉlevéCe module le définit par défaut false (TCP/IP privée) ; si db-init ou l'application ne peut pas atteindre la base de données, vérifiez si un socket (true) ou un chemin TCP est réellement utilisé dans la révision déployée.
memory_limit2GiÉlevéMixpost nécessite au moins 2 Go pour le traitement des médias et les workers de file d'attente ; des valeurs inférieures risquent des arrêts OOM sous une charge concurrente.
mixpost_admin_emailRécupérer les vrais identifiants après le déploiementMoyenLa variable n'est pas injectée dans la configuration en cours d'exécution ; l'image initialise son propre compte administrateur par défaut quoi qu'il arrive — changez le mot de passe immédiatement après la première connexion.
min_instance_count0 pour le coût, 1+ pour la latence/planificationMoyenLa mise à l'échelle à zéro (0) ajoute un délai de démarrage à froid à la première requête après l'inactivité, en plus du compromis de planification ci-dessus.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
enable_cloud_armoractiver pour la productionMoyenL'interface utilisateur d'administration et la connexion sont accessibles publiquement sans protection WAF.

Pour le comportement de base 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 à Mixpost (le secret APP_KEY, le script db-init et les variables d'environnement fusionnées dans le conteneur) est partagée avec la variante GKE via le module interne Mixpost_Common, qui n'est pas déployé directement et n'a pas encore son propre guide de configuration.

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