Cloudreve sur Google Cloud Run
Cloudreve est une plateforme de stockage cloud et de partage de fichiers open-source et auto-hébergée populaire, écrite en Go. Elle fournit une interface utilisateur web pour télécharger, organiser, prévisualiser et partager des fichiers, avec des backends de stockage enfichables. Ce module déploie Cloudreve sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par Cloudreve 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 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 Cloudreve sur RAD, et comment cela se compare
Cloudreve sur le module Cloud Run de RAD coûte environ 32,57 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 40 crédits (4 $ US). Cloudreve est une plateforme de stockage cloud et de partage de fichiers auto-hébergée. GKE Autopilot convient à Cloudreve qui doit rester opérationnel, s'adapter à plusieurs pods ou s'exécuter aux côtés d'autres charges de travail Kubernetes ; pour le coût le plus bas, ce module Cloud Run est généralement le bon choix — consultez le guide GKE si vous avez besoin de l'autre.
Si Cloudreve n'est nécessaire qu'occasionnellement — une démo, un essai, une charge de travail saisonnière ou d'étude — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que les 32,57 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet que RAD gère pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 40 crédits (4 $ US au prix de la recharge) | 36 crédits (10 % de moins) |
| 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 pour le temps de build à la minute | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 32,57 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 23 crédits par jour, environ 690 par mois (environ 69 $ US au prix de la recharge) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve |
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant 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).
10 crédits coûtent 1 $ US lors d'une recharge ponctuelle, moins sur un plan. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.
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 |
|---|---|
| Cloud Run, 1x vCPU / 1 Gio (chaud) | 13,14 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | environ 32,57 $ US |
Comment cela se compare
- Si vous l'exécutez vous-même, un VPS exécutant Cloudreve et son propre backend de stockage coûte moins cher en espèces : une boîte Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go coûte environ 24 $ par mois, ou une GCP
e2-standard-2environ 49 $ par mois — plus votre propre temps pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent pour vous. - RAD ne prétend jamais être moins cher que l'infrastructure nue en termes monétaires — ce n'est généralement pas le cas. La différence est ce que RAD gère pour vous : les correctifs, les sauvegardes, les secrets et la surveillance, ainsi que la possibilité de mettre Cloudreve en pause gratuitement plutôt que de payer pour une capacité inactive (voir ci-dessous).
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Cloudreve s'exécute dans un projet que RAD gère pour vous, vous avez une deuxième 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 à Cloudreve dont vous n'avez besoin qu'occasionnellement que de le faire fonctionner 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, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant qu'il attend. Contrairement à la suppression d'un module, cela ne démantèle pas la VM ou les ressources Cloud Run une par une — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter 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.
- Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 69 $ US par mois pour le maintenir en fonctionnement. Déployez Cloudreve, utilisez-le, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour les heures où il était réellement en ligne.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et que RAD ne gère que pour la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : 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.
- Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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é Cloudreve 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
Cloud Run conserve une instance chaude, il ne se met donc pas entièrement à l'échelle zéro de lui-même. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 40 crédits (4,00 $ US) dans votre propre projet. La suppression ne permet d'économiser de l'argent que si Cloudreve devait rester inutilisé pendant environ 5 jours ou plus, que ce soit dans votre propre projet ou dans un projet géré par RAD.
- La majeure partie du coût d'exécution est généralement le serveur de fichiers ou de cache partagé. Il ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de Cloudreve alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
- Conservez d'abord vos données. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde avant de la supprimer si vous souhaitez la conserver.
- Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lorsque vous dé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 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 reviennent 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 Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimations de crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
Cloudreve s'exécute comme un seul binaire Go servant à la fois l'interface utilisateur web et l'API de stockage de fichiers. Le déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Binaire Go sur le port 5212, instance unique par défaut (min = max = 1) |
| Persistance | Cloud Filestore (NFS) | Monté à /cloudreve (enable_nfs = true par défaut) ; contient la base de données SQLite intégrée, les conf.ini générés, les téléchargements et les avatars. Cloud Run n'a pas d'équivalent de volume de bloc au PVC de GKE, et GCS FUSE ne peut pas héberger une base de données SQLite |
| Stockage d'objets | Cloud Storage | Un bucket storage est créé ; il est monté à /cloudreve via GCS FUSE uniquement si enable_nfs est désactivé (non recommandé) |
| Base de données | Aucune | Cloudreve utilise une base de données SQLite intégrée sur le volume monté — aucune instance Cloud SQL n'est créée |
| Secrets | Secret Manager | Aucun créé — le mot de passe administrateur de première exécution est généré par Cloudreve lui-même et imprimé dans les journaux du conteneur |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- Pas de base de données SQL.
database_typeest fixé àNONEparCloudreve_Common; chaque variable liée à Cloud SQL est transmise à la fondation uniquement pour la compatibilité d'interface et n'a aucun effet. - NFS est le mécanisme de persistance, et
enable_nfsdoit restertrue. Cloud Run n'a pas d'option de volume de bloc, et GCS FUSE ne peut pas héberger une base de données SQLite (pas de verrouillage POSIX ou de mémoire partagée ; écritures d'ajout séquentiel uniquement) — sur GCS FUSE, les écritures de journal de Cloudreve échouent et une instance peut ne pas démarrer du tout. Ainsi, le volume NFS partagé est monté à/cloudreve(nfs_mount_path) et le wrapper désactive le volume de stockage GCS FUSE chaque fois que NFS est activé (enable_gcs_storage_volume = !var.enable_nfs). Cloudreve utilise un journal de restauration plutôt que WAL, donc NFS est une cible solide avec un seul rédacteur. Pour un véritable périphérique de bloc, utilisez Cloudreve_GKE. - La colocation binaire/données est gérée dans la construction de l'image. L'image
cloudreve/cloudreveen amont conserve à la fois le binairecloudreveet ses données dans/cloudreve. Le Dockerfile de ce module déplace le binaire vers/usr/local/bin/cloudrevedans une construction multi-étapes (ENTRYPOINT ["/usr/local/bin/cloudreve"],WORKDIR /cloudreve), de sorte que le montage du volume de données à/cloudrevene masque que les fichiers de données, jamais le binaire. Voir Section 3. - Pas de Cloud SQL, pas de Redis.
enable_cloudsql_volumepar défautfalseetenable_redisest explicitement remplacé parfalsedansmain.tf, quelle que soit la valeur propre de la variable. - Pas de secret administrateur injectable. Cloudreve génère son propre mot de passe administrateur initial au premier démarrage et l'imprime dans les journaux du conteneur — aucun secret Secret Manager n'est créé ;
secret_ids/secret_valuesdeCloudreve_Commonsont des cartes vides. - Instance unique par défaut.
min_instance_count = max_instance_count = 1, correspondant à l'absence de support de clustering distribué/multi-nœuds de Cloudreve et évitant les rédacteurs concurrents sur le fichier SQLite monté unique. container_portpar défaut à5212et est en fait transmis à la configuration effective par application (contrairement à d'autres variables de transmission dans ce module) — mais le modifier ne change pas ce que le binaire Cloudreve lui-même écoute en interne, car il n'y a pas de variable d'environnement ou de drapeau CLI qui connecte ce port au conteneur. Laissez-le à la valeur par défaut.- L'ingress public est activé par défaut (
ingress_settings = "all") afin que l'interface utilisateur web soit accessible directement à l'URL Cloud Run.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de service et de ressource sont rapportés dans les Sorties du déploiement.
A. Cloud Run — le service Cloudreve
Cloudreve s'exécute en tant que service Cloud Run v2. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs. Avec la valeur par défaut min_instance_count = max_instance_count = 1, exactement une instance
sert tout le trafic à tout moment.
- 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 Filestore (persistance NFS) et Cloud Storage
La base de données SQLite intégrée de Cloudreve (cloudreve.db), les conf.ini générés,
et les fichiers téléchargés résident tous sous /cloudreve, le répertoire de travail du conteneur.
Ce chemin est le point de montage du volume NFS partagé
(enable_nfs = true, nfs_mount_path = "/cloudreve") — Cloud Run n'a pas
d'équivalent de volume de bloc à un PVC GKE, et GCS FUSE ne peut pas héberger une base de données SQLite.
Un bucket Cloud Storage storage dédié est toujours créé par
Cloudreve_Common ; il est monté à /cloudreve via GCS FUSE uniquement si vous désactivez
NFS, ce qui n'est pas recommandé.
- Console : Cloud Storage → Buckets → filtrez par le suffixe
storagedu déploiement. - CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
gcloud storage ls gs://<data-bucket>/
SQLite a un seul rédacteur ici, donc l'exécution de plus d'une instance
(max_instance_count > 1) risque de corrompre le fichier de base de données intégré — voir Section 6.
Voir App_CloudRun pour les options GCS Fuse et CMEK.
C. Secret Manager
Cloudreve_Common ne crée aucun secret Secret Manager pour Cloudreve lui-même —
le mot de passe administrateur de première exécution est généré en interne par Cloudreve et imprimé
dans les journaux du conteneur au premier démarrage, non stocké dans Secret Manager. Tous les secrets
configurés via secret_environment_variables sont toujours injectés via le
mécanisme standard de Secret Manager.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~cloudreve"
gcloud logging read 'resource.type="cloud_run_revision"' --project "$PROJECT" --limit 200 | grep -i "admin\|password"
Voir App_CloudRun pour les détails d'injection et de rotation (la rotation n'a aucun effet ici car aucun secret de service n'existe).
D. Réseau et ingress
Le service est accessible à son URL run.app par défaut
(ingress_settings = "all"). Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés via enable_cloud_armor ;
les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité autrement.
- 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 des conteneurs sont acheminés vers Cloud Logging — c'est également là qu'apparaît le mot de passe administrateur généré lors de la première exécution (voir Section 3). Les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte facultatives.
- 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 Cloudreve
- Pas de job d'initialisation de base de données.
Cloudreve_Commonn'injecte pas de jobdb-init/db-createpar défaut — Cloudreve n'a pas de base de données SQL à provisionner.initialization_jobsn'exécute que les jobs que vous fournissez explicitement. - Auto-configuration au premier démarrage, mot de passe administrateur dans les journaux. Au premier démarrage, Cloudreve
crée son schéma SQLite sur le volume
/cloudrevemonté et génère le compte administrateur initial, imprimant le mot de passe généré dans les journaux du conteneur. Il n'y a pas d'étape de migration séparée et pas de secret Secret Manager pour le récupérer — capturez-le avecgcloud run services logs read(ougcloud logging read) avant que le tampon de journal ne tourne, puis modifiez-le via l'interface utilisateur web. - L'ombrage de volume est pré-corrigé dans le Dockerfile. Sans le déplacement
décrit dans la Section 1, le volume monté à
/cloudreveombragerait le binaire colocalisé, produisantexec ./cloudreve: no such file or directory(boucle de crash). Il s'agit d'un module de construction personnalisée (container_image_source = "custom",image_source = "custom"dansCloudreve_Common) précisément pour que cette correction (modules/Cloudreve_Common/scripts/Dockerfile) puisse être intégrée — ce n'est pas un simple passage de l'image amont. La modification du Dockerfile nécessite une reconstruction (tofu taint 'module.app_cloudrun.module.app_build.null_resource.build_and_push_application_image[0]'si un déclencheur de hachage de contenu manque la modification). - L'épinglage de version utilise un ARG de build spécifique à l'application. Le Dockerfile lit
CLOUDREVE_VERSION(épinglé à3.8.3lorsqueapplication_version = "latest"), et non le génériqueAPP_VERSIONque la Fondation injecte et forcerait autrement à la balise irrésolublelatest. - Chemins des sondes de santé. La sonde de démarrage est HTTP
GET /(initial_delay_seconds = 15,failure_threshold = 10, c'est-à-dire jusqu'à ~100s pour devenir prête) ; la sonde de vivacité est également HTTPGET /(initial_delay_seconds = 30,period_seconds = 30). Cloudreve n'a pas de point de terminaison de santé dédié distinct de son interface utilisateur web —/renvoie 200 une fois que le serveur est en service. - Sémantique d'instance unique. Avec
min_instance_count = max_instance_count = 1, une seule instance sert le trafic ; n'augmentez pasmax_instance_countsans vérifier le support multi-nœuds/clustering de Cloudreve (non géré par ce module) — le fichier SQLite partagé n'a pas de protection intégrée contre les rédacteurs concurrents. container_portest transmis mais non câblé à l'application. Le binaire Cloudreve écoute sur son propre port par défaut (5212) sans variable d'environnement ni drapeau CLI dans le Dockerfile de ce module pour le modifier ; la modification decontainer_portne modifie que ce vers quoi Cloud Run achemine, il doit donc rester à la valeur par défaut.- Inspecter le service en cours d'exécution et l'exécution des jobs :
gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT"
gcloud run jobs list --project "$PROJECT" --region "$REGION"
gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"
4. Variables de configuration
Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement (selon leurs balises {{UIMeta group=N}}). Seuls les paramètres spécifiques ou notables pour Cloudreve 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 | [] | Adresses e-mail autorisées à 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 | cloudreve | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | Cloudreve | Nom lisible par l'homme affiché dans la console. |
description | Cloudreve — self-hosted cloud storage / file-sharing system | Description du service. |
application_version | latest | Balise d'image cloudreve/cloudreve ; latest est épinglé à 3.8.3 au moment de la construction via l'ARG de construction CLOUDREVE_VERSION. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
cpu_limit | 1000m | CPU par instance. |
memory_limit | 1Gi | Mémoire par instance ; taille pour le service de fichiers et les transferts concurrents. |
min_instance_count | 1 | Maintenu à 1 pour éviter les démarrages à froid pendant le chargement de l'index de Cloudreve. |
max_instance_count | 1 | Maintenir à 1 — pas de support multi-nœuds/clustering vérifié, et un fichier SQLite partagé n'a pas de protection contre les écritures concurrentes. |
container_port | 5212 | Port HTTP par défaut de Cloudreve. Transmis à la configuration effective par application, mais non câblé au port d'écoute du binaire — laisser par défaut. |
execution_environment | gen2 | Requis pour les montages NFS (et GCS Fuse). |
timeout_seconds | 300 | Durée maximale de la requête (0–3600 secondes). |
enable_cloudsql_volume | false | Cloudreve n'a pas de base de données Cloud SQL — toujours false. |
enable_image_mirroring | true | Mettre en miroir l'image Cloudreve dans Artifact Registry. |
traffic_split | [] | Répartir le trafic entre les révisions pour des déploiements échelonnés. |
container_protocol | http1 | HTTP/1.1 ; h2c disponible mais non requis par Cloudreve. |
service_annotations / service_labels | {} | Annotations/étiquettes personnalisées sur la ressource de service Cloud Run. |
container_image / container_image_source / container_build_config / container_resources / cloudsql_volume_mount_path / max_revisions_to_retain | (divers) | Déclaré pour la mise en miroir des variables de la Fondation uniquement — non transmis dans main.tf. L'image réelle, la configuration de build (chemin Dockerfile, ARG de build CLOUDREVE_VERSION) et la forme de la ressource sont fixées à l'intérieur de Cloudreve_Common. |
Groupe 5 — Contrôle d'accès et d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Accès public pour atteindre directement 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 avant la propre connexion de Cloudreve. |
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 supplémentaires non secrets transmis directement au conteneur. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom du 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 (aucun secret de service n'existe pour la rotation par défaut). |
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 / backup_source / backup_uri / backup_format | options de restauration | Restaurer à partir d'une sauvegarde lors du déploiement (backup_uri est transmis à l'entrée backup_file de la fondation). |
additional_containers / additional_services | [] | Déclaré pour la mise en miroir de la Fondation uniquement ; Cloudreve n'utilise pas de conteneurs sidecar ni de services supplémentaires. |
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, github_app_installation_id,
cicd_trigger_config, enable_cloud_deploy, cloud_deploy_stages,
enable_binary_authorization, binauthz_evaluation_mode.
Groupe 9 — Scripts SQL personnalisés et sélection d'instances NFS
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_root | désactivé | Non applicable — Cloudreve n'a pas de base de données SQL. |
nfs_instance_name / nfs_instance_base_name / nfs_volume_name | auto-découverte / app-nfs / nfs-data-volume | Sélectionnez quelle instance NFS sauvegarde /cloudreve (enable_nfs est activé par défaut et doit le rester pour Cloudreve sur Cloud Run). |
Groupe 10 — Équilibreur de charge, CDN et rétention d'images
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_cloud_armor | false | Provisionner l'équilibreur de charge HTTPS global + Cloud Armor WAF. |
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. |
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éer des buckets GCS définis dans storage_buckets ; gère également le bucket storage auto-provisionné. |
storage_buckets | [] | Buckets GCS supplémentaires au-delà du bucket de données auto-provisionné. |
enable_nfs | true | Doit rester true sur Cloud Run : Cloudreve conserve conf.ini, sa base de données SQLite, les téléchargements et les avatars sous /cloudreve, et GCS FUSE ne peut pas héberger une base de données SQLite. |
nfs_mount_path | /cloudreve | Doit rester /cloudreve — le répertoire de travail de Cloudreve, où réside tout son état. |
gcs_volumes | [] | Montages de volumes GCS Fuse supplémentaires. Le bucket storage est monté à /cloudreve uniquement lorsque enable_nfs = false ; avec NFS activé (par défaut), seules les entrées ici sont montées. |
manage_storage_kms_iam / enable_artifact_registry_cmek | false | Options CMEK. |
enable_redis | Valeur par défaut App_CloudRun true, mais forcée false dans main.tf | Cloudreve n'utilise pas Redis ; la valeur de la variable n'a aucun effet quelle que soit la configuration. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Fixé par Cloudreve_Common — Cloudreve n'a pas de base de données SQL. |
database_password_length / enable_auto_password_rotation / rotation_propagation_delay_sec / db_host_env_var_name / db_user_env_var_name / db_name_env_var_name / db_port_env_var_name / db_password_env_var_name / service_url_env_var_name / application_database_name / application_database_user / enable_mysql_plugins / mysql_plugins / enable_postgres_extensions / postgres_extensions / sql_instance_name / sql_instance_base_name | (divers) | Tous déclarés pour la mise en miroir des variables de la Fondation uniquement et non transmis dans main.tf — Cloudreve n'a pas de base de données à laquelle l'une de ces variables pourrait s'appliquer. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Aucun job par défaut n'est injecté — Cloudreve n'a pas besoin de configuration de base de données. Ne fournissez des jobs que pour le chargement de données personnalisées ou les tâches de maintenance. |
cron_jobs | [] | Aucune tâche récurrente planifiée par la plateforme par défaut. |
backup_file | backup.sql | Déclaré pour la mise en miroir de la Fondation uniquement ; le nom de fichier de restauration réel provient de backup_uri (groupe 7) via backup_source/backup_format. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP GET /, initial_delay=15s, failure_threshold=10 | Pas de point de terminaison de santé dédié — Cloudreve sert / une fois prêt. |
liveness_probe | HTTP GET /, initial_delay=30s, period=30s | Même point de terminaison que la sonde de démarrage. |
startup_probe_config | HTTP /, activé | Sonde structurée alternative ; la sonde startup_probe par application ci-dessus est celle qui est réellement câblée via Cloudreve_Common. |
health_check_config | HTTP /, activé | Sonde de vivacité structurée alternative. |
uptime_check_config | { enabled=false, path="/" } | Vérification de disponibilité Cloud Monitoring ; désactivée par défaut. |
alert_policies | [] | Politiques d'alerte métrique. |
Groupe 15 — Réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
network_name | "" (auto-découverte) | Déclaré pour la mise en miroir de la Fondation uniquement ; non transmis dans main.tf — le module auto-découvre toujours le VPC unique géré par Services_GCP. |
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. |
5. Sorties
Retournées 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. |
cloudreve_url | URL de l'interface utilisateur web de Cloudreve (port 5212). L'accessibilité dépend de ingress_settings ; internal la restreint au même VPC. |
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 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 | Statut de surveillance, canaux, tests de disponibilité. |
initialization_jobs | Noms des jobs d'initialisation fournis par l'utilisateur (Cloudreve n'en injecte aucun par défaut). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | Statut 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 | Statut VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation d'audit et statut CMEK. |
Notez que, contrairement à la plupart des modules d'application, il n'y a
pas de sorties database_* — Cloudreve n'a pas d'instance Cloud SQL à décrire.
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 base App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — IAP sans identités autorisées, un runtime
gen1avec le montage GCS Fuse requis, uncontainer_port/backup_retention_days/secret_propagation_delayhors limites. 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ètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
enable_nfs (persistance à /cloudreve) | true | Critique | Le désactiver revient à un montage GCS FUSE, qui ne peut pas héberger la base de données SQLite de Cloudreve : les écritures de journal échouent et une instance peut ne pas démarrer. Pour un périphérique de bloc, utilisez Cloudreve_GKE. |
Relocalisation binaire Dockerfile (/usr/local/bin/cloudreve) | Conserver tel quel | Critique | Revenir à ENTRYPOINT ["./cloudreve"] à l'intérieur de /cloudreve réintroduit l'occultation de volume : le montage de volume /cloudreve masque le binaire et le conteneur boucle en cas de crash avec exec ./cloudreve: no such file or directory. |
max_instance_count | 1 | Critique | Cloudreve n'a pas de mode multi-nœuds/clustering vérifié dans ce module ; la mise à l'échelle au-delà de 1 risque des écritures concurrentes sur le même fichier SQLite. |
| Récupération du mot de passe administrateur | Capturer depuis gcloud run services logs read immédiatement après le premier démarrage | Élevé | Le mot de passe administrateur généré n'est imprimé dans les journaux du conteneur qu'une seule fois ; le manquer vous bloque l'accès au compte super-administrateur de première exécution jusqu'à ce que vous trouviez un autre chemin de récupération. |
container_port | 5212 | Élevé | Le binaire de Cloudreve écoute sur un port par défaut fixe sans câblage env/CLI pour le modifier dans ce module ; la modification de la variable ne modifie que la cible de routage de Cloud Run, ce qui interrompt la connectivité. |
min_instance_count | 1 | Moyen | La mise à l'échelle à zéro (0) ajoute une latence de démarrage à froid pendant que Cloudreve recharge son index à partir du volume monté, et augmente le risque de chevauchement d'instances froides/chaudes touchant momentanément le même fichier SQLite pendant un déploiement. |
ingress_settings | all | Moyen | Le réglage à internal bloque l'accès direct à l'interface utilisateur web à moins d'être précédé d'un équilibreur de charge ou d'être accédé depuis le VPC. |
enable_iap | Facultatif | Faible–Moyen | IAP ajoute une passerelle d'identité Google devant la propre connexion de Cloudreve ; sans elle, la propre authentification de Cloudreve est la seule barrière à l'internet public. |
database_type / autres variables db_* / sql_* | Laisser les valeurs par défaut | Faible | Cloudreve n'a pas de base de données SQL — toute valeur ici est une opération nulle, puisque database_type est fixé à NONE par Cloudreve_Common. |
enable_redis | Laisser la valeur par défaut | Faible | Forcé à false dans main.tf quelle que soit la valeur de la variable — Cloudreve n'utilise pas Redis. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
Pour le comportement de base 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 à Cloudreve partagée avec la variante GKE se trouve
dans le module Cloudreve_Common (modules/Cloudreve_Common) ; un guide Cloudreve_Common.md dédié n'existe pas encore dans cet ensemble de documentation — voir aussi
Cloudreve_GKE pour l'alternative de production
soutenue par PVC de bloc.
Guides associés
- Lab pratique : Cloudreve sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Cloudreve sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Cloudreve Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé avec Gokapi sur Google Cloud Run, Chibisafe sur Google Cloud Run dans la solution Partage et transfert de fichiers.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.