Aller au contenu principal

Radicale sur Google Cloud Run

Radicale sur Google Cloud Run

Radicale est un serveur CalDAV/CardDAV open-source auto-hébergé pour la synchronisation des calendriers et des contacts — une application WSGI légère, purement Python, sans framework ni base de données. Il stocke chaque calendrier et carnet d'adresses sous forme de fichiers iCalendar/vCard simples sur disque. Ce module déploie Radicale sur Cloud Run v2 sur la base de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud que Radicale utilise et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications 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 Radicale coûte sur RAD, et comment cela se compare​

L'exécution de Radicale dans votre propre projet Google Cloud coûte environ 17,58 $ US/mois en infrastructure, plus des frais de module uniques de 40 crédits RAD (dimensionnés à 1 vCPU / 1 GiB sur une instance Cloud Run à mise à l'échelle à zéro). 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 16 crédits/jour — et les frais de module sont inférieurs de 10 %, à 36 crédits. Voir "Mettez-le en pause gratuitement" ci-dessous pour savoir comment un déploiement Radicale géré par RAD peut être arrêté, sans frais d'exécution, jusqu'à ce que vous en ayez à nouveau besoin. (ou voir le guide GKE si vous avez besoin de Kubernetes)

Ce que vous payez sur RAD​

ÉlémentVotre propre projetProjet géré par RAD
Frais de module40 crédits (une fois)36 crédits (une fois)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites, puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minute.Identique
Coût d'exécution Google Cloud~17,58 $ US/mois, facturé à votre propre compte de facturation au prix catalogue de Google~16 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 d'exécution par défaut dans votre propre projet

Ressource$ US/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 1 GiB (scaleToZero)11,58
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Total17,58 $

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 simple serveur auto-géré : 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). L'empreinte propre de cette application (1 vCPU ou moins, 1 GiB ou moins) est plus petite que n'importe laquelle de ces classes, donc une machine auto-gérée dimensionnée pour correspondre coûterait moins cher que les chiffres ci-dessus — mais vous seriez toujours responsable de chaque correctif, sauvegarde et mise à jour de sécurité.
  • RAD ne prétend pas battre un simple VPS 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 conservés dans Secret Manager, une surveillance et une mise à jour en un clic, qu'un simple VPS ne vous offre pas gratuitement.
  • Sur un simple VPS, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, effectuez et testez les sauvegardes, et renouvelez les certificats ; les services Cloud SQL gérés par RAD, Secret Manager et la surveillance 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 principale sur un projet géré par RAD, et elle est gratuite pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet lui-même — la suppression 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 une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes : c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit. Ce qu'il faut pour cela : vous devez être propriétaire du projet (pas seulement faire gérer sa facturation par RAD), vous devez le restaurer vous-même dans les 30 jours — après quoi 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émonstration correspondent). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.

Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression 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 Radicale purement et simplement et de le redéployer plus tard. Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) — 40 crédits au total pour ce module.

La suppression ne permet d'économiser de l'argent que si Radicale reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — pour ce module, cela représente environ 8 jours ou plus d'inactivité, basé sur son propre coût d'exécution de 17,58 $ US/mois ci-dessus. La majeure partie de ce coût d'exécution est généralement la base de données et toute VM de fichier/cache partagée, et elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application seule n'économise que sa propre part de calcul si quelque chose d'autre 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, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les 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 interrompue 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​

