Aller au contenu principal

Forgejo sur Google Cloud Run

Forgejo sur Google Cloud Run

Forgejo est un service Git léger, autohébergé et géré par la communauté — un fork de Gitea — offrant l'hébergement de dépôts, le suivi des problèmes, les pull requests, un runner CI/CD (Actions) intégré, la revue de code et un registre de paquets à partir d'un seul binaire Go. Ce module déploie Forgejo sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud utilisés par Forgejo 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 — reportez-vous au guide du socle App_CloudRun plutôt que de les répéter ici.


Ce que coûte Forgejo sur RAD, et comment cela se compare​

Dans un projet Google Cloud que vous possédez, Forgejo sur le module Cloud Run de RAD coûte environ 84 US$ par mois, plus 11 US$ une fois par déploiement et aucune licence par utilisateur. GKE Autopilot est l'alternative pour les charges de travail qui doivent rester actives en permanence ou s'exécuter à côté d'autres applications Kubernetes ; voir le guide GKE, environ 143 US$ par mois. Forgejo est une forge Git légère et autohébergée, un fork communautaire de Gitea, avec hébergement de dépôts, problèmes, pull requests et un runner Actions intégré. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si cela s'exécute dans un projet géré par RAD pour vous, il peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de rester en cours d'exécution — ainsi, un déploiement à usage occasionnel coûte quelques dollars par mois, et non les 201 US$ par mois que coûte son maintien en fonctionnement. Voir Mettez-le en pause gratuitement, ci-dessous.

Ce que vous payez sur RAD​

