Aller au contenu principal

Vikunja sur GKE Autopilot

Vikunja sur GKE Autopilot

Vikunja est une application open source auto-hébergée de gestion de tâches et de projets — listes, tableaux kanban, diagrammes de Gantt, calendriers, rappels et partage d'équipe via une API REST et une interface web. Ce module déploie Vikunja sur GKE Autopilot par-dessus la fondation App_GKE, qui provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud utilisés par Vikunja et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications 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.


Coût de Vikunja sur RAD et comparaison​

L'exécution de Vikunja sur GKE Autopilot dans votre propre projet Google Cloud coûte environ 91,31 $ US/mois en frais Google Cloud (environ 164,31 $ US si ce n'est pas votre seul cluster Autopilot), en plus des mêmes frais de module RAD uniques de 75 crédits (7,50 $ US) que le module Cloud Run — cette variante n'exécute pas de volume NFS partagé, ses frais n'ont donc pas eu besoin d'être plus élevés, et son coût d'exécution est inférieur au chiffre alwaysOn de Cloud Run. GKE Autopilot convient à Vikunja qui doit fonctionner aux côtés d'autres charges de travail Kubernetes ; pour le coût le plus bas, consultez plutôt le guide Cloud Run. Dans un projet géré par RAD, les frais de module tombent à 67,5 crédits (10 % de moins) — voir Mettre en pause gratuitement ci-dessous.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module (uniques)75 crédits67,5 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 au temps de build à la minuteIdentique
Coût d'exécution Google Cloud91,31 $ US/mois, facturé par Google au prix catalogue~116 crédits/jour (environ 3 480/mois, 348 $ US au prix de la recharge), mesuré au prix catalogue plus la marge de RAD

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et la fondation partagée du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore assez d'historique GKE géré par RAD pour le mesurer, donc la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

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 pour une recharge unique, et moins pour un plan mensuel.

Coût d'exécution par défaut dans votre propre projet

Ressource (par défaut du module)Par mois
Pod GKE Autopilot, 1 vCPU / 0,5 GiB34,29 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total91,31 $ US

Les frais de gestion du cluster GKE sont exclus du total ci-dessus car ils sont partagés entre toutes les applications GKE du projet — 0 $ si c'est la seule, sinon environ 73 $ US/mois répartis entre le nombre d'applications que vous exécutez.

