Kimai sur GKE Autopilot
Kimai est une application de suivi du temps gratuite et open source (Symfony/PHP) utilisée par les freelances et les agences pour le suivi des heures facturables, les feuilles de temps et les rapports qui alimentent la facturation. Ce module déploie Kimai 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 utilisés par Kimai et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications 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 Kimai sur RAD, et comparaison
Le module GKE Autopilot de Kimai sur RAD coûte environ 97 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 110 crédits (11,00 $ US). GKE convient à Kimai qui doit rester disponible pour une agence plus grande ; pour le coût le plus bas, le module Cloud Run exécute le même Kimai pour environ 70 $ US par mois. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 97 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 110 crédits (11,00 $ US au prix de la recharge) | 99,0 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 à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 97 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 123 crédits par jour, environ 3 690 par mois (environ 369 $ US au prix de la recharge ; estimé à partir des prix catalogue de Google, et incluant les frais de cluster) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est détenu en réserve |
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 projet propre suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que 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 : 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 ponctuelle, et moins avec un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas de deuxième base de données.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (valeur par défaut du module) | Par mois |
|---|---|
| Pod GKE Autopilot, 1x vCPU / 2 GiB | 39,68 $ US |
| Cloud SQL pour MySQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Cloud NAT et réseau | 5,00 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 $ US |
| Frais de gestion du cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $ |
| Total | environ 97 $ US |
Comparaison
- Kimai Cloud (Standard 3,99 €/utilisateur/mois, 2,99 € annuellement ; Professionnel 4,99 €/utilisateur/mois, 3,99 € annuellement — kimai.org/en/pricing) reste moins cher en espèces pour la plupart des tailles d'équipe que le chiffre GKE ci-dessus, pour la même raison : il évolue avec les utilisateurs, ce n'est pas le cas ici.
- Le coût de RAD ne croît pas par utilisateur, et un déploiement GKE reste disponible en continu plutôt que de dépendre de la disponibilité d'un tiers.
- Une instance Compute Engine e2-standard-2 (2 vCPU/8 Go, environ 49 $/mois) est la comparaison autogérée de taille plus proche, moins la base de données gérée, les sauvegardes et les correctifs inclus par RAD.
- Ou consultez le guide Cloud Run pour l'option à moindre coût.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin
Si Kimai s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Kimai dont vous n'avez besoin qu'occasionnellement — un projet de cours, une démo, une évaluation de courte durée — que de le faire fonctionner en continu.
Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, seront utilisables après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. La facturation étant déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL ou le calcul propre à Kimai un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
- Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes de Kimai sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Kimai et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de travail de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
GKE maintient au moins un pod en cours d'exécution, il ne se met donc jamais à l'échelle zéro de lui-même. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 $ US), car RAD recrée le projet et les services partagés avant Kimai. La suppression ne permet d'économiser de l'argent que si Kimai devait rester inutilisé pendant environ quatre jours ou plus, à la fois dans votre propre projet (environ 3,22 $ US par jour) et dans un projet géré par RAD (123 crédits par jour).
- Supprimez tout ce que Kimai utilise. La majeure partie du coût d'exécution est généralement la base de données. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de Kimai alors que quelque chose d'autre partage le projet n'économise que la partie calcul propre à Kimai.
- Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, 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 Kimai pour une classe. Chaque participant dispose de Kimai 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 à l'avance, 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 Kimai pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est interrompue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin de l'engagement, 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 mobile money.
Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation quotidienne de 93 crédits de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle. Tarification Kimai Cloud. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
Kimai s'exécute en tant que pod Symfony/PHP (l'image officielle kimai/kimai2:apache,
enveloppée dans un build personnalisé léger) sur GKE Autopilot. Le déploiement
connecte un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pod Symfony/PHP, 1 vCPU / 2 GiB par défaut ; réplica unique par défaut (GKE n'a pas de mise à l'échelle à zéro) |
| Base de données | Cloud SQL pour MySQL 8.0 | Requis — Kimai_Common fixe le moteur ; PostgreSQL n'est pas pris en charge |
| Stockage d'objets | Cloud Storage | Un bucket storage, monté via GCS-FUSE à /opt/kimai/var/data pour les logos/modèles de facture téléchargés et les données de plugin |
| Secrets | Secret Manager | APP_SECRET (clé de signature Symfony) et ADMINPASS (mot de passe administrateur) générés automatiquement ; mot de passe de la base de données |
| Ingress | Cloud Load Balancing | LoadBalancer externe ; domaine personnalisé et IP statique réservée sont pris en charge (voir §4 pour les valeurs par défaut utilisées par le déploiement en direct de ce module) |
Valeurs par défaut judicieuses à connaître d'emblée :
- MySQL 8.0 est obligatoire. Le moteur de base de données est fixé par
Kimai_Common; la sélection de tout autre moteur interrompt le déploiement. - L'image wrapper personnalisée est requise, non facultative.
container_image_source = "custom"construit une image légèreFROM kimai/kimai2dont le point d'entrée compose la chaîne de connexion uniqueDATABASE_URLde Kimai au démarrage du conteneur à partir des valeurs secrètes injectées par la fondation (voir §3). container_port = 8001, pas le port 80 — confirmé via des tests locauxdocker runet un déploiement en direct. C'est le port d'écoute réel de la variante d'image:apache.enable_cloudsql_volume = true— c'est la valeur par défaut opposée àKimai_CloudRun. Un sidecar Cloud SQL Auth Proxy est injecté dans le pod et écoute sur127.0.0.1; l'aliasDB_IPdu point d'entrée du wrapper se résout à cette adresse de bouclage ici, plutôt qu'à l'IP privée brute utilisée par Cloud Run.- Deux secrets Secret Manager, générés une seule fois.
APP_SECRET(clé de signature CSRF/session Symfony) etADMINPASS(mot de passe super-administrateur initial) — tous deux réinjectés depuis Secret Manager à chaque démarrage de conteneur, donc aucun volume persistant n'est nécessaire juste pour les maintenir stables. - Pas de mise à l'échelle à zéro.
min_instance_count = 1,max_instance_count = 1par défaut ; GKE Autopilot maintient le nombre de réplicas d'un déploiement à son minimum configuré ou au-dessus. enable_nfspar défauttruemais est fonctionnellement inutilisé. Il monte Cloud Filestore NFS à/var/lib/kimai, mais le chemin de stockage persistant réel est le bucketstoragemonté via GCS-FUSE à/opt/kimai/var/data. Rien n'écrit sur le montage NFS. Peut être désactivé en toute sécurité.- Pas de job de migration séparé.
kimai:install(création de schéma et migrations) s'exécute à chaque démarrage de conteneur, de manière idempotente, dans le cadre de la chaîne de point d'entrée du fournisseur — seul un jobdb-initest nécessaire pour créer la base de données et l'utilisateur au préalable.
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 Kimai
Kimai s'exécute par défaut en tant que déploiement à réplica unique. Autopilot facture le
CPU/mémoire que le pod demande réellement. Un sidecar Cloud SQL Auth Proxy s'exécute
à côté du conteneur principal (enable_cloudsql_volume = true).
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Kimai pour les pods, les événements et les journaux. Kubernetes Engine → Services et Ingress affiche l'IP externe.
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 -c <service-name>
Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Déploiement vs StatefulSet).
B. Cloud SQL pour MySQL 8.0
Kimai stocke toutes les données de l'application (projets, activités, feuilles de temps, utilisateurs,
factures) dans une instance Cloud SQL gérée pour MySQL 8.0. Le pod y accède
privément via un sidecar Cloud SQL Auth Proxy écoutant sur
127.0.0.1. Lors du premier déploiement, un job db-init crée la base de données
et l'utilisateur de l'application ; kimai:install crée ensuite le schéma lors du
premier démarrage du conteneur.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs et 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 Secret Manager contenant le mot de passe se trouvent tous dans les Sorties. Voir App_GKE pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe.
C. Cloud Storage
Deux buckets GCS peuvent exister pour ce déploiement : un bucket storage provisionné
par Kimai_Common et monté via GCS-FUSE à /opt/kimai/var/data (logos/modèles de facture
téléchargés, données de plugin), et un bucket générique de niveau Fondation séparé
(storage_buckets, par défaut un bucket nommé data) que Kimai ne lit ni n'écrit
sauf si vous le connectez explicitement.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT"
Voir App_GKE pour les options CMEK et les montages CSI GCS Fuse.
D. Secret Manager
Deux secrets sont générés automatiquement et stockés dans Secret Manager :
APP_SECRET (clé de signature CSRF/session Symfony) et ADMINPASS (le mot de passe
initial du compte super-administrateur). 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" --filter="name~kimai"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.
E. Réseau et ingress
Par défaut, la charge de travail est exposée via une IP externe de Cloud Load Balancing ;
un Ingress Kubernetes pour les domaines personnalisés et une IP statique réservée peuvent être superposés
(les deux valeurs par défaut du module sont true, bien que le déploiement en direct de ce module ait été exécuté avec les deux définis sur false — voir Sorties et §4).
- 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 l'IP statique.
F. 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, avec des tests de disponibilité et des stratégies d'alerte facultatifs.
- 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 Kimai
- Une seule
DATABASE_URLcomposée entièrement à l'exécution, non transmise via Terraform. La couche Doctrine DBAL de Kimai lit une chaîne de connexion,DATABASE_URL=mysql://user:pass@host:port/db?charset=utf8mb4&serverVersion=8.0, et non des variablesDB_*discrètes.Kimai_Commonconstruit une image wrapper personnalisée légèreFROM kimai/kimai2dont leentrypoint.shcomposeDATABASE_URLau démarrage du conteneur à partir des variables d'environnementDB_USER/DB_NAME/DB_PASSWORD/DB_IPinjectées par la fondation — encodant l'URL du mot de passe avecphp -r 'echo rawurlencode(...)'— avant de passer sans modification audocker-php-entrypoint /entrypoint.shdu fournisseur. DB_IPse résout à la boucle de rappel du sidecar Auth Proxy sur GKE. Le wrapper lit l'hôte depuis$DB_IP(aliasé viadb_host_env_var_name = "DB_IP"). Sur GKE, avecenable_cloudsql_volume = true(la valeur par défaut), cela se résout à l'adresse127.0.0.1du sidecar cloud-sql-proxy — un hôte simple sans deux-points, tout comme l'IP privée brute utilisée par la variante Cloud Run de ce même module. C'est pourquoi le même code de point d'entrée du wrapper fonctionne sans modification sur les deux plateformes.- Vérifié localement avant même de toucher le cloud. L'étape d'encodage URL du mot de passe et la vérification préliminaire de l'attente de la base de données du fournisseur ont toutes deux été confirmées en construisant l'image du wrapper et en l'exécutant localement contre un conteneur MySQL réel avec un mot de passe contenant des caractères spéciaux
(
@:/?), en détectant et en corrigeant les problèmes avant la première tentative de déploiement dans le cloud. - Comportement de la vérification de santé. Les sondes de démarrage et de vivacité ciblent toutes deux
GET /en/login(la page de connexion de Kimai), qui renvoie200une fois que l'application est prête.EXTERNAL_IP=$(kubectl get svc -n "$NAMESPACE" -o jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}')
curl -s -o /dev/null -w "%{http_code}\n" "http://${EXTERNAL_IP}/en/login" # expect 200 - Le bootstrap administrateur s'exécute à chaque démarrage, de manière idempotente. Le point d'entrée du fournisseur exécute
kimai:user:create admin "$ADMINMAIL" ROLE_SUPER_ADMIN "$ADMINPASS"à chaque démarrage de conteneur lorsqueADMINPASSest défini — une opération nulle une fois le compte existant. Le nom d'utilisateur est toujoursadmin, codé en dur par l'image du fournisseur quelle que soit la valeur deadmin_email. - Inspecter l'exécution du job :
kubectl get jobs -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
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 Kimai sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour le cluster et les ressources régionales. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | kimai | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | Kimai | Nom lisible par l'homme affiché dans la console. |
application_description | Kimai time tracking on GKE | Description de la charge de travail Kubernetes. |
application_version | latest | Tag d'image pilotant le build kimai/kimai2. "latest" correspond au tag roulant :apache maintenu ; toute autre valeur correspond à "<version>-apache". |
admin_email | admin@example.com | E-mail du compte super-administrateur, injecté en tant que ADMINMAIL. Le nom d'utilisateur du compte est toujours admin, codé en dur par le point d'entrée du fournisseur. |
enable_gcs_storage_volume | true | Monte le bucket storage via GCS-FUSE à /opt/kimai/var/data. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_image_source | custom | Construit l'image wrapper composant DATABASE_URL via Cloud Build — requis, non facultatif, pour ce module. |
min_instance_count / max_instance_count | 1 / 1 | GKE n'a pas de mise à l'échelle à zéro ; réplica unique par défaut. |
container_port | 8001 | La variante d'image :apache de Kimai écoute sur le port 8001, confirmé par des tests locaux et un déploiement en direct. |
cpu_limit / memory_limit | 1000m / 2Gi | Limites de ressources par pod. |
php_memory_limit | 512M | memory_limit PHP (le point d'entrée du fournisseur lit directement la variable d'environnement memory_limit en minuscules). |
enable_cloudsql_volume | false | Sidecar Cloud SQL Auth Proxy sur 127.0.0.1. Conserver true sur GKE — l'alias DB_IP du wrapper en dépend. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | IP externe par défaut. |
session_affinity | ClientIP | Acheminer les requêtes d'un client vers le même pod. |
workload_type | null | Se résout automatiquement en Deployment (Kimai n'a pas besoin d'identité PVC par pod). |
Groupe 11 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laisser vide pour utiliser le job db-init unique intégré. Il n'y a pas de job de migration séparé — kimai:install s'exécute à chaque démarrage de conteneur, de manière idempotente. |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Fonctionnellement inutilisé — monté à /var/lib/kimai, mais le véritable stockage persistant de Kimai est le bucket storage monté via GCS-FUSE à /opt/kimai/var/data. Peut être désactivé en toute sécurité. |
Groupe 14 — Cloud Storage et Artifact Registry
| Variable | Valeur par défaut | Description |
|---|---|---|
storage_buckets | [{ name_suffix = "data" }] | Bucket générique de niveau Fondation. Non lu ni écrit par Kimai. |
gcs_volumes | [] | Montages de volume GCS Fuse supplémentaires, fusionnés avec le montage du bucket storage. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | null (se résout en MYSQL_8_0) | Fixé par Kimai_Common. |
application_database_name / application_database_user | kimai | Préfixé par le locataire au moment du déploiement. Immuable après le premier déploiement. |
db_host_env_var_name | DB_IP | Aliasse l'hôte de la base de données afin que la composition DATABASE_URL du wrapper lise un hôte simple, sans deux-points — se résout à la boucle de rappel du sidecar Auth Proxy sur GKE. |
db_user_env_var_name / db_name_env_var_name / db_port_env_var_name / db_password_env_var_name | "" (les quatre) | Inutilisé par Kimai — le wrapper lit directement les DB_USER/DB_NAME/DB_PASSWORD standard et code en dur le port 3306. |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Ingress Kubernetes avec application_domains. Le déploiement vérifié en direct de ce module a défini ceci false (voir config/deploy.tfvars). |
reserve_static_ip | true | Une IP stable qui survit aux redéploiements. Le déploiement vérifié en direct de ce module a également défini ceci false. |
network_tags | ["nfsserver"] | Ciblage du pare-feu ; requis pour la connectivité NFS lorsque enable_nfs = true. |
Groupe 15 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Kimai n'a pas d'intégration Redis intégrée utilisée par ce module — son backend de cache par défaut est le système de fichiers local. |
Toutes les autres entrées (métadonnées du groupe 0, environnement du groupe 2, secrets du groupe 5, StatefulSet du groupe 7, quota de ressources du groupe 8, fiabilité du groupe 9, observabilité du groupe 10, CI/CD du groupe 12, sauvegarde du groupe 17, SQL personnalisé du groupe 18, IAP du groupe 20, Cloud Armor du groupe 21, VPC-SC du groupe 22) se comportent exactement comme documenté dans App_GKE.
5. Sorties
Retourné lors d'un déploiement réussi — 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 Kubernetes. |
service_cluster_ip / service_external_ip | IP interne / externe. |
service_url | URL du service. |
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 Secret Manager contenant le mot de passe de la base de données. |
database_host | 127.0.0.1 via le sidecar Cloud SQL Auth Proxy. |
storage_buckets | Buckets Cloud Storage créés. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
initialization_jobs | Nom du job de configuration (db-init). |
kubernetes_ready | Indique si le point de terminaison du cluster est disponible et si toutes les ressources K8s sont déployées. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants du projet. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | Statut VPC-SC. |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration via le moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource.
| Paramètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
container_image_source | custom | Critique | Le passage à prebuilt déploie l'image kimai/kimai2 standard sans point d'entrée wrapper — DATABASE_URL n'est jamais composé, de sorte que le pod ne peut pas du tout atteindre MySQL. |
enable_cloudsql_volume | true sur GKE | Critique | La définition de false supprime le sidecar Auth Proxy dont l'alias DB_IP du point d'entrée du wrapper dépend pour atteindre Cloud SQL — le pod ne peut pas se connecter. |
container_port | 8001 | Critique | La variante d'image :apache écoute sur le port 8001, pas 80 — pointer la plateforme vers le mauvais port rend le service inaccessible même si le conteneur est sain. |
application_database_name / application_database_user | Définir une 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 feuilles de temps, projets et factures. |
APP_SECRET (généré automatiquement) | Ne jamais modifier manuellement dans Secret Manager après le premier démarrage | Élevé | Kimai l'utilise comme clé de signature de sécurité Symfony ; le modifier invalide les jetons CSRF et les sessions actives. |
Compte administrateur par défaut (nom d'utilisateur toujours admin, mot de passe dans le secret ADMINPASS) | Récupérer le mot de passe généré depuis Secret Manager et se connecter rapidement | Élevé | Le mot de passe administrateur est un véritable secret généré par déploiement, pas une valeur par défaut publique bien connue — mais il est toujours utile de confirmer qui a un accès en lecture au secret. |
max_instance_count | 1 sauf si vérifié autrement | Élevé | La mise à l'échelle au-delà d'un pod sans vérifier le comportement de session de Kimai sous plusieurs pods risque des sessions utilisateur incohérentes entre les pods. |
enable_nfs | false sauf si nécessaire à d'autres fins | Faible / coût | Par défaut true et provisionne un partage Filestore que Kimai n'utilise jamais — un coût récurrent inutile ; la persistance réelle est le bucket storage monté via GCS-FUSE. |
enable_cloud_armor | activer pour la production | Moyen | Le service est publiquement accessible sans protection WAF par défaut. |
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 à Kimai partagée avec la variante Cloud Run est décrite dans Kimai_Common.
Guides associés
- Lab pratique : Kimai sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Kimai sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- Kimai 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.