PhotoPrism sur Google Cloud Run
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, la reconnaissance faciale et la recherche textuelle/visuelle, le tout servi à partir d'un seul binaire Go avec une base de données SQLite intégrée — pas de moteur de base de données externe, pas de processus worker séparé. Ce module déploie PhotoPrism sur Cloud Run v2 en mode SQLite intégré, soutenu par GCS sur la base App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par PhotoPrism 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 Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.
Ce que coûte PhotoPrism sur RAD, et comment cela se compare
L'exécution de PhotoPrism dans votre propre projet Google Cloud coûte environ 25,72 $ US/mois en infrastructure, plus des frais de module uniques de 75 crédits RAD (dimensionnés à 1 vCPU / 2 Gio sur une instance Cloud Run chaude toujours active). 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 19 crédits/jour — et les frais de module sont inférieurs de 10 %, soit 67,50 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement PhotoPrism géré par RAD peut être arrêté, sans frais de fonctionnement, jusqu'à ce que vous en ayez à nouveau besoin. (ou voir le guide GKE si vous avez besoin de Kubernetes)
Ce que vous payez sur RAD
| Article | Votre propre projet | Projet géré par RAD |
|---|---|---|
| Frais de module | 75 crédits (une fois) | 67,50 crédits (une fois) |
| Builds | Inclus 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 build | Idem |
| Coût de fonctionnement Google Cloud | ~25,72 $/mois, facturé à votre propre compte de facturation au prix catalogue de Google | ~19 crédits/jour, mesurés à 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 des frais : 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 de fonctionnement par défaut dans votre propre projet
| Ressource | US$/mois (prix catalogue Google, us-central1) |
|---|---|
| Cloud Run, 1x vCPU / 2 Gio (chaud) | 19,72 |
| Cloud NAT et réseau | 5 |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 |
| Total | 25,72 $ |
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 le même montant ou un montant similaire est une base de données gérée, des identifiants stockés dans Secret Manager, la surveillance et la mise à jour en un clic, dont aucun n'est offert gratuitement par un VPS nu.
- 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 ; Cloud SQL géré, Secret Manager et la surveillance de RAD gèrent les trois pour vous.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le 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 commence par délier sa facturation, puis demande à Google de supprimer le projet lui-même — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un seul module, cela ne démantèle 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 avoir RAD qui gère sa facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox que la plupart des utilisations d'étude et de démo conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, 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.
Payez uniquement pendant que vous l'utilisez, 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 que le coût de redéploiement soit inférieur à son propre coût de fonctionnement — pour ce module, cela représente environ 10 jours ou plus d'inactivité, sur la base de son coût de fonctionnement de 25,72 $ US/mois mentionné ci-dessus. La majeure partie de ce coût de fonctionnement est généralement la base de données et toute VM de fichier/cache partagée, et elles ne s'arrêtent que lorsque 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 autre chose partage le projet.
Conservez d'abord les données : 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 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, 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais 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 un conteneur binaire Go unique sur Cloud Run v2, épinglé à exactement une instance. Le déploiement relie un ensemble délibérément restreint de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur binaire Go sur le port 2342, 1 vCPU / 1 Gio par défaut ; instance unique toujours (min=1, max=1) — pas de mise à l'échelle à zéro, pas de mise à l'échelle horizontale |
| Base de données | Aucune | SQLite intégré (PHOTOPRISM_DATABASE_DRIVER=sqlite) — aucune instance Cloud SQL n'est provisionnée par défaut |
| Stockage persistant | Cloud Storage (GCS FUSE) | La seule couche de persistance sur cette variante — l'intégralité du répertoire de données /photoprism (base de données SQLite, cache, originaux, importations) est montée à partir d'un seul bucket GCS via GCS FUSE |
| Secrets | Secret Manager | Auto-généré PHOTOPRISM_ADMIN_PASSWORD |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL par défaut run.app (ingress_settings = "all") ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- Aucune base de données n'est jamais provisionnée par défaut.
database_typepar défaut à"NONE"etenable_cloudsql_volumeest codé en durfalsedansmain.tf— PhotoPrism gère son propre fichier SQLite sous/photoprism/storage. Contrairement à la variante GKE (qui code en durdatabase_type = "NONE"inconditionnellement), ce module Cloud Run transfère toujoursvar.database_typeà la fondation — voir le piège dans le §6 si vous le modifiez deNONE. - GCS FUSE est le seul mécanisme de persistance — il n'y a pas d'option PVC de bloc sur Cloud Run. La description du module le dit clairement : "Ce module déploie PhotoPrism sur Cloud Run en mode SQLite intégré avec un volume de données soutenu par GCS. Pour les bibliothèques multimédias de production nécessitant un volume de bloc durable, utilisez PhotoPrism_GKE (PVC de bloc)." Le modèle d'écriture/cohérence de gcsfuse est plus faible qu'un véritable périphérique de bloc pour les fichiers WAL/journal de SQLite ; l'épinglage à instance unique (ci-dessous) est ce qui le rend sûr plutôt que toute garantie de verrouillage de gcsfuse lui-même.
- Instance unique, toujours.
min_instance_count = 1etmax_instance_count = 1sont tous deux par défaut et décrits comme fixes — PhotoPrism sert une bibliothèque SQLite partagée à partir d'un volume inscriptible ; l'exécution de deux instances sur le même bucket monté par gcsfuse risque la corruption de la base de données et de l'index. - Redis est désactivé de force, quelle que soit la variable. La valeur par défaut de la fondation App_CloudRun pour
enable_redisesttrue, maismain.tfcode en durenable_redis = falseinconditionnellement — PhotoPrism n'a pas d'intégration Redis et aucunREDIS_HOST/REDIS_PORTn'est jamais injecté. - Le mot de passe administrateur est auto-généré. Un mot de passe de 24 caractères (sans caractères spéciaux) est créé et stocké dans Secret Manager, puis injecté comme variable d'environnement secrète
PHOTOPRISM_ADMIN_PASSWORD; le nom d'utilisateur est la variable simpleadmin_username(par défautadmin). - La construction d'image personnalisée est un miroir mince, pas une logique d'application. La construction enveloppe l'image amont
photoprism/photoprism(FROM photoprism/photoprism:${PHOTOPRISM_VERSION}) afin que la fondation puisse la refléter dans Artifact Registry ; l'ARG de construction spécifique à l'application estPHOTOPRISM_VERSION(pas le génériqueAPP_VERSION), épinglé à240915lorsqueapplication_version = "latest". - L'environnement d'exécution
gen2est obligatoire. Les volumes GCS FUSE nécessitentexecution_environment = "gen2"(la valeur par défaut) ; passer àgen1rompt complètement le montage du stockage. - Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux le point de terminaison non authentifié
GET /api/v1/status.
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 PhotoPrism (instance unique)
PhotoPrism s'exécute en tant que service Cloud Run v2 épinglé à exactement une instance
(min_instance_count = max_instance_count = 1) — il n'y a pas de plage d'autoscaling à
régler. Chaque déploiement crée une révision immuable ; le trafic peut toujours être réparti
entre les révisions pour des déploiements progressifs, mais l'exécution de deux révisions servant du trafic en direct
simultanément risque deux rédacteurs sur le même fichier SQLite monté par gcsfuse.
- Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux 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 volume persistant GCS FUSE
Un bucket Cloud Storage dédié (suffixe de nom storage_buckets storage) est
provisionné automatiquement et monté dans le conteneur en tant que volume GCS FUSE à
/photoprism (entrée gcs_volumes name = "storage", mount_path = "/photoprism",
non en lecture seule). Ce montage unique couvre tout ce que PhotoPrism persiste :
/photoprism/storage (base de données SQLite + cache de vignettes), /photoprism/originals
(médias importés/indexés) et /photoprism/import (importations en attente). Des
buckets supplémentaires peuvent être déclarés via storage_buckets ; des montages GCS FUSE supplémentaires via
gcs_volumes.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
gcloud storage ls gs://<storage-bucket>/photoprism/originals/ # bucket name is in the Outputs
Voir App_CloudRun pour les options de montage GCS Fuse et CMEK.
C. Secret Manager
Un secret est généré automatiquement : le mot de passe administrateur de PhotoPrism
(secret-<prefix>-photoprism-admin-password), une chaîne aléatoire de 24 caractères sans
caractères spéciaux, injectée sous le nom PHOTOPRISM_ADMIN_PASSWORD. Il n'y a pas de mot de passe de base de données
à gérer car aucune instance Cloud SQL n'existe par défaut.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~admin-password"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_CloudRun pour les détails d'injection et de rotation.
D. Réseau et ingress
Le service est accessible par son URL run.app par défaut (ingress_settings = "all"), ce qui permet un accès direct à l'interface utilisateur web. Un équilibreur de charge HTTPS externe
avec un domaine personnalisé, Cloud CDN et Cloud Armor peut être superposé ; les paramètres d'ingress
et le contrôle d'egress VPC contrôlent la connectivité.
- Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
- CLI :
gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
gcloud compute addresses list --project "$PROJECT"
Voir App_CloudRun.
E. Cloud Logging et Monitoring
Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec une vérification de disponibilité facultative (désactivée par défaut) et des politiques d'alerte personnalisées.
- Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
3. Comportement de l'application PhotoPrism
- Pas de job d'initialisation/création de base de données par défaut.
initialization_jobspar défaut à[]— il n'y a pas de base de données externe à amorcer. PhotoPrism crée et migre son propre schéma SQLite au premier démarrage, directement sur le volume monté par gcsfuse. - 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_USERest la variable simpleadmin_username(par défautadmin) ;PHOTOPRISM_ADMIN_PASSWORDest 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_URLest vide par défaut — PhotoPrism tolère cela et revient à l'hôte de la requête, mais définissezsite_urlsur l'URL Cloud Run déployée pour des liens absolus et des URL de vignettes correctement générés. - Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux
GET /api/v1/status, un point de terminaison non authentifié qui renvoie 200 une fois que le serveur HTTP est opérationnel et que l'index SQLite est prêt. La sonde de démarrage permet environ 15s + 10×10s (~1 minute 55 secondes) après le délai initial pour la création du schéma au premier démarrage et le réchauffement de l'index ; la sonde de vivacité revérifie toutes les 30 secondes avec un seuil de 3 échecs. - Pas de mise à l'échelle horizontale, pas de coordination de file d'attente. Parce que l'état complet de l'application — base de données SQLite, index, cache de vignettes et originaux — réside sur un seul volume gcsfuse inscriptible, PhotoPrism doit s'exécuter en une seule instance (
min_instance_count = max_instance_count = 1) ; il n'y a pas de prise en charge multi-rédacteurs. - Inspecter la configuration et le stockage en cours d'exécution :
gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT" \
--format='value(spec.template.spec.containers[0].env)' | tr ',' '\n' | grep PHOTOPRISM_
gcloud run jobs list --project "$PROJECT" --region "$REGION" # empty unless custom jobs were added
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 ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
support_users | [] | E-mails autorisés à accéder au projet et aux alertes de surveillance. |
resource_labels | {} | Étiquettes appliquées à toutes les ressources. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | photoprism | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | PhotoPrism | Nom lisible par l'homme affiché dans la console. |
description | PhotoPrism — AI-powered photo management app | Description du service. |
application_version | latest | Tag d'image photoprism/photoprism utilisé comme base de build personnalisée ; latest est épinglé à un tag connu et fonctionnel (240915) au moment du build. |
admin_username | admin | Nom d'utilisateur initial du compte administrateur (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 Cloud Run est connue pour des liens absolus corrects. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
cpu_limit | 1000m | CPU par instance. |
memory_limit | 2Gi | "PhotoPrism charge les index vectoriels en mémoire ; dimensionnez-le en fonction de vos collections." 2 Gio est le minimum qui maintient la reconnaissance faciale/le support RAW activés — la valeur par défaut de PhotoPrism_Common est 4Gi pour les charges de travail d'indexation réelles sur de grandes bibliothèques. |
min_instance_count | 1 | Fixé à 1 pour éviter les démarrages à froid pendant le chargement de l'index. |
max_instance_count | 1 | Maintenir à 1 — une seule instance PhotoPrism pour la cohérence des données. |
container_port | 2342 | Port du serveur HTTP de PhotoPrism. |
execution_environment | gen2 | Obligatoire — les volumes GCS FUSE ne fonctionnent qu'avec gen2. |
timeout_seconds | 300 | Durée maximale de la requête (0–3600 secondes). |
enable_cloudsql_volume | false | Également codé en dur false dans main.tf quelle que soit cette variable — PhotoPrism n'a pas de Cloud SQL. |
container_protocol | http1 | HTTP/1.1 est suffisant ; PhotoPrism ne nécessite pas h2c. |
enable_image_mirroring | true | Mettre en miroir l'image basée sur photoprism/photoprism construite dans Artifact Registry. |
traffic_split | [] | Répartir le trafic entre les révisions pour les déploiements progressifs. |
max_revisions_to_retain | 7 | Déclaré pour la parité de convention ; non référencé par le déploiement de ce module. |
Groupe 5 — Contrôle d'accès et d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | all permet un accès direct à l'interface utilisateur web. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Acheminer uniquement le trafic RFC 1918 via VPC. |
enable_iap | false | Exiger la connexion Google devant l'interface utilisateur. |
iap_authorized_users / iap_authorized_groups | [] | Qui peut accéder via IAP. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres non secrets supplémentaires (par exemple, réglage PHOTOPRISM_* supplémentaire). Ne pas définir PHOTOPRISM_ADMIN_PASSWORD ici. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. |
secret_propagation_delay | 30 | Secondes à attendre après la création du secret avant de continuer. |
secret_rotation_period | 2592000s | Fréquence de notification de rotation de Secret Manager. |
Groupe 7 — Sauvegarde et maintenance
| Variable | Valeur par défaut | Description |
|---|---|---|
backup_schedule | 0 2 * * * | Cron de sauvegarde automatisée (UTC). |
backup_retention_days | 7 | Rétention ; augmenter pour la production/conformité. |
enable_backup_import | false | Restaurer à partir d'une sauvegarde lors du déploiement. |
backup_source | gcs | gcs ou gdrive. |
backup_uri | "" | Emplacement de la sauvegarde ; utilisé uniquement lorsque enable_backup_import = true. |
backup_format | tar | Puisque PhotoPrism n'a pas de base de données SQL, une restauration de sauvegarde est une archive de système de fichiers du bucket média/bibliothèque, pas un dump de base de données — gardez ceci orienté archive de fichiers (tar/zip/etc.), pas sql. |
Groupe 8 — CI/CD et autorisation binaire
Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir
App_CloudRun. Entrées clés : enable_cicd_trigger,
github_repository_url, github_token, enable_cloud_deploy,
enable_binary_authorization.
Groupe 9 — Instance NFS et SQL personnalisé
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_sql_scripts | false | Non applicable — PhotoPrism n'a pas de base de données SQL. |
custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root | (vide) | Non applicable à PhotoPrism. |
nfs_instance_name / nfs_instance_base_name | "" / app-nfs | Découverte facultative de VM NFS préexistante/intégrée. Transféré mais inutilisé par défaut — PhotoPrism s'appuie sur le volume GCS FUSE, pas NFS, pour la persistance (enable_nfs = false). |
Groupe 10 — Équilibreur de charge, CDN et rétention d'images
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_cloud_armor | false | Provisionner un équilibreur de charge HTTPS global + WAF Cloud Armor. |
admin_ip_ranges | [] | Plages CIDR exemptées des règles WAF. |
application_domains | [] | Noms de domaine personnalisés pour l'équilibreur de charge HTTPS. |
enable_cdn | false | Activer Cloud CDN sur le backend de l'équilibreur de charge HTTPS — attention aux réponses photo/média mises en cache si activé. |
max_images_to_retain / delete_untagged_images / image_retention_days | 7 / true / 30 | Politique de nettoyage d'Artifact Registry. |
Groupe 11 — Stockage, système de fichiers et Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Crée le bucket storage auto-provisionné ainsi que tout ce qui se trouve dans storage_buckets. |
storage_buckets | [] | Buckets GCS supplémentaires au-delà du bucket de données PhotoPrism auto-provisionné. |
enable_nfs | false | Désactivé par défaut et non nécessaire — le volume GCS FUSE est le stockage principal de PhotoPrism sur cette variante. |
nfs_mount_path | /mnt/nfs | Inerte sauf si enable_nfs = true. |
gcs_volumes | [] | Montages GCS FUSE supplémentaires ; le volume PhotoPrism storage à /photoprism est ajouté automatiquement par PhotoPrism_Common. |
manage_storage_kms_iam / enable_artifact_registry_cmek | false | Options CMEK. |
enable_redis | true (valeur par défaut de la variable) → forcé false | main.tf code en dur enable_redis = false quelle que soit cette valeur — PhotoPrism n'a pas d'intégration Redis. |
redis_host / redis_port / redis_auth | "" / 6379 / "" | Inerte — jamais injecté puisque Redis est désactivé de force. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Aucune base de données SQL n'est utilisée par PhotoPrism. Contrairement à la variante GKE, cette valeur est toujours transmise à la fondation — voir le piège au §6 avant de la modifier. |
database_password_length | 32 | Inerte — aucun mot de passe de base de données n'est jamais généré tant que database_type = NONE. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Pas de job d'initialisation intégré — PhotoPrism amorce son propre schéma SQLite. Ajoutez des jobs personnalisés uniquement pour des tâches de chargement/maintenance de données sur mesure. |
cron_jobs | [] | Pas de tâches récurrentes planifiées par la plateforme par défaut (par exemple, on pourrait en ajouter une pour des instantanés périodiques de la bibliothèque). |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /api/v1/status, délai de 15s, période de 10s, seuil de 10 échecs | Sonde de démarrage principale (fenêtre d'environ 1m55s après le délai). |
liveness_probe | HTTP /api/v1/status, délai de 30s, période de 30s, seuil de 3 échecs | Sonde de vivacité principale. |
startup_probe_config | enabled = true, chemin /api/v1/status | Surface de sonde de démarrage structurée alternative. |
health_check_config | enabled = true, chemin /api/v1/status | Surface de sonde de vivacité structurée alternative (même mise en garde de précédence que ci-dessus). |
uptime_check_config | { enabled = false, path = "/api/v1/status" } | Vérification de disponibilité Cloud Monitoring ; désactivée par défaut. |
alert_policies | [] | Politiques d'alerte métrique. |
Groupe 23 — VPC Service Controls et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC (nécessite organization_id). |
vpc_cidr_ranges / vpc_sc_dry_run | (défini) | CIDR de niveau d'accès / mode simulation. |
organization_id | "" | Remplacement pour les projets imbriqués dans des dossiers. |
enable_audit_logging | false | Journaux d'audit Cloud détaillés. |
Toutes les autres entrées suivent le comportement standard de App_CloudRun.
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.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
photoprism_url | L'URL du service Cloud Run. La description de la sortie elle-même l'appelle une "URL VPC interne… uniquement accessible au sein du même VPC lorsque ingress_settings est 'internal'" — mais ingress_settings par défaut à all (public) ; vérifiez l'accessibilité réelle du service déployé par rapport à votre propre valeur ingress_settings plutôt que de supposer d'après le nom de la sortie. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
storage_buckets | Buckets Cloud Storage créés, y compris le bucket GCS FUSE PhotoPrism storage. |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | État de la surveillance, canaux, vérifications de disponibilité. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
initialization_jobs | Noms des jobs d'initialisation personnalisés (vide par défaut). |
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_id | Registre 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_enabled | Journalisation d'audit et état CMEK. |
Notez qu'il n'y a pas de sorties database_* — aucune instance Cloud SQL n'est provisionnée par
défaut (contrairement aux modules de style Activepieces/BookStack).
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — IAP sans identités autorisées, un runtime
gen1avec des montages GCS Fuse, uncontainer_port/backup_retention_dayshors plage. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
max_instance_count / min_instance_count | 1 / 1 | Critique | La mise à l'échelle au-delà de 1 donne à deux instances une seule base de données SQLite montable par gcsfuse inscriptible — risque de corruption/conflit de verrouillage, pire qu'un PVC de bloc car le modèle de cohérence de gcsfuse est plus faible. |
execution_environment | gen2 | Critique | gen1 ne peut pas monter les volumes GCS FUSE — l'intégralité du répertoire de données /photoprism (DB, médias) ne parvient pas à se connecter et l'application ne peut pas démarrer. |
database_type | NONE | Moyen | Contrairement à PhotoPrism_GKE (qui code en dur NONE), ce module transmet toujours la variable à la fondation. La définir sur MYSQL/POSTGRES provisionne une instance Cloud SQL réelle et facturée que PhotoPrism_Common ne connecte jamais à l'application (aucun DB_HOST/DB_USER n'est consommé) — coût gaspillé sans avantage fonctionnel. |
enable_redis | Forcé false dans main.tf | Faible | Aucune action nécessaire — la surcharge est intentionnelle et ne peut être annulée en définissant la variable true. |
enable_cloudsql_volume | false (par défaut et codé en dur) | Faible | Ne peut pas être activé même en définissant la variable — à titre informatif uniquement. |
memory_limit | 2Gi par défaut — augmenter pour les bibliothèques réelles | Élevé | La base de référence de PhotoPrism_Common est 4Gi pour les charges de travail d'indexation/reconnaissance faciale ; 2 Gio est le seuil qui maintient ces fonctionnalités activées mais peut toujours risquer des arrêts OOM une fois qu'une bibliothèque a un volume significatif de photos/vidéos. |
PHOTOPRISM_ADMIN_PASSWORD (auto-généré) | Récupérer avant la première connexion | Moyen | Ne pas le connaître vous bloque l'accès au premier compte administrateur jusqu'à la réinitialisation via la base de données. |
site_url | Définir sur l'URL Cloud Run déployée une fois connue | Moyen | Laissé vide, PhotoPrism revient à l'hôte de la requête ; les liens absolus/URL de vignettes peuvent être incorrects derrière un équilibreur de charge ou un domaine personnalisé. |
ingress_settings | all pour un accès direct à l'interface utilisateur web | Moyen | La définition sur internal bloque l'accès du navigateur à l'interface utilisateur sauf si elle est atteinte via un client connecté au VPC ou un équilibreur de charge interne. |
backup_format | Un format d'archive de fichiers (tar, zip, …), pas sql | Moyen | PhotoPrism n'a pas de base de données SQL — un backup_uri pointant vers un dump de base de données n'a pas de sens pour cette application ; les sauvegardes doivent cibler le contenu du bucket média/bibliothèque. |
enable_nfs | false | Faible | Valeur par défaut correcte — PhotoPrism n'a pas besoin de NFS puisque le volume GCS FUSE est son stockage principal ; l'activer ajoute des coûts sans avantage à moins que des jobs personnalisés n'aient besoin d'un accès au système de fichiers partagé. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
enable_cloud_armor | activer pour la production | Moyen | L'interface utilisateur web publique et la connexion administrateur sont accessibles sans protection WAF par défaut. |
Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à PhotoPrism partagée avec la variante GKE — les identifiants administrateur, le moteur de base de données SQLite intégré, la disposition du stockage, la construction du conteneur et les sondes de santé par défaut — est décrite dans PhotoPrism_Common.
Guides connexes
- Lab pratique : PhotoPrism sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- PhotoPrism sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- PhotoPrism Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.