Aller au contenu principal

Kavita sur Google Cloud Run

Kavita sur Google Cloud Run

Kavita est un serveur de bibliothèque numérique et de lecture rapide, auto-hébergé, pour les bandes dessinées, les mangas et les livres électroniques — une interface utilisateur web de lecture propre, des flux OPDS, des collections, des listes de lecture et une recherche en texte intégral dans votre bibliothèque, construit sur .NET avec une base de données SQLite interne. Ce module déploie Kavita 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 que Kavita utilise 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 Kavita sur RAD, et comment cela se compare​

Kavita sur le module Cloud Run de RAD coûte environ 19 $ US par mois dans votre propre projet, plus des frais de module de 40 crédits (4 $ US) une fois par déploiement. Si vous ne lisez que par intermittence plutôt que continuellement, consultez la section "Mettez-le en pause gratuitement" ci-dessous pour arrêter de payer sans perdre votre progression de lecture. Kavita est également disponible en tant que module GKE, qui coûte plus cher ici (environ 42 $ US/mois) en raison des frais de gestion du cluster — Cloud Run est le choix le moins cher, sauf si vous utilisez déjà GKE Autopilot pour d'autres applications.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement40 crédits (4,00 $ US)36 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 CloudFacturé par Google à votre propre compte de facturation, environ 19,14 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 17 crédits par jour, environ 510 par mois (environ 51 $ 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 minimum acheté est détenu en réserve

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, moins sur un plan. 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 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
Cloud Run, 1x vCPU / 1 GiB (chaud)13,14 $ US
Cloud NAT et réseau5,00 $ US
Cloud Storage (modules complémentaires, sauvegardes)1,00 $ US
Totalenviron 19,14 $ US

Comment cela se compare​

  • Kavita n'a pas de plan SaaS hébergé officiel à comparer — il est livré purement comme un serveur de lecture auto-hébergé avec une base de données SQLite interne — donc la comparaison honnête est un serveur nu.
  • L'empreinte de Kavita est légère (1 vCPU, 1 GiB), donc même un niveau de VPS moins cher/plus petit que ceux ci-dessous ferait fonctionner confortablement une bibliothèque personnelle ; à titre de référence, un Hetzner CPX22 ou un droplet DigitalOcean 2 vCPU/4 Go coûte environ 24 $/mois, et un GCP Compute Engine e2-standard-2 environ 49 $/mois.
  • Ce que RAD ajoute par rapport à un VPS nu : persistance basée sur Cloud Storage, mise en réseau et surveillance gérées — Kavita n'a pas besoin de service de base de données séparé, donc la majeure partie de la valeur ici est opérationnelle plutôt que d'administration de base de données.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin​

Si Kavita s'exécute dans un projet géré par RAD pour vous et que vous prévoyez d'y revenir — une pause entre les cours, un creux saisonnier, ou simplement ne pas savoir encore si vous en aurez besoin le mois prochain — c'est la meilleure option, et cela ne coûte presque rien.

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 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 suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet : la propre suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression de Kavita en tant que module unique, cela ne démantèle pas le service Cloud Run/GKE et le réseau un par un — 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.

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 une 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 posséder le 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 que la plupart utilisent conviennent). 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 logicielle de Cloud Storage explicitement désactivée, il est donc très probable qu'il disparaisse dès que vous supprimez le projet, même si le projet lui-même est récupérable pendant 30 jours. L'exportation nocturne de Kavita couvre sa base de données SQLite (progression de lecture, collections, listes de lecture) ; pour une installation par défaut, c'est la seule copie qui vaille la peine d'être conservée, car les fichiers source de votre bibliothèque proviennent généralement d'ailleurs.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Dans votre propre projet, ou une fois que la fenêtre de 30 jours ci-dessus est passée, la solution de repli est de supprimer Kavita purement et simplement et de le redéployer plus tard.

  • Ce que coûte un redéploiement : les frais de module à nouveau (les builds sont inclus) — les frais de module indiqués ci-dessus.
  • Quand cela en vaut la peine : la suppression ne permet d'économiser de l'argent que si Kavita devait rester inutilisé pendant environ 7 jours ou plus dans votre propre projet (environ 5 jours ou plus dans un projet géré par RAD). Kavita n'a pas de base de données ou de VM partagée propre, donc sa suppression supprime à elle seule son coût d'exécution total.
  • Conservez d'abord les données. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du déploiement, et ce bucket est supprimé avec lui — copiez la dernière sauvegarde (vers Google Drive, ou un bucket que vous conservez) 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 Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Google Cloud : supprimer et restaurer des projets pour le mécanisme de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.


