Aller au contenu principal

PhotoPrism sur GKE Autopilot

PhotoPrism sur GKE Autopilot

PhotoPrism est une application auto-hébergée de gestion de photos et de vidéos basée sur l'IA : elle parcourt, organise et partage une bibliothèque multimédia personnelle avec un étiquetage automatique, une reconnaissance faciale et une recherche plein texte/visuelle, le tout servi à partir d'un seul binaire Go avec une base de données SQLite intégrée. Ce module déploie PhotoPrism 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 utilisés par PhotoPrism et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide du socle App_GKE plutôt que de les répéter ici.


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

L'exécution de PhotoPrism dans votre propre projet Google Cloud coûte environ 45,68 $ US/mois en infrastructure, plus des frais de module uniques de 75 crédits RAD (dimensionnés à 1 vCPU / 2 Gio sur les pods GKE Autopilot). RAD facture les frais de module une seule fois, au moment du déploiement — jamais plus lors d'une mise à jour — et les builds sont inclus dans le prix ; l'utilisation de Google Cloud elle-même est facturée à votre propre compte de facturation au prix catalogue de Google. Sur un projet géré par RAD, les mêmes ressources sont mesurées à l'heure en crédits au prix catalogue plus la marge de RAD — environ 77 crédits/jour — et les frais de module sont 10 % inférieurs, à 67,50 crédits. Voir "Mettre en pause gratuitement" ci-dessous pour savoir comment un déploiement PhotoPrism géré par RAD peut être arrêté, sans frais d'exécution, jusqu'à ce que vous en ayez à nouveau besoin. (ou voir le guide Cloud Run pour l'option à moindre coût)

Ce que vous payez sur RAD​

ÉlémentVotre propre projetProjet géré par RAD
Frais de module75 crédits (une fois)67,50 crédits (une fois)
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 au temps de build à la minuteIdentique
Coût d'exécution Google Cloud~45,68 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google~77 crédits/jour, mesuré à l'heure au prix catalogue + marge de RAD

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

Ressource$/mois (prix catalogue Google, us-central1)
Pod GKE Autopilot, 1x vCPU / 2 Gio39,68
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Frais de gestion de cluster GKE*partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Total45,68 $

* Non inclus dans le total ci-dessus — il est partagé entre toutes les applications GKE exécutées dans le même projet, il est donc de 0 $ si c'est votre seul cluster GKE.

Comment cela se compare​

  • Nous n'avons pas pu vérifier un prix SaaS commercial actuel, directement comparable, pour ce projet open-source exact, donc la comparaison honnête est un serveur autogéré nu : Hetzner CPX22 (2 vCPU/4 Go, ~24 $/mois), un Droplet DigitalOcean 2 vCPU/4 Go (~24 $/mois), ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, ~49 $/mois).
  • RAD ne prétend pas battre un VPS nu sur le prix affiché — ce n'est généralement pas le cas. Ce que RAD ajoute pour un montant en dollars identique ou similaire, c'est une base de données gérée, des identifiants détenus par Secret Manager, une surveillance et une mise à jour en un clic, dont aucun un VPS nu ne vous offre gratuitement.
  • Sur un VPS nu, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, effectuez et testez les sauvegardes, et renouvelez les certificats ; les services Cloud SQL, Secret Manager et de surveillance gérés par RAD s'occupent des trois pour vous.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin​

C'est l'option phare sur un projet géré par RAD, et elle est gratuite pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet lui-même — la suppression logique récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne démolit pas la base de données, une VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend.

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 la 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 seulement faire gérer sa facturation par RAD), 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 que la plupart des utilisations d'étude et de démonstration conviennent). Google indique que la plupart des services sont à 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 logique de Cloud Storage explicitement désactivée, de sorte que le bucket de sauvegarde est très probablement parti 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é ce déploiement 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.

Payer uniquement pendant l'utilisation, l'autre méthode : supprimer et redéployer​

