Aller au contenu principal

Gitea sur Google Cloud Run

Gitea sur Google Cloud Run

Gitea est un service Git léger et auto-hébergé, ainsi qu'une forge logicielle (un fork communautaire de Gogs, plus de 45 000 étoiles GitHub) qui offre l'hébergement de dépôts, le suivi des problèmes, les pull requests, la revue de code, un registre de paquets et un système CI/CD Actions intégré à partir d'un seul binaire Go. Ce module déploie Gitea sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Gitea 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 à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — veuillez vous référer au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Coût de Gitea sur RAD et comparaison​

L'exécution de Gitea dans votre propre projet Google Cloud coûte environ 83,61 $ US/mois en frais Google Cloud, en plus d'un coût unique de 110 crédits pour le module RAD (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 GitHub. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et reprendre plus tard — voir « Mettre en pause gratuitement » ci-dessous.

Gitea est également disponible sur GKE — consultez le guide GKE si vous avez besoin d'une orchestration basée sur Kubernetes ; ce guide couvre l'option Cloud Run, moins coûteuse.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module110 crédits (une fois)99 crédits (une 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 à la minute pour le temps de buildIdem
Coût d'exécution Google Cloud~83,61 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue~67 crédits/jour (~6,70 $ 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$/mois (prix catalogue Google, us-central1)
Cloud Run, 1 vCPU / 2 Gio (scaleToZero)13,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
Total83,61 $ US

Comparaison​

  • 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 83,61 $ US/mois (Cloud Run) quel que soit le nombre d'utilisateurs, sur une instance open source que vous contrôlez entièrement.
  • Le véritable compromis ici est entre le plafond et le 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 par siège groupé.
  • RAD ne prétend pas être moins cher qu'un VPS nu en termes d'argent — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer quand 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 purement et simplement le projet — la propre 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, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être invoqué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. 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. 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 dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi 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 de 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.

Payer uniquement pendant l'utilisation, 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 reste inutilisé suffisamment longtemps pour que le coût de redéploiement soit compensé par son propre coût d'exécution : environ 5 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 83,61 $ US/mois), ou environ 4 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~67 crédits/jour).

La majeure partie du coût d'exécution de Gitea est due à la base de données et à la VM de fichiers/cache partagés. Ils 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 sur le total ci-dessus.

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

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation : un formateur anime une session pour une classe. Chaque participant dispose de l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits inutilisés sont reversés au formateur.
  • Environnements gérés, pour les sociétés de conseil : un partenaire exécute l'application pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est 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 s'exécute sous forme de conteneur binaire Go unique sur Cloud Run v2. Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v21 vCPU / 2 Gio par défaut, facturation basée sur les requêtes, mise à l'échelle à zéro
Base de donnéesCloud SQL pour PostgreSQL 15Métadonnées de dépôt, utilisateurs, problèmes, PR — GITEA__database__DB_TYPE = "postgres"
Fichiers partagésFilestore / NFSDépôts, objets LFS et pièces jointes sur le volume partagé /mnt/nfs (gen2 requis)
Stockage d'objetsCloud StorageUn bucket data provisionné par la fondation, plus le bucket de sauvegarde automatisée
SecretsSecret ManagerSECRET_KEY, INTERNAL_TOKEN et le mot de passe de la base de données gérés automatiquement
Image de conteneurArtifact Registry + Cloud BuildBuild personnalisé léger sur l'image officielle gitea/gitea
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut, équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est le moteur câblé. Gitea_Common définit GITEA__database__DB_TYPE = "postgres" ; ne pas basculer database_type vers MySQL.
  • L'image est une build personnalisée quasi-standard. Cloud Build produit FROM gitea/gitea:<version> plus un petit point d'entrée de plateforme. Le point d'entrée existe parce que Cloud Run n'interpole pas les références d'environnement $(VAR) — il compose GITEA__database__{HOST,NAME,USER,SSL_MODE} à partir des valeurs DB_* injectées par la fondation au démarrage du conteneur et choisit le bon mode SSL Postgres par saut de connexion.
  • L'utilisateur et le nom de la base de données sont préfixés par le locataire. La fondation crée le rôle et la base de données comme gitea<tenant><hex> et les injecte comme DB_USER / DB_NAME ; le point d'entrée les mappe dans Gitea. Ne jamais coder en dur gitea dans les paramètres de la base de données.
  • TCP par défaut. enable_cloudsql_volume = false — Gitea se connecte à l'IP privée de Cloud SQL via TCP avec SSL_MODE = require (le point d'entrée bascule automatiquement vers disable sur les chemins de socket Unix ou de bouclage proxy).
  • Toutes les données du dépôt résident sur NFS. GITEA__server__APP_DATA_PATH est défini sur le montage NFS (/mnt/nfs), de sorte que les dépôts, LFS et les pièces jointes survivent aux redémarrages et sont partagés entre les instances.
  • L'installateur web de première exécution est ignoré. GITEA__security__INSTALL_LOCK = "true" — la configuration est entièrement fournie via des variables d'environnement. Le premier utilisateur à s'inscrire devient l'administrateur.
  • L'auto-inscription est activée par défaut (GITEA__service__DISABLE_REGISTRATION = "false"). Enregistrez votre compte administrateur immédiatement après le déploiement, puis désactivez l'inscription pour les forges privées.
  • Un job db-init s'exécute à chaque apply pour créer de manière idempotente le rôle et la base de données PostgreSQL de Gitea.
  • Les sondes de santé ciblent /api/healthz — le point de terminaison de santé non authentifié de Gitea.
  • Mise à l'échelle à zéro, facturation basée sur les requêtes. min_instance_count = 0, max_instance_count = 1, cpu_always_allocated = false. Définissez cpu_always_allocated = true uniquement si vous comptez sur la synchronisation miroir planifiée, le cron de santé du dépôt ou la livraison de webhook temporisée.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms des services et des ressources sont indiqués dans les Sorties du déploiement.