Dans un projet Google Cloud que vous possédezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11 US$ au prix de la recharge)99 crédits (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 pour le temps de build à la minuteIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 84 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, environ 2 010 par mois (environ 201 US$ au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 US$ pour une recharge ponctuelle, et moins pour un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.

Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (module par défaut)Par mois
Cloud Run, 1 vCPU / 2 Gio, mise à l'échelle à zéro13 US$
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 US$
Serveur de fichiers NFS/cache : une petite VM13 US$
Passerelle Cloud NAT et adresse IP5 US$
Cloud Storage pour les sauvegardes1 US$
Totalenviron 84 US$

Comment cela se compare​

Nous n'avons pas trouvé de plan commercial géré/SaaS spécifiquement pour Forgejo au 8 octobre 2026, donc la comparaison honnête est avec l'exécution par vous-même :

OptionPar moisQui l'exécute
Hetzner CPX22 (2 vCPU/4 Go)~24 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
DigitalOcean 2 vCPU/4 Go Droplet24 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
GCP Compute Engine e2-standard-2 (2 vCPU/8 Go)~49 US$Vous : OS, mises à jour, sauvegardes, correctifs de sécurité
RAD, Cloud Run, votre propre projet84 US$, plus 11 US$ une foisL'automatisation de RAD, dans votre projet
RAD, GKE Autopilotenviron 143 US$ ; voir le guide GKE AutopilotRAD

L'empreinte propre de Forgejo ici (1 vCPU / 2 Gio) est plus légère que celle de la boîte de référence, donc un niveau plus petit et moins cher des mêmes fournisseurs l'exécuterait également confortablement.

  • RAD n'est généralement pas moins cher en espèces qu'un VPS nu — la différence est ce qui est géré pour vous. Le prix d'un VPS n'inclut pas le temps de l'administrateur pour les sauvegardes, les correctifs de sécurité et les mises à niveau du système d'exploitation ; le Cloud SQL géré par RAD (où cette application utilise une base de données), Secret Manager et la surveillance couvrent cela à la place.
  • Forgejo est une forge Git légère et autohébergée, un fork communautaire de Gitea, avec hébergement de dépôts, problèmes, pull requests et un runner Actions intégré. Cela détermine quelle colonne est importante : une opération prévisible et sans intervention vaut plus pour la plupart des équipes utilisant ce type d'outil que de réduire de quelques dollars la facture mensuelle.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin​

Si Forgejo s'exécute dans un projet géré par RAD pour vous, vous avez une option au-delà de la réduction d'échelle : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à un déploiement dont vous n'avez besoin qu'occasionnellement — pour étudier en vue d'une certification, une démo, un besoin saisonnier — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration, de sorte que la restauration ne peut pas être considérée comme un moyen fiable de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne le supprime pas immédiatement : il le conserve, récupérable, pendant 30 jours, et comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, la VM ou Cloud Run un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Update 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 201 US$ par mois pour le maintenir en fonctionnement. Déployez Forgejo, utilisez-le pour une session, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et pour les heures où il était réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et que RAD ne gère que pour la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du 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 ne survivent pas. Les sauvegardes 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é ce déploiement 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​

Cloud Run se met déjà à l'échelle à zéro entre les requêtes, de sorte que la majeure partie de son propre coût de calcul s'arrête d'elle-même lorsque personne ne l'utilise. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le déployer à nouveau lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 US$). La suppression permet d'économiser de l'argent si Forgejo devait rester inutilisé pendant environ 5 jours ou plus dans votre propre projet (environ 2,79 US$ par jour), ou environ 2 jours ou plus dans un projet géré par RAD (67 crédits par jour).
  • Supprimez tout ce que Forgejo utilise. La majeure partie du coût d'exécution est généralement la base de données et toute VM de fichier/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 partie calcul propre à cette application.
  • Conservez d'abord les données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.
  • Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez à nouveau les paramètres lorsque vous déployez.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant obtient Forgejo 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 Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour le mécanisme de pause/restauration. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Forgejo s'exécute comme un seul binaire Go à l'intérieur d'un mince wrapper de build personnalisé sur l'image stock codeberg.org/forgejo/forgejo : le wrapper ajoute un point d'entrée de plateforme (/platform-entrypoint.sh) qui compose la connexion à la base de données au moment de l'exécution, puis passe la main au propre point d'entrée de Forgejo sous s6. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Binaire Go sur le port 3000, 1 vCPU / 2 Gio par défaut, autoscaling sans serveur ; max_instance_count par défaut à 1
Base de donnéesCloud SQL pour PostgreSQL 15Verrouillé en pratique — db-init.sh utilise psql ; le menu déroulant database_type liste MYSQL/NONE comme options mais elles ne sont pas prises en charge
Persistance de fichiersCloud Filestore (NFS)Activé par défaut ; les dépôts, les objets LFS et les pièces jointes résident sous le montage NFS (/mnt/nfs)
Stockage d'objetsCloud StorageUn bucket générique, inutilisé, suffixé par data est provisionné par défaut par le socle — Forgejo lui-même ne stocke rien dans GCS
SecretsSecret ManagerSECRET_KEY et INTERNAL_TOKEN auto-générés, plus le mot de passe de la base de données, tous injectés directement comme variables d'environnement GITEA__
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • PostgreSQL 15 est le seul moteur qui fonctionne réellement. database_type par défaut à POSTGRES_15 ; le script du job db-init est écrit entièrement pour psql, donc la sélection de MySQL ou NONE interrompt la configuration de la base de données même si les métadonnées de la variable les listent comme options.
  • Cloud SQL est atteint par TCP IP privé direct par défaut, pas par un socket. enable_cloudsql_volume = false par défaut pour ce module (contrairement à de nombreux autres modules CloudRun), de sorte que le point d'entrée de la plateforme voit une IP privée DB_HOST et définit GITEA__database__SSL_MODE=require pour ce saut. Définissez enable_cloudsql_volume = true pour passer au socket Unix du proxy d'authentification Cloud SQL à /cloudsql/<connection-name> à la place (SSL_MODE=disable).
  • NFS est activé par défaut, monté à /mnt/nfs (GITEA__server__APP_DATA_PATH) — c'est là que les dépôts, les objets Git LFS et les pièces jointes persistent. La valeur par défaut de ce module remplace la valeur par défaut interne du module Forgejo_Common de /data.
  • max_instance_count par défaut à 1. Combiné avec le stockage de dépôts basé sur NFS et un rôle Postgres unique, cela évite les conflits d'écriture concurrents sans nécessiter une stratégie de déploiement Recreate de type Kubernetes (Cloud Run n'a pas de concept équivalent — une nouvelle révision ne reçoit du trafic qu'une fois que ses vérifications de santé sont passées, et les instances de la révision précédente sont alors drainées).
  • Pas de job de migration séparé. GITEA__security__INSTALL_LOCK = "true" ignore l'installateur web de Forgejo ; l'image forgejo/forgejo crée et migre son propre schéma au démarrage du conteneur par rapport à la base de données vide préparée par le job db-init.
  • Aucun compte administrateur n'est amorcé par Terraform. Il n'y a pas de job d'initialisation qui crée un utilisateur administrateur Forgejo — voir la Section 3 pour les options côté opérateur.
  • SECRET_KEY et INTERNAL_TOKEN sont auto-générés et stockés dans Secret Manager. Sur Cloud Run, il n'y a pas de restriction CRD SecretSync (cela ne s'applique qu'à GKE), donc ils sont injectés directement comme variables d'environnement GITEA__security__ — aucune indirection de fichier monté CSI n'est nécessaire.
  • public_domain / public_url par défaut à localhost. Même si le service obtient une URL run.app réelle au moment du déploiement, GITEA__server__DOMAIN / GITEA__server__ROOT_URL ne sont pas automatiquement synchronisés avec elle — définissez public_domain (et éventuellement public_url) sur le véritable nom d'hôte externe afin que les URL de clonage et les liens se résolvent correctement.
  • L'auto-enregistrement est ouvert par défaut (GITEA__service__DISABLE_REGISTRATION = "false").
  • Redis est provisionné mais pas réellement câblé dans la configuration de Forgejo. enable_redis = true par défaut et le socle injecte REDIS_HOST / REDIS_PORT dans le conteneur, mais Forgejo_Common ne définit aucune variable GITEA__cache__* / GITEA__session__* / GITEA__queue__* pour les consommer — Forgejo revient à ses valeurs par défaut de cache/session intégrées à moins que vous n'ajoutiez ce câblage vous-même via environment_variables.
  • Git-over-SSH n'est pas accessible. Cloud Run ne route que le trafic HTTP(S) sur un seul port de conteneur (3000, HTTP). Le sshd interne de Forgejo (également supervisé par s6, selon le Dockerfile) n'a pas de chemin vers le monde extérieur sur cette plateforme — utilisez les URL de clonage https://, pas git+ssh://.
  • Le tag de l'image de base est piloté par un ARG de build spécifique à l'application. L'argument de build du Dockerfile est FORGEJO_VERSION, pas le générique APP_VERSION que le socle injecte dans build_args (et qui gagnerait autrement la fusion et se résoudrait en forgejo:latest). application_version = "latest" correspond au tag épinglé 11 dans la configuration de Forgejo_Common.

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 rapportés dans les Sorties du déploiement.

A. Cloud Run — le service Forgejo​

Forgejo s'exécute comme un 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 logs 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​

Forgejo stocke toutes les métadonnées de l'application (utilisateurs, dépôts, problèmes, pull requests, exécutions d'Actions) dans une instance Cloud SQL gérée pour PostgreSQL 15. Par défaut (enable_cloudsql_volume = false), le service se connecte via TCP IP privé direct avec sslmode=require ; la définition de enable_cloudsql_volume = true bascule vers le socket Unix du proxy d'authentification Cloud SQL à la place (sslmode=disable). Lors du premier déploiement, un job Cloud Run db-init crée le rôle et la base de données de l'application et accorde les privilèges de schéma ; Forgejo crée et migre ensuite son propre schéma au premier démarrage du conteneur.

  • Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les drapeaux, les métriques.
  • CLI :
    gcloud sql instances list --project "$PROJECT"
    gcloud sql instances describe <instance-name> --project "$PROJECT"
    gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"

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

