Aller au contenu principal

Radicale sur GKE Autopilot

Radicale sur GKE Autopilot

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 GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud que Radicale utilise et sur la façon de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


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

L'exécution de Radicale dans votre propre projet Google Cloud coûte environ 42,08 $ US/mois en infrastructure, plus des frais de module uniques de 75 crédits RAD (dimensionnés à 1 vCPU / 1 GiB sur les pods GKE Autopilot). RAD facture les frais de module une seule fois, au moment du déploiement — jamais plus lors d'une mise à jour — et les builds sont inclus dans le prix ; l'utilisation de Google Cloud elle-même est facturée à votre propre compte de facturation au prix catalogue de Google. Sur un projet géré par RAD, les mêmes ressources sont mesurées à l'heure en crédits au prix catalogue plus la marge de RAD — environ 75 crédits/jour — et les frais de module sont inférieurs de 10 %, soit 67,50 crédits. Voir "Mettre 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 Cloud Run pour l'option à moindre coût)

Ce que vous payez sur RAD​

ÉlémentVotre propre projetProjet géré par RAD
Frais de module75 crédits (une fois)67,50 crédits (une fois)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés pour le temps de build à la minute.Identique
Coût d'exécution Google Cloud~42,08 $ US/mois, facturé à votre propre compte de facturation au prix catalogue de Google~75 crédits/jour, mesuré à l'heure au prix catalogue + marge de RAD

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant 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)
Pod GKE Autopilot, 1x vCPU / 1 GiB36,08
Cloud NAT et réseau5
Cloud Storage (modules complémentaires, sauvegardes)1
Frais de gestion de cluster GKE*partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Total42,08 $

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

Comment cela se compare​

  • Nous n'avons pas pu vérifier un prix SaaS commercial actuel, directement comparable, pour ce projet open-source exact, donc la comparaison honnête est un serveur auto-géré nu : Hetzner CPX22 (2 vCPU/4 Go, ~24 $/mois), un Droplet DigitalOcean 2 vCPU/4 Go (~24 $/mois), ou un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go, ~49 $/mois). L'empreinte de cette application (1 vCPU ou moins, 1 GiB ou moins) est plus petite que n'importe laquelle de ces classes, donc une boîte auto-gérée nue dimensionnée pour correspondre coûterait moins 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 VPS nu sur le prix affiché — ce n'est généralement pas le cas. Ce que RAD ajoute pour le même montant en dollars ou un montant similaire, c'est une base de données gérée, des informations d'identification conservées dans Secret Manager, une surveillance et une mise à jour en un clic, dont aucune n'est gratuite avec un VPS nu.
  • Sur un VPS nu, c'est vous qui appliquez les correctifs de sécurité du système d'exploitation/de la base de données, effectuez et testez les sauvegardes, et renouvelez les certificats ; Cloud SQL géré par RAD, Secret Manager et la surveillance gèrent les trois pour vous.

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

C'est l'option principale sur un projet géré par RAD, et elle est gratuite pendant la pause. La suppression d'un projet géré par RAD dissocie 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étruit pas la base de données, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et comme la facturation est déjà dissocié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 invoquée comme 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 restaurer 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 plus jamais les frais de module. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit. Ce qu'il faut : vous devez être propriétaire du projet (pas seulement faire gérer sa facturation par RAD), vous devez le restaurer vous-même dans les 30 jours — après 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 conviennent). Google indique que la plupart des services fonctionnent à nouveau pleinement 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.

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

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

La suppression ne permet d'économiser de l'argent que si 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 6 jours ou plus d'inactivité, sur la base de son propre coût d'exécution de 42,08 $ 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 lorsque 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.

