WordPress Common — Configuration d'application partagée
Wordpress_Common est la couche d'application partagée pour WordPress. Elle n'est pas déployée seule ; elle fournit plutôt la configuration spécifique à WordPress sur laquelle s'appuient Wordpress_GKE et Wordpress_CloudRun, de sorte que les deux variantes de plateforme se comportent de manière identique là où cela compte. Les utilisateurs finaux ne configurent jamais cette couche directement — elle n'a pas ses propres entrées d'interface utilisateur de déploiement — mais comprendre ce qu'elle fournit explique les valeurs par défaut que vous voyez dans la documentation de la plateforme.
Pour l'infrastructure qui provisionne et exécute réellement WordPress, consultez les guides de la plateforme (Wordpress_GKE, Wordpress_CloudRun) et les guides du socle (App_GKE, App_CloudRun, App_Common).
1. Ce que cette couche fournit
| Domaine | Fourni par Wordpress_Common | Où cela apparaît |
|---|---|---|
| Secrets d'authentification | Génère huit clés et sels de sécurité WordPress et les stocke dans Secret Manager | Récupérer via Secret Manager (voir ci-dessous) |
| Image de conteneur | Construit une image PHP 8.4 + Apache personnalisée à partir de la source officielle WordPress via Cloud Build | Sortie container_image du déploiement de la plateforme |
| Moteur de base de données | Fixe Cloud SQL pour MySQL 8.0 comme seul moteur pris en charge | §Base de données dans les guides de la plateforme |
| Amorçage de la base de données | Définit le job de premier déploiement qui crée la base de données, l'utilisateur et les autorisations | Sortie initialization_jobs |
| Stockage d'objets | Déclare le bucket média Cloud Storage wp-uploads | Sortie storage_buckets |
| Paramètres de base | Définit l'environnement WordPress de base (préfixe de table, mode débogage, connexion Redis, gestion des proxys de confiance) | Comportement de l'application dans les guides de la plateforme |
| Tests de santé | Fournit la configuration par défaut de la sonde de démarrage (TCP) et de vivacité (HTTP /wp-admin/install.php) | §Observabilité dans les guides de la plateforme |
2. Secrets d'authentification WordPress dans Secret Manager
Huit constantes de sécurité WordPress sont générées automatiquement sous forme de chaînes aléatoires de 64 caractères (y compris les caractères spéciaux) et stockées en tant que secrets Secret Manager — elles ne sont jamais définies en texte clair. Récupérez-les après le déploiement :
# List all secrets for this deployment:
gcloud secrets list --project "$PROJECT" --filter="name~<resource-prefix>"
# Retrieve a specific secret value:
gcloud secrets versions access latest --secret=secret-<resource-prefix>-wordpress-auth-key --project "$PROJECT"
Les huit secrets correspondent aux constantes WordPress AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT et NONCE_SALT. Ils sont injectés dans les pods de l'application au moment de l'exécution via le pilote CSI du magasin de secrets Kubernetes (GKE) ou le montage de secrets Cloud Run (Cloud Run).
Important : La rotation de ces secrets (en les supprimant et en les recréant) invalide immédiatement toutes les sessions de navigateur WordPress actives. Chaque utilisateur connecté — y compris les administrateurs — sera déconnecté. Ne faites pivoter que si un secret est soupçonné d'avoir été compromis.
Le mot de passe de la base de données est généré et géré séparément par le socle ; son nom de secret est indiqué dans les sorties de déploiement de la plateforme (database_password_secret). Voir App_Common pour le secret partagé et le modèle Workload Identity.
3. Moteur de base de données et amorçage
WordPress nécessite MySQL 8.0 ; le moteur est fixe et PostgreSQL n'est pas pris en charge. Lors du premier déploiement, un job db-init ponctuel se connecte à Cloud SQL via le proxy d'authentification et de manière idempotente :
- Crée la base de données WordPress (si absente).
- Crée l'utilisateur de l'application avec le mot de passe généré.
- Accorde à l'utilisateur tous les privilèges sur cette base de données.
Le job s'exécute à chaque tofu apply car il est idempotent — il ignore en toute sécurité les étapes déjà terminées. Inspectez la base de données directement avec :
gcloud sql connect <instance-name> --user=<db-user> --project "$PROJECT"
Les noms d'instance, de base de données et d'utilisateur se trouvent dans les sorties de déploiement de la plateforme.
4. Image de conteneur
L'image WordPress est construite à partir d'un Dockerfile personnalisé basé sur php:8.4-apache. La construction est effectuée par Cloud Build au moment du déploiement avec application_version passé comme argument de construction APP_VERSION, qui contrôle la version de WordPress téléchargée depuis wordpress.org.
L'image comprend :
- Extensions PHP :
bcmath,exif,gd(AVIF, FreeType, JPEG, WebP),intl,mysqli,zip - Extensions PECL :
imagick(ImageMagick pour le traitement d'images avancé),redis(requis par le plugin de cache d'objets WP Redis) - Modules Apache :
mod_rewrite(support des permaliens WordPress),mod_expires,mod_remoteip(fait confiance àX-Forwarded-Fordes équilibreurs de charge Cloud Run et GKE) - Surcharges PHP.ini :
memory_limit,upload_max_filesizeetpost_max_sizesont intégrées à partir des arguments de construction définis dans le module de la plateforme
Les modifications de configuration PHP (limite de mémoire, taille de téléchargement) nécessitent une nouvelle exécution et un nouveau déploiement de Cloud Build. Inspectez les valeurs actives dans une instance en cours d'exécution :
# GKE:
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- php -r "
echo 'memory_limit: ' . ini_get('memory_limit') . PHP_EOL;
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . PHP_EOL;
echo 'post_max_size: ' . ini_get('post_max_size') . PHP_EOL;
"
# Cloud Run:
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
5. Paramètres d'application de base
Wordpress_Common établit l'environnement WordPress de base afin que l'application démarre correctement au premier démarrage :
- Préfixe de table —
WORDPRESS_TABLE_PREFIXest défini surwp_. Ne le remplacez viaenvironment_variablesque lors de la migration d'une base de données existante avec un préfixe non standard. - Mode débogage —
WORDPRESS_DEBUGest défini surfalse. Activez-le uniquement dans les environnements de développement ; le mode débogage peut exposer des informations sensibles dans les réponses HTTP. - Cache d'objets Redis — lorsque
enable_redis = true,WP_REDIS_HOSTetWP_REDIS_PORTsont injectés et quedocker-entrypoint.shconfigure le plugin WP Redis. Lorsqueredis_hostest laissé vide, l'espace réservé$(REDIS_HOST)est résolu au démarrage du conteneur à l'adresse IP du serveur NFS — permettant Redis sur la VM NFS sans connaître son IP au moment de la planification.
Ajustements spécifiques à la plateforme gérés ici :
- Les deux plateformes dérivent
WP_HOMEetWP_SITEURLde l'URL de service injectée par la plateforme —CLOUDRUN_SERVICE_URLsur Cloud Run,GKE_SERVICE_URLsur GKE, en revenant à une variable d'environnementWP_HOME— afin que WordPress génère des liens absolus corrects, évite les boucles de redirection HTTP→HTTPS et suive l'adresse que la plateforme sert actuellement plutôt que les lignessiteurl/homestockées dans sa base de données au moment de l'installation.
6. Comportement de la sonde de santé
Les sondes par défaut sont réglées pour les caractéristiques de démarrage de WordPress :
- Sonde de démarrage (TCP) : Vérifie que le port d'Apache est ouvert. Utilise TCP plutôt que HTTP car WordPress peut émettre des redirections ou renvoyer des erreurs avant que la connexion à la base de données ne soit établie et que l'application ne soit entièrement initialisée. Le
failure_thresholdélevé (20 tentatives × 15 secondes = 300 secondes de grâce) tient compte du jobdb-initet de la phase d'initialisation au premier démarrage de WordPress. - Sonde de vivacité (HTTP) : Interroge
/wp-admin/install.phpavec un délai initial de 300 secondes. Cette page gérée par WordPress renvoie HTTP 200, que WordPress soit fraîchement installé ou déjà configuré, ce qui en fait un indicateur de vivacité fiable qui ne dépend pas d'une route/healthzpersonnalisée.
Les sondes sont identiques pour les variantes GKE et Cloud Run — les deux utilisent TCP pour le démarrage et HTTP pour la vivacité.
7. Stockage d'objets
Un bucket média Cloud Storage dédié avec le suffixe de nom wp-uploads est déclaré ici et provisionné par le socle, qui accorde également l'accès au compte de service de la charge de travail. Listez-le avec :
gcloud storage buckets list --project "$PROJECT" --filter="name~wp-uploads"
Le bucket est provisionné dans la région de déploiement. Combiné au volume Filestore (NFS) partagé, cela donne à WordPress un stockage média durable et cohérent sur toutes les instances.
Pour la configuration spécifique à WordPress et destinée à l'utilisateur (variables par groupe, sorties et comment explorer chaque service depuis la Console et la CLI), consultez les guides de la plateforme : Wordpress_GKE et Wordpress_CloudRun.
Guides associés
- WordPress sur Google Cloud Run — cette configuration déployée sur Cloud Run.
- WordPress sur GKE Autopilot — cette configuration déployée sur GKE.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.