Aller au contenu principal

Calibre-Web sur Google Cloud Run

Calibre-Web sur Google Cloud Run

Calibre-Web est une application web propre et auto-hébergée pour parcourir, lire et télécharger des livres électroniques à partir d'une bibliothèque Calibre existante — elle propose un lecteur intégré au navigateur, un flux OPDS, une gestion des utilisateurs et une synchronisation Kobo en plus de l'image LinuxServer.io calibre-web en amont. Ce module déploie Calibre-Web sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée ; CalibreWeb_CloudRun est un wrapper léger qui fournit la propre configuration de Calibre-Web (image, ports, sondes, câblage de stockage) et transmet tout le reste directement.

Ce guide se concentre sur les services cloud utilisés par Calibre-Web 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 Calibre-Web sur RAD, et comment cela se compare​

Calibre-Web sur le module Cloud Run de RAD coûte environ 33 US$ par mois dans votre propre projet Google Cloud, sans frais de licence supplémentaires — Calibre-Web est open source. Dans un projet géré par RAD pour vous, le même déploiement est facturé 23 crédits par jour (environ 690 par mois, soit environ 69 US$ au prix de la recharge). Ou consultez le guide GKE pour une capacité toujours active sur les pods. Si vous n'avez besoin de Calibre-Web qu'occasionnellement — études, démo, projet de courte durée — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ce chiffre mensuel ne représente que quelques dollars. Voir Mettre en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Calibre-Web est open source, il n'y a donc pas de frais de licence. Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement75 crédits (7,50 US$ au prix de la recharge)67,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 minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 33 US$ par mois pour la configuration par défaut (tableau ci-dessous)Facturé à l'heure en crédits ; RAD publie 23 crédits par jour, environ 690 par mois (environ 69 US$ au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde acheté minimum est conservé en réserve

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 ponctuelle, et moins avec un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (module par défaut)Par mois
Cloud Run, 1x vCPU / 1 GiB (chaud)13,14 US$
Serveur de fichiers NFS/cache (petite VM)13,43 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Totalenviron 33 US$

Les prix de Cloud SQL et des pods Cloud Run/GKE sont les mêmes en africa-south1 (Johannesburg) ; la petite VM coûte environ 10 % de plus là-bas.

  • Ce module est maintenu chaud par défaut (min_instance_count ≥ 1), de sorte que le chiffre Cloud Run ci-dessus suppose déjà qu'il ne se met jamais à l'échelle à zéro.

Comment cela se compare, pour un serveur de livres électroniques personnel ou de petite bibliothèque​

Calibre-Web n'a pas d'offre hébergée officielle — il est conçu pour fonctionner avec votre propre bibliothèque Calibre existante, donc la comparaison réaliste est un serveur nu :

  • Un Hetzner CPX22 ou un droplet DigitalOcean (2 vCPU/4 Go, environ 24 US$/mois) ou un GCP e2-standard-2 (2 vCPU/8 Go, environ 49 US$/mois) le ferait fonctionner confortablement — surdimensionné pour l'empreinte de 1 vCPU/1 GiB de Calibre-Web ici, donc une classe d'instance plus petite et moins chère ferait tout aussi bien l'affaire.
  • Sur un VPS nu, vous possédez le système d'exploitation, les correctifs de sécurité et votre propre discipline de sauvegarde. Le module de RAD vous offre la puissance de calcul, Secret Manager et Cloud Monitoring déjà câblés, pour les frais de module plus l'utilisation de Google Cloud ci-dessus.

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

Si Calibre-Web s'exécute dans un projet géré par RAD pour vous, la suppression de l'ensemble du projet — plutôt que la suppression de ce seul module — délie d'abord sa facturation, puis demande à Google de supprimer définitivement le projet. Google le conserve, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. 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.

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 est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut demander à Google de récupérer le projet et de rattacher son compte de facturation, puis d'exécuter Mettre à 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, et une mise à jour ne facture plus jamais les frais de module. 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 que cela nécessite. Vous devez posséder le projet (pas un projet dont RAD ne gère que la facturation), le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et franchir à nouveau le seuil d'admission 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 opérationnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage désactivée, il est donc très probable qu'il disparaisse dès que le projet est supprimé — même si le projet lui-même est récupérable pendant 30 jours. Copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer s'il y a quelque chose d'important à conserver ; pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Source : Supprimer et restaurer des projets.

Payer uniquement pendant l'utilisation, l'autre façon : supprimer et redéployer​

Dans votre propre projet, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 US$) au prix de la recharge. La suppression permet d'économiser de l'argent seulement si Calibre-Web resterait inutilisé pendant environ 6 jours ou plus — dans votre propre projet, cela représente environ 1,09 US$ par jour, et dans un projet géré par RAD, c'est 23 crédits par jour.
  • La majeure partie du coût d'exécution ici est généralement la base de données et/ou la VM ou le cluster de fichiers/cache partagé. Ils ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de Calibre-Web alors qu'une autre application partage le projet n'économise que la partie calcul de Calibre-Web.
  • Conserver les données en premier. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de 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 dispose de 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 non utilisé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 isolé qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est interrompue 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 Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et la mise en garde concernant le bucket de sauvegarde ; les prix changent, vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Calibre-Web s'exécute comme une seule révision Cloud Run. Il n'a pas de base de données externe — tout son état (la base de données de l'application, la base de données des métadonnées de la bibliothèque Calibre, la configuration, le cache et les journaux) réside dans des fichiers SQLite internes sous /config. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur Calibre-Web (image LinuxServer.io) sur le port 8083, 1 vCPU / 1 GiB par défaut ; min_instance_count = max_instance_count = 1
Persistance de la configuration/bibliothèqueNFS partagé (Filestore / VM NFS)/config est monté à partir du serveur NFS partagé par défaut (enable_nfs = true, nfs_mount_path = "/config"). Le bucket suffixé storage est toujours provisionné mais non monté — enable_gcs_storage_volume est exposé comme une variable de module sur CalibreWeb_CloudRun et par défaut à false, car GCS FUSE corrompt le SQLite de Calibre-Web app.db.
Base de donnéesAucunedatabase_type = "NONE" ; pas d'instance Cloud SQL, d'utilisateur ou de job db-init
Cache et file d'attenteAucunenable_redis est déclaré pour la mise en miroir des variables de fondation mais codé en dur à false dans main.tf quelle que soit la valeur de la variable
SecretsSecret ManagerCALIBRE_ADMIN_PASSWORD auto-généré — provisionné mais pas le credential avec lequel Calibre-Web s'authentifie réellement lors de la première connexion (voir §3)
IngressURL Cloud Run / Équilibrage de charge CloudURL run.app par défaut (ingress_settings = all) ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé via Cloud Armor

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

  • Persistance GCS Fuse, pas un PVC de bloc — conçu pour le développement/usage léger. Contrairement à CalibreWeb_GKE (qui utilise un véritable volume persistant de bloc spécifiquement parce que le modèle de cohérence relâché de gcsfuse peut corrompre SQLite), ce module Cloud Run n'a aucune option de stockage de bloc du tout — /config est sauvegardé par un montage NFS partagé par défaut (enable_nfs = true, nfs_mount_path = "/config"), qui fournit la sémantique POSIX dont SQLite a besoin. Le montage GCS Fuse à ce chemin est désactivé par défaut (enable_gcs_storage_volume = false) car il corrompt app.db. Le propre module_description du module indique explicitement que cette variante est "mieux adaptée au développement/usage léger" et recommande CalibreWeb_GKE avec un PVC de bloc pour la production.
  • Révision unique par défaut. min_instance_count = 1 et max_instance_count = 1. Contrairement à la variante GKE (où chaque réplica StatefulSet obtient son propre PVC indépendant), chaque instance Cloud Run monte le même bucket sauvegardé par GCS — donc augmenter max_instance_count ne bifurque pas la bibliothèque comme sur GKE, mais cela permet à deux instances d'écrire simultanément dans les mêmes fichiers SQLite sauvegardés par gcsfuse, ce qui est dangereux. Gardez-le à 1.
  • min_instance_count est par défaut à 1, pas à 0. Ce n'est délibérément pas une mise à l'échelle à zéro — l'intention est d'éviter un démarrage à froid pendant que Calibre-Web charge ses index de collection/bibliothèque. Ce module n'expose pas cpu_always_allocated du tout (il n'est pas mis en miroir dans variables.tf, ni transmis dans main.tf), il hérite donc silencieusement de la valeur par défaut de la fondation App_CloudRun (false, facturation basée sur les requêtes) — le CPU de l'instance toujours chaude n'est toujours facturé que lorsqu'il sert réellement une requête.
  • Pas de base de données. database_type = "NONE" ; il n'y a pas de job db-init et aucune des variables liées à la base de données dans ce module n'est référencée.
  • Pas de Redis. enable_redis est par défaut à true dans le variables.tf de ce module (mettant en miroir la valeur par défaut de la fondation App_CloudRun) mais est inerte — main.tf transmet un enable_redis = false codé en dur à l'appel de la fondation, et redis_host/redis_port/redis_auth sont déclarés mais jamais transmis.
  • Le mot de passe administrateur généré n'est pas le login fonctionnel. L'image LinuxServer en amont fournit un login par défaut intégré (admin / admin123) ; le secret CALIBRE_ADMIN_PASSWORD de Secret Manager est provisionné pour un credential plus fort mais n'est pas automatiquement câblé dans le conteneur. Changez le mot de passe dans l'interface utilisateur de Calibre-Web lors de la première connexion.
  • enable_cloudsql_volume est codé en dur sur off. main.tf transmet enable_cloudsql_volume = false à la fondation quelle que soit la valeur de la variable du module, supprimant entièrement le sidecar Cloud SQL Auth Proxy — correct, puisque Calibre-Web n'a pas de base de données.
  • La version de l'image est épinglée via un ARG de build spécifique à l'application. Le Dockerfile lit CALIBREWEB_VERSION (pas le générique APP_VERSION que la fondation injecte) ; lorsque application_version = "latest", le build est épinglé à un 0.6.24 connu et fonctionnel.

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 rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Calibre-Web​