A. Cloud Run — le service Gitea​

Gitea s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre le nombre minimal et maximal d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud SQL pour PostgreSQL 15​

Gitea stocke toutes les données relationnelles (utilisateurs, métadonnées des dépôts, problèmes, pull requests, état des Actions) dans une instance Cloud SQL pour PostgreSQL 15 gérée, accessible via l'IP privée du VPC (pas de point de terminaison public). Lors du premier déploiement, un job db-init crée le rôle et la base de données de l'application préfixés par le locataire.

  • 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=postgres --project "$PROJECT"

Le nom de l'instance, la base de données, l'utilisateur et le secret du mot de passe se trouvent dans les Sorties. Voir App_CloudRun pour le modèle de connexion, les sauvegardes et la rotation des mots de passe.

C. Filestore (NFS) et Cloud Storage​

Les données du dépôt — dépôts Git nus, objets LFS et pièces jointes aux problèmes — sont écrites sous GITEA__server__APP_DATA_PATH sur un partage NFS monté dans le service, de sorte qu'elles persistent après les redémarrages et les révisions. Un bucket Cloud Storage data est également provisionné, et les sauvegardes planifiées atterrissent dans le bucket de sauvegarde de la fondation. L'environnement d'exécution gen2 est requis pour les montages NFS.

  • Console : Filestore → Instances (ou Compute Engine → Instances de VM pour le serveur NFS autogéré) ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs

Voir App_CloudRun pour le montage NFS, GCS Fuse et CMEK.

D. Secret Manager​

