Aller au contenu principal

Wallabag sur Google Cloud Run

Wallabag sur Google Cloud Run

Wallabag est une application gratuite, open source et auto-hébergée d'archivage d'articles à lire plus tard — une alternative à Pocket. Enregistrez des articles depuis une extension de navigateur, un marque-page, une application mobile ou l'API REST, puis lisez-les plus tard dans une vue propre et sans distraction avec recherche en texte intégral, étiquetage, annotations et flux RSS de vos éléments enregistrés. Ce module déploie Wallabag sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Wallabag et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application 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 Wallabag sur RAD, et comment cela se compare​

L'exécution de Wallabag sur Cloud Run dans votre propre projet Google Cloud coûte environ 70,19 $ US/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 75 crédits (7,50 $ US) facturé une seule fois au moment du déploiement. Wallabag est un archiveur d'articles à lire plus tard auto-hébergé, et sa base de données MySQL gérée représente la majeure partie de ce coût d'exécution. Dans un projet géré par RAD, les frais de module tombent à 67,5 crédits (10 % de moins) — voir Mettre en pause gratuitement ci-dessous — ou voir le guide GKE si vous préférez l'exécuter sur Kubernetes.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (une seule fois)75 crédits67,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 pour le temps de build à la minuteIdem
Coût d'exécution Google Cloud70,19 $ US/mois, facturé par Google au prix catalogue~61 crédits/jour (environ 1 830/mois, 183 $ US au prix de la recharge), 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 des frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 $ US pour une recharge unique, et moins pour un abonnement mensuel.

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

Ressource (valeur par défaut du module)Par mois
Cloud Run, 1x vCPU / 2 Gio (scaleToZero)13,16 $ US
Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total70,19 $ US

Comment cela se compare​

  • Les créateurs de wallabag vendent leur propre hébergement officiel sur wallabag.it : les forfaits vont d'environ 11 €/an (environ 1 $/mois) jusqu'à un abonnement "cœur" à 30 €/an qui ajoute simplement un support de projet supplémentaire sur des fonctionnalités identiques — vérifié sur wallabag.it, 8 octobre 2026. C'est beaucoup moins cher que le coût d'exécution du propre projet de RAD ici, car wallabag.it est un service partagé, multi-locataire, conçu pour un usage personnel ; ce n'est pas une comparaison équivalente avec un projet dédié et isolé avec votre propre instance Cloud SQL et un contrôle total des données.
  • Une comparaison de VPS auto-géré, dimensionné aux valeurs par défaut de Wallabag (1 vCPU / 2 Gio) : un Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go coûte environ 24 $/mois — moins cher en termes monétaires, plus votre propre temps pour les sauvegardes et les correctifs MySQL, que Cloud SQL et Secret Manager gérés par RAD couvrent pour vous.
  • Pour un usage personnel simple, l'hébergement propre de wallabag.it est de loin l'option la moins chère ; le cas de RAD ici est un projet dédié — utile pour une archive d'équipe, un déploiement de lab en libre-service, ou toute personne qui souhaite que les données ne quittent jamais l'infrastructure qu'elle contrôle.

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

