Aller au contenu principal

Audiobookshelf sur GKE Autopilot

Audiobookshelf sur GKE Autopilot

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 GKE Autopilot au-dessus du socle App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

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 à chaque application GKE — Workload Identity, ingress, autoscaling, 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_GKE plutôt que de les répéter ici.


Coût d'Audiobookshelf sur RAD et comparaison​

Le module GKE Autopilot d'Audiobookshelf sur RAD coûte environ 42 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 75 crédits (7,50 US$ au prix de la recharge) dans un projet que vous possédez, et 67,5 crédits (10 % de moins) dans un projet géré par RAD. GKE convient à Audiobookshelf qui doit rester actif en continu ou s'adapter à travers les pods ; pour le coût le plus bas, le module Cloud Run exécute le même Audiobookshelf pour environ 19 US$ par mois. 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 42 US$ par mois deviennent presque nuls. 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é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, soit environ 2 250 par mois (environ 225 US$ au prix de la recharge ; estimé à partir des prix catalogue 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 détenu 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 le socle partagé 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 suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que 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 unique, et moins pour un plan mensuel.

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

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 1x vCPU / 1 Gio36,08 US$
Cloud NAT et réseau5 US$
Cloud Storage (extensions, sauvegardes)1 US$
Frais de gestion du cluster GKE0 US$ si c'est votre seul cluster Autopilot/zonal sur le compte de facturation, sinon environ 73 US$ (partagés entre toutes les applications GKE du projet)
Totalenviron 42 US$

Comparaison​

  • 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 l'exécuter 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, c'est une base de données gérée, Secret Manager pour les identifiants, et une surveillance qui serait autrement votre propre travail à configurer, patcher et sauvegarder.
  • 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 lorsque vous en avez besoin​

Si Audiobookshelf s'exécute 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 d'exécuter 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 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.

  • 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 cette attente. 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 restaurer le projet et de rattacher son compte de facturation, puis vous demande 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 — 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, de sorte que 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émonstration). 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 de nouveau besoin.

  • Coût d'un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 US$) dans votre propre projet, ou 67,5 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 d'exécution — environ 6 jours ou plus dans votre propre projet (1,40 US$/jour) ou 1 jour ou plus dans un projet géré par RAD (75 crédits/jour).
  • Le cluster GKE lui-même est une infrastructure partagée. Si une autre application utilise le même cluster Autopilot, la suppression d'Audiobookshelf seule ne sauve que son propre pod ; les frais de gestion du cluster ne diminuent que lorsque rien d'autre dans le projet n'en a besoin.
  • 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 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 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 s'exécute comme une seule charge de travail Node.js sur GKE Autopilot. 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
