Aller au contenu principal

Seerr sur GKE Autopilot

Seerr sur GKE Autopilot

Seerr est la fusion en 2026 de Jellyseerr et Overseerr — une interface utilisateur de requêtes open source, sous licence MIT, qui se place devant un serveur multimédia Jellyfin, Plex ou Emby. Les utilisateurs parcourent et demandent des titres ; un administrateur approuve la requête, et Seerr appelle les API de Sonarr et Radarr pour déclencher l'acquisition. Ce module déploie Seerr sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud que Seerr 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 GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_GKE plutôt que de les répéter ici.


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

L'exécution de Seerr dans votre propre projet GCP coûte environ 149,81 $/mois en frais Google Cloud ; les frais de module de RAD sont de 110 crédits uniques (ou 99 crédits dans un projet géré par RAD), couvrant la configuration et le support — pas la facture cloud continue, que Google vous facture directement dans votre propre projet ou que RAD mesure à l'heure en crédits dans un projet géré par RAD. Ou consultez le guide Cloud Run pour la cible de déploiement alternative ; dans tous les cas, si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement lorsque vous ne l'utilisez pas — voir Mettez-le en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits, une fois99 crédits, une fois (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 Cloud~149,81 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~141 crédits/jour, mesuré à l'heure par RAD au prix catalogue plus marge

Pourquoi les deux colonnes diffèrent. Le chiffre du projet géré par RAD inclut les frais de gestion du cluster GKE (environ 73 US$ par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore assez d'historique GKE géré par RAD pour le mesurer, 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).

Coût d'exécution par défaut dans votre propre projet

RessourceUS$/mois (prix catalogue Google, us-central1)
Pod GKE Autopilot, 2x vCPU / 4 Gio79,35 $
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $
Serveur de fichiers NFS/cache (petite VM)13,43 $
Cloud NAT et réseau5,00 $
Cloud Storage (modules complémentaires, sauvegardes)1,00 $
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Total149,81 $

Comment cela se compare​

  • L'exécuter vous-même sur un VPS nu reste l'option la moins chère en espèces — Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un Droplet DigitalOcean 2 vCPU/4 Go coûte également 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) coûte environ 49 $/mois — plus le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous — mais le prix de RAD n'est jamais destiné à battre un VPS, seulement à remplacer le temps d'administration qu'un VPS nécessite encore.
  • Seerr se trouve devant un serveur multimédia domestique plutôt que l'internet public, il fonctionne donc en continu mais avec un faible trafic — notez que ce module nécessite alwaysOn de calcul pour maintenir l'acquisition déclenchée par les requêtes réactive, c'est pourquoi son propre coût d'exécution est plus élevé que la plupart des applications de ce lot.

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

C'est le titre pour un projet géré par RAD. 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 — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL, aucune VM ni la ressource de calcul une par une : 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.

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 de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

La restauration, 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 ê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 niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude/démo). Google affirme que la plupart des services sont à nouveau pleinement opérationnels 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. Si vous avez personnalisé l'application et que vous souhaitez conserver ce travail, copiez 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​

Dans votre propre projet (ou une fois que vous avez dépassé la fenêtre de restauration de 30 jours ci-dessus), l'alternative est de supprimer Seerr purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 110 crédits.

La suppression ne permet d'économiser de l'argent que si Seerr reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution quotidien — par rapport au total du projet ci-dessus, cela représente environ 2 jours ou plus. La majeure partie du coût d'exécution ici est généralement la base de données et la VM NFS/cache ; elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.

Conservez les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, afin que personne ne reçoive 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; https://cloud.google.com/resource-manager/docs/delete-restore-projects pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