C. Cloud Filestore (NFS) — stockage de dépôts​

Les données de dépôt de Forgejo, les objets Git LFS et les pièces jointes résident sur NFS (Cloud Filestore), monté à l'intérieur du conteneur à /mnt/nfs par défaut (GITEA__server__APP_DATA_PATH). C'est là que réside tout l'état durable de l'application, non lié à la base de données — le système de fichiers du conteneur lui-même est éphémère.

  • Console : Filestore → Instances.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"

Voir App_CloudRun pour les détails de découverte/création NFS.

D. Cloud Storage​

Un bucket générique Cloud Storage suffixé par data est provisionné par la valeur par défaut storage_buckets du socle, mais Forgejo n'utilise pas GCS pour quoi que ce soit — Forgejo_Common rapporte toujours une sortie storage_buckets vide. Définissez create_cloud_storage = false pour ignorer son provisionnement s'il n'est pas nécessaire.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT" --filter="name~data"

Voir App_CloudRun pour les options GCS Fuse et CMEK.

E. Redis (provisionné, non câblé)​

Redis est activé par défaut (enable_redis = true) ; lorsque redis_host est laissé vide, l'IP de la VM du serveur NFS est utilisée comme point de terminaison Redis. Le socle injecte REDIS_HOST / REDIS_PORT dans le conteneur, mais Forgejo_Common ne définit aucune configuration GITEA__cache__* / GITEA__session__* / GITEA__queue__* pour les utiliser réellement — Forgejo fonctionne avec ses valeurs par défaut de cache/session/file d'attente en mémoire intégrées, à moins que vous n'ajoutiez vous-même le environment_variables correspondant.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

