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 projet | Projet géré par RAD | |
|---|---|---|
| Frais de module (uniques) | 75 crédits | 67,5 crédits (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites, puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minute | Identique |
| Coût d'exécution Google Cloud | 91,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 GiB | 34,29 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | 91,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
alwaysOnde 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 Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod Go, 1 vCPU / 512 Mio par défaut, réplica unique |
| Base de données | Cloud SQL pour PostgreSQL 15 | Obligatoire — Vikunja ne prend pas en charge MySQL dans ce module |
| Build de conteneur | Cloud Build + Artifact Registry | Enveloppe l'image amont scratch avec une busybox greffée |
| Secrets | Secret Manager | VIKUNJA_SERVICE_JWTSECRET auto-généré ; mot de passe de la base de données |
| Pièces jointes | PVC de bloc (StatefulSet) | PVC par pod à /data, où VIKUNJA_FILES_BASEPATH pointe |
| Ingress | Cloud Load Balancing | LoadBalancer 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 sur127.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
scratchet reçoit une greffe busybox. L'image amontvikunja/vikunjan'a pas de shell, donc le build personnalisé copie une busybox statique pour exécuter le point d'entrée.container_image_sourcepar défaut à"custom". VIKUNJA_SERVICE_JWTSECRETest 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) avecsession_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_BASEPATHsuitstateful_pvc_mount_path), questateful_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 = 1000rend 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, etscripts_dirsont reflétées dansvariables.tfuniquement pour satisfaire les vérifications de convention — lemain.tfde 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.shen utilisantpostgres: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-initne provisionne qu'une base de données vide, donc prévoyez un temps supplémentaire pour que le premier pod devienne Ready. VIKUNJA_SERVICE_JWTSECRETest 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"dansenvironment_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é
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
region | us-central1 | Région pour la charge de travail et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
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
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | vikunja | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | Vikunja | Nom lisible par l'homme affiché dans la console. |
application_description | Vikunja task manager on GKE Autopilot | Description de la charge de travail. |
application_version | latest | Balise 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
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
container_image_source | custom | Construit 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_mirroring | true | Miroir de l'image wrapper dans Artifact Registry. |
min_instance_count / max_instance_count | 1 / 1 | Réplica unique — Vikunja n'a pas de coordination multi-réplicas. |
container_port | 3456 | Port 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_volume | true | Sidecar Cloud SQL Auth Proxy (loopback 127.0.0.1). |
workload_type | null → StatefulSet | Se 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)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_iap | false | Exiger 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
| Variable | Valeur par défaut | Description |
|---|---|---|
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_type | LoadBalancer | Comment le service Kubernetes est exposé. |
session_affinity | None | Routage persistant (ClientIP) ou None. |
network_tags | [] | Balises réseau de nœud/pod pour le ciblage des règles de pare-feu. |
enable_network_segmentation | false | Cré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
| Variable | Valeur par défaut | Description |
|---|---|---|
backup_schedule | 0 2 * * * | Cron de sauvegarde Cloud SQL automatisé (UTC). |
backup_retention_days | 7 | Ré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é
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_pod_disruption_budget | true | Protéger la disponibilité pendant les mises à niveau de nœuds. |
pdb_min_available | 1 | Nombre minimal de pods disponibles pendant les perturbations volontaires. |
enable_topology_spread / topology_spread_strict | false | Ré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é
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe_config | HTTP /health, délai de 30s, fenêtre d'échec de 30 × 10s | Sonde de démarrage ; large fenêtre de réessai pour les migrations au premier démarrage. |
health_check_config | HTTP /health, délai de 30s | Sonde de vivacité. |
uptime_check_config | désactivé, chemin /health | Test de disponibilité Cloud Monitoring facultatif. |
alert_policies | [] | Stratégies d'alerte métrique facultatives. |
Groupe 11 — Automatisation de la charge de travail
| Variable | Valeur par défaut | Description |
|---|---|---|
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)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Non nécessaire — les pièces jointes sont sur le PVC de bloc. |
nfs_mount_path | /mnt/nfs | Chemin de montage à l'intérieur du conteneur. |
nfs_volume_name | nfs-data-volume | Nom du volume pour le montage. |
nfs_instance_name / nfs_instance_base_name | "" / app-nfs | VM NFS existante à réutiliser, ou nom de base pour une VM inline. |
Groupe 14 — Cloud Storage et Artifact Registry
| Variable | Valeur par défaut | Description |
|---|---|---|
create_cloud_storage | true | Cré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_cmek | false | Options CMEK. |
max_images_to_retain | 7 | Nombre maximal d'images Artifact Registry récentes à conserver. |
delete_untagged_images | true | Supprimer automatiquement les images non taguées. |
image_retention_days | 30 | Jours après lesquels les images sont éligibles à la suppression. |
Groupe 15 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Vikunja n'utilise pas Redis ; fourni pour la parité de convention de la Fondation. |
redis_host / redis_port | "" / 6379 | Dé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
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES | Moteur Cloud SQL ; fixé à PostgreSQL 15 par Vikunja_Common quelle que soit cette valeur. |
application_database_name | vikunja | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
application_database_user | vikunja | Utilisateur de la base de données de l'application. Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16-64). |
enable_auto_password_rotation | false | Rotation du mot de passe de la base de données sans interruption. |
rotation_propagation_delay_sec | 90 | Secondes à attendre après la rotation avant de redémarrer les pods. |
enable_postgres_extensions / postgres_extensions | false / [] | 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
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Provisionner Ingress pour les noms d'hôte personnalisés + certificat géré. |
application_domains | [] | Noms d'hôte à servir. |
reserve_static_ip | true | IP 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.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
stage_service_cluster_ips | Mappage des ClusterIPs pour les services spécifiques à l'étape. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre Vikunja. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Manager secret contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
initialization_jobs / db_import_job | Noms des jobs de configuration et (facultatifs) d'importation. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_name | Détails CI/CD GitHub. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
kubernetes_ready | Indique 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_enabled | Journalisation 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, uncontainer_port/backup_retention_dayshors limites. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'apply ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
VIKUNJA_SERVICE_JWTSECRET (auto-généré) | Ne jamais faire pivoter après le premier démarrage | Critique | Le faire pivoter invalide toutes les sessions utilisateur actives, forçant une reconnexion immédiate pour tout le monde. |
application_database_name / application_database_user | Définir une seule fois | Critique | Immuable 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_import | false sauf restauration | Critique | L'activation sans source/fichier de sauvegarde valide fait échouer le job d'importation. |
stateful_pvc_enabled | true | É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_source | custom | É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_volume | true | É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_count | 1 | Moyen | La 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 / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers nus sont des octets et bloquent toute planification de pod dans l'espace de noms. |
enable_pod_disruption_budget | true | Moyen | La désactivation permet à GKE d'expulser le pod pendant la maintenance sans garde de disponibilité. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop 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_mode | Laisser par défaut | Faible | Dé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.
Guides associés
- Lab pratique : Vikunja sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Vikunja sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- Vikunja Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.