Aller au contenu principal

Exemple d'application sur Google Cloud Run

Exemple d'application sur Google Cloud Run

Le module Sample est une implémentation de référence qui démontre comment les modules d'application sont construits sur cette plateforme. Il déploie une application web Flask minimale (Python 3.11, PostgreSQL 15, Redis optionnel, NFS optionnel) 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 l'application Sample et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à toutes les applications 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.


1. Vue d'ensemble​

L'application Sample s'exécute en tant que conteneur Python/Gunicorn sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service Flask/Gunicorn, 1 vCPU / 512 Mio par défaut, autoscaling basé sur les requêtes
Base de donnéesCloud SQL pour PostgreSQL 15Requis ; le job db-init crée le schéma lors du premier déploiement
Fichiers partagésFilestore (NFS)Activé par défaut ; volume partagé monté à /mnt/nfs (nécessite un environnement d'exécution gen2)
Stockage d'objetsCloud StorageUn seul bucket data provisionné par défaut
Cache et sessionsRedisOptionnel (enable_redis = false par défaut) ; lorsqu'il est activé, un service interne redis:alpine est déployé
SecretsSecret ManagerClé secrète Flask SECRET_KEY auto-générée stockée au moment du déploiement
IngressURL Cloud Run / Cloud Load BalancingURL par défaut run.app ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • PostgreSQL 15 est fixe. Le moteur de base de données est défini sur POSTGRES_15 par Sample_Common et ne peut pas être changé en MySQL ou NONE dans ce module.
  • Un job db-init s'exécute lors du premier déploiement pour créer la base de données PostgreSQL, l'utilisateur et le schéma. Il est idempotent et peut être réexécuté en toute sécurité.
  • Redis est désactivé par défaut. Lorsque enable_redis = true, un service interne redis:alpine Cloud Run est déployé. Contrairement à la variante GKE, il n'y a pas de repli automatique vers 127.0.0.1 — vous devez définir redis_host explicitement sur l'URL interne du service ou une IP privée Cloud Memorystore.
  • La clé secrète Flask SECRET_KEY est auto-générée et stockée dans Secret Manager ; elle n'est jamais définie en texte clair.
  • min_instance_count est par défaut à 0 (mise à l'échelle à zéro). Le module ne remplace pas cela ; définissez-le sur 1 si vous souhaitez éliminer les démarrages à froid.
  • Les sondes de santé ciblent /healthz — une sonde de démarrage TCP Cloud Run et une sonde de vivacité HTTP contre le point de terminaison /healthz (renvoie {"status": "healthy"}).

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 Sample​

L'application Flask s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge de requêtes entre les nombres minimum et maximum d'instances. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les 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 SQL pour PostgreSQL 15​

L'application Sample stocke son compteur de visiteurs dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le service se connecte en privé via le Cloud SQL Auth Proxy sur un socket Unix (pas d'IP publique). Lors du premier déploiement, un job d'initialisation crée la base de données de l'application, l'utilisateur et accorde les privilèges.

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

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

C. Filestore (NFS) et Cloud Storage​

Lorsque enable_nfs = true (par défaut), un partage Filestore (NFS) est monté dans le service Cloud Run afin que toutes les instances partagent les mêmes fichiers. Cela nécessite l'environnement d'exécution gen2. Un bucket Cloud Storage dédié est également provisionné.

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

Voir App_CloudRun pour le montage NFS, GCS Fuse et CMEK.

D. Cache Redis (optionnel)​

Lorsque enable_redis = true, un service interne redis:alpine Cloud Run est déployé parallèlement à l'application. L'application Flask l'utilise pour le stockage des sessions côté serveur. Les variables d'environnement ENABLE_REDIS, REDIS_HOST et REDIS_PORT sont injectées automatiquement. Vous devez définir redis_host explicitement — les instances Cloud Run ne peuvent pas atteindre un service colocalisé via 127.0.0.1.

  • Console : Cloud Run — le service Redis apparaît comme un service Cloud Run séparé dans le même projet et la même région.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <redis-service-name> --project "$PROJECT" --region "$REGION"

E. Secret Manager​

La clé secrète Flask SECRET_KEY est auto-générée lors du premier déploiement et stockée en tant que secret Secret Manager. Le mot de passe de la base de données est également géré dans Secret Manager 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.

F. 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 ajoutés en couches ; les paramètres d'ingress et le contrôle d'egress VPC contrôlent la connectivité.

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

G. Cloud Logging et Monitoring​

Les journaux des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run et Cloud SQL sont envoyées à Cloud Monitoring, avec des vérifications de disponibilité et des politiques d'alerte optionnelles.

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

  • Configuration de la base de données au premier déploiement. Un job d'initialisation exécute db-init.sh (en utilisant l'image postgres:15-alpine) qui crée de manière idempotente l'utilisateur de la base de données PostgreSQL, la base de données et accorde les privilèges. Il peut être réexécuté en toute sécurité.
  • Sondes de santé. La sonde de démarrage est TCP (vérifie que le port 8080 est ouvert). La sonde de vivacité cible GET /healthz, qui renvoie {"status": "healthy"} immédiatement sans requête de base de données.
  • Compteur de visiteurs. La route racine (GET /) incrémente un compteur persistant dans la table visitors de PostgreSQL, démontrant à la fois la connectivité de la base de données et (lorsque Redis est activé) le suivi par session.
  • Diagnostics de base de données. GET /db exécute SELECT version() et renvoie la chaîne de version de PostgreSQL — utile pour vérifier rapidement la connectivité de la base de données.
  • Gestion des sessions Redis. Lorsque enable_redis = true et redis_host est défini sur un point de terminaison accessible, l'application Flask utilise Flask-Session avec un backend Redis. Lorsque REDIS_HOST est vide, un avertissement est enregistré et les sessions se replient sur des cookies signés.
  • Clé secrète Flask SECRET_KEY. La clé auto-générée est récupérée de Secret Manager et injectée en tant que variable d'environnement SECRET_KEY au démarrage de l'instance. Elle est utilisée pour la signature des sessions.
  • Inspecter les instances en cours d'exécution :
    gcloud run services describe <service-name> --region "$REGION" --project "$PROJECT"
    gcloud run revisions list --service <service-name> --region "$REGION" --project "$PROJECT"

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 Sample_CloudRun sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec leur comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]E-mails ayant accès au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namecloudrunappNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameCloudrun ApplicationNom convivial affiché dans la console.
application_description(défini)Description du service.
application_versionlatestTag de version de l'image du conteneur.
application_database_namesampleappNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_usercloudrunappUtilisateur de l'application. Immuable après le premier déploiement.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustom"prebuilt" déploie une image existante ; "custom" construit via Cloud Build.
container_imageus-docker.pkg.dev/cloudrun/container/helloURI de l'image lorsque container_image_source = "prebuilt".
cpu_limit1000mCPU par instance.
memory_limit512MiMémoire par instance.
min_instance_count0Instances minimales (0 = mise à l'échelle à zéro).
max_instance_count1Instances maximales.
container_port8080Flask/Gunicorn écoute sur le port 8080.
execution_environmentgen2Requis pour les montages NFS.
enable_cloudsql_volumetrueCloud SQL Auth Proxy pour les connexions socket.
traffic_split[]Répartir le trafic entre les révisions pour des déploiements échelonnés.
max_revisions_to_retain7Nombre d'anciennes révisions à conserver.

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

VariableValeur par défautDescription
ingress_settingsallQuels réseaux peuvent atteindre le service (all / internal / internal-and-cloud-load-balancing).
vpc_egress_settingPRIVATE_RANGES_ONLYComment le trafic sortant est acheminé via le connecteur VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
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.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation.

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron de sauvegarde automatisée (UTC).
backup_retention_days7Rétention ; augmenter pour la production/conformité.
enable_backup_import / backup_source / backup_uri / backup_formatoptions de restaurationRestaurer à partir d'une sauvegarde lors du déploiement.

Groupe 8 — CI/CD et Binary Authorization​

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

Groupe 9 — Scripts SQL personnalisés​

enable_custom_sql_scripts, custom_sql_scripts_bucket, custom_sql_scripts_path, custom_sql_scripts_use_root — exécutez du SQL à partir d'un bucket GCS après le provisionnement. Voir App_CloudRun.

Groupe 10 — Domaine, CDN, Cloud Armor et rétention d'images​

VariableValeur par défautDescription
application_domains[]Noms d'hôtes personnalisés pour l'équilibreur de charge externe.
enable_cdnfalseActiver Cloud CDN sur le backend de l'équilibreur de charge.
enable_cloud_armor / admin_ip_rangesdésactivéAttacher une politique WAF / restreindre l'accès privilégié.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueVolume Filestore partagé. Nécessite l'environnement d'exécution gen2.
nfs_mount_path/mnt/nfsChemin de montage à l'intérieur du conteneur.
nfs_instance_name""Nom d'une VM NFS existante ; laisser vide pour la découverte automatique.
nfs_instance_base_nameapp-nfsNom de base pour une VM NFS intégrée lorsqu'il n'en existe pas.
create_cloud_storage / storage_buckets / gcs_volumes(défini)Bucket de données / buckets supplémentaires / montages GCS Fuse.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_password_length32Longueur du mot de passe généré (16-64).
enable_auto_password_rotation / rotation_propagation_delay_secdésactivéRotation du mot de passe de la base de données.

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

VariableValeur par défautDescription
initialization_jobs[]Laisser vide pour utiliser le job db-init intégré de Sample_Common.
cron_jobs[]Jobs Cloud Run récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe_configTCP, port 8080Sonde de démarrage TCP (attend que le port s'ouvre).
health_check_configHTTP GET /Sonde de vivacité.
startup_probe / liveness_probeHTTP GET /healthzParamètres de sonde au niveau de l'application passés à Sample_Common.
uptime_check_config{ enabled = false, path = "/" }Vérification de disponibilité Cloud Monitoring ; désactivée par défaut.
alert_policies[]Politiques d'alerte métrique.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseDéployer un service Redis interne et activer le stockage de session.
redis_host""Doit être défini explicitement. Pas de repli automatique — laisser vide entraîne un REDIS_HOST vide et un échec de connexion.
redis_port6379Port Redis.
redis_auth""Mot de passe d'authentification Redis optionnel (sensible).

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

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

5. Sorties​

Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
load_balancer_ip / load_balancer_urlIP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé).
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom de la base de données / utilisateur 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, vérifications 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).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
database_type (via Sample_Common)PostgreSQL 15 (fixe)CritiqueLe script db-init utilise des commandes spécifiques à PostgreSQL ; un moteur différent rompt la configuration de la base de données.
application_database_name / _userdéfini une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit les données.
application_namedéfini une foisCritiqueIntégré dans le nom du service Cloud Run, le dépôt Artifact Registry et les ID de secret Secret Manager. La modification orpheline les secrets existants.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans backup_uri valide échoue le job d'importation.
container_port8080CritiqueUne non-concordance entraîne l'échec de la sonde de démarrage TCP — la révision ne devient jamais saine.
enable_cloudsql_volumetrueCritiquefalse avec PostgreSQL : toutes les connexions à la base de données échouent au démarrage. Le job db-init échoue également.
execution_environmentgen2Élevégen1 avec enable_nfs = true : le montage NFS échoue au démarrage du conteneur.
enable_redisfalse (par défaut)Élevétrue sans redis_host défini : REDIS_HOST est vide et l'application Flask ne peut pas se connecter à Redis.
memory_limit512Mi ou plusÉlevéTrop peu de mémoire entraîne l'arrêt de l'application Flask par OOM au démarrage.
ingress_settingsall pour les tests ; internal-and-cloud-load-balancing avec Cloud ArmorMoyenL'utilisation de all avec Cloud Armor permet aux requêtes de contourner le WAF via l'URL *.run.app.
enable_iap / enable_cloud_armoractiver pour la productionMoyenL'application est autrement accessible publiquement.
min_instance_count1 pour les charges de travail sensibles à la latenceMoyen0 signifie des démarrages à froid (5–10 s) sous charge.
enable_vpc_sc avec vpc_sc_dry_run = falsetester d'abord en mode dry-runCritiqueSi un SA ou une IP est manquant du niveau d'accès, l'accès à Cloud Run, Cloud SQL et Secret Manager échoue simultanément.
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 partagée (clé secrète Flask, amorçage de la base de données, comportement des sondes et sidecar Redis) est décrite dans Sample_Common.

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