1. Vue d'ensemble​

Kavita s'exécute comme un conteneur .NET unique sur Cloud Run v2 sans base de données externe ni cache — tout ce dont il a besoin (paramètres, sa base de données SQLite interne et l'index de la bibliothèque) se trouve sur le disque sous /kavita/config.

CapacitéService Google CloudNotes
CalculCloud Run v2Conteneur web .NET sur le port 5000, 1000m CPU / 1Gi mémoire par défaut ; min=1/max=1
Base de donnéesAucune — SQLite internedatabase_type est fixé à NONE par Kavita_Common ; aucune instance Cloud SQL n'est créée
Persistance d'étatBucket Cloud Storage monté via GCS Fuse/kavita/config contient la base de données SQLite (kavita.db), les paramètres, les couvertures et les logs — c'est la seule option de persistance de Cloud Run (pas de PVC de bloc)
Stockage d'objetsCloud StorageUn bucket storage est auto-provisionné et monté à /kavita/config
SecretsSecret ManagerAucun généré — l'assistant de configuration de première exécution crée le compte administrateur ; secret_ids/secret_values sont vides
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 :

  • SQLite n'a pas d'autre choix que de vivre sur GCS Fuse ici. Cloud Run n'a pas d'option de volume persistant de bloc, donc /kavita/config (base de données SQLite et paramètres de Kavita) est toujours monté via gcsfuse. C'est le seul endroit dans ce module où la mise en garde habituelle du dépôt "gcsfuse corrompt SQLite" est inévitable plutôt qu'une mauvaise configuration — la description du module elle-même recommande Kavita_GKE pour les bibliothèques de production, où les mêmes données résident plutôt sur un véritable PVC de bloc. Considérez Kavita_CloudRun comme mieux adapté aux bibliothèques légères à moyennes.
  • min_instance_count est par défaut à 1, pas 0. Contrairement à la plupart des modules d'application Cloud Run (qui par défaut se mettent à l'échelle à zéro), Kavita maintient une instance toujours chaude par défaut, évitant les retards de démarrage à froid pendant qu'il recharge son index de bibliothèque et remonte le volume gcsfuse.
  • max_instance_count est épinglé à 1. Kavita n'a pas de clustering ou de coordination d'écriture partagée ; une deuxième instance écrivant dans le même fichier SQLite monté sur gcsfuse risque de corrompre l'index de la bibliothèque.
  • Pas de base de données, pas de Redis. database_type est fixé à NONE, et Redis est forcé d'être désactivé : main.tf code en dur enable_redis = false quelle que soit la valeur par défaut héritée de la variable (true) — Kavita n'a aucune utilité pour une file d'attente ou un cache.
  • Pas de secrets auto-générés. Il n'y a pas de mot de passe administrateur, de clé API ou de clé de signature créé dans Secret Manager. Le compte administrateur est créé de manière interactive via l'assistant de configuration de première exécution de Kavita la première fois que vous ouvrez l'URL du service.
  • Image personnalisée, tag de version épinglé. Le Dockerfile enveloppe finement jvmilazz0/kavita:${KAVITA_VERSION}. application_version = "latest" se résout en un argument de build KAVITA_VERSION = 0.8.7 épinglé dans Kavita_Common (pas le générique APP_VERSION que la Fondation injecte) — la mise à jour de la version nécessite de modifier cette valeur épinglée et de reconstruire, pas seulement de redéployer.
  • Le chemin de santé est /api/health, non authentifié, pour les deux sondes. La sonde de démarrage permet un budget d'échec généreux pour tolérer l'indexation de la bibliothèque au premier démarrage.
  • Seul le répertoire d'état de Kavita est persisté par ce module. Le contenu réel de la bibliothèque (bandes dessinées, mangas, livres électroniques) n'est pas provisionné ici — ajoutez votre propre gcs_volumes (ou NFS) pour le contenu et enregistrez-le comme bibliothèque dans l'interface utilisateur de Kavita après le déploiement.

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 Kavita​

Kavita s'exécute comme un service Cloud Run v2 unique. Comme il s'agit d'une application SQLite à écrivain unique, sauvegardée par un volume monté sur gcsfuse, ne pas augmenter max_instance_count au-dessus de 1.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs 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 — le bucket d'état de configuration/bibliothèque monté sur GCS Fuse​