Seerr s'exécute comme un seul pod Node.js/Next.js. Le déploiement relie un petit ensemble de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod de processus Node.js unique, 2 vCPU / 4 Gio par défaut
Base de donnéesCloud SQL PostgreSQL 15Contient les données de requête/utilisateur ; les migrations s'exécutent automatiquement à chaque démarrage de pod
Stockage d'objetsCloud StorageUn bucket storage monté à /app/config via GCS FUSE (ou un PVC StatefulSet facultatif) — contient settings.json, les propres paramètres de l'application Seerr
Cache et file d'attenteaucunSeerr n'a pas de dépendance Redis ou de file d'attente
SecretsSecret ManagerSeulement le mot de passe de la base de données généré — le premier administrateur de Seerr provient de l'assistant de configuration web de l'application
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré

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

  • Véritablement pré-construit — pas d'image personnalisée. Le répertoire Seerr_Common de scripts/ est vide. container_image_source = "prebuilt" déploie ghcr.io/seerr-team/seerr directement.
  • DB_TYPE=postgres est défini inconditionnellement par Seerr_Common — voir le §3 du guide Cloud Run pour l'explication complète ; le même piège et la même correction s'appliquent ici.
  • Port 5055, chemin de santé /api/v1/status. Confirmé via des tests locaux docker run et un déploiement en direct (le pod a signalé 3/3 Running, GET /api/v1/status a renvoyé du JSON réel via kubectl exec).
  • Un bug de permission GCS-FUSE spécifique à GKE, trouvé et corrigé. Le conteneur de Seerr s'exécute en tant que uid=1000/gid=1000. L'intégration gcsfuse de Cloud Run applique automatiquement cet UID/GID au montage ; le pilote CSI GKE GCS FUSE ne le fait pas — sans correction explicite, le pod boucle en cas de crash au premier démarrage avec EACCES: permission denied en essayant de créer /app/config/logs/. Seerr_Common monte le volume avec uid=1000, gid=1000, file-mode=0664, dir-mode=0775 pour corriger cela. Voir §3.
  • Deux éléments d'état distincts. PostgreSQL contient les données de requête/utilisateur. Les propres paramètres de l'application Seerr (serveurs multimédias connectés, curseurs de découverte, agents de notification) vivent dans un simple fichier settings.json sous /app/config — quel que soit le backend de la base de données.
  • DB_PASS, pas DB_PASSWORD. La source de données TypeORM de Seerr lit une variable d'environnement DB_PASS nommée spécifiquement. Ce module définit db_password_env_var_name = "DB_PASS" pour correspondre.

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.

A. GKE Autopilot — la charge de travail Seerr​

  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100

B. Cloud SQL — données de requête/utilisateur​

  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql databases list --instance=<instance-name> --project "$PROJECT"

C. Stockage — Cloud Storage ou un PVC de bloc​

  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~seerr"
    kubectl get pvc -n "$NAMESPACE" # only when stateful_pvc_enabled = true

D. Secret Manager​

  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~seerr"

E. Réseau et ingress​

  • CLI :
    kubectl get svc -n "$NAMESPACE" -o wide

F. Cloud Logging et Monitoring​

  • CLI :
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 -f

3. Comportement de l'application Seerr​

  • Pas de job de schéma de base de données au premier déploiement. Le dist/index.js de Seerr appelle dbConnection.runMigrations() explicitement à chaque démarrage de pod, il n'y a donc pas de job d'initialisation dans ce module et aucun n'est nécessaire. initialization_jobs est vide par défaut.
  • La configuration initiale se fait entièrement dans l'interface web de l'application. Il n'y a aucune information d'identification d'administrateur pré-remplie — connectez-vous au service et complétez l'assistant de configuration de Seerr : serveur multimédia d'abord, puis Sonarr/Radarr.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux GET /api/v1/status.
  • Inspecter l'exécution du job (ne devrait rien afficher, par conception) :
    kubectl get jobs -n "$NAMESPACE"

⚠ Le bug UID/GID de GCS-FUSE — le piège spécifique à GKE que ce module corrige​

Le conteneur de Seerr s'exécute en tant que uid=1000/gid=1000 (l'utilisateur node — confirmé via docker run ghcr.io/seerr-team/seerr id), et au premier démarrage tente mkdir '/app/config/logs/'.

  • Sur Cloud Run, l'intégration gcsfuse de la plateforme applique automatiquement uid:1000/gid:1000 au volume monté, cela fonctionne donc sans configuration supplémentaire.
  • Sur GKE, le pilote CSI GCS FUSE ne définit pas par défaut un UID inscriptible. Un montage gcs_volumes nu est détenu par root, et le conteneur non-root boucle en cas de crash avec EACCES: permission denied.

Seerr_Common corrige cela en définissant des mount_options explicites sur le volume de stockage qu'il déclare pour /app/config :

mount_options = [
"implicit-dirs", "stat-cache-ttl=60s", "type-cache-ttl=60s",
"uid=1000", "gid=1000", "file-mode=0664", "dir-mode=0775",
]

Il s'agit d'une classe de bugs connue dans ce catalogue — la même forme de défaillance a été précédemment trouvée et corrigée sur les variantes GKE de Paperless, CodeServer et CloudBeaver (voir la découverte "GKE gcsfuse UID/GID permission denied" du dépôt CLAUDE.md). Seerr est la dernière instance confirmée, maintenant corrigée au niveau Seerr_Common afin que les deux modules d'application héritent de la correction uniformément.

Indicateur de diagnostic, si vous rencontrez ce symptôme sur un fork de ce module :

