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édez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 175 crédits (17,50 $ US au prix de la recharge) | 157,5 crédits (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | Facturé 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 quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD 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 SSD | 51 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | environ 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 Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Service Node.js, 2 vCPU / 4 Gio par défaut ; autoscaling sans serveur |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — Logto ne prend pas en charge MySQL ou d'autres moteurs |
| Stockage d'objets | Cloud Storage | Un bucket provisionné automatiquement ; facultatif pour Logto (tout l'état principal est dans Postgres) |
| Secrets | Secret Manager | Seulement 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) |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL 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 = 1par 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, donc0(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 = trueinjecte toujours le sidecar Auth Proxy, mais le piloteslonikde 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) avecsslmode=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_redispar défautfalse. ENDPOINTest 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; remplacezENDPOINTviaenvironment_variablespour 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.shen utilisantpostgres:15-alpine. Il crée de manière idempotente le rôle d'application avecCREATEDB 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émapublicau 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_ENDPOINTutilise par défaut le même hôte queENDPOINTpour la cohérence des URL. ENDPOINTdoit correspondre à l'hôte visible par le navigateur. Logto construit son émetteur OIDC et ses URL de redirection à partir deENDPOINT; le point d'entrée le définit à partir deCLOUDRUN_SERVICE_URL. Pour un domaine personnalisé, définissezENDPOINTdansenvironment_variablesavant 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 renvoie200une 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é
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (obligatoire) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe 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
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | logto | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | Logto | Nom lisible par l'homme affiché dans la console. |
description | Logto - open-source Auth0-alternative identity provider (OIDC) | Description du service. |
application_version | latest | Tag 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
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
container_image_source | custom | Logto est construit comme un wrapper léger FROM svhd/logto — conservez custom. |
cpu_limit | 2000m | CPU par instance. |
memory_limit | 4Gi | Mémoire par instance ; Logto a besoin d'au moins 2 Gio pour un fonctionnement fiable. |
cpu_always_allocated | false | Facturation 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_count | 1 | Gardez 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_count | 5 | Plafond de coût ; doit être ≥ min_instance_count. |
container_port | 3001 | Le cœur de Logto écoute sur le port 3001 ; la console d'administration (3002) n'est pas publiée. |
execution_environment | gen2 | Gen2 recommandé. |
timeout_seconds | 300 | Durée maximale de la requête. |
enable_cloudsql_volume | true | Injecte 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
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Ingress public afin que les clients OIDC externes et les navigateurs puissent atteindre Logto. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Acheminer uniquement le trafic RFC 1918 via VPC. |
enable_iap | false | Exiger 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
| Variable | Valeur par défaut | Description |
|---|---|---|
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_delay | 30 | Secondes à attendre après la création du secret avant de continuer. |
Groupe 7 — Sauvegarde et restauration
| Variable | Valeur par défaut | Description |
|---|---|---|
backup_schedule | 0 2 * * * | Cron de sauvegarde automatique de la base de données (UTC). |
backup_retention_days | 7 | Rétention ; augmenter pour la production/conformité. |
enable_backup_import / backup_source / backup_file / backup_format | options de restauration | Restaurer à 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
| Variable | Valeur par défaut | Description |
|---|---|---|
db_name | logto | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
db_user | logto | Utilisateur de la base de données de l'application (accordé CREATEROLE). Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laisser vide pour utiliser le job db-init intégré. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /api/status, délai de 60 s, 30 tentatives | Large fenêtre de premier démarrage pour l'étape d'amorçage. |
liveness_probe | HTTP /api/status, délai de 60 s, période de 30 s | Sonde 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
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Logto utilise Postgres pour toute la persistance — laisser false. |
Groupe 22 — VPC Service Controls et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC. |
enable_audit_logging | false | Journaux 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.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL run.app par défaut du service (cœur Logto / point de terminaison OIDC). |
service_location | Région dans laquelle le service s'exécute. |
stage_services | URL de service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison / port de la base de données. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image 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_jobs | Noms des jobs de configuration. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_id | Registre 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_enabled | Journalisation d'audit et état CMEK. |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un
database_typenon-PostgreSQL,min_instance_count > max_instance_count, Redis activé sans hôte résoluble,enable_cloudsql_volumesans 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ètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
| Base de données Cloud SQL | Sauvegarder ; ne jamais effacer | Critique | Les 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_user | Définir une fois | Critique | Immuable 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_type | POSTGRES_15 | Critique | MySQL/autres moteurs sont rejetés au moment de la planification ; Logto ne fonctionne que sur PostgreSQL. |
enable_backup_import | false sauf restauration | Critique | L'activation sans fichier de sauvegarde valide fait échouer le job d'importation. |
ENDPOINT | Hô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_port | 3001 | É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_iap | false 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_limit | 4Gi (≥ 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_volume | true | Moyen | Le 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_count | 1 pour la production | Moyen | La 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_redis | false | Faible | Logto n'utilise pas Redis ; l'activer connecte une dépendance inutilisée. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité. |
Pour le comportement de la fondation référencé tout au long — 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.
Guides connexes
- Lab pratique : Logto sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Logto sur GKE Autopilot — la même application sur Kubernetes, lorsque vous avez besoin de l'autre cible de déploiement.
- Logto Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.