Gitea sur GKE Autopilot
Gitea est un service Git léger et auto-hébergé, ainsi qu'une plateforme d'hébergement de code source (un fork communautaire de Gogs) offrant l'hébergement de dépôts, le suivi des problèmes, les requêtes de tirage (pull requests), un exécuteur CI/CD intégré (Actions), la révision de code et un registre de paquets à partir d'un seul binaire Go. Ce module déploie Gitea sur GKE Autopilot au-dessus de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.
Ce guide se concentre sur les services cloud que Gitea utilise et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et le 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 Gitea sur RAD, et comment cela se compare
L'exécution de Gitea dans votre propre projet Google Cloud coûte environ 142,62 $ US/mois en frais Google Cloud, en plus d'un frais de module RAD unique de 110 crédits (99 crédits — 10 % de moins — dans un projet géré par RAD). Gitea est un service Git léger et auto-hébergé, ainsi qu'une plateforme d'hébergement de code source (un fork communautaire de Gogs) avec plus de 45 000 étoiles sur GitHub. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et le reprendre plus tard — voir "Mettez-le en pause gratuitement" ci-dessous.
Gitea est également disponible sur Cloud Run — voir le guide Cloud Run pour l'option à moindre coût ; ce guide couvre la variante GKE.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 110 crédits (une seule fois) | 99 crédits (une seule fois, 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 | Idem |
| Coût d'exécution Google Cloud | ~142,62 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue | ~138 crédits/jour (~13,80 $ US/jour), mesuré à l'heure au prix catalogue plus la marge de RAD |
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).
Coût d'exécution par défaut dans votre propre projet
| Ressource | $ US/mois (prix catalogue Google, us-central1) |
|---|---|
| Pod GKE Autopilot, 2x vCPU / 2 Gio | 72,16 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion de cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 |
| Total | 142,62 $ US |
Comment cela se compare
- Le niveau Enterprise de Gitea Cloud commence à 9,50 $ US/utilisateur/mois (engagement d'un an requis en ligne ; SAML SSO, journaux d'audit, support prioritaire) — vérifié sur https://about.gitea.com/pricing. Pour une équipe de cinq personnes, cela représente environ 47,50 $ US/mois et augmente avec les effectifs ; le coût d'exécution de RAD dans votre propre projet est un forfait d'environ 142,62 $ US/mois (GKE) quel que soit le nombre d'utilisateurs, sur une instance open source que vous contrôlez entièrement.
- Le véritable compromis ici est le plafond par rapport au contrôle, pas le prix : un plan SaaS géré est moins cher à cette échelle, et le coût d'exécution de RAD est ce que coûtent réellement Cloud SQL, le calcul et le réseau au prix catalogue de Google, sans rien de caché dans un prix de siège groupé.
- RAD ne prétend pas être moins cher qu'un simple VPS en termes monétaires — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Gitea est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer le projet purement et simplement — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression du module Gitea seul, cela ne détruit 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, de sorte que la restauration ne peut pas être considérée comme un moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.
La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à jour sur chaque déploiement pour confirmer que tout est revenu. Parce que 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. Les frais de module de 99 crédits ne sont pas facturés à nouveau.
Ce qu'il faut : vous devez être propriétaire du projet (pas un projet que RAD gère uniquement pour 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, de sorte que votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont à nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
Un véritable manque : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, 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é Gitea et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
Si Gitea se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.
Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 110 crédits (11,00 $ US) dans votre propre projet, ou 99 crédits sur un projet géré par RAD.
La suppression ne permet d'économiser de l'argent que si Gitea resterait autrement 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 d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 142,62 $ US/mois), ou environ 1 jour ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~138 crédits/jour).
La majeure partie du coût d'exécution de Gitea est la base de données et la VM de fichiers/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression de cette application alors que quelque chose d'autre partage le projet n'économise que la part de calcul de cette application du total ci-dessus.
Gardez les données en premier : 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 la supprimer si vous voulez la conserver.
Sessions de lab et environnements gérés
- Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite fixée par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
- Environnements gérés, pour les cabinets de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire 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 mécanismes de pause/restauration ; tarification de Gitea Cloud pour les chiffres de Gitea Cloud.
1. Vue d'ensemble
Gitea fonctionne comme une charge de travail web binaire Go unique (serveur de dépôt + SSH/CI intégré
supervisé par s6). Le déploiement relie un ensemble ciblé de services Google
Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pods Gitea sur le port 3000, 1 vCPU / 512 Mio par défaut |
| Base de données | Cloud SQL pour PostgreSQL 15 | database_type par défaut à POSTGRES_15 ; le job db-init est PostgreSQL uniquement |
| Persistance des fichiers | Cloud Filestore (NFS) | Les dépôts, les objets LFS et les pièces jointes persistent sous /data, partagés entre les pods |
| Stockage d'objets | Cloud Storage | Aucun — Gitea_Common ne déclare aucun bucket GCS (storage_buckets = []) |
| Secrets | Secret Manager | SECRET_KEY et INTERNAL_TOKEN générés automatiquement ; mot de passe de la base de données |
| Ingress | Cloud Load Balancing / Gateway | service_type = LoadBalancer par défaut, avec enable_custom_domain = true provisionnant une Gateway + un certificat géré |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est le moteur prévu, et seul Postgres fonctionne réellement.
database_typepar défaut àPOSTGRES_15, mais la validation de la variable accepte égalementMYSQL/MYSQL_8_0. Le scriptdb-initfourni (scripts/gitea/db-init.sh) est codé en dur pourpsql— la sélection d'un moteur MySQL rompt l'initialisation de la base de données. Laissezdatabase_typesur une valeur Postgres. - Cloud SQL est atteint via le sidecar Auth Proxy sur la boucle locale par défaut.
enable_cloudsql_volume = trueexécute un sidecarcloud-sql-proxy; le point d'entrée de la plateforme (/platform-entrypoint.sh) composeGITEA__database__HOSTà partir desDB_HOST/DB_IPinjectés et sélectionneSSL_MODE=disablepour le chemin socket/boucle locale ouSSL_MODE=requirepour un saut TCP IP privée direct. - Il s'agit d'un build personnalisé léger, et non de l'image standard
gitea/giteautilisée telle quelle.container_image_sourcepar défaut à"custom": Cloud Build produitFROM gitea/gitea:${APP_VERSION}plus un point d'entrée de plateforme qui compose les valeursGITEA__database__*à l'exécution (Cloud Run n'interpole pas les références$(VAR)comme le fait Kubernetes, donc le même point d'entrée est partagé entre les deux variantes pour la cohérence). Les6-svscanCMDstandard est conservé. - NFS est activé par défaut (
enable_nfs = true, monté à/datavianfs_mount_path) afin que les dépôts, les objets Git LFS et les pièces jointes persistent et soient partagés entre les pods (GITEA__server__APP_DATA_PATH). - Mise à l'échelle à zéro par défaut.
min_instance_count = 0,max_instance_count = 3. Étant donné que les données du dépôt résident sur NFS partagé plutôt que sur un stockage par pod, l'exécution de plus d'un réplica est généralement sûre pour les requêtes HTTP sans état, mais le verrouillage propre à Git et les jobs d'arrière-plan en cours ne sont pas explicitement coordonnés entre les réplicas par ce module — gardezmax_instance_countconservateur sauf vérification. - Pas d'installateur, pas de compte administrateur automatisé.
GITEA__security__INSTALL_LOCK = "true"ignore l'installateur web de première exécution (la configuration est entièrement fournie via des variables d'environnement) etGITEA__service__DISABLE_REGISTRATION = "false"laisse l'auto-enregistrement ouvert. Aucun job géré par Terraform ne crée d'utilisateur administrateur — enregistrez le premier compte via l'interface utilisateur web, ou promouvez/créez-en un viakubectl exec ... -- gitea admin user create --admin(vérifiez le chemin du binaire dans l'image déployée avant de vous fier à cela). SECRET_KEYetINTERNAL_TOKENsont générés automatiquement et stockés dans Secret Manager ; le mot de passe de la base de données est le secretDB_PASSWORDgéré par la fondation, livré à Gitea en tant queGITEA__database__PASSWD.public_domain/public_urlpar défaut àlocalhost. Contrairement à certains modules, les URL de clonage de Gitea (GITEA__server__DOMAIN/GITEA__server__ROOT_URL) ne sont pas automatiquement renseignées à partir de l'adresse LoadBalancer/Gateway attribuée — définissezpublic_domain(oupublic_url) sur votre nom d'hôte réel après le déploiement, sinon les liens de clonage et les rappels OAuth/webhook feront référence àlocalhost.enable_redisn'a aucun effet sur le comportement propre de Gitea. La variable par défauttrueet la fondation injecteREDIS_HOST/REDIS_PORT, maisGitea_Commonne définit jamais de configurationGITEA__cache__*/GITEA__session__*/GITEA__queue__*pour les consommer — Gitea fonctionne avec ses valeurs par défaut intégrées en mémoire/sans SQLite indépendamment de ce paramètre.- git-over-SSH n'est pas exposé. Seul le port HTTP (
container_port, par défaut3000) est câblé dans le service Kubernetes. Lesshdpropre à l'image (supervisé pars6à côté du serveur web) n'est pas publié — clonez via HTTPS, ou ajoutez un mappage de service/port personnalisé si l'accès SSH est requis.
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 Gitea
Les pods Gitea sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods
demandent réellement. La valeur par défaut workload_type est Deployment.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Gitea pour les pods, les révisions et les événements. 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
kubectl describe pod -n "$NAMESPACE" -l app=<service-name>
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
Gitea stocke toutes les données de l'application (métadonnées du dépôt, problèmes, requêtes de tirage,
utilisateurs, organisations) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Les pods l'atteignent
via le sidecar Cloud SQL Auth Proxy ; aucune IP publique n'est exposée. Lors du premier
déploiement, le job db-init crée de manière idempotente le rôle et la base de données de l'application et
accorde les privilèges — Gitea lui-même crée et migre son schéma au premier démarrage.
- 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 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. Stockage NFS — dépôts, LFS et pièces jointes
Le répertoire racine des documents de Gitea (GITEA__server__APP_DATA_PATH) réside sur NFS (Cloud
Filestore) monté à /data par défaut, partagé entre les pods. Aucun bucket GCS n'est
provisionné pour ce module.
- Console : Filestore → Instances.
- CLI :
gcloud filestore instances list --project "$PROJECT"
kubectl get pvc -n "$NAMESPACE"
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- df -h /data
Voir App_GKE pour les options CMEK et les montages GCS Fuse.
D. Secret Manager
Deux secrets Gitea sont générés automatiquement et stockés dans Secret Manager :
SECRET_KEY (chiffre les données sensibles telles que les secrets 2FA et les jetons OAuth) et
INTERNAL_TOKEN (authentifie les appels d'API internes de Gitea). Le mot de passe de la base de données
est géré séparément par la fondation. Sur GKE, les deux secrets sont
matérialisés sous des clés Secret Manager simples (SECRET_KEY / INTERNAL_TOKEN,
et non les noms GITEA__security__* utilisés sur Cloud Run) car la CRD SecretSync du pilote CSI Secret Store interdit les traits de soulignement consécutifs dans un secret synchronisé
targetKey ; Gitea les lit à partir des fichiers montés par CSI via sa convention native
GITEA__section__KEY__FILE.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~gitea"
gcloud secrets versions access latest --secret=<secret-key-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
(service_type = LoadBalancer, reserve_static_ip = true), et
enable_custom_domain = true provisionne une Gateway avec un certificat géré (un
nom d'hôte nip.io est utilisé automatiquement si application_domains est laissé vide).
- Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
- CLI :
kubectl get svc,ingress -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails des IP statiques.
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. Des tests de disponibilité et des politiques d'alerte optionnels 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 Gitea
- Configuration de la base de données au premier déploiement. Le job
db-initexécutedb-init.shen utilisantpostgres:15-alpine. Il attend que Cloud SQL accepte les connexions, crée de manière idempotente (ou réinitialise le mot de passe) le rôle de l'application avecCREATEDB, crée la base de données appartenant à ce rôle, accorde des privilèges complets sur la base de données et le schémapublic(PostgreSQL 15+ nécessite des octrois de schéma explicites), puis signale au sidecar Cloud SQL Auth Proxy de s'arrêter (POST /quitquitquit). Le job peut être réexécuté en toute sécurité (execute_on_apply = true,max_retries = 3). - La création du schéma relève de la responsabilité de Gitea. Il n'existe pas de job de migration distinct — Gitea crée et migre son schéma lui-même au premier démarrage sur la base de données vide. Aucune extension Postgres n'est installée (
db-init.shn'en a pas besoin). - Composition des variables d'environnement de la base de données à l'exécution. La fondation injecte des
DB_HOST/DB_PORT/DB_NAME/DB_USERdiscrets (+ le secretDB_PASSWORD). Le point d'entrée de la plateforme composeGITEA__database__{HOST,NAME,USER,SSL_MODE}à partir de ceux-ci au démarrage du conteneur — en fonction de siDB_HOSTest un chemin de socket Cloud SQL (/cloudsql/..., SSL désactivé), la boucle locale du proxy local (127.0.0.1, SSL désactivé), ou une IP privée directe (SSL requis) — puis passe la main au/usr/bin/entrypointstandard de Gitea. - Pas d'installateur, auto-enregistrement ouvert.
GITEA__security__INSTALL_LOCK = "true"ignore l'installateur interactif de première exécution ;GITEA__service__DISABLE_REGISTRATION = "false"laisse l'auto-enregistrement de compte activé. Il n'y a pas de démarrage automatique de l'administrateur — créez/promouvez un administrateur manuellement après le premier déploiement. - Données du dépôt sur NFS.
GITEA__server__APP_DATA_PATHpointe vers lenfs_mount_path(par défaut/data), de sorte que les dépôts, les objets Git LFS et les pièces jointes persistent après les redémarrages et les redéploiements des pods. - Définissez
public_domain/public_urlune fois que l'IP ou le domaine est connu. Ils sont par défaut àlocalhost/http://localhost/. Corrigez-les viaenvironment_variables(ou les variablespublic_domain/public_urldu module) une fois que l'adresse externe est attribuée, afin que les URL de clonage, les rappels de webhook et les redirections OAuth se résolvent correctement. - Chemin de santé. Les sondes de démarrage et de vivacité sont toutes deux HTTP
GET /api/healthz, que Gitea sert non authentifié avec HTTP 200 une fois qu'il a terminé son démarrage. - Inspectez le job d'initialisation et la configuration en cours d'exécution :
kubectl get jobs -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep GITEA__
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 Gitea sont listés ; toute autre entrée est héritée de App_GKE avec son comportement et ses valeurs par défaut standard.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | gitea | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | 1 | Tag d'image gitea/gitea consommé par l'argument de build APP_VERSION du Dockerfile. |
container_image_source | custom | Construit l'enveloppe légère du point d'entrée de la plateforme sur gitea/gitea. prebuilt déploie gitea/gitea directement sans composition GITEA__database__* à l'exécution — n'utilisez ceci que si vous câblez vous-même les variables d'environnement de la base de données. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_port | 3000 | Port HTTP de Gitea (GITEA__server__HTTP_PORT). |
min_instance_count | 0 | Mise à l'échelle à zéro par défaut. |
max_instance_count | 3 | Plafond de coût ; à augmenter avec prudence — la coordination des réplicas pour les opérations Git/CI en arrière-plan n'est pas explicitement gérée par ce module. |
enable_cloudsql_volume | true | Sidecar Auth Proxy (boucle locale) pour la connectivité Cloud SQL. |
Groupe 6 — Backend et cluster GKE
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | IP externe pour l'interface utilisateur de Gitea. |
workload_type | Deployment | Déploiement sans état ; les données persistantes résident sur NFS, pas sur le stockage par pod. |
session_affinity | ClientIP | Routage persistant pour qu'un client atteigne le même pod. |
public_domain | localhost | Définit GITEA__server__DOMAIN ; utilisé pour les URL de clonage et les liens. Définissez-le sur votre nom d'hôte réel. |
public_url | "" → http://<public_domain>/ | Définit GITEA__server__ROOT_URL. |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | NFS est activé par défaut afin que les dépôts, les objets LFS et les pièces jointes persistent et soient partagés. |
nfs_mount_path | /data | Chemin de montage pour le partage NFS (correspond à la valeur par défaut de Gitea_Common). La valeur passée est également celle à laquelle GITEA__server__APP_DATA_PATH est défini, de sorte que le répertoire de données effectif corresponde toujours au montage. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Le job db-init est PostgreSQL uniquement (psql) ; ne pas passer à une valeur MySQL même si elle est acceptée par la validation. |
db_name | gitea | Nom de la base de données. Immuable après le premier déploiement. |
db_user | gitea | Utilisateur de la base de données de l'application ; mot de passe généré automatiquement dans Secret Manager. |
Groupe 20 — Accès et réseau (IAP)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_iap | false | Proxy d'identité (IAP) devant la Gateway. Nécessite enable_custom_domain ou enable_cdn. |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Provisionne une Gateway + un certificat géré ; revient à un nom d'hôte nip.io si application_domains est vide. |
reserve_static_ip | true | IP externe stable entre les redéploiements. |
application_domains | [] | Noms d'hôte personnalisés + certificat géré. |
Toutes les autres entrées suivent le comportement standard de 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 | Carte des ClusterIPs pour les services spécifiques à la phase. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre Gitea. |
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 / 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 (vides — Gitea persiste sur NFS). |
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 (db-init) et d'importation (facultatif). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants du 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 GitHub CI/CD. |
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 de la planification. Ce module transmet sa configuration au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un
StatefulSetforcé à côté d'un paramètre sans état, IAP sans identités autorisées,quota_memory_*donné comme des entiers bruts, uncontainer_port/backup_retention_dayshors de portée. 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'application ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
database_type | POSTGRES_15 | Critique | Le passage à une valeur MySQL réussit la validation de la variable mais rompt le script db-init.sh (PostgreSQL uniquement), laissant la base de données non initialisée. |
db_name / db_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 orpheline toutes les données. |
SECRET_KEY / INTERNAL_TOKEN (généré automatiquement) | Ne jamais modifier | Critique | La modification de ceux-ci après le premier démarrage invalide les secrets 2FA, les jetons OAuth et l'authentification API interne. |
enable_nfs | true | Critique | Le désactiver rend les dépôts, les objets LFS et les pièces jointes éphémères — perdus lors de la recréation du pod. |
enable_cloudsql_volume | true | Élevé | Le sidecar Auth Proxy est requis pour le chemin de connectivité de base de données par socket/boucle locale par défaut. |
public_domain / public_url | Définir sur le nom d'hôte réel | Élevé | Laissé à localhost, les URL de clonage, les rappels de webhook et les redirections OAuth sont incorrects pour chaque utilisateur. |
max_instance_count | Rester conservateur (valeur par défaut 3) | Élevé | Une mise à l'échelle supplémentaire sans vérifier la coordination multi-réplicas pour les travaux Git/Actions en arrière-plan est un comportement non vérifié. |
memory_limit / cpu_limit | 512Mi / 1000m (valeurs par défaut) | Élevé | En dessous des seuils équivalents à la génération 2 de Kubernetes, le pod subit des OOM ou est étranglé sous charge ; à augmenter pour les dépôts plus grands ou les charges de travail CI. |
quota_memory_requests / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms. |
| Création de compte administrateur | Étape manuelle post-déploiement | Moyen | Aucun compte n'est amorcé automatiquement ; oublier cette étape avec l'auto-enregistrement ouvert ne garantit pas que le premier utilisateur enregistré soit un administrateur. |
enable_redis | Inerte pour Gitea | Faible | Le basculement n'a aucun effet — aucun câblage GITEA__cache__*/GITEA__session__* ne consomme REDIS_HOST. |
reserve_static_ip | true | Moyen | Sans cela, l'IP externe peut changer entre les redéploiements, rompant le DNS et public_url. |
backup_retention_days | 7 (à augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
Pour le comportement de la fondation référencé tout au long — 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 à Gitea partagée avec la variante Cloud Run est décrite dans Gitea_Common.
Guides associés
- Lab pratique : Gitea sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Gitea sur Google Cloud Run — la même application sur Cloud Run, pour lorsque vous avez besoin de l'autre cible de déploiement.
- Gitea 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.