Aller au contenu principal

Logto sur Google Cloud Run

Logto sur Google Cloud Run

Logto est un fournisseur d'identité open source sous licence MPL-2.0 — une alternative à Auth0 qui prend en charge OIDC et OAuth 2.0 et qui est livré avec des flux de connexion, des connecteurs sociaux/d'entreprise, la multi-location et une console d'administration. Ce module déploie Logto sur Cloud Run v2 sur la base 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 Logto 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 de la fondation App_CloudRun plutôt que de les répéter ici.


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

Le module Cloud Run de Logto sur RAD coûte environ 110 $ US par mois dans votre propre projet, sans frais par utilisateur ou par MAU. RAD facture 175 crédits une fois par déploiement dans votre propre projet (157,5 crédits, soit 10 % de moins, dans un projet géré par RAD). Les builds sont inclus dans le prix. Logto se déploie également sur GKE Autopilot pour environ 150 $ US par mois — consultez le guide GKE si vous avez besoin qu'il y fonctionne à la place. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ce chiffre mensuel devient quelques dollars seulement — 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éploiement175 crédits (17,50 $ US au prix de la recharge)157,5 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 à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé par Google à votre propre compte de facturation, environ 110 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 79 crédits par jour, environ 2 370 par mois (environ 237 $ 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 maintenu en réserve

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, 2x vCPU / 4 Gio (chaud)39 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51 $ US
Serveur de fichiers NFS/cache (petite VM)13 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Totalenviron 110 $ US

Comment cela se compare​

  • Auth0 (B2C) commence à 35 $ US par mois sur son plan Essentials pour jusqu'à 500 utilisateurs actifs mensuels, puis évolue avec les MAU ; son plan B2B Essentials commence à 150 $ US par mois. Un niveau gratuit couvre jusqu'à 25 000 MAU mais supprime la plupart des fonctionnalités d'entreprise.
  • Le module Logto de RAD coûte environ 110 $ US par mois dans votre propre projet — plus que le niveau d'entrée d'Auth0 pour un très faible nombre d'utilisateurs, mais il n'a pas de facturation basée sur les MAU ni de niveau de prix par locataire à dépasser, et vous détenez vous-même la base de données des utilisateurs et les clés de signature plutôt que de confier chaque connexion à un tiers.
  • Comparaison autogérée : l'empreinte de 2 vCPU / 4 Gio de Logto est proche d'une instance GCP Compute Engine e2-standard-2 (environ 49 $ US/mois) ou d'une machine Hetzner/DigitalOcean plus grande, et vous auriez toujours besoin d'exécuter et de patcher PostgreSQL et la couche NFS/cache dont il dépend vous-même.

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

Si Logto s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Logto dont vous n'avez besoin qu'occasionnellement — évaluation, environnement de démonstration, charge de travail saisonnière ou intermittente — que de le faire fonctionner en continu.

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

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. 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 la base de données, aucune VM ou la ressource de calcul une par une — 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éactiver le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 237 $ US par mois pour le maintenir en fonctionnement. Déployez Logto, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez que les frais de module une seule fois et le temps qu'il a réellement été en ligne.
  • Ce qu'il faut. Vous devez posséder le projet (pas un projet dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours dépasser le seuil du niveau (100 crédits pour le niveau sandbox que la plupart des utilisations d'évaluation conviennent). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Une lacune réelle : les sauvegardes nocturnes ne survivent pas. Les sauvegardes et autres fichiers générés sont écrits dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé Logto 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​

L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) — 175 crédits (17,50 $ US) au total. La suppression ne permet d'économiser de l'argent que si Logto devait rester inutilisé assez longtemps pour compenser ce coût de redéploiement par rapport à son propre coût de fonctionnement — environ 5 jours ou plus, à la fois dans votre propre projet (environ 3,66 $ US par jour) et dans un projet géré par RAD (79 crédits par jour).
  • La majeure partie du coût de fonctionnement est généralement partagée. Pour Logto, il s'agit de la base de données et de la 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 de cette application.
  • Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de 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 obtient 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 Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation des crédits quotidiens de radmodules.dev/pricing ; Supprimer et restaurer des projets pour les mécanismes de pause/restauration et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle ; Auth0. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

