Payload CMS sur Google Cloud Run
Payload CMS est un CMS headless et un framework d'application TypeScript-natif, code-first, construit
directement sur Next.js — ce n'est pas un produit SaaS hébergé, mais une bibliothèque installée dans votre propre application Next.js. Le contenu est modélisé via des « Collections » typées définies dans payload.config.ts, et
Payload génère une interface d'administration ainsi que des API REST, GraphQL et Locales à partir de cette même configuration. Ce
module déploie une véritable application Payload sur Cloud Run v2 au-dessus de la
fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud utilisés par ce déploiement 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 — référez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.
Ce que coûte Payload sur RAD, et comment cela se compare
Pour une petite équipe, Payload sur le module Cloud Run de RAD coûte environ 84 $ US par mois, sans licence par utilisateur. Payload Cloud, l'offre hébergée du projet, ne publie pas de liste de prix publique actuelle ; un serveur autogéré est moins cher en espèces que RAD, mais vous devez alors gérer la base de données, les sauvegardes, les correctifs de sécurité et les mises à niveau vous-même. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.
Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 84 $ US deviennent quelques dollars par mois. 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 que RAD gère pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 110 crédits (11 $ US au prix de la recharge) | 99 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 (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 67 crédits par jour, soit environ 2 010 par mois (environ 201 $ 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 conservé en réserve |
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).
10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins avec 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 de deuxième base de données.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (valeur par défaut du module) | Par mois |
|---|---|
| Cloud Run, 1x vCPU / 2 Gio (scaleToZero) | 13,16 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | environ 84 $ US |
- Cloud SQL et Cloud Run coûtent le même prix en africa-south1 (Johannesburg) ; la VM coûte environ 10 % de plus.
- La mise à l'échelle à zéro est la valeur par défaut. La ligne Cloud Run ci-dessus reflète déjà ce coût ; le réglage
min_instance_count = 1maintient une instance active et augmente cette ligne, en échange de l'absence de démarrages à froid. - Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 $ US par mois à elle seule.
Comment cela se compare
- Payload Cloud, l'offre hébergée du projet, ne publie pas de liste de prix publique actuelle, la comparaison se fait donc avec un serveur nu.
- Un VPS nu — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $/mois — est moins cher que le chiffre de RAD pour un projet propre. Payload n'a besoin que de 1 vCPU / 1-2 Gio, donc un niveau de VPS plus petit/moins cher ferait probablement l'affaire ; les chiffres ci-dessus sont la plus petite classe vérifiée indépendamment.
- La différence réside dans la base de données et la gestion des secrets : les sauvegardes Cloud SQL et la récupération à un instant précis, ainsi que Secret Manager, sont inclus sur RAD plutôt que d'être votre propre tâche sur un VPS.
- Si Payload doit rester actif sans mise à l'échelle à zéro, ou fonctionner aux côtés d'autres charges de travail Kubernetes, consultez plutôt le guide GKE — environ 107 $ US par mois dans votre propre projet, ou 2 760 crédits (environ 221-276 $ US) par mois dans un projet géré par RAD.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin
Si Payload s'exécute dans un projet que RAD gère 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 à une utilisation occasionnelle — étudier pour une certification, un environnement de démonstration, une activité saisonnière — que de faire fonctionner Payload 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. La restauration ne peut donc 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 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 Cloud SQL, aucune VM ou Cloud Run 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écupérer 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 201 $ US par mois pour le maintenir en fonctionnement. Déployez Payload, utilisez-le 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 pendant lequel Payload a été réellement actif.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et 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 palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services sont entièrement opérationnels dans les 36 heures suivant une restauration.
- Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes de Payload sont écrites 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 apporté des modifications à Payload que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer, comme pour le workflow de redéploiement ci-dessous. 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. 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), car RAD recrée le projet et les services partagés avant Payload. La suppression ne permet d'économiser de l'argent que si Payload devait rester inutilisé pendant environ 5 jours ou plus, à la fois dans votre propre projet (environ 2,79 $ US par jour) et dans un projet géré par RAD (67 crédits par jour).
- La majeure partie du coût d'exécution est généralement la base de données et la VM de fichier/cache partagée. Ils ne s'arrêtent que lorsque rien d'autre dans le projet ne les utilise, donc la suppression de Payload alors que quelque chose d'autre partage le projet n'économise que la partie calcul de Payload.
- Conservez d'abord les données. Les sauvegardes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, donc copiez la dernière sauvegarde avant de supprimer si vous voulez la conserver.
- RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à 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 l'application dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans une limite 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 retournent 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, afin que personne ne reçoive 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 ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle.
1. Vue d'ensemble
Payload s'exécute comme un conteneur Node.js (Next.js) sur Cloud Run v2. Il n'y a pas d'image Docker officielle de Payload — ce module construit une application de démarrage réelle, vérifiée localement, à partir de la source (un modèle create-payload-app vierge utilisant l'adaptateur PostgreSQL) via Cloud Build. Le déploiement connecte un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Service Node.js (Next.js autonome), autoscaling sans serveur ; mise à l'échelle à zéro prise en charge par défaut |
| Build | Cloud Build | Construit l'application de démarrage Payload groupée à partir de Payload_Common/scripts/Dockerfile — aucune image préconstruite n'existe à tirer |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — l'adaptateur Postgres de Payload est utilisé ; MySQL/MongoDB ne sont pas câblés |
| Stockage d'objets | Aucun | Aucun bucket n'est provisionné ; les téléchargements de médias vont sur le disque de conteneur local et éphémère |
| Secrets | Secret Manager | PAYLOAD_SECRET auto-généré ; mot de passe de la base de données |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est obligatoire et le schéma n'est pas créé au démarrage. Le démarrage du serveur construit
contre une base de données fraîche crée zéro table — le job d'initialisation
payload-migrateapplique le schéma via la CLIpayload migrate, en utilisant un fichier de migration pré-généré intégré à l'image. container_image_sourceest fixé à"custom". Il n'y a rien à déployer sans une exécution de Cloud Build — le module construit toujoursPayload_Common/scripts/à partir de la source.- Les sondes de santé ciblent
/admin, pas/ou une route API./adminsert le formulaire de connexion/création du premier utilisateur de Payload et renvoie un200non authentifié ; les routes REST/GraphQL de Payload nécessitent une authentification et sont des cibles de sonde inappropriées. - Aucun bucket de stockage n'est provisionné. Les médias téléchargés sont écrits sur le disque local du conteneur et ne survivent pas à un redémarrage de pod ou à un redéploiement.
enable_rediset les variables associées du groupe 21 sont déclarées mais inertes. Elles ne sont pas transmises àPayload_Common, qui n'a pas de câblage Redis.- La mise à l'échelle à zéro est activée par défaut (
min_instance_count = 0). Les démarrages à froid ajoutent de la latence à la première requête après l'inactivité, aggravée par le coût de démarrage à froid de Next.js. - Le premier utilisateur administrateur est créé manuellement. Payload n'a pas de CLI non interactive pour cela —
la visite de
/adminsur une collectionusersvide affiche un formulaire d'inscription.
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 rapportés dans les Sorties du déploiement.
A. Cloud Run — le service Payload
Payload s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement à la charge de requêtes entre le nombre minimum et maximum d'instances. Chaque déploiement crée une révision immuable.
- Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
- CLI :
gcloud run services list --project "$PROJECT" --region "$REGION"
gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"
Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.
B. Cloud Build — construction de l'image Payload
Comme il n'existe pas d'image Payload officielle, chaque déploiement (et chaque redéploiement après une modification de Dockerfile ou de source) déclenche une exécution de Cloud Build sur Payload_Common/scripts/.
- Console : Cloud Build → Historique.
- CLI :
gcloud builds list --project "$PROJECT" --limit=10
gcloud builds log <build-id> --project "$PROJECT"
C. Cloud SQL pour PostgreSQL 15
Payload stocke toutes les données de l'application (Collections, utilisateurs, métadonnées de documents téléchargés) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le service se connecte en privé via le proxy d'authentification Cloud SQL sur un socket Unix ; aucune IP publique n'est exposée. Lors du premier déploiement, db-init crée la base de données et le rôle, puis payload-migrate applique le schéma.
- Console : SQL → sélectionnez l'instance pour les connexions, les sauvegardes, les indicateurs, les métriques.
- CLI :
gcloud sql instances list --project "$PROJECT"
gcloud sql instances describe <instance-name> --project "$PROJECT"
gcloud sql connect <instance-name> --user=<db-user> --database=<db-name> --project "$PROJECT"
Le nom de l'instance, la base de données, l'utilisateur et le secret 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.
D. Secret Manager
Un secret cryptographique est généré automatiquement et stocké dans Secret Manager : PAYLOAD_SECRET
(utilisé pour signer les propres jetons de session/authentification de Payload). Le mot de passe de la base de données est géré séparément par
la fondation.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT"
gcloud secrets versions access latest --secret=<secret-name> --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. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés.
- 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 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 facultatifs.
- 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 Payload
- Configuration de la base de données au premier déploiement.
db-init(utilisantpostgres:15-alpine) se connecte via le proxy d'authentification Cloud SQL et crée de manière idempotente le rôle et la base de données de l'application. - La migration de schéma est un job distinct et dépendant.
payload-migrate(depends_on_jobs = ["db-init"]) exécute./node_modules/.bin/payload migrateà partir d'une copie complète/app/clidenode_modules+ source TypeScript intégrée à l'image — l'exécution autonome Next.js allégée utilisée pour servir le trafic n'inclut pas la CLI Payload ni ses dépendances. C'est un fait comportemental réel confirmé localement : le démarrage de l'application contre une base de données sans schéma sert zéro table et chaque requête de collection échoue tant que les migrations n'ont pas été exécutées. PAYLOAD_SECRETdoit être traité comme immuable après le premier démarrage. Il signe les jetons de session/authentification de Payload ; sa rotation invalide toutes les sessions actives.- Chemin de santé. Les sondes de démarrage et de vivacité ciblent
/admin— la route de l'interface d'administration de Payload, qui renvoie un200non authentifié une fois que le serveur Node.js et la connexion à la base de données sont prêts. Prévoyez plusieurs minutes au premier démarrage pour que le jobpayload-migratese termine avant que le service ne soit censé servir du contenu réel. - Premier compte administrateur. Payload n'a pas de commande CLI pour créer le premier utilisateur administrateur
de manière non interactive. Visitez
$SERVICE_URL/admin— avec une collectionusersvide, Payload affiche un formulaire d'inscription pour créer le premier administrateur. Il s'agit d'une étape manuelle et unique de l'opérateur. - Les téléchargements de médias ne persistent pas. Aucun bucket de stockage n'est provisionné ; les fichiers téléchargés sont écrits sur le disque local du conteneur et sont perdus lors du prochain redémarrage du pod, du redéploiement ou du démarrage à froid de mise à l'échelle à zéro remplaçant le conteneur.
- 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 comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour Payload sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | 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 | Court suffixe qui rend les noms de ressources uniques par environnement. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | payload | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | Payload CMS | Nom lisible par l'homme affiché dans la console. Texte restant de la source de clonage du module — à remplacer par Payload CMS (ou toute étiquette de votre choix) au moment du déploiement ; c'est purement cosmétique. |
application_version | latest | Balise de suivi de déploiement intégrée à l'image via l'argument de build application_version de Cloud Build. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
cpu_limit / memory_limit | 1000m / 2Gi | Payload (Next.js) a besoin de marge pour le serveur autonome plus l'empreinte TypeScript/CLI du job de migration. |
cpu_always_allocated | false | Facturation basée sur les requêtes — Payload s'exécute uniquement côté serveur (pas de processus worker, cron désactivé), il s'agit donc d'une pure requête/réponse sans rien à limiter. |
min_instance_count / max_instance_count | 0 / 3 | 0 active la mise à l'échelle à zéro. |
container_port | 3000 | Valeur par défaut de Next.js. |
container_image_source | custom | Fixe — il n'y a pas d'image Payload préconstruite à déployer. |
enable_cloudsql_volume | true | Proxy d'authentification Cloud SQL pour les connexions socket. |
enable_image_mirroring | true | Met en miroir l'image construite dans Artifact Registry. |
Groupe 5 — Contrôle d'accès et d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Public par défaut. |
enable_iap | false | Exiger la connexion Google — bloque les visiteurs anonymes du formulaire d'inscription du premier utilisateur de /admin si activé avant l'existence du premier administrateur. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres supplémentaires non secrets. Ne pas définir PAYLOAD_SECRET ou DATABASE_URL ici — les deux sont calculés automatiquement. |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. |
Groupe 11 — Cloud Storage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_gcs_storage | false | Déclaré dans variables.tf avec une description impliquant un adaptateur de stockage GCS compatible S3, mais non transmis à Payload_Common — n'a aucun effet. La sortie Payload_Common de storage_buckets est toujours []. |
gcs_volumes | [] | Transmis réellement — montages de volume GCS Fuse, si vous souhaitez câbler vous-même le stockage persistant. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Fixe ; Payload nécessite PostgreSQL. |
db_name / db_user | payload / payload | Nom de la base de données PostgreSQL et utilisateur de l'application. Immuable après le premier déploiement. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laisser vide pour utiliser la chaîne intégrée db-init → payload-migrate. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /admin, délai de 120s, période de 15s, 40 tentatives | Fenêtre totale d'environ 12 minutes pour que les migrations au premier démarrage se terminent. |
liveness_probe | HTTP /admin, délai de 30s | Sonde de vivacité. |
Groupe 21 — Cache Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis / redis_host / redis_port / redis_auth | true / "" / 6379 / "" | Inerte. Déclaré dans variables.tf (avec une description affirmant que Payload v0.4+ nécessite Redis) mais jamais transmis à Payload_Common, qui n'a aucun câblage Redis. La définition de ces valeurs n'a aucun effet. |
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. |
service_location | Région dans laquelle le service s'exécute. |
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 de la base de données / utilisateur 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 | Toujours vide — aucun bucket n'est provisionné. |
container_image / container_registry | Image construite et dépôt Artifact Registry. |
initialization_jobs | Noms des jobs db-init et payload-migrate. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | Statut de surveillance, canaux, tests de disponibilité. |
cicd_enabled / cicd_configuration | Statut et détails CI/CD. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | Statut VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation 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).
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
PAYLOAD_SECRET (auto-généré) | Ne jamais faire pivoter après le premier démarrage | Critique | Le faire pivoter invalide chaque session active, forçant tous les utilisateurs à se reconnecter. |
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/l'utilisateur et détruit toutes les données. |
Synchronisation startup_probe / payload-migrate | Laisser la fenêtre complète d'environ 12 minutes | Élevé | Si la fenêtre de la sonde est raccourcie en dessous du temps nécessaire à payload-migrate, la révision peut être marquée comme non saine avant la fin de la migration du schéma, car les deux s'exécutent concurremment plutôt que la sonde n'attende le job. |
| Persistance des médias/téléchargements | Ajouter un véritable adaptateur de stockage avant l'utilisation en production | Élevé | Sans bucket de stockage câblé, tous les médias téléchargés résident sur le disque local du conteneur et sont perdus à chaque redémarrage de pod, redéploiement ou démarrage à froid. |
enable_gcs_storage | Ne pas se fier à ce commutateur | Moyen | Déclaré mais non transmis à Payload_Common — son activation ne provisionne ni ne câble aucun stockage. |
enable_redis / redis_* | Ne pas se fier à ces commutateurs | Moyen | Déclaré mais non transmis à Payload_Common, qui n'a aucun câblage Redis — leur définition n'a aucun effet. |
| Création du premier administrateur | Terminer rapidement après le déploiement | Moyen | Tant que le premier administrateur n'est pas créé via le formulaire d'inscription /admin, l'instance n'a aucun utilisateur authentifié. |
container_image_source | Laisser à custom | Faible | Il n'y a pas d'image Payload préconstruite ; définir prebuilt sans un container_image valide interrompt le déploiement. |
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 à Payload partagée avec la variante GKE est décrite dans Payload_Common.
Guides associés
- Lab pratique : Payload CMS sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Payload CMS sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- Payload Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Medusa sur Google Cloud Run, Matomo sur Google Cloud Run, Listmonk sur Google Cloud Run dans la solution E-commerce Storefront.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.