Trois secrets sont gérés automatiquement : le mot de passe de la base de données (injecté sous le nom GITEA__database__PASSWD), le SECRET_KEY de Gitea (chiffre les données sensibles stockées telles que les jetons 2FA et OAuth2), et son INTERNAL_TOKEN (authentifie les propres appels d'API internes de Gitea). Tous sont générés une seule fois et injectés au moment de l'exécution ; le texte en clair n'apparaît jamais dans la configuration.

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

Voir App_CloudRun pour les détails d'injection et de rotation.

E. Artifact Registry et Cloud Build​

Le déploiement construit une image personnalisée légère (FROM gitea/gitea:<application_version> + le point d'entrée de la plateforme) via Cloud Build et la stocke dans Artifact Registry. L'incrémentation de application_version déclenche une reconstruction par rapport à la balise amont correspondante.

  • Console : Artifact Registry → Dépôts ; Cloud Build → Historique.
  • CLI :
    gcloud artifacts repositories list --project "$PROJECT" --location "$REGION"
    gcloud builds list --project "$PROJECT" --limit 5

F. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

G. Cloud Logging et Monitoring​

Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run et Cloud SQL sont acheminées vers Cloud Monitoring, avec des vérifications de disponibilité et des stratégies d'alerte facultatives.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application Gitea​

  • Configuration de la base de données au premier déploiement. Un job db-init (postgres:15-alpine) attend l'instance Cloud SQL, puis crée de manière idempotente le rôle d'application préfixé par le locataire (avec CREATEDB), crée la base de données Gitea appartenant à ce rôle et accorde les privilèges. Le job s'exécute à chaque apply (execute_on_apply = true, jusqu'à 3 tentatives) et peut être réexécuté en toute sécurité.
  • Câblage de la base de données à l'exécution. Le point d'entrée de la plateforme enregistre une ligne comme Gitea DB wired: host=… sslmode=… name=… user=… à chaque démarrage, puis passe la main au point d'entrée standard de Gitea (qui écrit toutes les variables d'environnement GITEA__* dans app.ini et lance le serveur sous s6). Lorsque DB_HOST démarre avec /, il est traité comme le répertoire de socket du proxy d'authentification Cloud SQL (SSL_MODE=disable) ; un hôte de bouclage signifie un sidecar proxy (disable) ; tout le reste est l'IP privée via TCP (SSL_MODE=require).
  • Installateur ignoré ; le premier inscrit est administrateur. INSTALL_LOCK=true supprime l'installateur web. Enregistrez le premier compte immédiatement après le déploiement — il reçoit les privilèges d'administrateur. Pour les forges privées, définissez ensuite GITEA__service__DISABLE_REGISTRATION = "true" via environment_variables.
  • Les URL de clonage proviennent de public_domain / public_url. Celles-ci pilotent GITEA__server__DOMAIN et GITEA__server__ROOT_URL. Les valeurs par défaut (localhost / dérivées) produisent des URL de clonage et des redirections incorrectes — définissez-les sur l'hôte run.app du service ou votre domaine personnalisé.
  • Clonage HTTPS uniquement. Cloud Run ne route que le port HTTP container_port (3000). Le démon SSH intégré à l'image n'est pas accessible, utilisez donc des remotes HTTPS (avec un jeton d'accès Gitea ou un mot de passe) ; git clone basé sur SSH n'est pas disponible sur cette plateforme.
  • Actions Gitea. Le serveur CI/CD Actions intégré est livré avec Gitea, mais l'exécution des jobs nécessite un calcul act_runner séparé que ce module ne provisionne pas.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent /api/healthz, qui renvoie HTTP 200 sans authentification une fois que Gitea est en service.
  • CLI de vérification :
    SERVICE_URL=$(gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)')
    curl -s -o /dev/null -w "%{http_code}\n" "$SERVICE_URL/api/healthz"

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 ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail ayant accès au projet et aux alertes de surveillance.
resource_labels{}Libellés appliqués à toutes les ressources.

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.
display_nameGiteaNom convivial affiché dans la console.
application_version1Balise d'image gitea/gitea amont sur laquelle est basée la build personnalisée ; incrémenter (par exemple 1.24) pour mettre à niveau.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomcustom construit l'image wrapper légère (requise) ; prebuilt déploie l'image standard, qui ne fonctionne pas sur Cloud Run (pas d'interpolation d'environnement $(VAR) pour le câblage de la base de données).
cpu_limit1000mCPU par instance.
memory_limit2GiMémoire par instance.
container_port3000Port HTTP de Gitea (GITEA__server__HTTP_PORT).
min_instance_count0Mise à l'échelle à zéro par défaut ; définir 1 pour éliminer les démarrages à froid.
max_instance_count1Plafond de coût.
cpu_always_allocatedfalseFacturation basée sur les requêtes. Définir true si vous comptez sur la synchronisation miroir planifiée, le cron de santé du dépôt ou la livraison de webhook temporisée.
enable_cloudsql_volumefalseTCP vers l'IP privée de Cloud SQL (SSL requis par le point d'entrée). Définir true pour le chemin du proxy d'authentification de socket Unix.
execution_environmentgen2Requis pour le montage NFS.
enable_image_mirroringtrueMettre en miroir l'image de base dans Artifact Registry pour éviter les limites de débit de Docker Hub.

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

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallQuels réseaux peuvent atteindre le service.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy — notez que IAP devant Gitea filtre également les clients HTTP git.

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

Groupe 6 — Variables d'environnement, secrets et URL publique​