F. Secret Manager​

Deux secrets Forgejo sont générés automatiquement et stockés dans Secret Manager : SECRET_KEY (chiffre les données sensibles telles que les jetons 2FA et OAuth) et INTERNAL_TOKEN (authentifie les appels API internes de Forgejo). Le mot de passe de la base de données est le secret géré par le socle, aliasé en GITEA__database__PASSWD via db_password_env_var_name dans main.tf. Sur Cloud Run, les trois arrivent directement comme variables d'environnement GITEA__ — il n'y a pas de restriction CRD SecretSync (cela ne s'applique qu'à GKE), donc aucune indirection de fichier monté CSI n'est utilisée.

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

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

G. Réseau et ingress​

Le service est accessible à son URL run.app par défaut (ingress_settings = "all"), ce qui permet un accès public à l'interface web et aux points de terminaison de clonage/push Git https://. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés. Seul le port HTTP (3000) est exposé par Cloud Run — le sshd interne de Forgejo n'a aucun moyen d'être atteint depuis cette plateforme, donc les URL de clonage git+ssh:// ne sont pas disponibles ; clonez via https:// à la place.

  • 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.

H. Cloud Logging et Monitoring​

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

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

3. Comportement de l'application Forgejo​

  • Configuration de la base de données au premier déploiement. Le job Cloud Run db-init exécute db-init.sh en utilisant postgres:15-alpine. Il attend que Cloud SQL accepte les connexions, crée (ou réinitialise le mot de passe) de manière idempotente le rôle de l'application avec CREATEDB, crée la base de données appartenant à ce rôle et accorde des privilèges complets sur la base de données + le schéma public (PG15+). Aucune extension Postgres n'est installée par le script — les propres migrations de Forgejo créent tout ce dont il a besoin. Le job peut être réexécuté en toute sécurité (execute_on_apply = true, max_retries = 3).
  • Pas de job de migration séparé — la création du schéma se produit au démarrage du conteneur. Avec GITEA__security__INSTALL_LOCK = "true", l'installateur web de Forgejo est ignoré ; le point d'entrée stock forgejo/forgejo crée et migre le schéma dans la base de données vide au premier démarrage, et applique d'autres migrations lors des mises à niveau de version ultérieures.
  • Aucun compte administrateur n'est créé automatiquement. Aucun job d'initialisation n'exécute une étape forgejo admin user create (ou équivalente), et l'auto-enregistrement est activé (GITEA__service__DISABLE_REGISTRATION = "false"), de sorte que toute personne pouvant atteindre le service peut créer un compte. Contrairement à GKE, Cloud Run n'a pas d'équivalent à kubectl exec dans une instance en cours d'exécution, de sorte que les options d'amorçage côté opérateur diffèrent : soit ajouter une entrée unique à initialization_jobs qui exécute la CLI Forgejo/Gitea admin user create sur la même base de données (image : l'image Forgejo déployée ; nécessite les variables d'environnement DB que ce module injecte déjà), soit se fier au comportement de Forgejo/Gitea selon lequel le premier utilisateur devient administrateur, si cela s'applique à la version déployée. TODO : confirmer l'invocation exacte de la CLI et si la version déployée de Forgejo accorde toujours les droits d'administrateur au premier compte auto-enregistré avant de se fier à l'une ou l'autre voie — cela n'a pas été vérifié à partir de la source de ce dépôt.
  • Câblage des variables d'environnement de connexion à la base de données. Le socle injecte DB_HOST (l'IP privée par défaut, ou le répertoire du socket du proxy d'authentification Cloud SQL lorsque enable_cloudsql_volume = true), DB_NAME, DB_USER, et le secret DB_PASSWORD (aliasé en GITEA__database__PASSWD). Comme les références $(VAR) de type Kubernetes ne sont pas interpolées par Cloud Run, /platform-entrypoint.sh compose GITEA__database__{HOST,NAME,USER,SSL_MODE} au moment de l'exécution à partir des valeurs DB_* injectées, en se basant sur la forme de DB_HOST elle-même (début / → socket, disable ; 127.0.0.1/localhost → proxy loopback, disable ; tout le reste → TCP IP privé direct, require) — le même point d'entrée fonctionne également sans modification sur la variante GKE.
  • L'instance unique par défaut sécurise les écritures basées sur NFS. max_instance_count par défaut à 1, de sorte qu'une seule instance Forgejo s'exécute à la fois sur les données de dépôt NFS partagées et la base de données Postgres. L'augmenter n'est pas quelque chose que ce module a testé pour la correction des écritures Git concurrentes — traitez-le avec la même prudence que toute charge de travail de système de fichiers partagé.
  • Chemin de santé. Les deux sondes sont HTTP GET /api/healthz, que Forgejo sert sans authentification une fois les migrations de base de données terminées : sonde de démarrage initial_delay_seconds=30, timeout_seconds=5, period_seconds=20, failure_threshold=10 ; sonde de vivacité initial_delay_seconds=15, timeout_seconds=5, period_seconds=30, failure_threshold=3.
  • Inspecter l'exécution du job et la configuration en cours :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <db-init-job-name> --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)' | tr ';' '\n' | 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 Forgejo sont listés ; toute autre entrée est héritée 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_iddemoCourt suffixe qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameforgejoNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameForgejoNom lisible par l'homme affiché dans la console.