Conserver les données d'abord : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, 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 obtient l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une autorisation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille devient faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire remet le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les 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 pod Python WSGI. Le déploiement relie un petit ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod de processus Python unique, 1 vCPU / 1 GiB par défaut
Base de donnéesaucuneRadicale stocke chaque collection sous forme de fichiers simples — aucune instance Cloud SQL n'est créée
Stockage d'objetsCloud Storage, ou un PVC de blocPVC de bloc par défaut (stateful_pvc_enabled = true) ; un bucket GCS storage est également provisionné et est le point de montage uniquement si le PVC est désactivé
Cache et file d'attenteaucunRadicale n'a aucune 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
IngressCloud Load BalancingÉquilibreur de charge externe, domaine personnalisé facultatif + certificat géré

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 magasin de fichiers pur.
  • Build personnalisé, avec un wrapper léger. Radicale_Common superpose un point d'entrée cloud à l'image officielle ghcr.io/kozea/radicale via Cloud Build, puis met en miroir le résultat dans Artifact Registry.
  • PVC de stockage de blocs par défaut, et requis. stateful_pvc_enabled = true (résout automatiquement workload_type en StatefulSet) donne aux collections de Radicale un verrouillage de fichiers POSIX réel et des renommages de répertoires. Sur GCS FUSE, la création d'un calendrier ou d'un carnet d'adresses échoue, car gcsfuse ne peut pas renommer le répertoire temporaire dans lequel Radicale construit chaque collection. stateful_pvc_storage_class est par défaut standard (HDD) plutôt que SSD — les collections sont de petits fichiers texte sans besoin d'IOPS élevées.
  • Pas de compte administrateur par défaut — un vrai secret généré. 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 à chauffer au démarrage, donc la mise à l'échelle à zéro est sûre et rapide.
  • MKCOL fonctionne nativement ici — mais le job de démarrage peut ne pas atteindre un PVC. Le service LoadBalancer L4 simple de GKE n'a pas de restriction MKCOL (contrairement à Cloud Run), mais avec stateful_pvc_enabled = true (par défaut), les collections pré-créées du job de démarrage peuvent ne pas apparaître — voir §3.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que vous avez exécuté gcloud container clusters get-credentials <cluster> --region <region> --project <project> et que PROJECT, REGION et NAMESPACE sont définis.

A. GKE Autopilot — la charge de travail Radicale​

  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 # Deployment mode
    kubectl logs -n "$NAMESPACE" statefulset/<service-name> --tail=100 # StatefulSet mode

B. Stockage — Cloud Storage ou un PVC de bloc​

  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~radicale"
    kubectl get pvc -n "$NAMESPACE" # only when stateful_pvc_enabled = true

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 :
    kubectl get svc -n "$NAMESPACE" -o wide

E. Cloud Logging et Monitoring​

  • CLI :
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 -f

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 unique (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.
  • 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 de pod.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /.
  • Inspecter l'exécution du job :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<job-name>

⚠ MKCOL fonctionne sur GKE — mais vérifiez où les écritures de votre job de démarrage atterrissent​

Contrairement à Cloud Run, le service LoadBalancer L4 simple de GKE ne restreint pas la méthode WebDAV MKCOL — confirmé en direct (201 Created). Un vrai client CalDAV/CardDAV peut créer de nouvelles collections directement sans avoir besoin de contournement, ce qui est l'une des raisons pour lesquelles Radicale_GKE est mieux adapté à une utilisation plus intensive ou en production.

Cependant, le job d'initialisation par défaut seed-default-collections est un job de module commun Cloud-Run/GKE partagé et ne monte que le bucket GCS partagé storage — il ne peut pas s'attacher au PVC de bloc d'un StatefulSet (un job Kubernetes ne peut pas monter un PVC ReadWriteOnce déjà détenu par un pod en cours d'exécution). Donc :

  • Avec stateful_pvc_enabled = true (par défaut) : les écritures du job de démarrage atterrissent dans le bucket GCS autrement inutilisé, et le "Calendrier par défaut"/"Carnet d'adresses par défaut" n'apparaîtront pas sur le système de fichiers du pod en cours d'exécution, sauvegardé par PVC. C'est inoffensif — créez votre premier calendrier via un vrai client CalDAV, ou curl -X MKCOL (confirmé comme fonctionnant), au lieu d'attendre les valeurs par défaut pré-initialisées.
  • Sans PVC (mode de déploiement sauvegardé par GCS) : les écritures du job de démarrage atterrissent dans le même bucket que le pod en cours d'exécution, de sorte que les valeurs par défaut apparaissent — mais la création de toute autre collection échoue sur GCS FUSE.

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 ; toutes les autres entrées sont héritées de App_GKE 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.
application_versionlatestRésout le 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_port5232Fixé via Radicale_Common ; cette variable n'est pas transmise à App_GKE.
min_instance_count / max_instance_count0 / 1Limites de mise à l'échelle HPA ; max est épinglé à 1 de manière non négociable.
enable_image_mirroringtrueMet en miroir l'image construite dans Artifact Registry.

