Aller au contenu principal

Cloudreve sur Google Cloud Run

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édezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement40 crédits (4 $ US au prix de la recharge)36 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé 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 quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est 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éseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 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-2 environ 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 CloudNotes
CalculCloud Run v2Binaire Go sur le port 5212, instance unique par défaut (min = max = 1)
PersistanceCloud 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'objetsCloud StorageUn bucket storage est créé ; il est monté à /cloudreve via GCS FUSE uniquement si enable_nfs est désactivé (non recommandé)
Base de donnéesAucuneCloudreve utilise une base de données SQLite intégrée sur le volume monté — aucune instance Cloud SQL n'est créée
SecretsSecret ManagerAucun 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
IngressURL Cloud Run / Cloud Load BalancingURL 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_type est fixé à NONE par Cloudreve_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_nfs doit rester true. 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/cloudreve en amont conserve à la fois le binaire cloudreve et ses données dans /cloudreve. Le Dockerfile de ce module déplace le binaire vers /usr/local/bin/cloudreve dans une construction multi-étapes (ENTRYPOINT ["/usr/local/bin/cloudreve"], WORKDIR /cloudreve), de sorte que le montage du volume de données à /cloudreve ne masque que les fichiers de données, jamais le binaire. Voir Section 3.
  • Pas de Cloud SQL, pas de Redis. enable_cloudsql_volume par défaut false et enable_redis est explicitement remplacé par false dans main.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_values de Cloudreve_Common sont 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_port par défaut à 5212 et 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 storage du 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_Common n'injecte pas de job db-init/db-create par défaut — Cloudreve n'a pas de base de données SQL à provisionner. initialization_jobs n'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 /cloudreve monté 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 avec gcloud run services logs read (ou gcloud 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é à /cloudreve ombragerait le binaire colocalisé, produisant exec ./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" dans Cloudreve_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.3 lorsque application_version = "latest"), et non le générique APP_VERSION que la Fondation injecte et forcerait autrement à la balise irrésoluble latest.
  • 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 HTTP GET / (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 pas max_instance_count sans 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_port est 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 de container_port ne 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é​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe 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​

VariableValeur par défautDescription
application_namecloudreveNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameCloudreveNom lisible par l'homme affiché dans la console.
descriptionCloudreve — self-hosted cloud storage / file-sharing systemDescription du service.
application_versionlatestBalise 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​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
cpu_limit1000mCPU par instance.
memory_limit1GiMémoire par instance ; taille pour le service de fichiers et les transferts concurrents.
min_instance_count1Maintenu à 1 pour éviter les démarrages à froid pendant le chargement de l'index de Cloudreve.
max_instance_count1Maintenir à 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_port5212Port 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_environmentgen2Requis pour les montages NFS (et GCS Fuse).
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseCloudreve n'a pas de base de données Cloud SQL — toujours false.
enable_image_mirroringtrueMettre 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_protocolhttp1HTTP/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​

VariableValeur par défautDescription
ingress_settingsallAccès public pour atteindre directement l'interface utilisateur web.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger 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​

VariableValeur par défautDescription
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_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFré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​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à 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​

VariableValeur par défautDescription
enable_custom_sql_scripts / custom_sql_scripts_bucket / custom_sql_scripts_path / custom_sql_scripts_use_rootdésactivéNon applicable — Cloudreve n'a pas de base de données SQL.
nfs_instance_name / nfs_instance_base_name / nfs_volume_nameauto-découverte / app-nfs / nfs-data-volumeSé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​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner 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_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days7 / true / 30Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage, système de fichiers et Redis​

VariableValeur par défautDescription
create_cloud_storagetrueCré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_nfstrueDoit 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/cloudreveDoit 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_cmekfalseOptions CMEK.
enable_redisValeur par défaut App_CloudRun true, mais forcée false dans main.tfCloudreve 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​

VariableValeur par défautDescription
database_typeNONEFixé 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​

VariableValeur par défautDescription
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_filebackup.sqlDé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é​

VariableValeur par défautDescription
startup_probeHTTP GET /, initial_delay=15s, failure_threshold=10Pas de point de terminaison de santé dédié — Cloudreve sert / une fois prêt.
liveness_probeHTTP GET /, initial_delay=30s, period=30sMême point de terminaison que la sonde de démarrage.
startup_probe_configHTTP /, 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_configHTTP /, 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​

VariableValeur par défautDescription
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​

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer 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_loggingfalseJournaux 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.

SortieDescription
service_nameNom du service Cloud Run.
cloudreve_urlURL de l'interface utilisateur web de Cloudreve (port 5212). L'accessibilité dépend de ingress_settings ; internal la restreint au même VPC.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
storage_bucketsBuckets Cloud Storage créés, y compris le bucket storage.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesStatut de surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs d'initialisation fournis par l'utilisateur (Cloudreve n'en injecte aucun par défaut).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationStatut et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation 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 gen1 avec le montage GCS Fuse requis, un container_port/backup_retention_days/secret_propagation_delay hors 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ètreValeur judicieuseRisqueConséquence en cas d'erreur
enable_nfs (persistance à /cloudreve)trueCritiqueLe 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 quelCritiqueRevenir à 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_count1CritiqueCloudreve 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 administrateurCapturer 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_port5212É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_count1MoyenLa 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_settingsallMoyenLe 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_iapFacultatifFaible–MoyenIAP 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éfautFaibleCloudreve 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_redisLaisser la valeur par défautFaibleForcé à false dans main.tf quelle que soit la valeur de la variable — Cloudreve n'utilise pas Redis.
backup_retention_days7 (augmenter pour la production)MoyenTrop 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.

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