Comparaison​

  • Le cloud hébergé de Vikunja facture par utilisateur : Personnel est à 4 €/mois, Famille à 10 €/mois (jusqu'à 5 utilisateurs), et Organisation à 5 €/mois par utilisateur — vérifié sur la page de tarification de Vikunja, le 8 octobre 2026. Le coût d'exécution de RAD dans votre propre projet ici (environ 91 $ US/mois) convient à une équipe déjà plus grande que la taille du plan Famille, exécutée dans une infrastructure que vous contrôlez.
  • Une comparaison de VPS auto-géré, dimensionné selon la configuration par défaut de Vikunja (1 vCPU / 0,5 GiB) : un Hetzner CPX11 ou un DigitalOcean 1 vCPU/2 Go Droplet coûte environ 6-12 $ US/mois — plus votre propre temps pour les sauvegardes et les correctifs, et aucun plan de contrôle Kubernetes à exécuter.
  • Cette variante GKE est en fait moins chère que le module Cloud Run ici (pas de volume NFS, et le pod lui-même coûte moins cher que le prix alwaysOn de Cloud Run pour la même forme) — l'un des rares cas dans ce catalogue où GKE n'est pas l'option la plus chère.

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

C'est l'avantage principal d'un projet géré par RAD, et il ne coûte rien pendant la pause. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression d'un module, cela ne démantèle pas Cloud SQL, aucune VM, ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

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. Par conséquent, 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.

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 à nouveau 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 un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après cela, Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, donc votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'étude/démo conviennent). Google affirme que la plupart des services sont entièrement fonctionnels dans les 36 heures suivant une restauration.

Un véritable écart : 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, 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é Vikunja 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​

Dans votre propre projet, ou une fois que 30 jours se sont écoulés sur un projet géré par RAD, il n'y a pas de pause gratuite — la suppression supprime les ressources pour de bon, et le retour de Vikunja signifie un redéploiement à partir de zéro. Cela coûte environ 78-81 crédits dans votre propre projet, ou environ 70,5-73,5 crédits dans un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si Vikunja reste inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution — environ 3 jours ou plus dans votre propre projet (environ 3,04 $ US par jour), ou environ 1 jour ou plus dans un projet géré par RAD (116 crédits par jour).

Conservez d'abord les données : les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, alors copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

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

Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est mise en pause et les données sont conservées, afin que personne ne reçoive 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 ; documentation de Google sur la suppression/restauration de projets pour les affirmations de pause/restauration ; tarification Vikunja.

1. Vue d'ensemble​

Vikunja fonctionne comme une charge de travail web Go. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod Go, 1 vCPU / 512 Mio par défaut, réplica unique
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — Vikunja ne prend pas en charge MySQL dans ce module
Build de conteneurCloud Build + Artifact RegistryEnveloppe l'image amont scratch avec une busybox greffée
SecretsSecret ManagerVIKUNJA_SERVICE_JWTSECRET auto-généré ; mot de passe de la base de données
Pièces jointesPVC de bloc (StatefulSet)PVC par pod à /data, où VIKUNJA_FILES_BASEPATH pointe
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; la sélection de tout autre moteur interrompt le démarrage.
  • Le pod se connecte à Cloud SQL via le proxy loopback avec sslmode=disable. Sur GKE, le sidecar Cloud SQL Auth Proxy écoute sur 127.0.0.1 (texte brut), donc le point d'entrée désactive SSL. Le même point d'entrée nécessite SSL sur l'IP privée sur Cloud Run — il se ramifie selon que l'hôte résolu est loopback.
  • L'image est basée sur scratch et reçoit une greffe busybox. L'image amont vikunja/vikunja n'a pas de shell, donc le build personnalisé copie une busybox statique pour exécuter le point d'entrée. container_image_source par défaut à "custom".
  • VIKUNJA_SERVICE_JWTSECRET est généré automatiquement et stocké dans Secret Manager. Le faire pivoter après le premier démarrage invalide toutes les sessions utilisateur actives.
  • Réplica unique par défaut (min_instance_count = 1, max_instance_count = 1) avec session_affinity = None. Vikunja n'a pas de coordination multi-réplicas intégrée.
  • Un PodDisruptionBudget maintient le pod en service pendant les mises à niveau de nœuds (enable_pod_disruption_budget = true).
  • Les pièces jointes résident sur un PVC de bloc. Les tâches, projets et utilisateurs sont dans PostgreSQL ; les pièces jointes sont écrites dans /data (VIKUNJA_FILES_BASEPATH suit stateful_pvc_mount_path), que stateful_pvc_enabled = true (par défaut) sauvegarde avec un PVC par pod, de sorte que la charge de travail se résout en un StatefulSet. stateful_fs_group = 1000 rend le volume modifiable par l'utilisateur de Vikunja. NFS est désactivé par défaut.
  • Un domaine personnalisé + une IP statique sont activés par défaut (enable_custom_domain = true, reserve_static_ip = true) afin que l'adresse externe survive aux redéploiements.
  • Quelques variables de la Fondation sont déclarées mais inertes. db_host_env_var_name, db_name_env_var_name, db_password_env_var_name, db_port_env_var_name, db_user_env_var_name, redis_auth, extra_service_ports, sql_instance_name, sql_instance_base_name, network_name, gke_cluster_selection_mode, prereq_gke_subnet_cidr, binauthz_evaluation_mode, explicit_secret_values, et scripts_dir sont reflétées dans variables.tf uniquement pour satisfaire les vérifications de convention — le main.tf de ce module ne les transmet pas, donc les définir n'a aucun effet.

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. L'espace de noms et les autres identifiants sont signalés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Vikunja​

Les pods Vikunja sont planifiés sur Autopilot, qui facture le CPU/la mémoire réellement demandés par les pods.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Vikunja pour voir les pods et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc,hpa -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe deploy -n "$NAMESPACE"

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

Vikunja stocke toutes les données d'application (tâches, projets, tableaux, utilisateurs, équipes) dans une instance gérée Cloud SQL pour PostgreSQL 15. Les pods l'atteignent en privé via le sidecar Cloud SQL Auth Proxy sur loopback (127.0.0.1, sslmode=disable) ; aucune IP publique n'est exposée. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe, consultez App_GKE.

C. Cloud Build et Artifact Registry​

Étant donné que l'image Vikunja amont est basée sur scratch, le module construit une image wrapper via Cloud Build (en greffant une busybox statique et le point d'entrée) et la pousse vers Artifact Registry. App_GKE force imagePullPolicy=Always pour l'image personnalisée afin qu'un rebuild-redeploy tire toujours de nouvelles couches.

  • Console : Cloud Build → Historique ; Artifact Registry → Dépôts.
  • CLI :
    gcloud builds list --project "$PROJECT" --limit 5
    gcloud artifacts docker images list <region>-docker.pkg.dev/$PROJECT/<repo> --project "$PROJECT"