L'autre levier, pour un projet propre (ou un projet géré par RAD au-delà de sa fenêtre de restauration de 30 jours), est de supprimer PhotoPrism purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 75 crédits au total pour ce module.

La suppression ne permet d'économiser de l'argent que si PhotoPrism reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour ce module, cela représente environ 6 jours ou plus d'inactivité, sur la base de son propre coût d'exécution de 45,68 $ US/mois ci-dessus. La majeure partie de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée, et ils ne s'arrêtent que si rien d'autre dans le projet ne les utilise, de sorte que la suppression de cette application seule n'économise que sa propre part de calcul si quelque chose d'autre partage le projet.

Conserver les données en premier : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, 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 dispose de 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 cabinets 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 remet 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 frais propres de RAD et les estimations de crédits quotidiens ; Resource Manager : supprimer et restaurer des projets pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

PhotoPrism s'exécute comme une charge de travail web binaire Go unique, déployée en tant que StatefulSet avec une Persistent Volume Claim de type bloc plutôt qu'un Deployment sans état. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod PhotoPrism sur le port 2342, StatefulSet par défaut
Base de donnéesAucuneSQLite intégré (PHOTOPRISM_DATABASE_DRIVER=sqlite) — aucune instance Cloud SQL n'est provisionnée
Stockage de blocsPersistent Disk (PVC de type bloc)/photoprism (base de données SQLite, cache, originaux, importations) — obligatoire, gcsfuse ne peut pas sauvegarder SQLite en toute sécurité
Stockage d'objetsCloud StorageUn bucket storage est provisionné mais n'est monté via GCS FUSE que si la PVC de type bloc est désactivée
SecretsSecret ManagerMot de passe administrateur auto-généré (PHOTOPRISM_ADMIN_PASSWORD)
IngressCloud Load BalancingÉquilibreur de charge externe avec une IP statique réservée ; domaine personnalisé facultatif + certificat géré

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

  • Aucune base de données n'est jamais provisionnée. PhotoPrism_Common code en dur database_type = "NONE" et enable_cloudsql_volume = false ; PhotoPrism gère ses propres fichiers SQLite sous /photoprism/storage. Les variables GKE database_type/application_database_*/enable_mysql_plugins/etc. sont toutes des espaces réservés inertes transmis uniquement pour la compatibilité du socle.
  • La PVC de type bloc, et non gcsfuse, est obligatoire. stateful_pvc_enabled = true par défaut, résolvant workload_type en StatefulSet et montant un Persistent Disk standard-rwo (SSD) de 20 Gio à /photoprism. gcsfuse ne peut pas héberger SQLite ou l'index multimédia en toute sécurité, donc le module définit automatiquement enable_gcs_storage_volume = false sur la couche Common lorsque la PVC est activée, évitant un double montage au même chemin.
  • Réplica unique, toujours. min_instance_count = 1, max_instance_count = 1. PhotoPrism sert une seule bibliothèque SQLite partagée à partir d'un seul volume inscriptible — ne pas dépasser 1.
  • Redis est désactivé de force. La variable GKE enable_redis par défaut true (la valeur par défaut du socle App_GKE), mais PhotoPrism_GKE's main.tf la remplace en dur par false — PhotoPrism n'a pas d'intégration Redis, donc aucun hôte Redis Memorystore/NFS n'est jamais injecté.
  • NFS est désactivé par défaut (enable_nfs = false). La PVC de type bloc est le stockage durable ; NFS n'est pas nécessaire à moins d'ajouter des jobs/services personnalisés qui nécessitent un accès partagé au système de fichiers.
  • Le mot de passe administrateur est auto-généré. Un mot de passe de 24 caractères est créé et stocké dans Secret Manager, puis injecté comme variable d'environnement secrète PHOTOPRISM_ADMIN_PASSWORD ; le nom d'utilisateur administrateur est la variable simple admin_username (par défaut admin).
  • Le build d'image personnalisé est un miroir fin, pas une logique d'application. Le build enveloppe l'image amont photoprism/photoprism (FROM photoprism/photoprism:${PHOTOPRISM_VERSION}) afin que le socle puisse la refléter dans Artifact Registry ; l'argument de build spécifique à l'application est PHOTOPRISM_VERSION (pas le générique APP_VERSION), épinglé à 240915 lorsque application_version = "latest".

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