VariableValeur par défautDescription
environment_variablescarte EMAIL_SMTP_* de substitutionVariables d'environnement supplémentaires fusionnées sur les valeurs par défaut du module. Gitea lui-même est configuré via des noms GITEA__<section>__<KEY> (par exemple GITEA__mailer__SMTP_ADDR, GITEA__service__DISABLE_REGISTRATION) ; les clés EMAIL_SMTP_* de substitution ne sont pas lues par Gitea.
public_domainlocalhostDéfinit GITEA__server__DOMAIN — pilote les URL de clonage. Définir sur votre véritable hôte.
public_url""Définit GITEA__server__ROOT_URL ; vide dérive http://<public_domain>/. Définir sur https://<host>/ en production.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.

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

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée de la base de données/NFS (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupes 8-11 — CI/CD, SQL personnalisé, Domaine/CDN/WAF, Stockage​

Comportement standard d'App_CloudRun — voir App_CloudRun. Entrées notables pour Gitea :

VariableValeur par défautDescription
enable_nfstrueMaintenir activé — les dépôts, LFS et les pièces jointes résident sur le partage NFS.
nfs_mount_path/dataChemin de montage ; devient également GITEA__server__APP_DATA_PATH.
storage_bucketsun bucket dataBucket GCS provisionné par la fondation.
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge externe — maintenir synchronisé avec public_domain.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Gitea est câblé pour PostgreSQL — ne pas modifier.
db_namegiteaNom de base de la base de données ; la fondation le préfixe par le locataire et l'injecte comme DB_NAME.
db_usergiteaUtilisateur de base de l'application ; préfixé par le locataire et injecté comme DB_USER. Le mot de passe est injecté comme GITEA__database__PASSWD.
database_password_length32Longueur du mot de passe généré (16–64).
enable_auto_password_rotationfalseRotation automatisée du mot de passe de la base de données.

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

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré (postgres:15-alpine).
cron_jobs[]Jobs récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/healthz, délai de 30 s, 10 échecsSonde de démarrage vers le point de terminaison de santé de Gitea.
liveness_probeHTTP /api/healthz, délai de 15 sSonde de vivacité.
uptime_check_configdésactivé, chemin /Vérification de disponibilité de Cloud Monitoring — activer pour la production.
alert_policies[]Stratégies d'alerte métrique.

Groupe 21 — Cache Redis​

Les entrées Redis (enable_redis, redis_host, redis_port, redis_auth) sont déclarées pour la convention de la plateforme mais ne sont pas transmises par ce module — Gitea n'utilise pas Redis ici ; les définir n'a aucun effet.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC.
vpc_cidr_ranges / vpc_sc_dry_run(défini)CIDR de niveau d'accès / mode simulation.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

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.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom / utilisateur de la base de données d'application préfixé par le locataire.
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 (sensible) / port.
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, vérifications de disponibilité.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configurationÉtat et détails CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
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).

ParamètreValeur judicieuseRisqueConséquence si incorrect
database_typePOSTGRES_15CritiqueLe module câble GITEA__database__DB_TYPE=postgres ; un autre moteur interrompt le démarrage.
db_name / db_userdéfini 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 de la forge.
enable_nfstrueCritiqueSans le partage NFS, les dépôts/LFS/pièces jointes résident sur un disque éphémère et disparaissent au redémarrage ou à la mise à l'échelle à zéro.
container_image_sourcecustomCritiqueL'image standard n'a pas de point d'entrée de plateforme ; Gitea essaie de composer un hôte littéralement nommé $(DB_HOST) et ne démarre jamais.
container_port3000CritiqueUn port HTTP de Gitea non concordant fait échouer toutes les sondes.
Paramètres de base de données via envne jamais coder en dur giteaCritiqueLes vrais DB_USER/DB_NAME sont préfixés par le locataire ; le codage en dur échoue avec password authentication failed.
GITEA__service__DISABLE_REGISTRATIONtrue après le premier administrateurÉlevéLaissé ouvert, quiconque trouve l'URL peut s'inscrire sur votre forge (le tout premier inscrit est administrateur — réclamez-le immédiatement).
public_domain / public_urlhôte réelÉlevéLes valeurs par défaut (localhost) produisent des URL de clonage et des redirections cassées dans l'interface utilisateur.
execution_environmentgen2ÉlevéLes montages NFS nécessitent gen2.
enable_cloudsql_volumefalse (TCP)ÉlevéSi basculé en mode socket, le point d'entrée s'adapte — mais les remplacements manuels GITEA__database__HOST non concordants cassent la sélection du mode SSL.
cpu_always_allocatedfalse, ou true pour les miroirs/cronMoyenLa facturation basée sur les requêtes limite le travail en arrière-plan ; la synchronisation miroir planifiée et les webhooks temporisés s'arrêtent pendant l'inactivité.
min_instance_count0 (ou 1 pour les équipes)MoyenLa mise à l'échelle à zéro ajoute un démarrage à froid à la première opération git après l'inactivité.
uptime_check_configactiver pour la productionMoyenDésactivé par défaut ; pas de signal de disponibilité externe.
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 — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à Gitea partagée avec la variante GKE 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.