D. Secret Manager​

Un secret cryptographique est généré automatiquement et stocké dans Secret Manager : VIKUNJA_SERVICE_JWTSECRET (utilisé pour signer les JWT de session utilisateur). Le mot de passe de la base de données est géré séparément par la fondation.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.

E. Pièces jointes​

Vikunja écrit les pièces jointes dans VIKUNJA_FILES_BASEPATH, que le module définit sur stateful_pvc_mount_path (/data) — le PVC de bloc par pod — de sorte que l'application et le volume ne peuvent pas être en désaccord. Sans cela, les pièces jointes reviendraient à l'éphémère /app/vikunja/files de Vikunja : la tâche les listerait toujours après un redémarrage tandis que le téléchargement échouerait. Le module ne déclare aucun bucket GCS dédié (storage_buckets = []).

  • Console : Kubernetes Engine → Stockage → le PVC Vikunja.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"

Voir App_GKE pour les options CMEK (manage_storage_kms_iam, enable_artifact_registry_cmek) et les montages GCS Fuse (gcs_volumes).

F. Réseau et Ingress​

Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing. Un domaine personnalisé avec un certificat géré par Google peut être activé, et une IP statique est réservée afin que l'adresse survive aux redéploiements.

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get ingress,svc -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les détails sur les domaines personnalisés, Cloud CDN et les IP statiques.

G. Cloud Logging et Monitoring​

Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des stratégies d'alerte facultatifs sont disponibles.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
    --project "$PROJECT" --limit 50

3. Comportement de l'application Vikunja​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute create-db-and-user.sh en utilisant postgres:15-alpine. Il se connecte via le proxy d'authentification Cloud SQL et crée de manière idempotente la base de données et le rôle de l'application, et accorde les privilèges. Le job peut être réexécuté en toute sécurité.
  • Migrations de schéma au démarrage. Vikunja applique ses propres migrations de schéma automatiquement au premier démarrage de l'application — le job db-init ne provisionne qu'une base de données vide, donc prévoyez un temps supplémentaire pour que le premier pod devienne Ready.
  • VIKUNJA_SERVICE_JWTSECRET est immuable après le premier démarrage. Il est généré une fois et écrit dans Secret Manager. Le modifier invalide toutes les sessions utilisateur actives. Ne le faites pivoter que pendant une fenêtre de maintenance planifiée.
  • Le premier compte enregistré devient le propriétaire. Vikunja n'est pas livré avec un administrateur pré-rempli. Ouvrez l'URL externe et enregistrez-vous — le premier compte est propriétaire de l'instance. Ensuite, définissez VIKUNJA_SERVICE_ENABLEREGISTRATION = "false" dans environment_variables.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /health — un point de terminaison public, non authentifié, qui renvoie 200 une fois que le serveur lie son port.

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement (les balises {{UIMeta group=N}} dans variables.tf). Seuls les paramètres spécifiques ou notables pour Vikunja sont listés dans chaque tableau ; toutes les autres entrées sont héritées de App_GKE avec son comportement et ses valeurs par défaut standards.

Groupe 0 — Métadonnées du module​