Calibre-Web s'exécute comme un service/révision Cloud Run v2 unique. Parce que min_instance_count = max_instance_count = 1 par défaut, il n'y a normalement qu'une seule instance en cours d'exécution à la fois.

  • 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 Storage et GCS Fuse — le montage /config​

Un bucket Cloud Storage dédié (suffixe storage) est toujours provisionné lorsque create_cloud_storage = true (la valeur par défaut), mais par défaut il n'est pas monté : enable_gcs_storage_volume = false, donc /config — le chemin où Calibre-Web conserve ses fichiers SQLite (app.db, le metadata.db de Calibre), sa configuration, son cache et ses journaux. Le montage est contrôlé par la variable de module enable_gcs_storage_volume, qui est par défaut à false sur Cloud Run ; le bucket est toujours provisionné mais laissé non monté, et /config est servi par NFS à la place (voir enable_nfs). Des buckets/volumes supplémentaires peuvent être déclarés via storage_buckets / gcs_volumes.

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

Voir App_CloudRun pour les options de montage GCS Fuse et CMEK.

C. Secret Manager​

Un secret Calibre-Web est généré automatiquement et stocké dans Secret Manager : CALIBRE_ADMIN_PASSWORD (une valeur aléatoire de 24 caractères, secret-<prefix>-<app>-admin-password), injecté dans la révision Cloud Run comme une variable d'environnement secrète. Il n'est pas appliqué comme le login réel de Calibre-Web — voir §3.

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

