Aller au contenu principal

Gitea sur GKE Autopilot

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 projetProjet géré par RAD
Frais de module110 crédits (une seule fois)99 crédits (une seule fois, 10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés au temps de build à la minuteIdem
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 Gio72,16 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73
Total142,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 CloudNotes
CalculGKE AutopilotPods Gitea sur le port 3000, 1 vCPU / 512 Mio par défaut
Base de donnéesCloud SQL pour PostgreSQL 15database_type par défaut à POSTGRES_15 ; le job db-init est PostgreSQL uniquement
Persistance des fichiersCloud Filestore (NFS)Les dépôts, les objets LFS et les pièces jointes persistent sous /data, partagés entre les pods
Stockage d'objetsCloud StorageAucun — Gitea_Common ne déclare aucun bucket GCS (storage_buckets = [])
SecretsSecret ManagerSECRET_KEY et INTERNAL_TOKEN générés automatiquement ; mot de passe de la base de données
IngressCloud Load Balancing / Gatewayservice_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_type par défaut à POSTGRES_15, mais la validation de la variable accepte également MYSQL/MYSQL_8_0. Le script db-init fourni (scripts/gitea/db-init.sh) est codé en dur pour psql — la sélection d'un moteur MySQL rompt l'initialisation de la base de données. Laissez database_type sur une valeur Postgres.
  • Cloud SQL est atteint via le sidecar Auth Proxy sur la boucle locale par défaut. enable_cloudsql_volume = true exécute un sidecar cloud-sql-proxy ; le point d'entrée de la plateforme (/platform-entrypoint.sh) compose GITEA__database__HOST à partir des DB_HOST/DB_IP injectés et sélectionne SSL_MODE=disable pour le chemin socket/boucle locale ou SSL_MODE=require pour un saut TCP IP privée direct.
  • Il s'agit d'un build personnalisé léger, et non de l'image standard gitea/gitea utilisée telle quelle. container_image_source par défaut à "custom" : Cloud Build produit FROM gitea/gitea:${APP_VERSION} plus un point d'entrée de plateforme qui compose les valeurs GITEA__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). Le s6-svscan CMD standard est conservé.
  • NFS est activé par défaut (enable_nfs = true, monté à /data via nfs_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 — gardez max_instance_count conservateur 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) et GITEA__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 via kubectl exec ... -- gitea admin user create --admin (vérifiez le chemin du binaire dans l'image déployée avant de vous fier à cela).
  • SECRET_KEY et INTERNAL_TOKEN sont générés automatiquement et stockés dans Secret Manager ; le mot de passe de la base de données est le secret DB_PASSWORD géré par la fondation, livré à Gitea en tant que GITEA__database__PASSWD.
  • public_domain/public_url par 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éfinissez public_domain (ou public_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_redis n'a aucun effet sur le comportement propre de Gitea. La variable par défaut true et la fondation injecte REDIS_HOST/REDIS_PORT, mais Gitea_Common ne définit jamais de configuration GITEA__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éfaut 3000) est câblé dans le service Kubernetes. Le sshd propre à l'image (supervisé par s6 à 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-init exécute db-init.sh en utilisant postgres: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 avec CREATEDB, 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éma public (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.sh n'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_USER discrets (+ le secret DB_PASSWORD). Le point d'entrée de la plateforme compose GITEA__database__{HOST,NAME,USER,SSL_MODE} à partir de ceux-ci au démarrage du conteneur — en fonction de si DB_HOST est 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/entrypoint standard 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_PATH pointe vers le nfs_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_url une fois que l'IP ou le domaine est connu. Ils sont par défaut à localhost / http://localhost/. Corrigez-les via environment_variables (ou les variables public_domain/public_url du 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​

VariableValeur par défautDescription
application_namegiteaNom de base des ressources. Ne pas modifier après le premier déploiement.
application_version1Tag d'image gitea/gitea consommé par l'argument de build APP_VERSION du Dockerfile.
container_image_sourcecustomConstruit 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​

VariableValeur par défautDescription
container_port3000Port HTTP de Gitea (GITEA__server__HTTP_PORT).
min_instance_count0Mise à l'échelle à zéro par défaut.
max_instance_count3Plafond 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_volumetrueSidecar Auth Proxy (boucle locale) pour la connectivité Cloud SQL.

Groupe 6 — Backend et cluster GKE​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour l'interface utilisateur de Gitea.
workload_typeDeploymentDéploiement sans état ; les données persistantes résident sur NFS, pas sur le stockage par pod.
session_affinityClientIPRoutage persistant pour qu'un client atteigne le même pod.
public_domainlocalhostDé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)​

VariableValeur par défautDescription
enable_nfstrueNFS 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/dataChemin 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​

VariableValeur par défautDescription
database_typePOSTGRES_15Le job db-init est PostgreSQL uniquement (psql) ; ne pas passer à une valeur MySQL même si elle est acceptée par la validation.
db_namegiteaNom de la base de données. Immuable après le premier déploiement.
db_usergiteaUtilisateur 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)​

VariableValeur par défautDescription
enable_iapfalseProxy d'identité (IAP) devant la Gateway. Nécessite enable_custom_domain ou enable_cdn.

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

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne une Gateway + un certificat géré ; revient à un nom d'hôte nip.io si application_domains est vide.
reserve_static_iptrueIP 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.

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

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment 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 StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors 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ètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15CritiqueLe 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_userDéfinir une foisCritiqueImmuable 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 modifierCritiqueLa modification de ceux-ci après le premier démarrage invalide les secrets 2FA, les jetons OAuth et l'authentification API interne.
enable_nfstrueCritiqueLe 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_volumetrueÉ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_urlDé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_countRester 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_limit512Mi / 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 / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes 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éploiementMoyenAucun 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_redisInerte pour GiteaFaibleLe basculement n'a aucun effet — aucun câblage GITEA__cache__*/GITEA__session__* ne consomme REDIS_HOST.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer entre les redéploiements, rompant le DNS et public_url.
backup_retention_days7 (à augmenter pour la production)MoyenTrop 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.

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