Logto s'exécute en tant que conteneur Node.js sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Node.js, 2 vCPU / 4 Gio par défaut ; autoscaling sans serveur
Base de donnéesCloud SQL pour PostgreSQL 15Requis — Logto ne prend pas en charge MySQL ou d'autres moteurs
Stockage d'objetsCloud StorageUn bucket provisionné automatiquement ; facultatif pour Logto (tout l'état principal est dans Postgres)
SecretsSecret ManagerSeulement le mot de passe de la base de données — Logto n'a pas de secret d'application externe (les clés OIDC sont amorcées par la base de données)
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé

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

  • PostgreSQL 15 est obligatoire. Le moteur de base de données est fixé par la couche d'application partagée ; une garde au moment de la planification rejette tout non-PostgreSQL database_type.
  • Le cœur de Logto est publié sur le port 3001 ; la console d'administration (3002) ne l'est pas. Cloud Run publie un seul port, de sorte que seul le point de terminaison de l'API/OIDC principal (3001) est accessible. La console d'administration — où le premier compte administrateur et les applications sont enregistrés — s'exécute sur le port 3002 et n'est pas exposée via l'URL run.app. Prévoyez un chemin séparé vers le port 3002 pour la configuration initiale (voir §3).
  • Il n'y a pas de secret d'application à protéger. Logto génère ses clés de signature OIDC au premier démarrage et les stocke dans la base de données. Rien dans Secret Manager n'a besoin d'être protégé ou renouvelé, sauf le mot de passe de la base de données géré par la fondation. Protéger les clés de Logto signifie protéger Cloud SQL.
  • min_instance_count = 1 par défaut. Logto est un fournisseur d'identité sur le chemin de requête de chaque connexion, donc une instance est maintenue chaude pour éviter la latence de démarrage à froid sur les requêtes OIDC. Tout l'état est dans Postgres, donc 0 (mise à l'échelle à zéro) est sûr pour les données si vous préférez échanger les démarrages à froid contre le coût.
  • cpu_always_allocated = false (facturation basée sur les requêtes). Le cœur de Logto est un fournisseur OIDC de requête/réponse sans travailleur de fond en cours qui doit s'exécuter sans requête entrante, donc le CPU n'est facturé que pendant le service.
  • La connexion contourne le socket Cloud SQL. enable_cloudsql_volume = true injecte toujours le sidecar Auth Proxy, mais le pilote slonik de Logto ne peut pas analyser la forme DSN du socket Unix — le point d'entrée se connecte via l'IP privée injectée (DB_IP) avec sslmode=no-verify à la place (crypté ; la vérification CA est ignorée pour le saut de la base de données uniquement).
  • Pas de Redis. Logto est basé sur Postgres ; enable_redis par défaut false.
  • ENDPOINT est dérivé de l'URL du service. Le point d'entrée définit l'émetteur OIDC de Logto et les URL absolues à partir de l'injecté CLOUDRUN_SERVICE_URL ; remplacez ENDPOINT via environment_variables pour un domaine personnalisé.

2. Services Google Cloud et comment les explorer​

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

A. Cloud Run — le service Logto​

Logto s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge de 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. Le port de conteneur publié est 3001 (cœur Logto / OIDC).

  • 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"
    # Confirm the injected DB_HOST / DB_IP / ENDPOINT on the running revision:
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION" \
    --format='value(spec.template.spec.containers[0].env)'

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​

Logto stocke tout — utilisateurs, applications, connecteurs, clés de signature OIDC et rôles par locataire — dans une instance Cloud SQL pour PostgreSQL 15 gérée. Sur Cloud Run, le sidecar Auth Proxy est injecté, mais l'application se connecte via l'IP privée de l'instance (DB_IP) avec sslmode=no-verify car le pilote de Logto ne peut pas utiliser la forme DSN du socket. Lors du premier déploiement, un job d'initialisation crée la base de données et le rôle de l'application (avec CREATEROLE, requis pour les rôles RLS par locataire de Logto).

  • 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 (logto), l'utilisateur (logto) 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 Storage​

Un bucket Cloud Storage est provisionné automatiquement. Logto conserve tout l'état principal dans PostgreSQL, ce bucket est donc disponible pour des ressources facultatives plutôt que pour un stockage d'exécution requis.

  • Console : Cloud Storage → Buckets.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<bucket-name>/ # bucket name is in the Outputs

Voir App_CloudRun pour les options GCS Fuse et CMEK.

D. Secret Manager​

Logto n'a pas de secret d'application externe — ses clés de signature OIDC sont générées et stockées dans la base de données au premier démarrage. Le seul secret en jeu est le mot de passe de la base de données, que la fondation génère et gère.

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

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

E. Réseau et ingress​

Le service est accessible par son URL run.app par défaut. L'émetteur OIDC de Logto et toutes les URL de redirection absolues sont construits à partir de ENDPOINT, que le point d'entrée dérive de l'URL du service — ainsi, l'hôte côté navigateur, l'émetteur et les URI de redirection enregistrés doivent tous concorde. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; définissez ENDPOINT sur le domaine personnalisé lorsque vous le faites.

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

F. Cloud Logging et Monitoring​

Les journaux de conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des stratégies d'alerte facultatifs. Le point d'entrée affiche une ligne [cloud-entrypoint] indiquant le mode de connexion à la base de données résolu et ENDPOINT — utile pour diagnostiquer les problèmes de connexion ou d'URL d'émetteur.

  • 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 Logto​

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute db-init.sh en utilisant postgres:15-alpine. Il crée de manière idempotente le rôle d'application avec CREATEDB CREATEROLE (requis pour les rôles RLS par locataire de Logto) et la base de données de l'application, puis accorde les privilèges et transfère la propriété du schéma public au rôle de l'application. Le job peut être réexécuté en toute sécurité.
  • Schéma et clés OIDC amorcés au démarrage. Au démarrage, Logto exécute npm run cli db seed -- --swe (--swe = amorçage si vide, idempotent) qui crée son schéma et génère les clés de signature privées OIDC dans la base de données — uniquement lorsque la base de données est vide. Ces clés ne sont pas stockées dans Secret Manager ; la base de données est leur seul dépositaire. Effacer la base de données régénère de nouvelles clés et invalide tous les jetons précédemment émis et les clients enregistrés.
  • Aucun secret d'application à renouveler. Il n'y a pas de clé de chiffrement ou de secret JWT dans Secret Manager — seulement le mot de passe de la base de données géré par la fondation.
  • La console d'administration (3002) n'est pas publiée. Cloud Run expose uniquement le cœur (3001). La console d'administration — où vous créez le premier administrateur et enregistrez les applications — s'exécute sur le port 3002 et n'est pas accessible via l'URL run.app. Terminez la configuration initiale en plaçant Logto derrière un proxy qui route vers le port 3002, ou en exposant temporairement le port 3002 via un déploiement dédié. ADMIN_ENDPOINT utilise par défaut le même hôte que ENDPOINT pour la cohérence des URL.
  • ENDPOINT doit correspondre à l'hôte visible par le navigateur. Logto construit son émetteur OIDC et ses URL de redirection à partir de ENDPOINT ; le point d'entrée le définit à partir de CLOUDRUN_SERVICE_URL. Pour un domaine personnalisé, définissez ENDPOINT dans environment_variables avant le déploiement.
  • Chemin de santé. Les sondes de démarrage, de vivacité et de disponibilité ciblent /api/status — un point de terminaison non authentifié qui renvoie 200 une fois le cœur opérationnel. La sonde de démarrage permet une large fenêtre de premier démarrage (délai initial de 60 s + 30 tentatives) pour l'étape d'amorçage. Vérifiez-le manuellement :
    curl -s "$(gcloud run services describe <service-name> --region "$REGION" \
    --format='value(status.url)')/api/status"
  • Inspecter l'exécution du job :
    gcloud run jobs list --project "$PROJECT" --region "$REGION"
    gcloud run jobs executions list --job <job-name> --project "$PROJECT" --region "$REGION"

4. Variables de configuration​

Les variables sont regroupées exactement telles qu'elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Logto 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(obligatoire)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[]E-mails auxquels sont accordés l'accès au projet et les alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelogtoNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameLogtoNom lisible par l'homme affiché dans la console.
descriptionLogto - open-source Auth0-alternative identity provider (OIDC)Description du service.
application_versionlatestTag d'image Logto (svhd/logto:<tag>) ; épingler à une version spécifique (par exemple 1.33) en production.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomLogto est construit comme un wrapper léger FROM svhd/logto — conservez custom.
cpu_limit2000mCPU par instance.
memory_limit4GiMémoire par instance ; Logto a besoin d'au moins 2 Gio pour un fonctionnement fiable.
cpu_always_allocatedfalseFacturation basée sur les requêtes (CPU facturé uniquement pendant le service). Logto n'a pas de travailleur en arrière-plan à maintenir en vie.
min_instance_count1Gardez 1 instance chaude pour que les requêtes OIDC/de connexion ne subissent jamais de démarrage à froid ; 0 est sûr pour les données (tout l'état est dans Postgres).
max_instance_count5Plafond de coût ; doit être ≥ min_instance_count.
container_port3001Le cœur de Logto écoute sur le port 3001 ; la console d'administration (3002) n'est pas publiée.
execution_environmentgen2Gen2 recommandé.
timeout_seconds300Durée maximale de la requête.
enable_cloudsql_volumetrueInjecte le sidecar Auth Proxy ; Logto se connecte toujours via DB_IP (socket DSN non pris en charge par slonik).

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

VariableValeur par défautDescription
ingress_settingsallIngress public afin que les clients OIDC externes et les navigateurs puissent atteindre Logto.
vpc_egress_settingPRIVATE_RANGES_ONLYAcheminer uniquement le trafic RFC 1918 via VPC.
enable_iapfalseExiger la connexion Google. Bloque le trafic OIDC/de connexion non authentifié — désactiver pour un IdP public.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Définissez ENDPOINT ici pour un domaine personnalisé. Ne définissez pas PORT (Cloud Run le réserve) ou DB_URL (composé par le point d'entrée).
secret_environment_variables{}Mappage de variable d'environnement → nom de secret Secret Manager. Logto n'en a pas besoin par défaut.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatique de la base de données (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_file / 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-11 — Équilibreur de charge / Stockage / SQL personnalisé​

enable_cloud_armor, application_domains, enable_cdn, et les paramètres de rétention d'Artifact Registry (Groupe 9) ; create_cloud_storage, storage_buckets, enable_nfs, gcs_volumes (Groupe 10) ; et enable_custom_sql_scripts et ses amis (Groupe 11) suivent tous le comportement standard de App_CloudRun. NFS est désactivé par défaut — Logto n'a pas besoin de système de fichiers partagé.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
db_namelogtoNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_userlogtoUtilisateur de la base de données de l'application (accordé CREATEROLE). Immuable après le premier déploiement.
database_password_length32Longueur du mot de passe généré.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeHTTP /api/status, délai de 60 s, 30 tentativesLarge fenêtre de premier démarrage pour l'étape d'amorçage.
liveness_probeHTTP /api/status, délai de 60 s, période de 30 sSonde de vivacité.
uptime_check_config{ enabled=false, path="/" }Test de disponibilité Cloud Monitoring. Désactivé par défaut ; activer et définir path = "/api/status" pour la surveillance de production.

Groupe 21 — Cache et file d'attente Redis​

VariableValeur par défautDescription
enable_redisfalseLogto utilise Postgres pour toute la persistance — laisser false.

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

VariableValeur par défautDescription
enable_vpc_scfalseAppliquer un périmètre VPC-SC.
enable_audit_loggingfalseJournaux d'audit Cloud détaillés.

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


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 (cœur Logto / point de terminaison OIDC).
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 Secret Manager 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.
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, tests 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).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un database_type non-PostgreSQL, min_instance_count > max_instance_count, Redis activé sans hôte résoluble, enable_cloudsql_volume sans base de données. 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 si erroné
Base de données Cloud SQLSauvegarder ; ne jamais effacerCritiqueLes clés de signature OIDC de Logto résident dans la base de données. L'effacer régénère de nouvelles clés et invalide chaque jeton émis et client enregistré.
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/le rôle et détruit toutes les données d'identité.
database_typePOSTGRES_15CritiqueMySQL/autres moteurs sont rejetés au moment de la planification ; Logto ne fonctionne que sur PostgreSQL.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans fichier de sauvegarde valide fait échouer le job d'importation.
ENDPOINTHôte réel visible par le navigateurÉlevéUn émetteur non concordant interrompt la découverte OIDC, les URI de redirection et chaque rappel OAuth.
container_port3001ÉlevéLe cœur écoute sur le port 3001 ; un mauvais port fait échouer chaque sonde et requête. La console d'administration (3002) est intentionnellement non publiée.
enable_iapfalse pour un IdP publicÉlevéIAP bloque toutes les requêtes non authentifiées, y compris les flux OIDC/de connexion que Logto est censé servir.
memory_limit4Gi (≥ 2 Gio)ÉlevéEn dessous de ~2 Gio, Logto est sujet aux OOM sous charge.
Accès à la console d'administration (3002)Planifier un itinéraire avant la mise en serviceÉlevéL'interface utilisateur de premier administrateur/configuration est sur le port 3002, inaccessible via l'URL run.app — la configuration initiale est bloquée sans chemin séparé.
enable_cloudsql_volumetrueMoyenLe sidecar proxy est injecté pour la parité, mais Logto se connecte via DB_IP ; le désactiver supprime le sidecar sans nuire au chemin IP privé de l'application.
min_instance_count1 pour la productionMoyenLa mise à l'échelle à zéro (0) ajoute une latence de démarrage à froid à la première connexion après l'inactivité (sûr pour les données sinon).
enable_redisfalseFaibleLogto n'utilise pas Redis ; l'activer connecte une dépendance inutilisée.
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 à Logto partagée avec la variante GKE est décrite dans Logto_Common.

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