Voir App_CloudRun pour l'injection et la rotation des secrets.

D. Réseau et ingress​

Le service est accessible par son URL run.app par défaut (ingress_settings = all, public). Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être superposé via enable_cloud_armor ; les paramètres d'ingress et le contrôle d'egress 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.

E. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring. Les tests de disponibilité sont désactivés par défaut (uptime_check_config.enabled = false).

  • 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 Calibre-Web​

  • Pas de job d'initialisation par défaut. initialization_jobs est par défaut à [] ; Calibre-Web gère son propre stockage SQLite et n'a pas besoin de bootstrap de base de données (il n'y a pas de job db-init car database_type = "NONE"). Seuls les jobs fournis par l'utilisateur s'exécutent.
  • Pas d'étape de migration. L'initialisation basée sur s6 de LinuxServer en amont s'exécute sans modification — le Dockerfile est FROM lscr.io/linuxserver/calibre-web:${CALIBREWEB_VERSION} sans script de point d'entrée ajouté. image_source = "custom" est défini uniquement pour que la fondation construise/mette en miroir l'image dans Artifact Registry.
  • Disposition du stockage au premier démarrage. L'image réduit les privilèges à PUID=1000/ PGID=1000 (injectés comme variables d'environnement par CalibreWeb_Common) et conserve tout l'état sous /config (le volume monté NFS) : app.db, le metadata.db de Calibre, la configuration, le cache et les journaux. La bibliothèque de livres électroniques elle-même se trouve sous /books (vide au premier démarrage — l'assistant de configuration intégré à l'application y pointe Calibre-Web).
  • CALIBRE_ADMIN_PASSWORD est provisionné mais non appliqué. Le secret Secret Manager existe pour qu'un mot de passe fort soit disponible et pour qu'une future image/point d'entrée puisse le consommer — il n'est pas câblé dans le flux de connexion réel du conteneur. Les identifiants de première connexion intégrés à l'image en amont sont admin / admin123. Changez le mot de passe administrateur dans l'interface utilisateur de Calibre-Web immédiatement après la première connexion.
  • Chemin de santé. Les sondes de démarrage et de vivacité émettent toutes deux un HTTP GET / (la page de connexion de Calibre-Web), qui renvoie 200 sans authentification requise — les sondes passent dès que le serveur est en service, indépendamment de tout état de connexion. Valeurs par défaut : démarrage initial_delay=15s, period=10s, failure_threshold=10 ; vivacité initial_delay=30s, period=30s, failure_threshold=3. (Remarque : le texte de description de la variable liveness_probe dans variables.tf fait référence à un point de terminaison /health que Calibre-Web n'expose pas — la valeur par défaut configurée réelle path est / ; ne la changez pas en /health, ce qui renverrait une erreur 404.)
  • Contrainte d'écriture unique. min_instance_count = max_instance_count = 1 maintient exactement une instance écrivant dans les fichiers SQLite montés par gcsfuse à la fois. Augmenter max_instance_count ne donne pas à Calibre-Web une bibliothèque partagée en toute sécurité — cela permet à deux instances Cloud Run d'écrire simultanément dans les mêmes fichiers SQLite sauvegardés par le bucket, ce qui risque de corrompre le modèle de cohérence relâché de GCS Fuse.
  • Inspecter l'exécution du job et la révision en cours :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT" \
    --format='value(status.url)'

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement (selon les balises {{UIMeta group=N}} dans variables.tf). Seuls les paramètres spécifiques ou notables pour Calibre-Web sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son 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[]Adresses e-mail autorisées à accéder 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_namecalibrewebNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameCalibre-WebNom lisible par l'homme affiché dans la console.
description(défini)Description du service.
application_versionlatestBalise lscr.io/linuxserver/calibre-web utilisée comme base de build personnalisé ; latest est épinglée à une balise connue et fonctionnelle (0.6.24) au moment du build via l'ARG de build spécifique à l'application CALIBREWEB_VERSION.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000m1 vCPU.
memory_limit1GiMémoire par instance.
min_instance_count1Pas de mise à l'échelle à zéro par défaut — évite un démarrage à froid pendant que Calibre-Web charge son index de bibliothèque.
max_instance_count1Maintenir à 1 — voir la contrainte d'écriture unique du §3.
container_port8083Port de l'interface web de Calibre-Web. Contrairement à la variante GKE (où cette variable est inerte), cette valeur EST transmise — calibreweb.tf la fusionne sur le CalibreWeb_Common codé en dur de 8083, elle prend donc effet si elle est modifiée.
execution_environmentgen2Gen2 requis pour le montage GCS Fuse /config.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseCodé en dur false dans main.tf quelle que soit cette variable — Calibre-Web n'a pas de Cloud SQL.
container_protocolhttp1Le texte de description mentionne gRPC ; non applicable à Calibre-Web — laisser http1.
enable_image_mirroringtrueMet en miroir l'image dans Artifact Registry pour éviter les limites de débit de Docker Hub.
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.
service_annotations / service_labels{}Annotations/libellés de service Cloud Run personnalisés.

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

VariableValeur par défautDescription
ingress_settingsallPublic par défaut pour que l'interface web soit directement accessible.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google devant l'interface utilisateur de Calibre-Web.
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 non secrets supplémentaires ; fusionnés avec CalibreWeb_Common's PUID=1000, PGID=1000, TZ=Etc/UTC.
secret_environment_variables{}Mappage de variable d'environnement → nom de 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/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer /config à 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 scripts SQL personnalisés​

VariableValeur par défautDescription
enable_custom_sql_scriptsfalseNon applicable — Calibre-Web n'a pas de base de données SQL.
custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root"" / "" / falseNon applicable.
nfs_instance_name / nfs_instance_base_name"" / app-nfsEntrées de découverte/nommage NFS — sans objet puisque enable_nfs = false par défaut (Groupe 11) et Calibre-Web n'a pas de chemin de stockage basé sur NFS.

Groupe 10 — Domaine, CDN, Cloud Armor 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_days7 / true / 30Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage, système de fichiers et Redis​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionne toujours le bucket suffixé storage. Il n'est pas monté par défaut — voir enable_gcs_storage_volume (false) et §2.B.
storage_buckets[]Buckets GCS supplémentaires au-delà de celui provisionné automatiquement.
enable_nfstrueNFS est la façon dont Calibre-Web persiste sur Cloud Run : /config contient un app.db SQLite en mode journal de restauration, que GCS FUSE ne peut pas maintenir (BufferedWriteHandler.OutOfOrderError for object: app.db-journal). NFS fournit la sémantique POSIX de renommage/fsync/verrouillage que FUSE ne fournit pas. Définissez false uniquement si vous acceptez le risque de corruption.
nfs_mount_path/configOù le volume NFS est monté — Calibre-Web y conserve tout son état (app.db, metadata.db, configuration, cache, journaux). Doit rester en phase avec enable_gcs_storage_volume : monter à la fois NFS et le volume GCS FUSE à /config est un conflit de double montage.
gcs_volumes[]Volumes GCS Fuse supplémentaires. Le volume automatique storage→/config n'est fusionné que lorsque enable_gcs_storage_volume = true, qui est par défaut à false sur Cloud Run.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
enable_redistrue (déclaré)Inerte — main.tf code en dur enable_redis = false sur l'appel de la fondation quelle que soit cette variable. Calibre-Web n'a pas de dépendance Redis.
redis_host / redis_port / redis_auth"" / 6379 / ""Déclaré pour la mise en miroir des variables de fondation mais non transmis à App_CloudRun du tout.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixé par CalibreWeb_Common ; aucune instance Cloud SQL, base de données ou utilisateur n'est créé.
database_password_length32Non référencé — aucune base de données n'existe.
application_database_name / application_database_user / db_password_env_var_name / enable_mysql_plugins / enable_postgres_extensions / enable_auto_password_rotation / sql_instance_name / sql_instance_base_namediversTous déclarés pour la mise en miroir des variables de fondation uniquement — non applicable, puisque database_type = "NONE".
service_url_env_var_name""Non lié à la base de données malgré le placement du groupe — ajoute un nom de variable d'environnement supplémentaire pour l'URL de service Cloud Run prédite à côté de CLOUDRUN_SERVICE_URL.

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

VariableValeur par défautDescription
initialization_jobs[]Pas de job d'initialisation intégré — Calibre-Web gère son propre stockage SQLite. Ne fournissez des jobs que pour le chargement de données personnalisées.
cron_jobs[]Pas de tâches récurrentes planifiées par la plateforme par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP / délai de 15sLa sonde qui est réellement appliquée (transmise via CalibreWeb_Common's config, qui remplace l'entrée brute startup_probe_config).
liveness_probeHTTP / délai de 30sLa sonde qui est réellement appliquée. Voir §3 pour l'incohérence du texte de description /health.
startup_probe_config / health_check_configactivé, chemin /Alternats inertes — une fois que CalibreWeb_Common fournit startup_probe/liveness_probe via application_config, ces entrées brutes de niveau supérieur sont ignorées.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring ; désactivé par défaut.
alert_policies[]Politiques d'alerte métrique.

Groupe 23 — VPC Service Controls 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.
organization_id""Remplacer pour les projets imbriqués dans des dossiers.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

Note : ce groupe est étiqueté group=23 dans variables.tf, un de plus que le 22 utilisé par la plupart des autres modules d'application Cloud Run pour les mêmes entrées VPC-SC/journalisation d'audit — une bizarrerie de numérotation de regroupement d'interface utilisateur cosmétique sans effet fonctionnel.

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.
calibreweb_urlL'URL du service Cloud Run (status.url). Note : la description de cette sortie dans outputs.tf fait référence à une "API REST VPC interne... (port 6333)" — ce texte est un copier-coller obsolète d'un module sans rapport (Calibre-Web n'a pas une telle API/port) ; la valeur elle-même est simplement l'URL normale du service, accessible via ingress_settings (publique par défaut).
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é).
storage_bucketsBuckets Cloud Storage créés, y compris le bucket /config monté storage.
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 la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration fournis par l'utilisateur (aucun par défaut).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / 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.

Note : outputs.tf n'expose pas l'ID du secret Secret Manager pour CALIBRE_ADMIN_PASSWORD au niveau supérieur (contrairement à la sortie CalibreWeb_GKE calibreweb_admin_password_secret_id) — récupérez-le avec gcloud secrets list --filter="name~admin-password" à la place.


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 du plan. Ce module transmet sa configuration au moteur de base App_CloudRun, qui valide les valeurs et les combinaisons au moment du plan — un réplica en lecture sans son primaire, 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, un redis_port/backup_retention_days hors de portée. 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
Modèle de persistance /configUtilisez CalibreWeb_GKE pour les bibliothèques de productionCritiqueCe module n'a pas d'option PVC de bloc ; /config est basé sur NFS par défaut (enable_nfs = true, nfs_mount_path = "/config"), ce qui évite la corruption de SQLite par gcsfuse. Ne définissez pas enable_gcs_storage_volume = true à ce chemin — le modèle de cohérence relâché de gcsfuse corrompt app.db/metadata.db en utilisation réelle, et cela monterait également deux fois /config. La description du module signale cette variante comme étant uniquement pour le développement/usage léger.
max_instance_count1CritiqueAu-dessus de 1, plusieurs instances Cloud Run écrivent concurremment dans les mêmes fichiers SQLite montés par gcsfuse — un risque réel de corruption de base de données, distinct (et à certains égards plus risqué) du forking PVC par réplica de la variante GKE.
CALIBRE_ADMIN_PASSWORD (auto-généré)Changez le login dans l'interface utilisateur lors de la première connexionÉlevéLe secret généré n'est pas appliqué automatiquement ; l'identifiant de première connexion fonctionnel est le défaut amont admin/admin123 jusqu'à ce qu'il soit modifié manuellement.
enable_redisIgnorer — inerteFaiblemain.tf code en dur enable_redis = false quelle que soit cette variable ; Calibre-Web n'a pas de dépendance Redis.
enable_cloudsql_volumeIgnorer — inerteFaiblemain.tf code en dur enable_cloudsql_volume = false ; Calibre-Web n'a pas de dépendance Cloud SQL.
min_instance_count1 (par défaut)MoyenGarde une instance toujours chaude pour éviter un démarrage à froid pendant que Calibre-Web charge son index de bibliothèque ; ce module n'expose pas cpu_always_allocated, donc le CPU est toujours facturé en fonction des requêtes (par défaut de Foundation) plutôt qu'en permanence.
startup_probe_config / health_check_configIgnorer — inerte une fois que application_config est définiFaibleCes entrées brutes sont remplacées par CalibreWeb_Common startup_probe/liveness_probe, qui est ce qui est réellement appliqué.
container_port8083 (garder)MoyenContrairement à CalibreWeb_GKE (où cette variable est inerte), sur Cloud Run, elle remplace réellement le port du conteneur via un merge() dans calibreweb.tf — le modifier sans modifier également le port d'écoute de l'image amont interrompt le routage.
enable_cloud_armoractiver pour la productionMoyenL'interface utilisateur de Calibre-Web et les points de terminaison OPDS/Kobo-sync sont accessibles publiquement sans protection WAF par défaut.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité de la sauvegarde /config.

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 à Calibre-Web partagée avec la variante GKE est décrite dans CalibreWeb_Common.

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