Métadonnées de plateforme standard (module_description, module_documentation, module_dependency, requires_services, module_services, credit_cost, require_credit_purchases, enable_purge, public_access, require_services_gcp_module, shared_users, technical_support_users, resource_creator_identity, impersonation_service_account, job_execution_wait_timeout) plus deux variables déclarées mais non référencées par ce module — explicit_secret_values et scripts_dir. credit_cost par défaut à 75, le même que la variante Cloud Run.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(obligatoire)Projet Google Cloud cible.
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
regionus-central1Région pour la charge de travail et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources pour le suivi des coûts/propriétés.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namevikunjaNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameVikunjaNom lisible par l'homme affiché dans la console.
application_descriptionVikunja task manager on GKE AutopilotDescription de la charge de travail.
application_versionlatestBalise de version de l'image Vikunja ; latest construit une version récente épinglée (2.3.0).

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit le wrapper greffé busybox via Cloud Build.
container_image""Remplace l'URI de l'image ; laissez vide pour le chemin AR auto-dérivé.
container_build_config{ enabled = true }Dockerfile/contexte pour le build personnalisé.
enable_image_mirroringtrueMiroir de l'image wrapper dans Artifact Registry.
min_instance_count / max_instance_count1 / 1Réplica unique — Vikunja n'a pas de coordination multi-réplicas.
container_port3456Port sur lequel le serveur Go de Vikunja écoute.
container_resources{ cpu_limit = "1000m", memory_limit = "512Mi" }Limites et requêtes CPU/mémoire.
enable_cloudsql_volumetrueSidecar Cloud SQL Auth Proxy (loopback 127.0.0.1).
workload_typenull → StatefulSetSe résout en un StatefulSet car le PVC des pièces jointes est activé.

Également dans ce groupe, suivant le comportement standard d'App_GKE : enable_vertical_pod_autoscaling (false), container_protocol (http1), timeout_seconds (300), cloudsql_volume_mount_path (/cloudsql), service_annotations / service_labels ({}).

Groupe 5 — Proxy conscient de l'identité (IAP)​

VariableValeur par défautDescription
enable_iapfalseExiger l'authentification Google Identity avant d'atteindre Vikunja.
iap_authorized_users / iap_authorized_groups[]Identités autorisées via IAP.
iap_oauth_client_id / iap_oauth_client_secret""Informations d'identification OAuth 2.0. Requises ensemble lorsque enable_iap = true.
iap_support_email""E-mail de support sur l'écran de consentement IAP.

Groupe 6 — Cluster GKE, réseau et variables d'environnement​

VariableValeur par défautDescription
environment_variables{}Paramètres VIKUNJA_* supplémentaires. Ne pas définir VIKUNJA_DATABASE_* ou VIKUNJA_SERVICE_JWTSECRET ici.
secret_environment_variables{}Mappage de var d'env → nom de secret Secret Manager.
gke_cluster_name""Cluster cible ; laissez vide pour découvrir automatiquement le cluster Services_GCP.
namespace_name""Espace de noms Kubernetes ; laissez vide pour générer automatiquement.
service_typeLoadBalancerComment le service Kubernetes est exposé.
session_affinityNoneRoutage persistant (ClientIP) ou None.
network_tags[]Balises réseau de nœud/pod pour le ciblage des règles de pare-feu.
enable_network_segmentationfalseCréer des ressources Kubernetes NetworkPolicy.

gke_cluster_selection_mode et prereq_gke_subnet_cidr sont déclarés pour la parité de convention et ne sont pas référencés. extra_service_ports est déclaré mais non transmis par ce module, donc le définir n'a aucun effet. Également dans ce groupe, suivant le comportement standard d'App_GKE : secret_rotation_period (2592000s), secret_propagation_delay (30), enable_multi_cluster_service (false), configure_service_mesh (false), termination_grace_period_seconds (30), deployment_timeout (600), et prereq_subnet_cidr_override ("", défini uniquement pour épingler le CIDR du sous-réseau VPC inline sur un déploiement existant).

Groupe 7 — Sauvegardes et configuration de StatefulSet​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde Cloud SQL automatisé (UTC).
backup_retention_days7Rétention ; augmentez à 30-90 pour la production/conformité.