CalculGKE AutopilotPod Node.js, 1 vCPU / 1 Gio par défaut, réplica unique
Base de donnéesAucuneAudiobookshelf intègre sa propre base de données SQLite sous CONFIG_PATH — pas de Cloud SQL
État persistantPersistent Volume Claim (stockage par blocs)Un PVC StatefulSet monté à /data, supportant à la fois CONFIG_PATH et METADATA_PATH
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
IngressCloud Load BalancingLoadBalancer externe avec une IP statique réservée ; domaine personnalisé optionnel

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 vrai PVC de bloc, pas GCS FUSE, supporte /data. stateful_pvc_enabled = true par défaut — gcsfuse corrompt SQLite et l'index des fichiers multimédias, donc Audiobookshelf nécessite un véritable périphérique de bloc. Lorsque le PVC est activé, la variante désactive automatiquement le volume de stockage GCS-FUSE au même chemin (enable_gcs_storage_volume = !stateful_pvc_enabled) pour éviter un conflit de double montage à /data. C'est la différence clé avec Audiobookshelf_CloudRun, qui n'a pas d'option PVC et utilise GCS FUSE à la place.
  • stateful_pvc_enabled = true sans workload_type explicite se résout en StatefulSet. Un PVC par pod, provisionné à partir de la StorageClass standard-rwo (SSD, PD équilibré) par défaut — voir §6 pour l'implication du quota SSD.
  • 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 le seul stateful_pvc_mount_path (/data). La perte de ce PVC entraîne la perte de tout l'état d'Audiobookshelf.
  • Réplica 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 sans vérifier la sécurité multi-rédacteur (il n'y en a pas).
  • Image personnalisée (wrapper léger). Cloud Build enveloppe l'image amont ghcr.io/advplyr/audiobookshelf afin qu'elle soit mise en miroir dans Artifact Registry. Le Dockerfile lit l'ARG de build AUDIOBOOKSHELF_VERSION spécifique à l'application (pas le générique APP_VERSION que le socle injecte) ; 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 des secret_ids/secret_values vides.
  • Les sondes de santé ciblent /healthcheck, le point de terminaison 200 non authentifié d'Audiobookshelf (démarrage : délai initial de 15 s, période de 10 secondes, 10 échecs autorisés ; vivacité : délai de 30 s, période de 30 secondes, 3 échecs).
  • Pas de Redis. Le main.tf de la variante remplace le enable_redis par défaut du socle par false pour ce module.
  • Domaine personnalisé activé par défaut. enable_custom_domain = true (contrairement à la plupart des autres modules GKE, qui désactivent cette option par défaut) — fournissez application_domains pour attacher un nom d'hôte, sinon il revient à l'IP du LoadBalancer.

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

Audiobookshelf s'exécute comme un StatefulSet à pod unique (le type de charge de travail résolu par défaut lorsque stateful_pvc_enabled = true), lui donnant une identité de pod stable et un redémarrage ordonné — approprié pour une charge de travail SQLite à rédacteur unique.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Audiobookshelf pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get 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 du type de charge de travail (Déploiement vs StatefulSet).

B. Persistent Volume Claim — le stockage par blocs /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 — se trouve sous /data, soutenu par un Persistent Volume Claim de bloc provisionné par pod par le StatefulSet. gcsfuse est explicitement évité ici car il corrompt SQLite et l'index des fichiers multimédias. Des bibliothèques multimédias supplémentaires (par exemple un bucket de livres audio en lecture seule) peuvent toujours être attachées via gcs_volumes à un chemin de montage différent.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail → onglet Volumes/Stockage. Compute Engine → Disques répertorie également le Persistent Disk sous-jacent.
  • 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>"

Voir App_GKE §7 (StatefulSet / PVC) pour les options de StorageClass, et §6 ci-dessous pour le piège du quota SSD.

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é principale ou de secret JWT. Secret Manager reste disponible pour tout secret_environment_variables personnalisé que vous ajoutez. Sur GKE, les secrets sont projetés dans les pods via le pilote CSI du Secret Store.

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

Voir App_GKE pour l'intégration et la rotation du Secret Store CSI.

E. Réseau et ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing (service_type = ClusterIP par défaut au niveau du socle, mais l'ingress d'Audiobookshelf est normalement atteint via enable_custom_domain = true et une IP statique réservée ; définissez service_type = LoadBalancer pour une IP externe directe sans domaine personnalisé). Un domaine personnalisé avec un certificat géré par Google est activé par défaut pour ce module.

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

Voir App_GKE pour les détails sur les domaines personnalisés, Cloud CDN et l'IP statique.

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. Des tests de disponibilité et des stratégies d'alerte optionnels sont disponibles (les tests de disponibilité sont désactivés par défaut et ne passent que sur un point de terminaison accessible publiquement).

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

  • Premier démarrage autonome, pas de job d'initialisation. 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 PVC persistant, la base de données survit aux redémarrages de pods et aux mises à niveau de version d'application. Audiobookshelf_Common n'injecte aucun initialization_jobs par défaut ; des jobs personnalisés peuvent toujours être fournis pour des chargements de données ponctuels.
  • 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 (Paramètres → Utilisateurs).
  • Rédacteur unique, réplica unique. SQLite sur un PVC de bloc tolère exactement un rédacteur. Le module épingle min_instance_count = 1 / max_instance_count = 1 ; un StatefulSet avec stateful_pod_management_policy = OrderedReady assure en outre que les pods ne sont pas démarrés concurremment pendant les événements de mise à l'échelle.
  • Point de terminaison de santé. /healthcheck renvoie HTTP 200 non authentifié une fois le serveur prêt ; il supporte la sonde de démarrage HTTP (délai initial de 15 s, période de 10 secondes, jusqu'à 10 échecs ≈ 115 s de grâce au premier démarrage) et la sonde de vivacité HTTP (délai initial de 30 s, période de 30 secondes, 3 échecs). L'interface web est à /.
  • Contraintes de mise à l'échelle. En tant que StatefulSet avec un backend SQLite à rédacteur unique, ne pas dépasser 1 réplica. Les stateful_update_strategy et stateful_pod_management_policy par défaut (tous deux null → valeurs par défaut du socle de RollingUpdate/OrderedReady) sont adéquats pour un nombre de réplicas de 1 ; ils n'ont d'importance que si vous expérimentez avec plus d'un pod, ce qui n'est pas pris en charge par l'application.
  • CLI de vérification :
    kubectl get pods,pvc -n "$NAMESPACE"
    SERVICE=$(kubectl get svc -n "$NAMESPACE" -o jsonpath='{.items[?(@.metadata.labels.application=="audiobookshelf")].metadata.name}')
    kubectl exec -n "$NAMESPACE" statefulset/<service-name> -- wget -qO- http://localhost:80/healthcheck
    kubectl port-forward -n "$NAMESPACE" svc/<service-name> 8080:80
    curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8080/healthcheck # expect 200

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 ; 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_nameaudiobookshelfNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image ghcr.io/advplyr/audiobookshelf utilisé comme base de build personnalisé ; latest se résout en 2.17.0 épinglé via l'ARG de build AUDIOBOOKSHELF_VERSION spécifique à l'application.
application_display_nameAudiobookshelf Media ServerNom d'affichage lisible par l'homme.
descriptionAudiobookshelf — self-hosted audiobook and podcast server with progress sync across clientsDescription de la charge de travail.

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

VariableValeur par défautDescription
cpu_limit1000mCPU par pod. Les analyses de bibliothèque sont limitées par le CPU — augmentez la taille pour les importations importantes.
memory_limit1GiMémoire par pod ; augmentez la taille pour les grandes bibliothèques.
min_instance_count1Maintenez à 1 pour éviter les démarrages à froid pendant le chargement de la bibliothèque/de l'index.
max_instance_count1Maintenez à 1 — une bibliothèque SQLite, un rédacteur.
container_port80Port HTTP d'Audiobookshelf (fixé par Audiobookshelf_Common ; cette variable n'est pas elle-même transmise à App_GKE).
enable_cloudsql_volumefalsePas de Cloud SQL — conservez false ; Audiobookshelf ne l'utilise pas.
enable_image_mirroringtrueMettre en miroir l'image amont dans Artifact Registry.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerType de service Kubernetes ; définissez LoadBalancer pour une IP externe directe.
workload_typenull → StatefulSet (via stateful_pvc_enabled = true)Recommandé pour l'identité de pod stable d'Audiobookshelf et les redémarrages ordonnés.
session_affinityNoneDéploiement à réplica unique, donc les sessions persistantes ne sont pas requises.
network_tags["nfsserver"]Valeur par défaut héritée du socle ; Audiobookshelf n'utilise pas NFS, donc ce tag n'a aucun effet pratique à moins que enable_nfs ne soit également activé.

Groupe 7 — StatefulSet / PVC​

VariableValeur par défautDescription
stateful_pvc_enabledtrueRequis — gcsfuse corrompt la base de données SQLite et l'index des fichiers multimédias d'Audiobookshelf, donc un vrai PVC de bloc supporte /data.
stateful_pvc_size20GiTaille pour contenir l'index complet de la bibliothèque audio plus les frais généraux (le PVC contient la configuration/les métadonnées, pas nécessairement les fichiers audio bruts si ceux-ci sont montés séparément via gcs_volumes).
stateful_pvc_mount_path/dataLes deux CONFIG_PATH (/data/config) et METADATA_PATH (/data/metadata) vivent sous ce montage.
stateful_pvc_storage_classstandard-rwo (SSD, PD équilibré)Voir §6 — considérez standard (HDD) pour éviter d'épuiser le quota SSD_TOTAL_GB ; la charge de travail SQLite/média d'Audiobookshelf n'a pas besoin d'IOPS SSD.
stateful_pod_management_policynull → OrderedReadyRequis pour des redémarrages sûrs d'une charge de travail à rédacteur unique.
stateful_update_strategynull → RollingUpdateN'a d'importance que si le nombre de réplicas est (non supporté) augmenté au-dessus de 1.
stateful_fs_group3000Correspond à la convention fsGroup du chart Helm d'Audiobookshelf (l'application s'exécute en tant que UID 1000/GID 2000) afin que le PVC soit accessible en écriture par le groupe.

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

VariableValeur par défautDescription
enable_nfsfalseNon utilisé par défaut — l'état d'Audiobookshelf réside sur le PVC de bloc, pas sur NFS.

Groupe 14 — Cloud Storage​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionne le bucket storage du module Common ; inutilisé pour le montage primaire /data lorsque stateful_pvc_enabled = true (le PVC remplace GCS FUSE à ce chemin), mais toujours créé et disponible pour les remplacements gcs_volumes.
gcs_volumes[]Montages GCS FUSE supplémentaires, par exemple un bucket de bibliothèque multimédia en lecture seule à un chemin séparé.

Groupe 15 — Cache Redis​

VariableValeur par défautDescription
enable_redistrue (valeur par défaut du socle) → forcé à false par main.tfAudiobookshelf n'utilise pas Redis ; la variante code en dur enable_redis = false dans son appel App_GKE quelle que soit la valeur de cette variable.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixe — Audiobookshelf n'a pas de base de données SQL ; toutes les autres entrées de base de données sont transmises uniquement pour la compatibilité du socle et n'ont aucun effet.

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

VariableValeur par défautDescription
enable_custom_domaintrueActivé par défaut pour ce module (contrairement à la plupart des modules GKE, qui désactivent cette option par défaut).
application_domains[]Noms d'hôtes personnalisés + certificat géré ; fournissez-en un pour utiliser le domaine personnalisé.
reserve_static_iptrueIP externe stable sur les redéploiements.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC (nécessite des autorisations au niveau de l'organisation).
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

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 à la phase.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Audiobookshelf.
statefulset_nameNom du StatefulSet.
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_channelsÉtat et canaux de surveillance.
initialization_jobsNoms des jobs de configuration personnalisés (aucun par défaut).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat 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_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit 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).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur du socle App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'apply ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence si erreur
max_instance_count1CritiquePlusieurs pods écrivent dans la même base de données SQLite via le PVC partagé — corruption de la base de données.
stateful_pvc_enabledtrueCritiqueLe désactiver revient à un montage de type GCS-FUSE pour /data ; gcsfuse corrompt la base de données SQLite et l'index des fichiers multimédias d'Audiobookshelf.
CONFIG_PATH / METADATA_PATH (via environment_variables)laisser 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.
stateful_pvc_mount_path/dataCritiqueDoit rester synchronisé avec CONFIG_PATH/METADATA_PATH ; une non-concordance signifie que la base de données SQLite n'est jamais réellement persistante sur le PVC.
stateful_pvc_storage_classstandard (HDD) recommandé par rapport à la valeur par défaut standard-rwo (SSD)ÉlevéCe module utilise actuellement par défaut standard-rwo, qui utilise le quota régional strict SSD_TOTAL_GB (par exemple, seulement 500 Go sur Qwiklabs) ; la charge de travail SQLite/média d'Audiobookshelf n'a pas besoin d'IOPS SSD. Une campagne de plusieurs applications avec état basées sur SSD peut épuiser le quota — passez -var stateful_pvc_storage_class=standard pour utiliser HDD (pd-standard) à la place. Mettre la charge de travail à zéro ne libère pas le PVC ; seule sa suppression le fait.
container_port80CritiqueAudiobookshelf écoute sur le port 80 (PORT=80 injecté par Audiobookshelf_Common) ; une non-concordance fait échouer toutes les sondes de santé.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms (pertinent uniquement si enable_resource_quota = true).
enable_redisforcé false quelle que soit l'entréeFaibleAudiobookshelf n'a aucune utilité pour Redis ; la variante ignore cette variable et passe toujours false au socle.
application_versiontag épingléMoyenlatest se résout silencieusement en 2.17.0 épinglé ; épinglez explicitement pour contrôler les mises à niveau.
enable_custom_domain / application_domainstrue / définir un nom d'hôteMoyenLaissé true sans application_domains, le module revient à l'URL interne du cluster ou à l'IP du LoadBalancer plutôt qu'à un nom d'hôte stable.
enable_cloudsql_volumefalseFaibleAucun Cloud SQL n'existe ; l'activation gaspille un sidecar.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement du socle 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 à Audiobookshelf partagée avec la variante Cloud Run 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.