Kavita_Common provisionne un seul bucket Cloud Storage (suffixe storage) et ce module le monte à /kavita/config via GCS Fuse. Il contient la base de données SQLite de Kavita (kavita.db), les images de couverture, les signets, les sauvegardes et les logs — en fait, tout l'état durable de Kavita. Des buckets supplémentaires peuvent être déclarés via storage_buckets, et des montages de contenu en lecture seule supplémentaires via gcs_volumes.

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

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

C. Secret Manager​

Kavita n'a pas de secrets générés — aucun mot de passe administrateur, clé API ou clé de signature n'est créé par ce module. La propre clé de signature JWT de Kavita (TokenKey) est auto-générée par l'application au premier démarrage et persistée sur le volume /kavita/config monté sur gcsfuse, pas dans Secret Manager. Tous les secrets que vous ajoutez vous-même via secret_environment_variables transitent par Secret Manager comme tout autre module d'application.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~kavita"

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

D. Réseau et ingress​

Le service est accessible par son URL run.app par défaut (ingress_settings = "all"), ce qui permet aux navigateurs, aux applications de lecture mobiles et aux clients OPDS de l'atteindre directement. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et de 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 logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des stratégies d'alerte facultatifs.

  • Console : Logging → Explorateur de logs ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Kavita​

  • Pas de configuration de base de données au premier déploiement. Kavita n'a pas de job db-init — il n'y a pas de base de données externe à amorcer. initialization_jobs est par défaut une liste vide ; seuls les jobs personnalisés que vous fournissez sont exécutés.
  • Pas d'étape de migration. Kavita crée et migre son propre schéma SQLite interne au premier démarrage ; la mise à niveau de application_version (et la reconstruction) applique les modifications de schéma automatiquement sans job de migration séparé.
  • Pas de secrets immuables et auto-générés. Contrairement à la plupart des modules d'application, il n'y a pas de clé de chiffrement, de jeton administrateur ou de secret JWT frappé dans Secret Manager. Le propre TokenKey JWT de Kavita est généré en interne au premier démarrage et persisté sur le volume /kavita/config — rien à faire pivoter ou à perdre la trace au niveau Terraform.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux le point de terminaison public, non authentifié /api/health. La sonde de démarrage utilise un budget d'échec plus long (initial_delay_seconds = 15, period_seconds = 10, failure_threshold = 10) pour tolérer une indexation de bibliothèque plus lente au premier démarrage avant que la sonde de vivacité (initial_delay_seconds = 30, period_seconds = 30, failure_threshold = 3) ne prenne le relais.
  • Comportement d'inscription / première exécution. Il n'y a pas de compte administrateur pré-rempli ni de justificatif généré. Ouvrez l'URL du service — l'assistant de configuration de première exécution de Kavita vous guide pour créer le compte administrateur initial et ajouter votre première bibliothèque. Terminez cela rapidement après le déploiement : tant qu'il n'est pas exécuté, le service est accessible mais non revendiqué.
  • Redis est désactivé de force. main.tf définit enable_redis = false inconditionnellement lors de l'appel de App_CloudRun, annulant la valeur par défaut enable_redis = true de la fondation — aucun REDIS_HOST/REDIS_PORT n'est jamais injecté, et les variables redis_host/redis_port/redis_auth n'ont aucun effet.
  • enable_cloudsql_volume est fixé à désactivé. main.tf transmet enable_cloudsql_volume = false directement à la fondation quelle que soit la variable (dont la valeur par défaut est également false) — Kavita n'a pas de sidecar Cloud SQL Auth Proxy.
  • Build d'image personnalisé. Le conteneur est construit à partir d'un Dockerfile d'enveloppe mince (FROM jvmilazz0/kavita:${KAVITA_VERSION}) ; application_version = "latest" se résout en l'argument de build KAVITA_VERSION = 0.8.7 épinglé (une mise à jour de version nécessite de modifier la valeur épinglée dans Kavita_Common, puis une reconstruction — voir la convention "images de base à tag le plus récent" du dépôt).
  • Inspecter le service et son état monté :
    gcloud run services describe <service-name> \
    --region "$REGION" --project "$PROJECT" \
    --format='value(status.url)'
    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 Kavita sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)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 ayant accès 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_namekavitaNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameKavitaNom lisible par l'homme affiché dans la console.