descriptionForgejo - Self-hosted Git service and source-code hostingDescription du service.
application_version11Tag d'image codeberg.org/forgejo/forgejo, appliqué via l'argument de build FORGEJO_VERSION spécifique à l'application ; latest correspond au 11 épinglé.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomConstruit le wrapper léger FROM codeberg.org/forgejo/forgejo:${FORGEJO_VERSION}. prebuilt ne fonctionnera pas sur Cloud Run — pas d'interpolation d'environnement $(VAR).
container_port3000Port HTTP de Forgejo ; définit également GITEA__server__HTTP_PORT.
cpu_limit1000m1 vCPU par instance (minimum pour un fonctionnement fiable).
memory_limit2GiMinimum 512 Mio ; 2 Gio recommandés pour la production.
cpu_always_allocatedfalseFacturation basée sur les requêtes par défaut. Définissez 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.
min_instance_count00 active la mise à l'échelle à zéro.
max_instance_count1Maintient une seule instance écrivant dans les données de dépôt NFS partagées et la base de données.
execution_environmentgen2Requis pour les montages NFS.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).
enable_cloudsql_volumefalseTCP IP privé direct par défaut (sslmode=require) ; définissez true pour le socket Unix du proxy d'authentification Cloud SQL à la place.
enable_image_mirroringtrueMettre en miroir l'image Forgejo dans Artifact Registry.
traffic_split[]Répartir le trafic entre les révisions pour les déploiements progressifs.
max_revisions_to_retain7Déclaré pour la parité de convention ; non référencé par le déploiement de ce module.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
ingress_settingsallall est requis pour le clonage/push Git public via HTTPS et l'accès web.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Bloque le clonage/push Git CLI, qui ne peut pas terminer un flux de navigateur Google OAuth.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

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

VariableValeur par défautDescription
environment_variablesEspaces réservés SMTPParamètres non secrets supplémentaires. Les valeurs GITEA__* principales sont définies automatiquement — ne définissez pas GITEA__database__* ou les clés secrètes auto-générées ici.
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation de Secret Manager.
public_domainlocalhostDéfinit GITEA__server__DOMAIN ; utilisé pour construire les URL de clonage et les liens. À remplacer en production.
public_url"" → http://<public_domain>/Définit GITEA__server__ROOT_URL.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (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.