stateful_pvc_enabled, stateful_pvc_size, stateful_pvc_mount_path, stateful_pvc_storage_class, stateful_headless_service, stateful_pod_management_policy, stateful_update_strategy, stateful_fs_group — modèles de PVC StatefulSet. Activé par défaut pour Vikunja : le PVC (/data, fs_group 1000) contient les pièces jointes. Conservez stateful_pvc_enabled = true.

Groupe 8 — Quota de ressources​

enable_resource_quota, quota_cpu_requests, quota_cpu_limits, quota_memory_requests, quota_memory_limits — ResourceQuota de l'espace de noms. Les valeurs de mémoire nécessitent des suffixes d'unité binaire (par exemple "4Gi").

Groupe 9 — Scripts SQL personnalisés et stratégies de fiabilité​

VariableValeur par défautDescription
enable_pod_disruption_budgettrueProtéger la disponibilité pendant les mises à niveau de nœuds.
pdb_min_available1Nombre minimal de pods disponibles pendant les perturbations volontaires.
enable_topology_spread / topology_spread_strictfalseRépartir les pods entre les zones.

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécution facultative de scripts SQL post-provisionnement sur la base de données.

Groupe 10 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configHTTP /health, délai de 30s, fenêtre d'échec de 30 × 10sSonde de démarrage ; large fenêtre de réessai pour les migrations au premier démarrage.
health_check_configHTTP /health, délai de 30sSonde de vivacité.
uptime_check_configdésactivé, chemin /healthTest de disponibilité Cloud Monitoring facultatif.
alert_policies[]Stratégies d'alerte métrique facultatives.

Groupe 11 — Automatisation de la charge de travail​

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré.
cron_jobs[]CronJobs Kubernetes planifiés.
additional_services[]Sidecar ou services d'aide déployés aux côtés de Vikunja.

Groupe 12 — CI/CD, GitHub et autorisation binaire​

Intégration standard App_GKE Cloud Build / Cloud Deploy — voir App_GKE. 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 est déclaré pour la parité de convention et n'est pas référencé.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfsfalseNon nécessaire — les pièces jointes sont sur le PVC de bloc.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
nfs_volume_namenfs-data-volumeNom du volume pour le montage.
nfs_instance_name / nfs_instance_base_name"" / app-nfsVM NFS existante à réutiliser, ou nom de base pour une VM inline.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
create_cloud_storagetrueCréer des buckets GCS supplémentaires.
storage_buckets[]Vikunja ne déclare aucun bucket par défaut.
gcs_volumes[]Montages de volume GCS Fuse via le pilote CSI.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.
max_images_to_retain7Nombre maximal d'images Artifact Registry récentes à conserver.
delete_untagged_imagestrueSupprimer automatiquement les images non taguées.
image_retention_days30Jours après lesquels les images sont éligibles à la suppression.

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redisfalseVikunja n'utilise pas Redis ; fourni pour la parité de convention de la Fondation.
redis_host / redis_port"" / 6379Détails de connexion Redis, significatifs uniquement si enable_redis = true.

redis_auth est déclaré mais non transmis par ce module, donc le définir n'a aucun effet.

Groupe 16 — Configuration de la base de données​

VariableValeur par défautDescription
database_typePOSTGRESMoteur Cloud SQL ; fixé à PostgreSQL 15 par Vikunja_Common quelle que soit cette valeur.
application_database_namevikunjaNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_uservikunjaUtilisateur de la base de données de l'application. Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré (16-64).
enable_auto_password_rotationfalseRotation du mot de passe de la base de données sans interruption.
rotation_propagation_delay_sec90Secondes à attendre après la rotation avant de redémarrer les pods.
enable_postgres_extensions / postgres_extensionsfalse / []Installation facultative d'extensions PostgreSQL.

enable_mysql_plugins / mysql_plugins ne sont pas applicables à Vikunja (PostgreSQL uniquement). sql_instance_name, sql_instance_base_name, et l'ensemble db_*_env_var_name (db_host_env_var_name, db_name_env_var_name, db_password_env_var_name, db_port_env_var_name, db_user_env_var_name) sont déclarés pour la parité de convention et ne sont pas référencés/transmis par ce module.

Groupe 17 — Importation/restauration de sauvegarde​