Radicale s'exécute comme un seul conteneur Python WSGI sur Cloud Run v2. Le déploiement connecte un petit ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Processus Python unique, 1 vCPU / 1 GiB par défaut, mise à l'échelle à zéro
Base de donnéesaucuneRadicale stocke chaque collection sous forme de fichiers simples — aucune instance Cloud SQL n'est créée
Stockage d'objetsCloud StorageUn bucket storage est monté à /var/lib/radicale via GCS FUSE — la source unique de vérité pour toutes les données
Cache et file d'attenteaucunRadicale n'a pas de dépendance Redis ou de file d'attente
SecretsSecret ManagerUn vrai ADMIN_PASSWORD généré — Radicale n'est livré avec aucun compte administrateur par défaut
IngressURL Cloud RunURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • Aucune base de données d'aucune sorte. Radicale_Common corrige database_type = "NONE" — Radicale est un pur stockage de système de fichiers.
  • Build personnalisé, avec un wrapper léger. Radicale_Common superpose un point d'entrée cloud sur l'image officielle ghcr.io/kozea/radicale via Cloud Build, puis met en miroir le résultat dans Artifact Registry.
  • Pas de compte administrateur par défaut — un secret réel généré. Contrairement aux applications qui livrent un identifiant de première connexion bien connu, l'authentification de Radicale est par défaut denyall jusqu'à ce qu'elle soit configurée. Radicale_Common génère et injecte un vrai ADMIN_PASSWORD à chaque déploiement (voir le guide commun).
  • max_instance_count épinglé à 1, min_instance_count par défaut à 0. Le backend de stockage de Radicale n'est pas conçu pour un accès concurrentiel multi-instance, mais n'a pas de base de données/index à préchauffer au démarrage, donc la mise à l'échelle à zéro est sûre et rapide.
  • MKCOL est bloqué en périphérie sur Cloud Run — lisez le §3 avant de déployer. La création d'un nouveau calendrier/carnet d'adresses nécessite normalement la méthode WebDAV MKCOL, que le frontend Cloud Run de Google rejette avant même d'atteindre le conteneur. Un job de démarrage par défaut contourne ce problème — voir ci-dessous.

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

  • 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"

Voir App_CloudRun pour la mise à l'échelle, la concurrence et la répartition du trafic.

B. Cloud Storage — la source unique de vérité​

Le bucket storage est monté à /var/lib/radicale via GCS FUSE. Chaque calendrier, carnet d'adresses, élément et les fichiers htpasswd/config générés se trouvent ici — la perte de ce bucket entraîne la perte de tout l'état de Radicale.

  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~radicale"
    gcloud storage ls "gs://<bucket-name>/collections/collection-root/"

C. Secret Manager​

  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~radicale"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

D. Réseau et ingress​

  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'

E. Cloud Logging et Monitoring​

  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Radicale​

  • Pas de configuration de base de données au premier déploiement. Il n'y a pas de job db-init — Radicale n'a pas de base de données à amorcer.
  • seed-default-collections s'exécute au moment du déploiement. Un job d'initialisation ponctuel (execute_on_apply = true) écrit un "Calendrier par défaut" et un "Carnet d'adresses par défaut" directement sur le volume de stockage pour l'utilisateur administrateur, en contournant entièrement HTTP. Cela existe en raison d'une limitation réelle de la plateforme — voir l'encadré ci-dessous.
  • Pas de compte administrateur par défaut. L'authentification de Radicale est par défaut denyall jusqu'à ce qu'un fichier htpasswd existe. Radicale_Common génère un vrai ADMIN_PASSWORD et le point d'entrée cloud écrit à la fois la configuration INI et une entrée htpasswd bcrypt à chaque démarrage (pas seulement au premier démarrage — il n'y a pas de table utilisateur à vérifier "déjà initialisé").
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent / — les redirections 302 non authentifiées de Radicale vers son interface web, traitées comme saines par les deux types de sondes.
  • Inspecter l'exécution du job :
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

⚠ MKCOL est bloqué par le frontend de Cloud Run — la chose la plus importante à savoir sur ce module​

La création d'une nouvelle collection (calendrier ou carnet d'adresses) via le protocole CalDAV/CardDAV standard nécessite la méthode HTTP WebDAV MKCOL. Confirmé en direct par un débogage approfondi sur trois tentatives de déploiement distinctes :

  • Le frontend de Google Cloud Run (GFE) rejette MKCOL en périphérie avec une page d'erreur Google générique "400 Bad Request" — la requête n'atteint jamais le conteneur Radicale. Toutes les autres méthodes (GET, PUT, PROPFIND) passent bien ; c'est spécifique à MKCOL.
  • Les services Cloud Run n'ont pas d'accès shell/exec, il n'y a donc pas de solution de contournement manuelle de l'opérateur après coup.
  • Sans correctif, un nouveau déploiement Radicale_CloudRun serait incapable de créer aucun calendrier — ni via un client standard (Apple Calendar, Thunderbird, DAVx5), ni même via l'interface web de Radicale, qui émet également MKCOL en interne.

