Aller au contenu principal

Audiobookshelf sur Google Cloud Run

Audiobookshelf sur Google Cloud Run

Audiobookshelf est un serveur auto-hébergé de livres audio et de podcasts — il organise votre bibliothèque audio, diffuse vers l'interface web et les applications mobiles officielles, et synchronise la progression d'écoute par utilisateur. Ce module déploie Audiobookshelf sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud qu'Audiobookshelf utilise et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toute 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 du socle App_CloudRun plutôt que de les répéter ici.


Ce que coûte Audiobookshelf sur RAD, et comment cela se compare​

Audiobookshelf sur le module Cloud Run de RAD coûte environ 19 $ US par mois dans un projet que vous possédez, sans frais de licence pour le logiciel lui-même. RAD facture des frais de module uniques de 40 crédits (4 $ US au prix de la recharge) dans un projet que vous possédez, et 36 crédits (10 % de moins) dans un projet géré par RAD. Si Audiobookshelf doit fonctionner en continu sur plusieurs pods ou à côté d'autres charges de travail Kubernetes, consultez plutôt le guide GKE. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, un besoin saisonnier — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les quelque 19 $ US par mois deviennent presque rien. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement40 crédits (4 $ US au prix de la recharge)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 de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 19 $ 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, soit 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 conservé 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 unique, et moins avec un plan mensuel.

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