enable_backup_import, backup_source, backup_file, backup_format — restaurer la base de données de l'application à partir d'un fichier de sauvegarde lors du déploiement.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
enable_custom_domaintrueProvisionner Ingress pour les noms d'hôte personnalisés + certificat géré.
application_domains[]Noms d'hôte à servir.
reserve_static_iptrueIP externe stable sur les redéploiements.
static_ip_name""Nom de l'IP statique ; laissez vide pour générer automatiquement.

network_name est déclaré pour la parité de convention et n'est pas référencé (le réseau est auto-découvert).

Groupe 21 — Cloud Armor et CDN​

enable_cloud_armor, admin_ip_ranges, cloud_armor_policy_name, enable_cdn — attacher un WAF Cloud Armor et Cloud CDN au backend GKE Ingress.

Groupe 22 — VPC Service Controls et journalisation d'audit​

enable_vpc_sc, vpc_cidr_ranges, vpc_sc_dry_run, organization_id, enable_audit_logging — appliquer un périmètre VPC-SC et des journaux d'audit Cloud détaillés.

Toutes les autres entrées suivent le comportement standard d'App_GKE.


5. Sorties​

Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsMappage des ClusterIPs pour les services spécifiques à l'étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Vikunja.
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données de l'application.
database_password_secretSecret Manager secret contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration et (facultatifs) d'importation.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / cicd_configurationÉtat et détails CI/CD (dépôt, déclencheur, registre).
github_repository_url / github_repository_owner / github_repository_nameDétails CI/CD GitHub.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

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 du plan. Ce module transmet sa configuration au moteur de base App_GKE, qui valide les valeurs et les combinaisons au moment du plan — un réplica en lecture sans son primaire, IAP sans identités autorisées, une non-concordance StatefulSet/Deployment, des valeurs de quota de mémoire sans suffixes binaires, un container_port/backup_retention_days 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
VIKUNJA_SERVICE_JWTSECRET (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueLe faire pivoter invalide toutes les sessions utilisateur actives, forçant une reconnexion immédiate pour tout le monde.
application_database_name / application_database_userDéfinir une seule foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit toutes les données.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans source/fichier de sauvegarde valide fait échouer le job d'importation.
stateful_pvc_enabledtrueÉlevéSans le PVC, les pièces jointes vivent sur le disque éphémère du pod et sont perdues à chaque redémarrage du pod.
container_image_sourcecustomÉlevéprebuilt déploie l'image scratch brute sans mappage shell/point d'entrée — le conteneur ne peut pas mapper DB_* et échoue.
enable_cloudsql_volumetrueÉlevéLe sidecar Auth Proxy est requis pour la connectivité PostgreSQL ; sa désactivation est bloquée par une garde de validation au moment du plan.
min_instance_count1MoyenLa propre validation de la variable autorise 0–1000 et il n'y a pas de garde au moment du plan rejetant 0 — la logique de déploiement d'App_GKE contraint silencieusement min_instance_count=0 à un min_replicas de 1 au moment de l'apply (local.min_instance_count > 0 ? local.min_instance_count : 1), de sorte que le nombre de réplicas déployés diverge silencieusement de ce qui a été configuré au lieu d'échouer avec une erreur.
VIKUNJA_SERVICE_ENABLEREGISTRATION (variable d'environnement)"false" après le premier administrateurÉlevéLaisser l'inscription ouverte permet à quiconque ayant l'URL de créer un compte.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers nus sont des octets et bloquent toute planification de pod dans l'espace de noms.
enable_pod_disruption_budgettrueMoyenLa désactivation permet à GKE d'expulser le pod pendant la maintenance sans garde de disponibilité.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.
db_*_env_var_name, redis_auth, extra_service_ports, sql_instance_name/sql_instance_base_name, network_name, gke_cluster_selection_mode, prereq_gke_subnet_cidr, binauthz_evaluation_modeLaisser par défautFaibleDéclarés pour la parité de convention de la Fondation mais non transmis/référencés par ce module — les définir n'a aucun effet sur le déploiement.

Pour le comportement de la fondation référencé partout — IAM et Workload Identity, autoscaling, ingress et certificats, 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 à Vikunja partagée avec la variante Cloud Run est décrite dans Vikunja_Common.

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