C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien lorsqu'il est en 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 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 : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression 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é Wallabag 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 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 Wallabag signifie le redéployer à partir de zéro. Cela coûte environ 78-81 crédits dans votre propre projet, ou environ 70,5-73,5 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Wallabag reste inutilisé assez longtemps pour que le coût de redéploiement soit inférieur à son propre coût d'exécution — environ 3 jours ou plus dans votre propre projet (environ 2,34 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (61 crédits par jour).

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, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant 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 retournent 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 ; hébergement wallabag.it.

1. Vue d'ensemble​

Wallabag s'exécute comme un conteneur PHP/Symfony (nginx + php-fpm sous s6-overlay) sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service PHP/Symfony, 1 vCPU / 2 Gio par défaut, autoscaling sans serveur ; mise à l'échelle à zéro par défaut
Base de donnéesCloud SQL pour MySQL 8.0Requis — Wallabag_Common fixe le moteur ; PostgreSQL n'est pas pris en charge
Stockage d'objetsCloud StorageUn bucket générique data est provisionné, mais Wallabag ne le lit ni ne l'écrit — tout le contenu réside dans MySQL
SecretsSecret ManagerAPP_SECRET auto-généré (jeton de sécurité Symfony) ; mot de passe de la base de données
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • MySQL 8.0 est obligatoire. Le moteur de base de données est fixé par Wallabag_Common ; la sélection de tout autre moteur interrompt le déploiement.
  • enable_cloudsql_volume = false. Cloud Run se connecte à Cloud SQL via TCP IP privée, et non via le socket Unix du proxy d'authentification. La variante GKE utilise plutôt le sidecar du proxy d'authentification sur 127.0.0.1.
  • Un seul secret Secret Manager. APP_SECRET (un jeton de sécurité Symfony) est généré automatiquement, remplaçant la valeur par défaut intégrée et publiquement connue de Wallabag. Il n'y a pas de secret de mot de passe administrateur généré séparément.
  • La mise à l'échelle à zéro est activée par défaut (min_instance_count = 0, max_instance_count = 1). Les démarrages à froid ajoutent de la latence à la première requête après l'inactivité ; définissez min_instance_count = 1 pour éviter cela.
  • enable_nfs par défaut true mais est fonctionnellement inutilisé. Il monte Cloud Filestore NFS à /var/lib/wallabag, mais l'image de Wallabag WORKDIR est /var/www/wallabag — rien n'écrit dans le chemin monté. Peut être désactivé en toute sécurité.
  • Pas de job de migration séparé. Le propre bin/console wallabag:install de Wallabag gère à la fois la création du schéma et la configuration initiale en une seule étape idempotente.
  • L'auto-inscription est désactivée. SYMFONY__ENV__FOSUSER_REGISTRATION = "false" — seul le compte administrateur amorcé existe jusqu'à ce qu'un opérateur active explicitement l'inscription ou crée d'autres comptes.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service Wallabag​

Wallabag s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre le nombre 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​

Wallabag stocke toutes les données de l'application (articles enregistrés, tags, utilisateurs, annotations) dans une instance Cloud SQL pour MySQL 8.0 gérée. Le service se connecte via l'IP privée de l'instance via TCP (pas le socket du proxy d'authentification — enable_cloudsql_volume de Cloud Run par défaut false pour ce module). Lors du premier déploiement, un job db-init crée la base de données et l'utilisateur de l'application, suivi de wallabag-install, qui exécute l'installateur de Wallabag pour créer le schéma.

  • 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 générique data est provisionné par défaut (via l'entrée storage_buckets de la Fondation), mais Wallabag lui-même ne le lit ni ne l'écrit jamais — tout le contenu réside dans MySQL, et gcs_volumes (qui monterait un bucket dans le conteneur via fuse) est vide par défaut.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"

D. Secret Manager​

Un secret est généré automatiquement et stocké dans Secret Manager : APP_SECRET (matérialisé sous cette clé simple ; aliasé sur le vrai nom SYMFONY__ENV__SECRET par le point d'entrée du wrapper). 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~app-secret"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

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

E. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être ajoutés.

  • 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.

F. 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 vérifications de disponibilité et des stratégies d'alerte facultatives.

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

  • Chaîne d'initialisation en deux étapes, pas une étape de migration séparée de type Laravel. db-init (mysql:8.0-debian) crée la base de données et l'utilisateur de l'application vides et accorde les privilèges. wallabag-install dépend ensuite de db-init et réutilise la même image d'application personnalisée (de sorte que l'alias d'environnement du point d'entrée du wrapper s'exécute toujours) avec sa commande remplacée par bin/console wallabag:install --env=prod -n. Cette seule commande effectue à la fois la création du schéma et la configuration initiale (y compris l'amorçage du compte administrateur par défaut) — il n'y a pas de job de migration séparé à exécuter lors des mises à niveau ; réexécuter wallabag:install sur une base de données déjà installée est sûr et idempotent.
  • Comportement de la vérification de santé. La sonde de démarrage est TCP sur le port 80 — elle n'a besoin que de nginx pour se lier, indépendamment de la progression de l'installateur. La sonde de vivacité est HTTP GET / : une requête non authentifiée vers le chemin racine renvoie une redirection HTTP 302 vers /login, que les sémantiques de vérification de santé de Cloud Run et de Kubernetes traitent comme une réponse réussie (tout 2xx–3xx). Ne vous attendez pas à un simple 200 de / — un 302 vers /login est le résultat attendu et sain.
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/"   # expect 302
  • Compte administrateur de première exécution. wallabag:install --env=prod -n crée le compte administrateur par défaut de Wallabag en utilisant les valeurs par défaut d'installation documentées de Wallabag (nom d'utilisateur et mot de passe tous deux wallabag) — il n'y a pas de secret Secret Manager contenant un mot de passe administrateur généré. Changez ce mot de passe immédiatement après la première connexion (Paramètres → votre compte → changer le mot de passe, ou bin/console fos:user:change-password wallabag à l'intérieur du conteneur). Les nouveaux comptes ne peuvent pas s'auto-enregistrer (SYMFONY__ENV__FOSUSER_REGISTRATION = "false") — créez des utilisateurs supplémentaires depuis l'interface utilisateur d'administration ou avec bin/console fos:user:create.
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Wallabag 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_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails autorisés à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namewallabagNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameWallabagNom lisible par l'homme affiché dans la console.
application_versionlatestTag d'image de base pour wallabag/wallabag. "latest" correspond à un tag épinglé (2.6.14) au moment du build via l'ARG de build WALLABAG_VERSION spécifique à l'application.
php_memory_limit, upload_max_filesize, post_max_size512M / 64M / 64MDéclarés pour la parité de convention mais non transmis nulle part — la définition de ces valeurs n'a aucun effet sur le conteneur déployé.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit l'image du wrapper via Cloud Build. "prebuilt" ignore entièrement le wrapper d'alias DB/secret — ne pas utiliser sans votre propre traduction.
cpu_limit1000mCPU par instance.
memory_limit2GiMémoire par instance.
min_instance_count00 active la mise à l'échelle à zéro.
max_instance_count1Limite supérieure de l'autoscaling.
container_port80Nginx de Wallabag écoute sur le port 80.
execution_environmentgen2Gen2 requis pour les montages GCS Fuse.
enable_cloudsql_volumefalseCloud Run se connecte via TCP IP privée au lieu du socket du proxy d'authentification.
enable_image_mirroringtrueMettre en miroir l'image dans Artifact Registry.
container_protocolhttp1HTTP/1.1.

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

VariableValeur par défautDescription
ingress_settingsallIngress public par défaut.
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. Ne pas remplacer SYMFONY__ENV__DATABASE_* ici — ils sont calculés par le point d'entrée du wrapper au démarrage du conteneur.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager.
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 restauration​

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

Groupe 8 — CI/CD et Binary Authorization​

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 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner l'équilibreur de charge HTTPS global + Cloud Armor 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 le bucket GCS générique data. Non lu ni écrit par Wallabag.
enable_nfsfalseFonctionnellement inutilisé — monté à /var/lib/wallabag, mais l'image de Wallabag n'y écrit rien. Peut être désactivé en toute sécurité.
gcs_volumes[]Montages de volume GCS Fuse (nécessite gen2). Vide par défaut — rien n'est monté.
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 Wallabag_Common.
db_name / db_userwallabagPréfixé par le locataire au moment du déploiement. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16–64).
db_host_env_var_name / db_user_env_var_name / db_name_env_var_name / db_port_env_var_name / db_password_env_var_name"" (tous vides)Non utilisé par Wallabag — le point d'entrée du wrapper lit directement les variables DB_* standard et les alias sur SYMFONY__ENV__DATABASE_* lui-même.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser la chaîne intégrée db-init → wallabag-install.
cron_jobs[]Aucune tâche récurrente planifiée par la plateforme par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP, port 80, délai 30s, 20 tentativesN'a besoin que de nginx pour se lier.
liveness_probeHTTP GET /, délai 300s, 3 tentativesWallabag renvoie une redirection 302 vers /login — une réponse réussie.
uptime_check_config{ enabled = true }Vérification de disponibilité Cloud Monitoring.
alert_policies[]Stratégies d'alerte métrique.