La solution : le job d'initialisation Radicale_Common par défaut de seed-default-collections écrit la structure de répertoire de la collection directement sur le volume de stockage — un conteneur simple avec accès au système de fichiers, sans couche HTTP/GFE. Cela s'exécute automatiquement à chaque déploiement (execute_on_apply = true) et amorce un "Calendrier par défaut" et un "Carnet d'adresses par défaut" pour l'utilisateur administrateur. Vérifié en direct : un PROPFIND sur le principal de l'administrateur liste correctement les deux collections, et un vrai VEVENT peut être PUT et GET avec succès.

Si vous avez besoin de collections supplémentaires au-delà des deux par défaut amorcées, vous ne pouvez pas les créer via un client standard sur Cloud Run. Soit vous fournissez une entrée initialization_jobs personnalisée qui les écrit de la même manière, soit vous utilisez Radicale_GKE, dont le service LoadBalancer L4 simple n'a aucune restriction MKCOL.


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 Radicale sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameradicaleNom de base des ressources.
application_display_nameRadicaleNom lisible par l'homme affiché dans l'interface utilisateur de la plateforme et la console Cloud Run.
application_versionlatestSe résout au build épinglé RADICALE_VERSION=3.7.7 — les tags GHCR n'ont pas de préfixe v.

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

VariableValeur par défautDescription
container_port5232Port natif par défaut de Radicale.
min_instance_count / max_instance_count0 / 1Mise à l'échelle à zéro ; max est épinglé à 1 de manière non négociable.
enable_image_mirroringtrueMet en miroir l'image construite dans Artifact Registry (évite les limites de débit de GHCR).
container_protocolhttp1Correct — Radicale sert du HTTP/1.1 simple.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
storage_bucketsun bucket storageMonté à /var/lib/radicale via GCS FUSE — la source unique de vérité pour tout l'état de Radicale.
gcs_volumes[]Le montage du bucket storage est ajouté automatiquement ; utilisez ceci uniquement pour des volumes supplémentaires.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typeNONEFixé par Radicale_Common — Radicale n'a pas de base de données d'aucune sorte.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobsseed-default-collections (injecté par Radicale_Common)Contourne la restriction MKCOL de Cloud Run — voir §3. Fournir une liste personnalisée remplace entièrement cette valeur par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / liveness_probeHTTP /Redirection 302 non authentifiée de Radicale vers son interface web ; les deux types de sondes traitent les codes 2xx–3xx comme sains.

5. Sorties​

SortieDescription
service_name / radicale_urlNom du service Cloud Run et URL interne/publique (note : cette sortie est nommée radicale_url, pas service_url).
storage_bucketsLe bucket storage supportant /var/lib/radicale.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
initialization_jobsNoms des jobs d'initialisation créés (inclut seed-default-collections).

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence si incorrect
Création de nouvelles collections via un client CalDAV/CardDAVS'appuyer sur les valeurs par défaut amorcées, ou utiliser Radicale_GKE pour de nouvelles collections arbitrairesÉlevéMKCOL est rejeté en périphérie de Cloud Run (GFE) avant d'atteindre le conteneur — aucun client standard, ni même l'interface web de Radicale, ne peut créer une NOUVELLE collection sur cette plateforme. Seules les deux collections amorcées au moment du déploiement existent, sauf si vous fournissez un job d'initialisation personnalisé.
max_instance_countLaisser à 1CritiqueLe backend de stockage de Radicale utilise le verrouillage de fichiers au niveau du système d'exploitation et n'est pas conçu pour un accès multi-instance concurrent ; augmenter cela risque une corruption des données.
Identifiant administrateurRécupérer depuis Secret Manager après le premier déploiementCritiqueContrairement aux applications avec un identifiant de connexion par défaut bien connu, Radicale génère un vrai secret — il n'y a aucun moyen de se connecter tant que vous n'avez pas récupéré ADMIN_PASSWORD.
stateful_pvc_enabled (non applicable sur Cloud Run)Utiliser Radicale_GKE pour la productionMoyenLe montage GCS FUSE de Cloud Run a des sémantiques de verrouillage de fichiers plus faibles que ce que le backend de stockage de Radicale attend ; acceptable uniquement parce que la concurrence est limitée à 1 instance.

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 à Radicale partagée avec la variante GKE est décrite dans Radicale_Common.

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