PhotoPrism s'exécute en tant que StatefulSet (et non un Deployment) afin que son pod unique obtienne une identité stable et un redémarrage ordonné, adapté à sa seule PVC de type bloc inscriptible. Autopilot facture le CPU/la mémoire que le pod demande réellement.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez le StatefulSet PhotoPrism pour les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc,statefulset -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail (Deployment vs StatefulSet) sont gérés.

B. Stockage de blocs persistant (Persistent Disk)​

Tout l'état de PhotoPrism — la base de données et le cache SQLite (/photoprism/storage), les médias importés (/photoprism/originals) et les importations en attente (/photoprism/import) — réside sur une seule PVC de type bloc par pod provisionnée par le StatefulSet à /photoprism, sauvegardée par la StorageClass standard-rwo (Persistent Disk équilibré / SSD) par défaut, d'une taille de 20Gi.

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

Voir App_GKE pour le provisionnement de PVC StatefulSet, les options de StorageClass et la mise en garde sur le quota GKE SSD_TOTAL_GB.

C. Cloud Storage​

Un bucket Cloud Storage dédié (suffixe storage) est provisionné par défaut (create_cloud_storage = true), mais il n'est monté dans le pod via GCS FUSE que lorsque la PVC de type bloc est désactivée (stateful_pvc_enabled = false) — dans la configuration par défaut du StatefulSet, le bucket existe mais n'est pas utilisé par le conteneur en cours d'exécution.

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

Voir App_GKE pour les options CMEK et les montages du pilote CSI GCS Fuse.

D. Secret Manager​

Un secret est généré automatiquement : le mot de passe administrateur de PhotoPrism (secret-<prefix>-photoprism-admin-password), injecté dans le conteneur en tant que PHOTOPRISM_ADMIN_PASSWORD. Sur GKE, les secrets sont projetés dans les pods via le pilote CSI Secret Store.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~photoprism-admin-password"
    gcloud secrets versions access latest --secret=<admin-password-secret-name> --project "$PROJECT"

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 un service LoadBalancer (service_type = "LoadBalancer") — PhotoPrism est une interface utilisateur web publique, pas une charge de travail de base de données ; passez à ClusterIP pour un accès interne uniquement, ou activez un domaine personnalisé (enable_custom_domain = true par défaut) via l'API Kubernetes Gateway avec un certificat géré par Google.

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

Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de 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. Un contrôle de disponibilité facultatif (uptime_check_config, désactivé par défaut) et des stratégies d'alerte personnalisées sont disponibles.

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

  • Pas de job d'initialisation/création de base de données. initialization_jobs par défaut à [] — il n'y a pas de base de données à amorcer. PhotoPrism crée et migre son propre schéma SQLite au premier démarrage, sous la PVC de type bloc montée.
  • Disposition du stockage. Tout l'état réside sous le répertoire monté unique /photoprism : PHOTOPRISM_STORAGE_PATH=/photoprism/storage (base de données SQLite + cache), PHOTOPRISM_ORIGINALS_PATH=/photoprism/originals (médias importés/indexés), PHOTOPRISM_IMPORT_PATH=/photoprism/import (importations en attente).
  • Compte administrateur. PHOTOPRISM_ADMIN_USER est la variable simple admin_username (par défaut admin) ; PHOTOPRISM_ADMIN_PASSWORD est la valeur auto-générée de Secret Manager, injectée comme variable d'environnement secrète. PHOTOPRISM_AUTH_MODE = "password" est défini explicitement. Récupérez le mot de passe de Secret Manager avant la première connexion.
  • URL du site. PHOTOPRISM_SITE_URL est vide par défaut — PhotoPrism le tolère et revient à l'hôte de la requête, mais définissez site_url à l'URL déployée pour des liens absolus correctement générés.
  • fsGroup pour la PVC. PhotoPrism s'exécute en tant que UID 1000 / GID 2000 ; le StatefulSet définit stateful_fs_group = 3000 (la convention du graphique Helm amont) afin que la PVC montée soit inscriptible par le groupe.
  • Chemin de santé. Les sondes de démarrage et de vivacité sont toutes deux HTTP GET /api/v1/status (délai initial de 15s / 10 tentatives pour le démarrage, 30s / 3 tentatives pour la vivacité) — aucune authentification requise. Les variables startup_probe_config/health_check_config du socle du groupe 10 reflètent le même chemin que les valeurs par défaut génériques.
  • La mise à l'échelle est limitée à un seul pod. min_instance_count = 1 et max_instance_count = 1 — PhotoPrism conserve une seule base de données SQLite inscriptible et un seul volume multimédia inscriptible ; il n'y a pas de prise en charge multi-écrivain.
  • Inspecter la configuration et le stockage en cours d'exécution :
    kubectl get pods,pvc -n "$NAMESPACE"
    kubectl exec -n "$NAMESPACE" statefulset/<service-name> -- env | grep PHOTOPRISM_
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100

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

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namephotoprismNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image photoprism/photoprism utilisé comme base de build personnalisé ; latest est épinglé à un tag connu et valide (240915) au moment du build.
admin_usernameadminNom d'utilisateur du compte administrateur initial (PHOTOPRISM_ADMIN_USER) ; le mot de passe est généré séparément.
site_url""URL publique du site (PHOTOPRISM_SITE_URL). Vide, revient à l'hôte de la requête ; à définir une fois que l'URL externe est connue pour des liens absolus corrects.

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