Groupe 21 — Redis​

VariableValeur par défautDescription
enable_redisfalsePurement facultatif — uniquement utilisé par la fonctionnalité d'importation en masse asynchrone de Wallabag (importation Pocket/Instapaper). L'utilisation normale de sauvegarde/lecture/API ne touche jamais Redis.
redis_host""Point de terminaison Redis.
redis_port6379Port Redis.

Groupe 22 — VPC Service Controls et journalisation d'audit​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite organization_id).
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

5. Sorties​

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

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
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 Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init, wallabag-install).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / cicd_configurationStatut 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_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut 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 la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. 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'application ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
Variable d'environnement du pilote de base de données (SYMFONY__ENV__DATABASE_DRIVER, codée en dur dans entrypoint.sh)doit être définie explicitement (pdo_mysql ici)CritiqueLe parameters.yml livré avec Wallabag définit par défaut database_driver à pdo_sqlite. Définir uniquement SYMFONY__ENV__DATABASE_HOST/_PORT/_NAME/_USER/_PASSWORD sans variable de pilote explicite installe toujours silencieusement sur un fichier SQLite local jetable — l'installation "réussit", l'application semble fonctionner, mais toutes les données résident dans un fichier éphémère effacé à chaque redémarrage ou redéploiement, et MySQL n'est jamais touché. Aucune erreur n'est levée. Si ce module est un jour cloné comme modèle pour une autre application basée sur Symfony, vérifiez que la variable d'environnement du pilote de base de données est définie explicitement — cette classe d'échec est indétectable de l'extérieur ; seule la comparaison des journaux de démarrage du conteneur ("Configuring the SQLite database..." vs. une ligne de connexion MySQL) la révèle. Voir App_CloudRun et App_GKE pour savoir comment la Fondation injecte génériquement les variables d'environnement de base de données — la traduction spécifique à l'application et les éventuelles pièces manquantes sont toujours la responsabilité du module appelant.
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit tous les articles enregistrés.
APP_SECRET (auto-généré)Ne jamais modifier manuellement dans Secret Manager après le premier démarrageÉlevéWallabag l'utilise comme clé de signature de sécurité Symfony ; le modifier invalide les jetons CSRF et toutes les URL signées déjà émises.
Identifiants administrateur par défaut (wallabag / wallabag, amorcés par wallabag:install)Changer immédiatement après la première connexionÉlevéL'installateur amorce les identifiants par défaut bien connus de Wallabag — toute personne connaissant l'URL du service et la valeur par défaut publique peut se connecter tant que le mot de passe n'est pas modifié.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
container_image_sourcecustomCritiqueLe passage à prebuilt déploie l'image wallabag/wallabag standard sans point d'entrée wrapper — l'alias des variables d'environnement de la base de données et des secrets ne s'exécute jamais, de sorte que l'application ne peut pas du tout atteindre MySQL.
min_instance_count1 pour la productionMoyenLa mise à l'échelle à zéro (0) ajoute une latence de démarrage à froid à la première requête après l'inactivité.
enable_nfsfalse sauf si nécessaire à d'autres finsFaible / coûtPar défaut true et provisionne un partage Filestore que Wallabag n'utilise jamais — un coût récurrent inutile.
enable_cloud_armoractiver pour la productionMoyenLe service est publiquement accessible sans protection WAF par défaut.

Pour le comportement de la fondation 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 à Wallabag partagée avec la variante GKE est décrite dans Wallabag_Common.

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