kubectl describe pod -n "$NAMESPACE" <seerr-pod>
# Look for: EACCES: permission denied, mkdir '/app/config/logs/'

4. Variables de configuration​

Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Seerr sont listés ; toute autre entrée est héritée de App_GKE avec son comportement standard.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameseerrNom de base des ressources.
application_display_nameSeerrNom lisible par l'homme affiché dans l'interface utilisateur de la plateforme.
application_versionlatestTiré directement comme étiquette d'image ghcr.io/seerr-team/seerr — aucune étape de build n'est impliquée.

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

VariableValeur par défautDescription
container_port5055Confirmé via docker run local et déploiement en direct ; le service K8s et les sondes doivent tous être d'accord sur cette valeur.
container_image_sourceprebuiltSeerr ne prend en charge que l'image officielle ; Seerr_Common la code également en dur en interne.
min_instance_count / max_instance_count1 / 5Voir §6 ci-dessous.

Groupe 31 — Configuration du StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledfalsesettings.json est un petit état JSON de fichier entier — sûr sur un volume GCS FUSE à max_instance_count = 1, donc un PVC de bloc est facultatif ici, contrairement aux applications SQLite en mode WAL de ce catalogue.
stateful_pvc_mount_path/app/configCorrespond au chemin de montage par défaut de GCS FUSE.
stateful_pvc_storage_classstandardHDD pd-standard — settings.json n'a pas besoin de IOPS élevées.

Groupe 16 — Base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Requis — Seerr n'a pas de chemin non-Postgres.
application_database_name / application_database_userseerr / seerrTransmis à Seerr_Common, injecté comme DB_NAME/DB_USER.
db_password_env_var_nameDB_PASSCritique — la source de données de Seerr lit spécifiquement DB_PASS, et non le DB_PASSWORD par défaut de la Fondation.

Groupe 11 — Automatisation de la charge de travail​

VariableValeur par défautDescription
initialization_jobs[]Vide et reste généralement ainsi — dbConnection.runMigrations() s'exécute à chaque démarrage de pod au sein de l'application elle-même.

Groupe 14 — Cloud Storage​

VariableValeur par défautDescription
gcs_volumes[]Le montage du bucket storage avec correction de permissions à /app/config est ajouté automatiquement (voir §3) ; utilisez ceci uniquement pour des volumes supplémentaires.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / liveness_probeHTTP /api/v1/status (via Seerr_Common)Point de terminaison de statut JSON 200 non authentifié ; la valeur par défaut variables.tf de la variante (HTTP /) est remplacée par la valeur par défaut plus précise de Seerr_Common.

5. Sorties​

SortieDescription
service_name / service_url / service_external_ipIdentité et adresse du service Kubernetes.
database_instance_name / database_name / database_user / database_password_secretIdentifiants de l'instance Cloud SQL et de la base de données Seerr.
storage_bucketsLe bucket storage supportant /app/config (inutilisé comme montage si stateful_pvc_enabled = true).
kubernetes_readyIndique si la charge de travail a atteint l'état Prêt.

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 erroné
Variable d'environnement DB_TYPELaissez la valeur par défaut de Seerr_Common (postgres) intacteCritiqueDB_TYPE manquant/écrasé place silencieusement Seerr sur un fichier SQLite par pod effacé à chaque redémarrage.
GCS FUSE mount_options sur /app/configLaissez la correction uid=1000/gid=1000 de Seerr_Common en placeCritiqueSans cela, le pod boucle en cas de crash avec EACCES: permission denied au premier démarrage — un mode de défaillance spécifique à GKE non observé sur Cloud Run.
db_password_env_var_nameLaissez à DB_PASSCritiqueLa source de données TypeORM de Seerr ne lit que DB_PASS ; le DB_PASSWORD par défaut de la Fondation n'est jamais lu seul.
max_instance_countDéfinissez 1 si les changements de paramètres ne doivent jamais être en concurrenceMoyensettings.json est un fichier unique et mutable — des écritures concurrentes de plusieurs pods risquent une perte d'écriture. La valeur par défaut du module est 5, plus lâche que la valeur sûre pour un seul rédacteur.
stateful_pvc_enabledLaissez false à moins d'avoir une raison spécifique pour le stockage par blocsFaiblesettings.json n'a pas besoin de verrouillage de fichier POSIX comme le ferait une application SQLite en mode WAL ; GCS FUSE est une valeur par défaut appropriée ici, contrairement aux applications qui nécessitent réellement un véritable périphérique de bloc.

Pour le comportement de la fondation référencé tout au long — Workload Identity, ingress, autoscaling, 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 à Seerr partagée avec la variante Cloud Run est décrite dans Seerr_Common.

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