Groupe 7 — StatefulSet​

VariableValeur par défautDescription
stateful_pvc_enabledtrueConserver true — donne aux collections de Radicale un verrouillage de fichiers POSIX réel et des renommages de répertoires ; sur GCS FUSE, la création d'une collection échoue. Résout automatiquement workload_type en StatefulSet.
stateful_pvc_mount_path/var/lib/radicaleDoit correspondre à la déclaration VOLUME de l'image de base.
stateful_pvc_storage_classstandardHDD pd-standard, pas SSD — les collections sont de petits fichiers texte sans besoin d'IOPS élevées ; évite le quota strict SSD_TOTAL_GB.
stateful_fs_group3000Rend le PVC inscriptible par le groupe ; Radicale s'exécute en tant que UID 1000 / GID 2000.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
storage_bucketsun bucket storageMonté à /var/lib/radicale via GCS FUSE sauf si stateful_pvc_enabled = true, auquel cas le PVC prend le même chemin de montage.

Groupe 16 — 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 11 — Automatisation de la charge de travail​

VariableValeur par défautDescription
initialization_jobsseed-default-collections (injecté par Radicale_Common)Voir §3 pour la mise en garde GKE+PVC. Fournir une liste personnalisée remplace entièrement cette valeur par défaut.

Groupe 10 — 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 considèrent 2xx–3xx comme sains.

5. Sorties​

SortieDescription
service_name / service_url / service_external_ipIdentité et adresse du service Kubernetes.
storage_bucketsLe bucket storage (inutilisé comme montage lorsque stateful_pvc_enabled = true).
statefulset_nameNom du StatefulSet, lorsque workload_type = "StatefulSet".
kubernetes_readyIndique si la charge de travail a atteint l'état Prêt.

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 en cas d'erreur
stateful_pvc_enabledtrue (par défaut)ÉlevéSans cela, /var/lib/radicale est sauvegardé par GCS FUSE, et la création d'un calendrier ou d'un carnet d'adresses échoue (gcsfuse ne peut pas renommer les répertoires).
Attendre des collections par défaut sur un déploiement sauvegardé par PVCCréer le premier calendrier via un vrai client CalDAV ou curl -X MKCOLMoyenLe job seed-default-collections ne peut pas monter le PVC ReadWriteOnce d'un StatefulSet, de sorte que ses écritures atterrissent dans le bucket GCS inutilisé — les valeurs par défaut pré-initialisées n'apparaissent pas silencieusement sur le système de fichiers du pod en cours d'exécution.
max_instance_countLaisser à 1CritiqueLe backend de stockage de Radicale n'est pas conçu pour un accès multi-instance concurrent ; augmenter cela risque une corruption des données.
stateful_pvc_storage_classLaisser à standard (HDD)Faible–MoyenPasser à standard-rwo/premium-rwo (SSD) puise dans le quota SSD_TOTAL_GB beaucoup plus strict sans réel avantage — le modèle d'E/S de Radicale n'a pas besoin d'IOPS SSD.
Identifiant administrateurRécupérer de Secret Manager après le premier déploiementCritiqueContrairement aux applications avec une connexion par défaut bien connue, 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.

Pour le comportement de la fondation référencé tout au long — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à Radicale partagée avec la variante Cloud Run 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.