VariableValeur par défautDescription
cpu_limit1000mCPU alloué au conteneur PhotoPrism. L'indexation/la création de vignettes est limitée par le CPU ; augmentez pour les grandes bibliothèques.
memory_limit2GiMémoire allouée au conteneur. PhotoPrism charge les index vectoriels en mémoire ; 2 Gio est le minimum qui maintient la reconnaissance faciale/le support RAW activés — augmentez vers 4 Gio pour les grandes collections.
min_instance_count1Maintenez à 1 pour éviter les démarrages à froid pendant le chargement de l'index.
max_instance_count1Maintenez à 1 — base de données SQLite et volume multimédia inscriptibles uniques.
container_port2342Non transmis à App_GKE ; PhotoPrism sert toujours sur 2342, fixé par PhotoPrism_Common.
enable_cloudsql_volumefalsePas de sidecar Cloud SQL Auth Proxy — PhotoPrism n'a pas de base de données externe.

Groupe 7 — StatefulSet (PVC de type bloc)​

VariableValeur par défautDescription
stateful_pvc_enabledtrueObligatoire. gcsfuse ne peut pas sauvegarder SQLite/l'index multimédia en toute sécurité ; lorsque vrai sans workload_type explicite, se résout en StatefulSet et désactive automatiquement le volume de stockage GCS FUSE.
stateful_pvc_size20GiDimensionnez la PVC pour contenir toutes les collections plus les frais généraux.
stateful_pvc_mount_path/photoprismRépertoire de données de PhotoPrism — couvre storage (SQLite/cache) et originals.
stateful_pvc_storage_classstandard-rwoPD équilibré (SSD) — utilise le quota SSD_TOTAL_GB ; voir §6.
stateful_fs_group3000GID pour fsGroup au niveau du pod ; PhotoPrism s'exécute en tant que UID 1000/GID 2000.
stateful_pod_management_policynull → OrderedReadyRedémarrages sûrs et ordonnés pour une charge de travail à pod unique avec état.

Groupe 10 — Santé et observabilité​

