Aller au contenu principal

Calibre-Web sur GKE Autopilot

Calibre-Web sur GKE Autopilot

Calibre-Web est une application web propre, auto-hébergée, pour naviguer, lire et télécharger des ebooks à partir d'une bibliothèque Calibre existante — elle offre un lecteur intégré au navigateur, un flux OPDS, la gestion des utilisateurs et la synchronisation Kobo en plus de l'image LinuxServer.io calibre-web en amont. Ce module déploie Calibre-Web sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes ; CalibreWeb_GKE est un wrapper léger qui fournit la propre configuration de Calibre-Web (image, ports, sondes, câblage du 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 à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — référez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


Ce que coûte Calibre-Web sur RAD, et comparaison​

Calibre-Web sur le module GKE Autopilot de RAD coûte environ 42 $ 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é à 75 crédits par jour (environ 2 250 par mois, soit environ 225 $ US au prix de la recharge). Ou consultez le guide Cloud Run pour l'option moins chère. 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 devient quelques dollars seulement. 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 à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 42 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 75 crédits par jour, environ 2 250 par mois (environ 225 $ US au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster)
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 minimum acheté est conservé en réserve

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore assez d'historique GKE géré par RAD pour le mesurer, donc la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

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 toutes les applications du projet, donc une deuxième application n'ajoute pas de 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
Pod GKE Autopilot, 1x vCPU / 1 Gio36,08 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total (hors frais de cluster GKE partagé)environ 42 $ US

Ces prix sont les mêmes en africa-south1 (Johannesburg).

  • GKE Autopilot ne se met pas à l'échelle zéro. Au moins un pod est toujours en cours d'exécution, donc le coût ci-dessus s'applique que quelqu'un utilise l'application ou non ; des pods supplémentaires ne sont ajoutés qu'en cas de charge.

Comparaison pour un serveur d'ebooks personnel ou pour 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 $/mois) ou un GCP e2-standard-2 (2 vCPU/8 Go, environ 49 $/mois) le ferait fonctionner confortablement — surdimensionné pour l'empreinte de 1 vCPU/1 Gio 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 le projet purement et simplement. 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 supprime 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, sera utilisable 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 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 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 que cela nécessite. Vous devez posséder le projet (pas un projet dont RAD gère uniquement la facturation), le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et atteindre à nouveau le seuil d'admission 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 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 à 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 méthode : 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 n'économise de l'argent que si Calibre-Web reste inutilisé pendant environ 3 jours ou plus — dans votre propre projet, cela représente environ 1,40 $ US par jour, et dans un projet géré par RAD, c'est 75 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 si 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 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 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 sur 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 charge de travail unique et stateful. 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
CalculGKE AutopilotPods Calibre-Web sur le port 8083, 1 vCPU / 1 Gio par défaut
Type de charge de travailKubernetes StatefulSetSélectionné automatiquement car stateful_pvc_enabled = true par défaut
Persistance de la configuration/bibliothèqueGKE Persistent Volume de bloc (standard-rwo, basé sur SSD)Monté à /config ; contient app.db, metadata.db de Calibre, configuration, cache, journaux
Stockage d'objetsCloud StorageUn bucket suffixé par storage est toujours provisionné, mais n'est pas monté tant que le PVC du StatefulSet est utilisé (voir §2.C)
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)
Base de donnéesAucunedatabase_type = "NONE" ; pas d'instance Cloud SQL, d'utilisateur ou de job db-init
IngressKubernetes Gateway API (lorsqu'un domaine personnalisé est configuré) ou ClusterIP intra-clusterservice_type par défaut à ClusterIP, pas LoadBalancer (voir §2.E)

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

  • Stateful, adossé à un PVC par défaut. stateful_pvc_enabled = true et workload_type est laissé null, ce qui se résout automatiquement en StatefulSet (selon le comportement "sélection automatique de StatefulSet" d'App_GKE). Un véritable PVC de bloc est utilisé au lieu de gcsfuse spécifiquement parce que les fichiers SQLite de Calibre-Web (app.db, metadata.db) seraient corrompus par le modèle de cohérence relâché de GCS FUSE.
  • La classe de stockage PVC par défaut est SSD (standard-rwo). Cela utilise le quota régional SSD_TOTAL_GB, qui est faible sur les projets à quota limité. Calibre-Web n'a pas besoin d'IOPS SSD pour sa charge de travail SQLite — envisagez de remplacer stateful_pvc_storage_class = "standard" (HDD pd-standard) pour préserver le quota SSD pour d'autres applications tout en conservant l'intégrité du verrouillage en écriture du périphérique de bloc dont SQLite a besoin.
  • Réplica unique par défaut. min_instance_count = 1, max_instance_count = 1. Parce que le StatefulSet utilise volumeClaimTemplates, chaque réplica obtient son propre PVC indépendant — la mise à l'échelle au-delà de 1 ne partage pas /config entre les pods ; elle duplique silencieusement la bibliothèque et la configuration en copies séparées et non synchronisées par pod. N'augmentez pas max_instance_count sans une stratégie de synchronisation externe.
  • 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 déclaré pour la mise en miroir des variables de fondation mais n'est pas transmis — main.tf code en dur enable_redis = false à l'appel de la Fondation quelle que soit la valeur de la variable.
  • service_type par défaut à ClusterIP, pas LoadBalancer. Combiné avec le défaut application_domains = [], le déploiement n'a pas d'accès externe configuré prêt à l'emploi même si enable_custom_domain = true par défaut — la passerelle est provisionnée mais n'a pas de nom d'hôte à router tant que vous ne fournissez pas application_domains ou ne changez pas service_type en LoadBalancer.
  • 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 Secret Manager CALIBRE_ADMIN_PASSWORD est provisionné pour un credential plus fort mais n'est pas câblé automatiquement dans le conteneur. Changez le mot de passe dans l'interface utilisateur de Calibre-Web lors de la première connexion.
  • Un bucket Cloud Storage est créé mais inutilisé par défaut. create_cloud_storage = true provisionne toujours le bucket suffixé storage, mais il n'est monté à /config que lorsque stateful_pvc_enabled = false (mode Déploiement). Avec le chemin StatefulSet/PVC par défaut, le bucket existe mais n'est pas attaché à la charge de travail.
  • 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 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 rapportés dans les Sorties du déploiement.

A. GKE Autopilot — le StatefulSet Calibre-Web​

Les pods Calibre-Web sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. La charge de travail s'exécute en tant que StatefulSet (pas un Deployment) afin d'obtenir une identité de pod stable et une séquence de redémarrage ordonnée (stateful_pod_management_policy par défaut à OrderedReady lorsqu'il est laissé null).

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Calibre-Web pour les pods, les révisions et les événements.
  • CLI :
    kubectl get statefulset,pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et de la sélection du type de charge de travail.

B. Stockage de blocs — le Persistent Volume Claim /config​

Les fichiers SQLite de Calibre-Web (app.db, metadata.db de Calibre), la configuration, le cache et les journaux résident sur un PVC de bloc par pod monté à /config (stateful_pvc_mount_path), d'une taille de 20Gi par défaut (stateful_pvc_size) sur la StorageClass standard-rwo (SSD pd-balanced) (stateful_pvc_storage_class).

  • Console : Kubernetes Engine → Stockage → Persistent Volume Claims ; Compute Engine → Stockage → Disques.
  • CLI :
    kubectl get pvc -n "$NAMESPACE"
    kubectl describe pvc -n "$NAMESPACE" -l app=<service-name>
    gcloud compute disks list --project "$PROJECT" --filter="name~<service-name>"

Étant donné que les PVC SSD utilisent le quota strict SSD_TOTAL_GB et que la mise à l'échelle à zéro d'une application stateful conserve son PVC (seule la suppression du PVC/namespace récupère le quota), vérifiez l'utilisation actuelle avant une large campagne d'applications GKE stateful. Voir App_GKE pour le cycle de vie général des StatefulSet et PVC.

C. Cloud Storage​

Un bucket Cloud Storage (suffixe storage) est toujours provisionné lorsque create_cloud_storage = true (la valeur par défaut) et que le compte de service de la charge de travail est autorisé — mais il n'est monté dans le pod à /config via GCS FUSE que lorsque stateful_pvc_enabled = false (c'est-à-dire lorsqu'il s'exécute en tant que Deployment au lieu du StatefulSet par défaut). Avec la configuration par défaut, le bucket existe mais n'est pas attaché à la charge de travail en cours d'exécution.

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

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

D. 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 le conteneur comme variable d'environnement secrète. Sur GKE, les secrets sont projetés via le pilote CSI Secret Store / SecretSync ; la clé n'a pas de __, c'est donc un targetKey valide.

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

Note : le secret injecté n'est pas automatiquement appliqué comme identifiant de connexion Calibre-Web — voir §3 pour les identifiants réels de la première connexion. Voir App_GKE pour l'intégration et la rotation du Secret Store CSI.

E. Réseau et ingress​

service_type par défaut à ClusterIP (interne uniquement), et enable_custom_domain = true par défaut provisionne une ressource Kubernetes Gateway API — mais avec le application_domains = [] vide par défaut, il n'y a pas de nom d'hôte pour que la passerelle route, donc le déploiement n'a pas d'accès externe configuré prêt à l'emploi. Pour exposer Calibre-Web en externe, définissez application_domains sur un vrai nom d'hôte, ou changez service_type en LoadBalancer (ce qui récupère également le nom d'hôte <reserved-ip>.nip.io par défaut d'App_GKE lorsque reserve_static_ip = true).

  • Console : Services réseau → Équilibrage de charge / Passerelles ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc,gateway,httproute -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails des IP statiques.

F. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE sont acheminées vers 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 logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application Calibre-Web​

  • Pas de job d'initialisation par défaut. initialization_jobs 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.
  • Image de wrapper léger, pas de point d'entrée personnalisé. Le Dockerfile est FROM lscr.io/linuxserver/calibre-web:${CALIBREWEB_VERSION} sans script de point d'entrée ajouté — l'init basé sur s6 de LinuxServer en amont s'exécute sans modification. image_source = "custom" est défini purement pour que la Fondation construise/mette en miroir l'image dans Artifact Registry.
  • Disposition du stockage au premier démarrage. L'image LinuxServer réduit les privilèges à PUID=1000/PGID=1000 et conserve tout l'état sous /config (app.db, metadata.db de Calibre, config, cache, journaux) ; la bibliothèque d'ebooks elle-même réside sous /books (vide au premier démarrage — l'assistant de configuration intégré à l'application y pointe Calibre-Web). stateful_fs_group par défaut à 3000 (la convention du chart Helm CalibreWeb) de sorte que le PVC est accessible en écriture par le groupe.
  • Identifiants de connexion. Les identifiants de première connexion intégrés de l'image en amont sont admin / admin123. Le secret CALIBRE_ADMIN_PASSWORD généré par Secret Manager n'est pas appliqué automatiquement — il existe pour qu'un mot de passe fort soit disponible dans Secret Manager et pour qu'une future image/point d'entrée puisse le consommer. Changez le mot de passe administrateur dans l'interface utilisateur de Calibre-Web immédiatement après la première connexion.
  • Sondes 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 donc dès que le serveur est en service, indépendamment de tout état de connexion. Démarrage : initial_delay=15s, timeout=5s, period=10s, failure_threshold=10. Vivacité : initial_delay=30s, timeout=5s, period=30s, failure_threshold=3.
  • Contrainte de mise à l'échelle. min_instance_count = 1 / max_instance_count = 1 par défaut. Étant donné que le StatefulSet provisionne un PVC distinct par réplica (volumeClaimTemplates), l'augmentation de max_instance_count ne donne pas aux pods une bibliothèque partagée — chaque pod obtient sa propre /config indépendante et non synchronisée.
  • Vérifier le déploiement :
    kubectl get statefulset,pods,pvc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
    kubectl exec -n "$NAMESPACE" <pod-name> -- ls -la /config

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

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_versionlatestTag lscr.io/linuxserver/calibre-web utilisé comme base de build personnalisé ; latest est épinglé à un tag connu et fonctionnel (0.6.24) au moment du build via l'ARG de build spécifique à l'application CALIBREWEB_VERSION.
application_display_nameCalibre-WebNom lisible par l'homme à des fins d'affichage.
descriptionCalibre-Web — a web app for browsing, reading and downloading ebooks from a Calibre library.Rempli la description de la charge de travail GKE.

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

VariableValeur par défautDescription
cpu_limit1000m1 vCPU.
memory_limit1GiLimite de mémoire pour le conteneur Calibre-Web.
min_instance_count / max_instance_count1 / 1Garder à 1 — voir la contrainte de mise à l'échelle §3 (forking PVC par réplica).
container_port8083Fixé par CalibreWeb_Common ; la variable du module n'est pas transmise à App_GKE et n'a aucun effet.
enable_cloudsql_volumefalseCorrectement désactivé — Calibre-Web n'utilise pas Cloud SQL.
enable_image_mirroringtrueMet en miroir l'image dans Artifact Registry pour éviter les limites de débit de Docker Hub.

Groupe 6 — Backend et cluster GKE​

VariableValeur par défautDescription
service_typeLoadBalancerAccessible de l'extérieur par défaut. Définir ClusterIP pour interne uniquement — voir §2.E pour le piège d'ingress que cela crée en combinaison avec application_domains = [].
workload_typenull → StatefulSetRésolu automatiquement car stateful_pvc_enabled = true.
session_affinityNonePas de routage persistant par défaut (un seul réplica rend cela discutable à l'échelle par défaut).

Groupe 7 — Configuration du StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueProvisionne un PVC de bloc par pod — requis car gcsfuse corromprait les fichiers SQLite de Calibre-Web.
stateful_pvc_size20GiTaille pour /config plus la bibliothèque Calibre.
stateful_pvc_mount_path/configOù Calibre-Web stocke ses bases de données SQLite, sa configuration, son cache et ses journaux.
stateful_pvc_storage_classstandard-rwo (SSD)Utilise le quota régional SSD_TOTAL_GB. La charge de travail SQLite de Calibre-Web n'a pas besoin d'IOPS SSD — envisagez standard (HDD pd-standard) pour conserver le quota SSD.
stateful_fs_group3000Correspond à la convention du chart Helm CalibreWeb afin que le PVC soit accessible en écriture par le groupe PUID:PGID=1000:1000.

Groupe 9 — PodDisruptionBudget​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueActivé par défaut (contrairement à la plupart des modules).
pdb_min_available1Avec max_instance_count = 1, un PDB de 1 bloque effectivement l'éviction volontaire du seul pod jusqu'à ce qu'il puisse être replanifié.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / liveness_probe (de CalibreWeb_Common)HTTP /Page de connexion, 200, aucune authentification requise — passe dès que le serveur est en service.
uptime_check_config.enabledfalseLes tests de disponibilité sont désactivés par défaut.

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

VariableValeur par défautDescription
enable_nfsfalseNFS n'est pas utilisé par Calibre-Web — la persistance se fait via le PVC du StatefulSet (ou GCS FUSE en mode Déploiement) à la place.
network_tags["nfsserver"]Inclut par défaut le tag nfsserver même si NFS est désactivé par défaut ; inoffensif mais pertinent uniquement si vous activez NFS séparément.

Groupe 14 — Cloud Storage​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionne toujours le bucket suffixé storage, mais voir §2.C — il est démonté tant que stateful_pvc_enabled = true (la valeur par défaut).

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redistrue (déclaré)Inerte — main.tf code en dur enable_redis = false sur l'appel de la Fondation quelle que soit la valeur de cette variable. Calibre-Web n'utilise pas Redis.
redis_host / redis_port"" / 6379Déclaré pour la mise en miroir des variables de fondation mais non transmis à App_GKE du tout.

Groupe 16 — 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éé. Toutes les autres variables database_*/sql_* de ce groupe sont explicitement "Non référencées".

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne la ressource Gateway API, mais ne fait rien d'utile en externe sans que application_domains soit défini (voir §2.E).
application_domains[]Vide par défaut — définissez-le pour obtenir un nom d'hôte externe fonctionnel tant que service_type = ClusterIP.
reserve_static_iptrueSe connecte au nom d'hôte <reserved-ip>.nip.io par défaut d'App_GKE uniquement lorsque service_type = LoadBalancer ; le comportement combiné avec le ClusterIP par défaut n'est pas explicitement documenté par la Fondation.

Toutes les autres entrées suivent le comportement standard de 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_ipsCarte des ClusterIPs pour les services spécifiques à chaque étape.
service_external_ipIP du LoadBalancer externe (lorsqu'une IP statique est réservée et service_type = LoadBalancer).
service_urlURL pour atteindre Calibre-Web.
calibreweb_admin_password_secret_idID du secret Secret Manager contenant le CALIBRE_ADMIN_PASSWORD généré (voir §3 pour savoir pourquoi ce n'est pas le login initial).
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_channelsStatut et canaux de surveillance.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
initialization_jobsNoms des jobs d'initialisation fournis par l'utilisateur (aucun par défaut).
statefulset_nameNom du StatefulSet.
cicd_enabled / cicd_configurationStatut 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_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 fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre stateless, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors plage. 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 si erroné
max_instance_count1CritiqueChaque réplica StatefulSet obtient son propre PVC (volumeClaimTemplates) — la mise à l'échelle duplique /config en copies indépendantes et non synchronisées par pod, et non en une bibliothèque partagée.
stateful_pvc_enabledtrue (conserver)CritiqueLe passage en mode false/Deployment déplace /config sur GCS FUSE, ce qui peut corrompre les fichiers SQLite de Calibre-Web (app.db, metadata.db) selon ses modèles d'accès.
service_type + application_domainsDéfinir application_domains, ou utiliser LoadBalancerÉlevéAvec les valeurs par défaut (ClusterIP + application_domains vide), le déploiement n'a pas d'accès externe configuré malgré enable_custom_domain = true.
stateful_pvc_storage_classstandard (HDD) pour les projets à quota limitéMoyenLe standard-rwo par défaut (SSD) utilise le quota strict SSD_TOTAL_GB ; une campagne d'applications GKE stateful peut l'épuiser vers l'application n°8. La mise à l'échelle à zéro ne libère pas le PVC — seule sa suppression le fait.
CALIBRE_ADMIN_PASSWORD (auto-généré)Changer le login dans l'interface utilisateur lors de la première connexionÉlevéLe secret généré n'est pas appliqué automatiquement ; le credential de première connexion fonctionnel est le défaut en amont admin/admin123 jusqu'à ce qu'il soit modifié manuellement.
enable_resource_quotaComprendre avant d'activerMoyenLes variables quota_cpu_*/quota_memory_*/quota_max_* de ce module sont déclarées mais non transmises à App_GKE — l'activation du quota utilise les propres valeurs par défaut de la Fondation (4 CPU / 4Gio–8Gio mémoire / 20 pods), et non une valeur définie sur ce module.
enable_redisIgnorer — inerteFaiblemain.tf code en dur enable_redis = false quelle que soit cette variable ; Calibre-Web n'a pas de dépendance Redis.
create_cloud_storagefalse si vous n'avez pas besoin du bucket de secoursFaibleAvec le chemin StatefulSet par défaut, le bucket storage est provisionné mais jamais monté — un petit coût évitable si vous ne prévoyez pas de passer en mode Déploiement.
memory_limit1Gi (augmenter pour les grandes bibliothèques)MoyenCalibre-Web charge les index de bibliothèque/collection en mémoire ; un sous-dimensionnement risque un OOM avec une grande bibliothèque Calibre.
quota_memory_requests / _limits (au niveau de la fondation, si activation des quotas directement sur App_GKE)unités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.

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 à Calibre-Web partagée entre les variantes de plateforme 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.