Aller au contenu principal

WriteFreely sur GKE Autopilot

WriteFreely sur GKE Autopilot

WriteFreely est une plateforme de blog open-source, minimaliste et fédérée, écrite en Go — une alternative légère à Medium pour publier des écrits clairs et sans distraction. Ce module déploie WriteFreely sur GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par WriteFreely et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress, autoscaling, 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_GKE plutôt que de les répéter ici.


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

L'exécution de WriteFreely sur des pods GKE Autopilot dans votre propre projet Google Cloud coûte environ 96,70 $/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 175 crédits facturé une fois au moment du déploiement. WriteFreely a besoin d'une base de données MySQL derrière lui, ce qui, avec le pod lui-même, représente la majeure partie de ces 96,70 $. Dans un projet géré par RAD, les frais de module tombent à 157,5 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 géré par RAD qu'un VPS auto-hébergé ne peut égaler — ou voir le guide Cloud Run pour l'option à moindre coût.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (unique)175 crédits157,5 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 au temps de build à la minuteIdentique
Coût d'exécution Google Cloud96,70 $/mois, facturé par Google au prix catalogue~123 crédits/jour, mesuré au prix catalogue plus la marge de RAD

Coût d'exécution par défaut dans votre propre projet

RessourceUS$/mois (prix catalogue Google, us-central1)
Pod GKE Autopilot, 1x vCPU / 2 Gio39,68 $
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
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 $
Total96,70 $

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 la seule, sinon environ 73 $/mois répartis entre le nombre d'applications que vous exécutez.

Comparaison​

  • write.as, géré par la même équipe que WriteFreely, est la version officielle hébergée de ce logiciel : sa page de tarification (vérifiée le 8 octobre 2026) liste un niveau gratuit, Pro à 6 $/mois (annuel) ou 9 $/mois (mensuel) pour un maximum de trois blogs avec des thèmes personnalisés, et Team à 25 $/mois (annuel) ou 30 $/mois (mensuel) pour des publications partagées et collaboratives.
  • Pro est moins cher que le coût d'exécution de 96,70 $/mois de RAD pour un projet propre, car il s'agit d'un service multi-locataire partagé ; le module de RAD offre à WriteFreely son propre service Cloud Run dédié et sa base de données Cloud SQL, ce qui est important lorsque vous souhaitez un contrôle total des données, de la disponibilité et de l'identité de fédération plutôt qu'un hébergement partagé.
  • Une alternative VPS nu fonctionne également : un serveur Hetzner ou DigitalOcean 2 vCPU/4 Go à environ 24 $/mois, ou un GCP Compute Engine e2-standard-2 à environ 49 $/mois, est suffisant pour auto-héberger WriteFreely et MySQL ensemble — moins cher en termes monétaires que RAD, sans les sauvegardes gérées, les correctifs ou la surveillance fournis par RAD.

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 logique 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 dont RAD gère uniquement 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 entièrement fonctionnels à nouveau 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 logique 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é WriteFreely 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 WriteFreely signifie redéployer à partir de zéro. Cela coûte 175 crédits (les frais de module ; les builds sont inclus).

La suppression ne permet d'économiser de l'argent que si WriteFreely reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour WriteFreely, c'est environ 6 jours ou plus. La majeure partie de ce coût d'exécution est généralement la base de données — elle ne s'arrête que lorsque rien d'autre dans le projet ne l'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 celui-ci, 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 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 affirmations de pause/restauration. Prix des plans write.as depuis write.as/pricing, vérifié le 8 octobre 2026.

1. Vue d'ensemble​

WriteFreely s'exécute comme une seule charge de travail web Go sur GKE Autopilot. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPods Go, 1 vCPU / 2 Gio par défaut, autoscalés horizontalement
Base de donnéesCloud SQL pour MySQL 8.0Requis — accessible via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1
Stockage d'objetsCloud StorageUn bucket de données writefreely-uploads dédié provisionné automatiquement
SecretsSecret ManagerTrois secrets de clé AES-256 auto-générés ; mot de passe de la base de données
IngressCloud Load BalancingÉquilibreur de charge externe, domaine personnalisé optionnel + certificat géré