Ressource (par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 GiB (chaud)13,14 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 19 $ US

Comment cela se compare​

  • Aucun concurrent SaaS de marque n'est une correspondance parfaite pour Audiobookshelf, donc la comparaison honnête est un simple serveur auto-géré. C'est une charge de travail plus petite qu'un VPS standard de 2 vCPU, donc le faire fonctionner vous-même sur une classe moins chère et plus petite qu'un Hetzner CPX22 ou un DigitalOcean 2 vCPU/4 Go Droplet (tous deux environ 24 $/mois) ferait l'affaire, pour nettement moins que cela.
  • RAD n'est pas moins cher qu'un VPS nu en termes d'argent, et n'essaie pas de l'être. Ce que RAD ajoute pour un prix similaire est une base de données gérée, Secret Manager pour les identifiants, et une surveillance que vous auriez autrement à configurer, patcher et sauvegarder vous-même.
  • Le temps de l'administrateur est le coût réel qu'un VPS ne montre pas. Les correctifs de sécurité, les sauvegardes et les mises à niveau de version sur un serveur nu sont un travail que quelqu'un doit continuer à faire ; les services gérés de RAD absorbent cela.

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

Si Audiobookshelf fonctionne dans un projet que RAD gère pour vous, vous avez une option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — étudier pour une certification, une démo, un besoin saisonnier — que de faire fonctionner Audiobookshelf en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable 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.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement. Google ne le supprime pas immédiatement : il conserve le projet, 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 la base de données, aucune VM ou la ressource de calcul une par une — l'ensemble du projet s'arrête simplement, et rien n'est facturé entre-temps.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, seul le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update 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 que cela nécessite. Vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démo). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : les sauvegardes ne survivent pas. Tout ce qu'Audiobookshelf écrit dans un bucket de sauvegarde à l'intérieur du projet est très probablement perdu dès que vous supprimez le projet, même si le projet lui-même est récupérable pendant 30 jours — la suppression logicielle de Cloud Storage est explicitement désactivée pour ce bucket. Quiconque a personnalisé le déploiement et souhaite conserver ce travail doit copier une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

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

C'est la solution de repli pour un projet que vous possédez, ou une fois que la fenêtre de restauration de 30 jours ci-dessus est passée : supprimez le déploiement, et redéployez-le lorsque vous en aurez à nouveau besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 40 crédits (4,00 $ US) dans votre propre projet, ou 36 crédits dans un projet géré par RAD, car RAD reconstruit les ressources à partir de zéro. La suppression permet d'économiser de l'argent une fois qu'Audiobookshelf resterait inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût de fonctionnement — environ 7 jours ou plus dans votre propre projet (0,64 $ US/jour) ou 3 jours ou plus dans un projet géré par RAD (17 crédits/jour).
  • Conservez d'abord vos données. Tout ce qu'Audiobookshelf écrit dans un bucket de sauvegarde à l'intérieur du déploiement 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.
  • RAD ne recrée pas un déploiement supprimé pour vous. Vous saisissez à nouveau les paramètres lorsque vous redéployez.

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 d'Audiobookshelf 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 Audiobookshelf 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 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 de RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Audiobookshelf fonctionne comme un conteneur Node.js sur Cloud Run v2. Fait inhabituel pour ce catalogue, il ne nécessite aucune base de données externe, aucun Redis et aucun secret d'application — l'empreinte du déploiement est délibérément petite :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 1 vCPU / 1 GiB par défaut, épinglé à une seule instance
Base de donnéesAucuneAudiobookshelf intègre sa propre base de données SQLite sous /data/config — pas de Cloud SQL
État persistantCloud Storage (GCS FUSE)Un bucket dédié storage monté à /data (gen2 requis)
Image de conteneurCloud Build + Artifact RegistryWrapper léger construit FROM ghcr.io/advplyr/audiobookshelf et mis en miroir dans votre registre
SecretsSecret ManagerPas de secrets d'application — l'utilisateur admin est créé dans l'interface web lors de la première exécution
IngressURL Cloud Run / Cloud Load BalancingPar défaut à all (internet public) ; équilibreur de charge HTTPS externe facultatif

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

  • Pas de base de données externe. database_type = "NONE" et enable_cloudsql_volume = false sont fixés par Audiobookshelf_Common ; Audiobookshelf crée et migre sa base de données SQLite interne au premier démarrage. Aucun job db-init ne s'exécute.
  • Un seul montage persistant couvre tout. CONFIG_PATH = /data/config (base de données SQLite + configuration de l'application) et METADATA_PATH = /data/metadata (illustrations de couverture, métadonnées mises en cache) sont tous deux redirigés sous /data, qui est sauvegardé par un bucket GCS provisionné automatiquement et monté via GCS FUSE. La perte de ce bucket entraîne la perte de tout l'état d'Audiobookshelf.
  • Instance unique. min_instance_count = 1 et max_instance_count = 1 — une bibliothèque SQLite partagée doit être servie par exactement un rédacteur. N'augmentez pas le maximum.
  • L'ingress est par défaut all. L'URL run.app est publiquement accessible depuis un navigateur dès la sortie de la boîte, correspondant à la valeur par défaut du socle App_CloudRun. Définissez ingress_settings = "internal" (ou placez le service derrière l'équilibreur de charge) pour le verrouiller à un accès uniquement VPC.
  • Image personnalisée (wrapper léger). Cloud Build encapsule l'image amont ghcr.io/advplyr/audiobookshelf afin qu'elle soit mise en miroir dans Artifact Registry. Le Dockerfile lit l'ARG de build spécifique à l'application AUDIOBOOKSHELF_VERSION ; application_version = "latest" se résout en 2.17.0 épinglé.
  • Pas de secrets générés. L'utilisateur root initial est créé de manière interactive dans l'interface web de première exécution, et les jetons API sont générés dans l'interface utilisateur par la suite — Audiobookshelf_Common expose secret_ids vide.
  • Les sondes de santé ciblent /healthcheck, le point de terminaison 200 non authentifié d'Audiobookshelf (démarrage : délai initial de 15 s, 10 échecs autorisés ; vivacité : délai de 30 s, 3 échecs).
  • Pas de Redis. enable_redis est explicitement forcé à false dans l'appel de la fondation.

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

Audiobookshelf s'exécute comme un service Cloud Run v2 épinglé à une seule instance. Chaque déploiement crée une révision immuable ; le trafic se déplace vers la plus récente et saine.

  • 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 /data​

Tout l'état d'Audiobookshelf — la base de données SQLite, la configuration de l'application, les illustrations de couverture et les métadonnées mises en cache — réside sous /data, sauvegardé par un bucket Cloud Storage dédié (suffixe storage) monté dans le conteneur via GCS FUSE. L'environnement d'exécution gen2 est requis pour les montages FUSE. Des buckets multimédias supplémentaires (par exemple, une bibliothèque de livres audio en lecture seule) peuvent être attachés via gcs_volumes.

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

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

C. Cloud Build et Artifact Registry — l'image de conteneur​

Le module construit une image wrapper légère FROM ghcr.io/advplyr/audiobookshelf:${AUDIOBOOKSHELF_VERSION} via Cloud Build et la stocke dans l'Artifact Registry du locataire, isolant les déploiements des limites de débit du registre amont et épinglant la version.

  • Console : Cloud Build → Historique ; Artifact Registry → Dépôts.
  • CLI :
    gcloud builds list --project "$PROJECT" --limit 5
    gcloud artifacts docker images list \
    "$REGION-docker.pkg.dev/$PROJECT/<repo>/audiobookshelf" --project "$PROJECT"

D. Secret Manager​

Audiobookshelf lui-même n'a pas besoin de secrets injectés — il n'y a pas de mot de passe de base de données, de clé maîtresse ou de secret JWT. Secret Manager reste disponible pour tout secret_environment_variables personnalisé que vous ajoutez.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"

E. Réseau et ingress​

Par défaut ingress_settings = "all" — le service est publiquement accessible, correspondant à la valeur par défaut du socle App_CloudRun. Définissez ingress_settings = "internal" pour restreindre le service aux appelants à l'intérieur du VPC, ou activez l'équilibreur de charge HTTPS externe (enable_cloud_armor) avec un domaine personnalisé pour une configuration frontale.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

F. Cloud Logging et Monitoring​

Les logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec un test de disponibilité facultatif (désactivé par défaut — il ne peut réussir que sur un point de terminaison publiquement accessible) et des stratégies d'alerte.

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

  • Premier démarrage autonome. Au premier démarrage, Audiobookshelf crée sa base de données SQLite et sa structure de répertoires sous CONFIG_PATH/METADATA_PATH — aucun job d'initialisation, job de migration ou provisionnement de base de données n'est impliqué. Comme les deux chemins se trouvent sous le montage persistant /data, la base de données survit aux déploiements de révisions, aux mises à niveau de version et aux événements de mise à l'échelle.
  • Assistant de configuration de première exécution. Ouvrez l'URL du service (/) — Audiobookshelf vous invite à créer l'utilisateur root initial de manière interactive. Il n'y a pas de bootstrap administrateur basé sur l'environnement ; les jetons API sont générés dans l'interface web par la suite.
  • Écrivain unique. SQLite sur un montage FUSE partagé tolère exactement un écrivain. Le module épingle min_instance_count = 1 / max_instance_count = 1 ; l'exécution de réplicas sur le même /data risque de corrompre la base de données.
  • Point de terminaison de santé. /healthcheck renvoie HTTP 200 non authentifié une fois le serveur prêt ; il prend en charge la sonde de démarrage (délai initial de 15 s, jusqu'à ~115 s de grâce), la sonde de vivacité et le test de disponibilité facultatif. L'interface web est à /.
  • Mise en garde sur la latence de GCS FUSE. Un serveur multimédia souhaite idéalement un stockage par blocs pour sa base de données SQLite et ses analyses de bibliothèque. GCS FUSE convient pour une utilisation légère à modérée ; pour les bibliothèques volumineuses ou de production, préférez Audiobookshelf_GKE, qui monte un véritable PVC de blocs à /data.
  • CLI de vérification :
    SERVICE=$(gcloud run services list --project "$PROJECT" --region "$REGION" \
    --filter="metadata.name~audiobookshelf" --format="value(metadata.name)" --limit=1)
    URL=$(gcloud run services describe "$SERVICE" --project "$PROJECT" --region "$REGION" \
    --format="value(status.url)")
    curl -s -o /dev/null -w "%{http_code}\n" "$URL/healthcheck" # expect 200 (ingress "all")

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 Audiobookshelf 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(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

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

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.

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

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameaudiobookshelfNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag de l'image ; latest construit le 2.17.0 épinglé. Modifier pour déclencher un nouveau build et un nouveau déploiement.

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

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

VariableValeur par défautDescription
cpu_limit1000mCPU par instance. Les analyses de bibliothèque et le travail de métadonnées intégrées sont liés au CPU — augmentez la taille pour les importations importantes.
memory_limit1GiMémoire par instance ; augmentez la taille pour les grandes bibliothèques.
min_instance_count1Maintient une instance chaude ; l'état SQLite est sur GCS donc 0 est sûr pour les données mais ajoute des démarrages à froid.
max_instance_count1Gardez à 1 — une bibliothèque SQLite, un écrivain.
container_port80Port HTTP d'Audiobookshelf (PORT=80 est injecté pour correspondre).
execution_environmentgen2Requis pour le montage GCS FUSE /data.
enable_cloudsql_volumefalsePas de Cloud SQL — conservez false.
enable_image_mirroringtrueMettre en miroir l'image amont dans Artifact Registry.

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

Groupe 5 — Accès et réseau​

VariableValeur par défautDescription
ingress_settingsallPublic par défaut. Définissez internal (ou utilisez l'équilibreur de charge) pour restreindre l'interface web et les applications mobiles à un accès uniquement VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.

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

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Fusionné sur les valeurs par défaut du module CONFIG_PATH=/data/config, METADATA_PATH=/data/metadata. Aucune valeur par défaut PORT n'est définie — Audiobookshelf écoute sur le $PORT auto-injecté de Cloud Run, et une variable d'environnement PORT fournie par l'utilisateur est un nom réservé que la plateforme rejette. Ne modifiez pas les deux chemins après le premier démarrage.
secret_environment_variables{}Mappage de var d'env → nom de secret Secret Manager (aucun requis par Audiobookshelf).

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

Groupe 7 — Sauvegarde et maintenance​

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_formatoff / gcs / "" / tarRestaurer à partir d'une sauvegarde lors du déploiement.

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

Groupe 8 — CI/CD et Binary Authorization​

Intégration standard Cloud Build / Cloud Deploy d'App_CloudRun — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

Groupe 9 — SQL personnalisé​

enable_custom_sql_scripts et ses compagnons ne sont pas applicables — Audiobookshelf n'a pas de base de données SQL. Laissez-les à leurs valeurs par défaut.

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

VariableValeur par défautDescription
enable_cloud_armor / application_domains / enable_cdnoff / [] / falseÉquilibreur de charge HTTPS externe avec WAF, domaine personnalisé et CDN — la méthode recommandée pour exposer Audiobookshelf publiquement.
max_images_to_retain / delete_untagged_images / image_retention_days7 / true / 30Politique de nettoyage d'Artifact Registry.

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

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueLe bucket /data storage est provisionné automatiquement — laissez-le activé.
gcs_volumes[]Montages GCS FUSE supplémentaires, par exemple un bucket de bibliothèque multimédia en lecture seule. Le bucket storage à /data est toujours ajouté.
enable_nfsfalseMontage Filestore facultatif ; non nécessaire pour la disposition par défaut.

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

Groupe 12 — Backend de base de données​

database_type est fixé à NONE par Audiobookshelf_Common ; les entrées de base de données restantes (database_password_length, paramètres de rotation, db_*_env_var_name) sont transmises uniquement pour la compatibilité avec le socle et n'ont aucun effet.

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

VariableValeur par défautDescription
initialization_jobs[]Pas de job d'initialisation par défaut — Audiobookshelf s'initialise lui-même. Fournissez des jobs uniquement pour des tâches ponctuelles personnalisées.
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /healthcheck, 15 s de délai initial, 10 échecsPermet ~115 s de grâce au premier démarrage.
liveness_probeHTTP /healthcheck, 30 s de délai initial, 3 échecsRedémarre une instance bloquée.
uptime_check_configdésactivé, chemin /healthcheckActiver uniquement lorsque le point de terminaison est publiquement accessible.
alert_policies[]Stratégies d'alerte métrique.

Groupe 23 — VPC Service Controls et Audit Logging​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite des autorisations au niveau de l'organisation).
vpc_cidr_ranges / vpc_sc_dry_run[] / trueCIDR 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.
audiobookshelf_urlURL de l'interface web / API. Publiquement accessible par défaut (ingress_settings = "all") ; interne au VPC uniquement si ingress_settings est changé en "internal".
service_locationRégion dans laquelle le service s'exécute.
stage_servicesDétails du 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 (inclut le bucket /data 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_namesÉtat de la surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration personnalisés.
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_enabledAudit logging et état 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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
max_instance_count1CritiquePlusieurs instances écrivent dans la même base de données SQLite via le montage FUSE partagé — corruption de la base de données.
create_cloud_storage / le bucket storagemaintenir provisionnéCritique/data contient tout l'état (base de données SQLite, configuration, métadonnées). La suppression du bucket entraîne la perte de toute la configuration de la bibliothèque.
CONFIG_PATH / METADATA_PATH remplacementslaisser les valeurs par défautCritiqueLes modifier après le premier démarrage orpheline la base de données SQLite existante et les métadonnées mises en cache.
container_port80CritiqueAudiobookshelf écoute sur le $PORT auto-injecté de Cloud Run, dérivé de container_port=80 (aucune variable d'environnement PORT explicite n'est définie — c'est un nom réservé que Cloud Run rejette) ; une non-concordance container_port fait échouer chaque sonde de santé.
execution_environmentgen2ÉlevéLes montages GCS FUSE nécessitent gen2 ; gen1 ne peut pas monter le bucket /data.
enable_backup_importfalse sauf restaurationÉlevéL'activation sans backup_uri valide fait échouer le job d'importation.
ingress_settingsall (par défaut) / internal si nécessaireMoyenLe all par défaut est publiquement accessible ; définissez internal (ou ajoutez l'équilibreur de charge) uniquement si vous souhaitez spécifiquement verrouiller le service à un accès uniquement VPC.
application_versiontag épingléMoyenlatest se résout silencieusement en 2.17.0 épinglé ; épinglez explicitement pour contrôler les mises à niveau.
min_instance_count1Moyen0 économise des coûts (l'état est sur GCS, donc il est sûr pour les données) mais ajoute un démarrage à froid au premier flux après l'inactivité.
Taille de la bibliothèque sur GCS FUSEbibliothèques petites/moyennesMoyenLes grandes bibliothèques et les analyses fréquentes souffrent de la latence FUSE — utilisez Audiobookshelf_GKE (PVC de blocs) pour les bibliothèques à l'échelle de la production.
enable_cloudsql_volumefalseFaibleAucune base de données Cloud SQL n'existe ; l'activation gaspille un sidecar.

Pour le comportement du socle 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 à Audiobookshelf partagée avec la variante GKE est décrite dans Audiobookshelf_Common.

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