Groupe 8 — CI/CD et Binary Authorization​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

Groupe 9 — Initialisation personnalisée et SQL​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Le propre schéma de Forgejo ne nécessite aucun SQL personnalisé. Voir App_CloudRun.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionner Global HTTPS LB + Cloud Armor WAF.
admin_ip_ranges[]Plages CIDR exemptées des règles WAF.
application_domains[]Noms de domaine personnalisés pour le LB HTTPS.
enable_cdnfalseActiver Cloud CDN sur le backend du LB HTTPS.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueCrée le bucket GCS par défaut suffixé par data, que Forgejo n'utilise jamais. Définissez false pour l'ignorer.
storage_buckets[{ name_suffix = "data" }]Buckets GCS supplémentaires au-delà du bucket de données auto-provisionné (inutilisé).
enable_nfstrueNFS est activé par défaut afin que les dépôts, les objets LFS et les pièces jointes persistent.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur ; définit GITEA__server__APP_DATA_PATH. Remplace la valeur par défaut interne de Forgejo_Common de /data.
nfs_instance_name / nfs_instance_base_name(auto-découverte)Ciblez ou nommez un serveur NFS existant/intégré.
gcs_volumes[]Montages de volume GCS Fuse (nécessite gen2) ; inutilisés par Forgejo tel quel.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
db_nameforgejoNom de la base de données, injecté comme GITEA__database__NAME. Immuable après le premier déploiement.
db_userforgejoUtilisateur de la base de données, injecté comme GITEA__database__USER. Mot de passe auto-généré et aliasé en GITEA__database__PASSWD (via un main.tf de niveau db_password_env_var_name, pas une variable visible par l'utilisateur).
database_typePOSTGRES_15Le seul moteur pris en charge par db-init.sh — ne pas modifier.
database_password_length32Longueur du mot de passe généré (16–64).
sql_instance_name / sql_instance_base_name(auto-découverte)Ciblez ou nommez une instance Cloud SQL existante/intégrée.
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.

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

VariableValeur par défautDescription
initialization_jobs[]Laissez vide pour utiliser le job db-init intégré.
cron_jobs[]Non utilisé — Forgejo n'a pas de tâches récurrentes planifiées par la plateforme par défaut.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/healthz, initial_delay_seconds=30, period_seconds=20, failure_threshold=10Sonde de démarrage spécifique à l'application.
liveness_probeHTTP /api/healthz, initial_delay_seconds=15, period_seconds=30, failure_threshold=3Sonde de vivacité spécifique à l'application.
startup_probe_configdésactivéSonde structurée alternative au niveau de Cloud Run (désactivée par défaut ; startup_probe prend effet).
health_check_configHTTP /Sonde de vivacité structurée alternative au niveau de Cloud Run.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring ; désactivé par défaut, activez-le explicitement pour l'activer.
alert_policies[]Stratégies d'alerte métrique.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redistrueInjecte REDIS_HOST / REDIS_PORT, mais Forgejo_Common ne définit aucune configuration GITEA__cache__*/session__*/queue__* pour les consommer — voir Section 1.
redis_host""Remplacez pour pointer vers Cloud Memorystore ou une autre instance Redis ; par défaut, l'IP du serveur NFS.
redis_port6379Port Redis.
redis_auth"" (sensible)Mot de passe d'authentification Redis facultatif.

Groupe 22 — VPC Service Controls et Audit Logging​

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

Toutes les autres entrées — y compris les miroirs de variables de socle inertes (additional_containers, additional_services, container_resources, enable_postgres_extensions/postgres_extensions, enable_mysql_plugins/mysql_plugins, network_name, etc.) déclarées pour la parité de convention mais non transmises au déploiement Forgejo — suivent le comportement standard de App_CloudRun.


5. Sorties​

Retournées 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 par défaut run.app 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 de l'application.
database_password_secretSecret Manager secret contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données.
storage_bucketsBuckets Cloud Storage créés (non utilisés par Forgejo).
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_namesStatut de surveillance, canaux, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
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_configurationStatut 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_modeStatut VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et statut CMEK.

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

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

Validation héritée au moment du plan. Ce module transmet sa configuration au moteur de base App_CloudRun, qui valide les valeurs et les combinaisons au moment du plan — un réplica en lecture sans son primaire, IAP sans identités autorisées, un environnement d'exécution gen1 avec des montages NFS/GCS, un timeout_seconds/backup_retention_days hors limites. Une configuration invalide fait échouer le plan avec une erreur claire et nommée avant la création de toute ressource, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'apply ou à l'exécution.

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15Critiquedb-init.sh est uniquement psql ; MySQL/NONE interrompt la configuration de la base de données même si les métadonnées de la variable les listent.
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 tous les dépôts, problèmes et PR stockés avec l'ancien rôle.
SECRET_KEY / INTERNAL_TOKEN (auto-généré)Ne jamais changerCritiqueLa rotation de ceux-ci invalide les données chiffrées 2FA/OAuth et l'authentification API interne de Forgejo, interrompant les opérations Git et API.
enable_nfstrueCritiqueLe désactiver rend les dépôts, les objets LFS et les pièces jointes éphémères — perdus lorsque l'instance de conteneur est remplacée.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
enable_cloudsql_volumefalse (par défaut) ou trueÉlevéLa valeur par défaut se connecte via TCP IP privée directe nécessitant SSL — assurez-vous que vpc_egress_setting et les règles de pare-feu l'autorisent. La définition de true bascule vers le socket Unix ; la sélection du mode SSL du point d'entrée suppose le mode réellement actif.
public_domain / public_urlNom d'hôte externe réelÉlevéPar défaut localhost / http://localhost/, produisant des URL de clonage Git erronées et des liens brisés jusqu'à ce qu'ils soient remplacés.
GITEA__service__DISABLE_REGISTRATION (via environment_variables)true pour les instances non publiquesÉlevéL'auto-enregistrement est ouvert par défaut et aucun compte administrateur n'est créé automatiquement — toute personne atteignant le service peut s'inscrire.
Compte administrateur initialCréer manuellement après le déploiementÉlevéAucun job d'initialisation ne démarre un administrateur ; Cloud Run n'a pas d'équivalent kubectl exec, donc la récupération nécessite une entrée initialization_jobs unique ou l'exécution de la CLI sur la même base de données.
enable_iapuniquement lorsque l'accès Git CLI n'est pas nécessaireÉlevéIAP nécessite une connexion Google interactive que la CLI git ne peut pas effectuer — le clonage/push via HTTPS est interrompu pour tous les clients non-navigateurs.
ingress_settingsallÉlevéLa définition à internal bloque tout clonage/push Git externe et l'accès web.
enable_redistrue, mais confirmez qu'il est réellement nécessaireMoyenREDIS_HOST/REDIS_PORT sont injectés sans effet à moins que vous n'ajoutiez également la configuration GITEA__cache__*/GITEA__session__* correspondante — provisionnement de la capacité Redis sans aucun avantage sinon.
max_instance_count1 (par défaut)MoyenL'augmenter permet à plusieurs instances de partager le même répertoire de données Git basé sur NFS et la même base de données Postgres ; la correction multi-instance pour les écritures Git concurrentes n'est pas documentée ni testée ici.
application_version11 ou une balise épinglée spécifiqueMoyenlatest ne suit pas l'amont — l'argument de build FORGEJO_VERSION du Dockerfile mappe "latest" à la balise épinglée 11, donc un simple paramètre latest reste silencieusement sur cette épingle.
memory_limit2GiMoyenMinimum 512 Mio ; des valeurs inférieures risquent des arrêts OOM lors d'opérations de dépôt concurrentes.
storage_buckets / create_cloud_storageLaisser tel quel ou définir create_cloud_storage = falseFaibleLe bucket par défaut suffixé data est provisionné mais inutilisé par Forgejo (toutes les données de l'application résident sur NFS/Postgres) — coût mineur inutile s'il est laissé activé inutilement.
Git-over-SSHNon disponible sur cette plateformeFaibleCloud Run expose uniquement le port HTTP(S) ; les URL de clonage git+ssh:// ne fonctionneront pas quelle que soit la configuration — utilisez https://.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

Pour le comportement de base référencé partout — 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 à Forgejo (câblage de base de données, secrets et disposition NFS) est définie dans le module Forgejo_Common et partagée avec la variante GKE de cette application.

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