Valeurs par défaut judicieuses à connaître d'emblée :

  • MySQL 8.0 est le moteur fixe. La couche d'application partagée se standardise sur Cloud SQL pour MySQL ; la variante GKE laisse database_type non défini et l'hérite.
  • Cloud SQL est accessible via le sidecar Auth Proxy. Sur GKE enable_cloudsql_volume = true et la variante remplace DB_HOST = 127.0.0.1 — WriteFreely compose l' adresse de bouclage où le sidecar cloud-sql-proxy écoute sur le port 3306.
  • Les trois clés AES-256 sont générées automatiquement et stockées dans Secret Manager (cookies-auth, cookies-enc, email-key). Elles ne doivent jamais être renouvelées après le premier démarrage — les renouveler déconnecte tous les utilisateurs et rend les données de courrier électronique précédemment chiffrées indéchiffrables.
  • Une image personnalisée est construite, non tirée pré-construite. container_image_source = custom : le wrapper de génération de configuration léger (rend config.ini, initialise les clés, exécute writefreely db init) est construit par Cloud Build et poussé vers Artifact Registry.
  • Un minimum de 1 réplica est maintenu (min_instance_count = 1, max_instance_count = 1 ; GKE ne prend pas en charge la mise à l'échelle à zéro) pour que le blog reste toujours accessible.
  • service_type = LoadBalancer avec session_affinity = ClientIP. WriteFreely est exposé sur une IP d'équilibreur de charge externe et les requêtes du même client restent sur le même pod.
  • reserve_static_ip = true est porteur de charge — ne le basculez pas sur false. Le point d'entrée intègre son hôte public résolu dans config.ini à chaque démarrage, en revertant vers GKE_SERVICE_URL injecté par la fondation lorsque WF_PUBLIC_URL n'est pas défini. GKE_SERVICE_URL n'est calculé qu'à partir de l'IP statique réservée ; avec reserve_static_ip = false, il peut revenir à un nom d'hôte *.svc.cluster.local interne inaccessible si l'IP éphémère de l'équilibreur de charge n'est pas encore connue au moment de l'application — confirmé sur WriteFreely (voir §6).
  • NFS et Redis sont désactivés par défaut (enable_nfs = false, enable_redis = false). WriteFreely n'a pas besoin de système de fichiers partagé : le contenu réside dans MySQL et ses clés de chiffrement sont initialisées à partir de Secret Manager à chaque démarrage.
  • Aucun compte administrateur n'est créé automatiquement. L'inscription est fermée ; créez le premier compte après le déploiement (voir §3).
  • WriteFreely est en Go — les paramètres Redis et PHP sont inertes. Activer enable_redis ne fait qu' injecter un REDIS_HOST que WriteFreely ignore, et les variables php_* proviennent de l' échafaudage du module et ne sont pas consommées par WriteFreely.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres identifiants sont signalés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail WriteFreely​

Les pods WriteFreely sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. L'autoscaling horizontal des pods dimensionne le déploiement entre les nombres minimum et maximum de réplicas.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail WriteFreely pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l' IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe hpa -n "$NAMESPACE" # current vs target utilisation

Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail (Déploiement vs StatefulSet) sont gérés.

B. Cloud SQL pour MySQL 8.0​

WriteFreely stocke toutes les données d'application (blogs, articles, utilisateurs, sessions) dans une instance Cloud SQL pour MySQL 8.0 gérée. Les pods y accèdent en privé via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1:3306 ; aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation (db-init) crée la base de données et l'utilisateur de l'application ; le point d'entrée du conteneur exécute ensuite writefreely db init pour construire les tables.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs et les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    # Open an interactive shell to inspect schema/data:
    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 Secret Manager contenant le mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, voir App_GKE.

C. Cloud Storage​

Un bucket de données Cloud Storage dédié (writefreely-uploads) est provisionné automatiquement et le compte de service de la charge de travail se voit accorder l'accès. Des buckets supplémentaires peuvent être déclarés via storage_buckets.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_GKE pour les options CMEK et les montages GCS Fuse.

D. Secret Manager​

Trois secrets cryptographiques sont générés automatiquement et stockés dans Secret Manager — les clés AES-256 que WriteFreely utilise pour signer les cookies de session (cookies-auth), chiffrer les charges utiles des cookies (cookies-enc) et chiffrer les adresses e-mail stockées (email-key). Ils sont livrés au pod via le pilote CSI du Secret Store et injectés comme WF_KEY_COOKIES_AUTH, WF_KEY_COOKIES_ENC et WF_KEY_EMAIL. 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~cookies-auth OR name~cookies-enc OR name~email-key"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_GKE pour l'intégration et la rotation du Secret Store CSI, et WriteFreely_Common pour savoir pourquoi ces clés doivent rester stables.

E. Réseau et Ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing (service_type = LoadBalancer). Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique peut être réservée afin que l'adresse survive aux redéploiements.

  • reserve_static_ip est par défaut true — ne le changez pas en false. WriteFreely intègre un hôte public auto-référentiel dans config.ini à chaque démarrage de conteneur (la chaîne de repli PUBLIC_URL du point d'entrée : WF_PUBLIC_URL → CLOUDRUN_SERVICE_URL → GKE_SERVICE_URL). App_GKE calcule GKE_SERVICE_URL à partir de l'IP statique réservée lorsque reserve_static_ip = true ; avec false, l'IP éphémère de l'équilibreur de charge n'est souvent pas encore connue au moment où Terraform rend les variables d'environnement du déploiement, donc GKE_SERVICE_URL revient au nom d'hôte *.svc.cluster.local interne au cluster — une véritable course reproductible, pas seulement un cas limite théorique (confirmé sur WriteFreely et corrigé en définissant reserve_static_ip = true, selon la valeur par défaut deploy.tfvars du module). Un hôte interne inaccessible intégré aux liens de fédération/générés ressemble à "l'application fonctionne mais chaque lien absolu est cassé".
  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.

F. Cloud Logging et Monitoring​

Les flux stdout/stderr des pods vers Cloud Logging ; les métriques GKE et Cloud SQL vers Cloud Monitoring. Des tests de disponibilité et des politiques d'alerte optionnels sont disponibles. Le point d'entrée enregistre sa progression (WriteFreely: rendered config.ini …, … seeded stable encryption keys …, … starting server …), ce qui est utile pour diagnostiquer le premier démarrage.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application WriteFreely​

  • 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 crée la base de données et l'utilisateur de l'application, accorde ALL PRIVILEGES sur la base de données, vérifie que l'utilisateur de l'application peut se connecter et arrête le sidecar Cloud SQL Proxy. Le job est idempotent (CREATE ... IF NOT EXISTS, max_retries = 3) et peut être réexécuté en toute sécurité.
  • Schéma créé au démarrage. Le point d'entrée du conteneur rend config.ini (avec DB_HOST = 127.0.0.1) puis exécute writefreely db init à chaque démarrage pour créer les tables (tolérant si elles existent déjà), de sorte que le schéma est amorcé sans étape de migration distincte.
  • Les trois clés AES-256 sont immuables après le premier démarrage. Elles sont générées une fois et écrites dans Secret Manager. Modifier l'une d'entre elles déconnecte tous les utilisateurs (les signatures de cookies ne sont plus valides) et rend les adresses e-mail précédemment chiffrées indéchiffrables. Ne les faites pivoter que pendant une fenêtre de maintenance planifiée.
  • Créez le premier compte après le déploiement. L'inscription est fermée par défaut (open_registration = false) et aucun administrateur n'est initialisé. Pour créer le premier compte, soit définissez temporairement WF_OPEN_REGISTRATION = "true" via environment_variables, inscrivez-vous via l'interface utilisateur, puis remettez-le à "false" ; soit exécutez --create-admin de WriteFreely à l'intérieur d'un pod en cours d'exécution :
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- \
    /usr/local/bin/writefreely --create-admin <user>:<password>
  • Correction de l'URL publique. Le point d'entrée revient à GKE_SERVICE_URL injecté par la fondation pour l'hôte public. Une fois l'IP de l'équilibreur de charge attribuée, définissez WF_PUBLIC_URL (via environment_variables) sur l'URL externe ou le domaine personnalisé afin que les liens générés et la fédération utilisent l'hôte accessible.
  • Chemin de santé. La sonde de démarrage est TCP (prête dès que le port 8080 est lié) et la sonde de vivacité est HTTP GET / — WriteFreely sert sa page d'accueil avec un 200 lorsqu'elle est saine ; il n'y a pas de point de terminaison /health dédié.
  • Confirmez l'hôte de la base de données injecté dans le pod en cours d'exécution :
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E 'DB_HOST|WF_'

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 WriteFreely sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement standard et ses valeurs par défaut.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namewritefreelyNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image writeas/writefreely ; latest résout l'image de base vers l'ARG de build 0.12.0 épinglé. Épinglez une version en production.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomLaissez comme custom — le wrapper de génération de configuration doit être construit.
min_instance_count1Réplicas minimum ; GKE ne prend pas en charge la mise à l'échelle à zéro.
max_instance_count1Réplicas maximum.
cpu_limit / memory_limit1000m / 2GiRessources par pod.
container_port8080Le serveur web de WriteFreely se lie au port 8080.
enable_cloudsql_volumetrueSidecar Auth Proxy ; DB_HOST est remplacé par 127.0.0.1.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerExposition IP externe pour le blog.
session_affinityClientIPRoutage persistant vers le même pod.
workload_typenullPar défaut, un déploiement sans état.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires. Utilisez pour WF_SITE_NAME, WF_SITE_DESCRIPTION, WF_PUBLIC_URL, WF_OPEN_REGISTRATION. Ne définissez pas WF_KEY_* ou DB_* ici.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfsfalseDésactivé par défaut : WriteFreely n'a pas besoin de système de fichiers partagé. Le contenu réside dans MySQL et les clés de chiffrement sont initialisées à partir de Secret Manager à chaque démarrage.
nfs_mount_path/var/lib/writefreelyChemin de montage à l'intérieur du conteneur.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
application_database_namewritefreelyNom de la base de données → injecté comme DB_NAME. Immuable après le premier déploiement.
application_database_userwritefreelyUtilisateur de l'application → injecté comme DB_USER. Immuable après le premier déploiement.
database_type"MYSQL_8_0"Défini explicitement, correspondant au moteur attendu par la couche d'application partagée.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP, délai de 30sPrêt dès que le port 8080 est lié.
liveness_probeHTTP /, délai de 30sPilote également la disponibilité et la vérification de santé de l'équilibreur de charge, donc un long délai maintient le pod hors service ; la sonde de démarrage TCP couvre déjà les démarrages lents.

Groupe 15 — Redis (inerte pour WriteFreely)​

VariableValeur par défautDescription
enable_redisfalseLaissez désactivé — WriteFreely ne peut pas utiliser Redis ; l'activer n'injecte qu'un REDIS_HOST ignoré.

Toutes les autres entrées suivent le comportement standard d'App_GKE.


5. Sorties​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsMappage des ClusterIPs pour les services spécifiques à l'étape.
service_external_ipIP externe de l'équilibreur de charge (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre WriteFreely.
database_instance_nameNom de l'instance Cloud SQL.
database_nameNom de la base de données de l'application.
database_userUtilisateur 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 de la base de données (127.0.0.1 via le proxy d'authentification) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration et (optionnels) d'importation.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledÉtat de la journalisation d'audit et de 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 fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — IAP sans identités autorisées, un runtime gen1 avec des montages NFS/GCS, un database_type qui ne correspond pas à une extension activée, des valeurs de quota de mémoire sans suffixes d'unité binaire, un backup_retention_days hors plage. Une configuration invalide échoue la planification avec une erreur claire et nommée avant qu'aucune ressource ne soit créée, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'au moment de l'application ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence si incorrect
Clés AES-256 (WF_KEY_*, auto-générées)Ne jamais faire pivoter après le premier démarrageCritiqueLa rotation déconnecte tous les utilisateurs et rend les données de courrier électronique chiffrées indéchiffrables.
application_database_name / application_database_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_cloudsql_volumetrueCritiqueSur GKE, le sidecar Auth Proxy est requis ; le désactiver supprime l'écouteur 127.0.0.1:3306 et interrompt la connectivité MySQL.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans fichier de sauvegarde valide échoue le job d'importation.
container_image_sourcecustomÉlevéDéfinir prebuilt sans une image qui intègre le point d'entrée de génération de configuration produit un pod qui ne peut pas rendre config.ini et ne démarre pas.
WF_PUBLIC_URLURL/domaine de l'équilibreur de charge externeÉlevéUn hôte public incorrect rompt les liens générés, la fédération et les redirections.
reserve_static_iptrueÉlevéAvec false, GKE_SERVICE_URL peut revenir à un hôte *.svc.cluster.local interne inaccessible au moment de l'application (une course d'IP LB éphémère), que le point d'entrée intègre dans config.ini comme hôte public — confirmé sur WriteFreely.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont des octets et bloquent toute planification de pod dans l'espace de noms.
min_instance_count1ÉlevéGKE exige min ≥ 1 ; le garde de validation rejette les valeurs invalides.
session_affinityClientIPMoyenSans persistance, les sessions peuvent rebondir entre les pods ; les clés de cookie stables rendent cela tolérable mais l'affinité est préférée.
application_versionÉpingler une versionMoyenlatest peut déplacer l'image de base lors des redéploiements ; l'épinglage maintient les builds reproductibles.
WF_OPEN_REGISTRATIONfalse après le premier administrateurMoyenLaisser l'inscription ouverte permet à quiconque ayant l'URL de créer un compte.
enable_pod_disruption_budgettrueMoyenLa désactivation permet à GKE d'expulser tous les pods simultanément pendant la maintenance.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement de la fondation référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à WriteFreely partagée avec la variante Cloud Run est décrite dans WriteFreely_Common.

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