descriptionKavita — self-hosted comics, manga and ebook server (.NET, SQLite)Description du service.
application_versionlatestTag d'image Kavita ; latest se résout en l'argument de build KAVITA_VERSION = 0.8.7 épinglé dans Kavita_Common.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance ; Kavita est un serveur .NET léger.
memory_limit1GiMémoire par instance ; confortable pour les grandes bibliothèques.
min_instance_count1Maintenu à 1 par défaut pour éviter les démarrages à froid pendant le chargement de l'index de la bibliothèque — la plupart des modules Cloud Run sont par défaut à 0.
max_instance_count1Maintenir à 1. Pas de clustering — une deuxième instance écrivant le même fichier SQLite monté sur gcsfuse risque de corrompre les données.
container_port5000Port HTTP fixe de Kavita.
execution_environmentgen2Requis pour le montage GCS Fuse.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseKavita n'a pas de Cloud SQL ; également codé en dur false dans main.tf quelle que soit cette valeur.
enable_image_mirroringtrueMettre en miroir l'image Kavita dans Artifact Registry.
container_protocolhttp1HTTP/1.1 est suffisant ; Kavita n'a pas d'utilisation gRPC pour h2c.
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/étiquettes personnalisées sur la ressource de service Cloud Run.

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

VariableValeur par défautDescription
ingress_settingsallAccès public pour l'interface utilisateur de lecture, les flux OPDS et les clients d'applications de lecture.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Les clients OPDS/applications de lecture mobiles ne peuvent généralement pas terminer le flux d'authentification d'IAP.
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 ; Kavita n'en a pas besoin par défaut.
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 — ne concerne que les secrets que vous ajoutez vous-même ; Kavita n'en crée aucun.

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 /kavita/config à partir d'une sauvegarde lors du déploiement — Kavita n'a pas de dump de base de données séparé ; son état est le répertoire de configuration lui-même.

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 et découverte d'instances NFS​

VariableValeur par défautDescription
enable_custom_sql_scriptsfalseNon applicable — Kavita n'a pas de base de données SQL.
custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root—Non applicable.
nfs_instance_name / nfs_instance_base_name"" / app-nfsPertinent uniquement si vous ajoutez un montage NFS pour un contenu de bibliothèque séparé ; inutilisé par défaut.

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

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner Global HTTPS LB + Cloud Armor WAF.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour le LB HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend du LB 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ée le bucket storage auto-provisionné (monté à /kavita/config) plus tout storage_buckets.
storage_buckets[]Buckets GCS supplémentaires au-delà du bucket de configuration auto-provisionné.
enable_nfsfalseDésactivé par défaut ; activer uniquement pour monter un contenu de bibliothèque séparé via NFS.
nfs_mount_path/mnt/nfsChemin de montage pour ce partage NFS (distinct de /kavita/config).
gcs_volumes[]Montages de volumes GCS Fuse supplémentaires — par exemple, un bucket en lecture seule de contenu de bibliothèque.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
enable_redis / redis_host / redis_port / redis_authinerteDéclaré uniquement pour la mise en miroir des variables de la Fondation — main.tf code en dur enable_redis = false inconditionnellement ; Kavita n'utilise jamais Redis quelles que soient ces valeurs.

Groupe 12 — Backend de base de données (non applicable)​

VariableValeur par défautDescription
database_typeNONEFixé par Kavita_Common — Kavita stocke tout dans un fichier SQLite interne ; aucune instance Cloud SQL n'est créée.
database_password_length32Non référencé — Kavita n'a pas de base de données SQL.