VariableValeur par défautDescription
startup_probe (Common)HTTP /api/v1/status, 15s de délai, 10 tentativesAppliqué au conteneur PhotoPrism.
liveness_probe (Common)HTTP /api/v1/status, 30s de délai, 3 tentativesAppliqué au conteneur PhotoPrism.
uptime_check_configenabled = false, chemin /api/v1/statusContrôle de disponibilité externe facultatif ; désactivé par défaut.

Groupe 14 — Cloud Storage​

VariableValeur par défautDescription
create_cloud_storagetrueCrée le bucket storage même s'il n'est pas utilisé lorsque la PVC de type bloc (par défaut) est active.
gcs_volumes[]Montages GCS FUSE supplémentaires au-delà du volume de stockage PhotoPrism (géré automatiquement).

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redistrue (valeur par défaut de la variable) → forcé falsemain.tf remplace en dur cette valeur par false quelle que soit la valeur passée — PhotoPrism n'a pas d'intégration Redis.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixe — PhotoPrism n'a pas de base de données SQL (uniquement SQLite intégré). Toutes les autres variables database_*/application_database_*/plugin MySQL de ce groupe sont inertes, transmises uniquement pour la compatibilité du socle.

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

VariableValeur par défautDescription
enable_custom_domaintrueAPI Kubernetes Gateway + certificat géré.
application_domains[]Noms d'hôtes personnalisés ; requis si enable_custom_domain est laissé true sans solution de repli LoadBalancer.
reserve_static_iptrueIP externe stable entre les redéploiements.

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 interne au cluster.
stage_service_cluster_ipsCarte des ClusterIP pour les services spécifiques à l'étape.
service_external_ipIP de l'équilibreur de charge externe (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre PhotoPrism.
photoprism_admin_password_secret_idID du secret Secret Manager contenant le mot de passe administrateur généré.
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.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
initialization_jobsNoms des jobs d'initialisation personnalisés.
statefulset_nameNom du StatefulSet.
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 via le 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'au moment de l'application ou de l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
stateful_pvc_enabledtrueCritiqueLe désactiver revient à utiliser GCS FUSE, qui ne peut pas héberger SQLite ou l'index multimédia en toute sécurité — risque de corruption.
max_instance_count1CritiqueMettre à l'échelle au-delà de 1 donne à deux pods une seule base de données SQLite et une seule PVC inscriptibles — corruption/conflit de verrouillage.
stateful_pvc_storage_classstandard-rwo (SSD) — envisager standard (HDD)Moyen–Élevéstandard-rwo utilise le quota régional strict SSD_TOTAL_GB (500 Go sur Qwiklabs) ; une campagne d'applications avec état peut l'épuiser vers l'application n°8. PhotoPrism n'a pas besoin d'IOPS SSD pour la correction, seulement pour le débit d'indexation/de création de vignettes — remplacez par HDD (-var stateful_pvc_storage_class=standard) sur les projets soumis à des contraintes de quota.
enable_redisForcé false dans main.tfFaibleAucune action nécessaire — la substitution est intentionnelle et ne peut être annulée en définissant la variable true.
create_cloud_storagetrueFaibleLe bucket storage est créé mais inutilisé tant que la PVC de type bloc est active ; inoffensif, coût de stockage inactif mineur.
PHOTOPRISM_ADMIN_PASSWORD (auto-généré)Récupérer avant la première connexionMoyenNe pas le connaître vous empêche d'accéder au premier compte administrateur jusqu'à la réinitialisation via la base de données.
site_urlDéfinir sur l'URL déployée une fois connueMoyenLaissé vide, PhotoPrism revient à l'hôte de la requête ; les liens absolus/URL de vignettes peuvent être incorrects derrière un proxy ou un domaine personnalisé.
stateful_fs_group3000ÉlevéUn fsGroup non concordant ou non défini peut rendre la PVC non inscriptible par l'UID 1000/GID 2000 de PhotoPrism, bloquant le démarrage.
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.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer entre les redéploiements, rompant le DNS et site_url.
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 à PhotoPrism partagée avec la variante Cloud Run est décrite dans PhotoPrism_Common.

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