Toutes les autres variables liées à la base de données dans ce groupe (sql_instance_name, application_database_name/_user, enable_mysql_plugins, enable_postgres_extensions, l'ensemble db_*_env_var_name, enable_auto_password_rotation, etc.) sont déclarées uniquement pour la mise en miroir des variables de la Fondation et n'ont aucun effet sur un déploiement Kavita.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide — Kavita n'a pas de job db-init/migration ; il gère son propre schéma SQLite au premier démarrage.
cron_jobs[]Non utilisé par défaut ; ajouter des tâches planifiées personnalisées (par exemple, des instantanés de collection) si nécessaire.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/health, délai de 15sSonde de démarrage ; le budget d'échec de 10 tentatives tolère l'indexation de la bibliothèque au premier démarrage.
liveness_probeHTTP /api/health, délai de 30sSonde de vivacité.
startup_probe_config / health_check_configdésactivé alt / HTTP /api/healthSondes structurées alternatives (inactives par défaut ; startup_probe/liveness_probe prennent effet).
uptime_check_config{ enabled=false, path="/api/health" }Test de disponibilité Cloud Monitoring ; désactivé par défaut.
alert_policies[]Stratégies d'alerte métrique.

Groupe 15 — Réseau​

VariableValeur par défautDescription
network_name""Déclaré pour la mise en miroir de convention ; non transmis à App_CloudRun par ce module — le réseau VPC est auto-découvert à la place.

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.
enable_audit_loggingfalseLogs 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.
kavita_urlURL VPC interne pour le service Kavita (port 5000) ; accessible uniquement au sein du VPC lorsque ingress_settings = "internal".
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 storage monté à /kavita/config.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs d'initialisation personnalisés que vous avez fournis (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_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

Notez qu'il n'y a pas de sorties database_* — Kavita ne provisionne aucune instance Cloud SQL.


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_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un réplica en lecture sans son primaire, IAP sans identités autorisées, un runtime gen1 avec un montage GCS Fuse, un redis_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 incorrect
/kavita/config sur GCS FuseAccepter uniquement pour les bibliothèques légères/moyennesCritiqueGCS Fuse est la seule option de persistance de Cloud Run ; les écritures concurrentes ou les analyses de métadonnées lourdes sur un fichier SQLite sauvegardé par gcsfuse risquent de corrompre l'index de la bibliothèque. Pour les grandes bibliothèques, utilisez le PVC de bloc de Kavita_GKE à la place.
max_instance_count1CritiqueKavita n'a pas de clustering ; une deuxième instance écrivant dans le même fichier SQLite monté sur gcsfuse corrompt l'index de la bibliothèque et les données administrateur/utilisateur.
Stockage du contenu de la bibliothèqueAjouter gcs_volumes (ou NFS) séparé de /kavita/configÉlevéKavita_Common ne persiste que le répertoire d'état de configuration/SQLite — sans un montage séparé pour les fichiers réels de bandes dessinées/mangas/livres électroniques, il n'y a nulle part où stocker durablement le contenu de la bibliothèque lui-même.
enable_iapfalse sauf si tous les clients le prennent en chargeÉlevéLe flux OPDS de Kavita et les clients d'applications de lecture mobiles ne peuvent généralement pas terminer le flux d'authentification de Google IAP, donc l'activation d'IAP bloque l'accès aux liseuses même si l'interface utilisateur du navigateur fonctionne toujours via un défi de navigateur.
ingress_settingsallÉlevéinternal empêche l'interface utilisateur de lecture et les clients OPDS d'atteindre directement le service.
Compte administrateur de première exécutionTerminer l'assistant de configuration immédiatement après le déploiementMoyenTant que l'assistant n'est pas exécuté, le service est accessible mais non revendiqué — quiconque atteint l'URL en premier peut créer le compte administrateur initial.
application_version / KAVITA_VERSIONÉpingler explicitement pour la productionMoyen"latest" se résout en Kavita_Common's KAVITA_VERSION = 0.8.7 épinglé ; la mise à jour nécessite de modifier cette valeur épinglée et de reconstruire, pas seulement de redéployer.
min_instance_count1 (par défaut)MoyenLa définition à 0 active la mise à l'échelle à zéro mais ajoute une latence de démarrage à froid pendant que gcsfuse remonte et que Kavita recharge son index de bibliothèque.
enable_redis (inerte)laisser tel quelFaibleLa définition de cette variable n'a aucun effet — main.tf code en dur enable_redis = false quelle que soit la valeur passée.
enable_cloudsql_volumefalseFaibleKavita n'utilise jamais Cloud SQL ; la valeur est codée en dur false dans main.tf quelle que soit cette valeur.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité ; l'état entier de Kavita est le répertoire /kavita/config, c'est donc le seul chemin de sauvegarde.

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 spécifique à l'application de Kavita partagée avec la variante GKE — y compris pourquoi elle n'a pas de secrets générés, pas de base de données, et comment le répertoire d'état /kavita/config est monté différemment sur chaque plateforme (GCS Fuse ici vs. un PVC de bloc sur GKE) — est décrite dans Kavita_Common.

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