Changedetection sur Google Cloud Run

changedetection.io est un service open source auto-hébergé qui surveille les modifications de pages web et envoie des notifications lorsqu'elles se produisent. Ce module déploie changedetection.io sur Cloud Run v2 au-dessus du socle App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud qu'utilise changedetection.io 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 à toutes les applications Cloud Run — identité du 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 du socle App_CloudRun plutôt que de les répéter ici.

1. Vue d'ensemble

changedetection.io s'exécute comme un conteneur Python/Flask unique sur Cloud Run v2. Le déploiement assemble un ensemble volontairement réduit de services Google Cloud — il n'y a ni base de données ni cache :

Fonctionnalité	Service Google Cloud	Remarques
Calcul	Cloud Run v2	Service Python/Flask, 1 vCPU / 1 GiB par défaut, à l'écoute sur le port 5000
Base de données	Aucune	`database_type = NONE` — changedetection.io stocke tout son état sur disque, et non en SQL
Stockage de données persistant	Cloud Storage (GCS FUSE)	Un bucket de données monté sur `/datastore`, contenant la configuration des surveillances, les instantanés et l'historique
Cache et file d'attente	Aucun	Redis n'est pas utilisé ; il est explicitement désactivé
Secrets	Secret Manager	Aucun secret d'application n'est injecté ; le jeton de l'API REST est créé dans l'interface web
Ingress	URL Cloud Run / Cloud Load Balancing	URL `run.app` par défaut ; équilibreur de charge HTTPS externe et domaine personnalisé facultatifs

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

Ni base de données, ni Redis. changedetection.io est entièrement autonome. Il n'y a ni instance Cloud SQL, ni job db-init, ni étape de migration de schéma. Redis est désactivé (enable_redis = false) et enable_cloudsql_volume = false.
Tout l'état réside dans un seul bucket GCS. Le bucket du stockage de données est monté sur /datastore via GCS FUSE (enable_gcs_storage_volume = true, ce qui nécessite l'environnement d'exécution gen2). Supprimer ou recréer ce bucket fait perdre toutes les surveillances et leur historique.
Instance unique par défaut. min_instance_count = 1 et max_instance_count = 1. changedetection.io exécute son planificateur de récupération dans le processus, sur un stockage de données unique sur disque ; exécuter plus d'une instance sur le même stockage monté via FUSE expose à une corruption par écritures concurrentes. Conservez max_instance_count = 1.
min_instance_count = 1 (pas de mise à zéro). L'instance unique reste active afin que le planificateur de récupération continue d'exécuter les vérifications de surveillance, même en l'absence de trafic web entrant.
Ingress public par défaut. ingress_settings = "all", afin que le tableau de bord web soit accessible depuis un navigateur. L'interface est livrée sans authentification — définissez immédiatement un mot de passe dans Settings → General, et/ou activez IAP.
BASE_URL est injectée automatiquement. L'URL prévue du service Cloud Run est injectée sous BASE_URL (service_url_env_var_name = "BASE_URL"), de sorte que les liens des notifications pointent vers l'adresse réelle du service.
Épinglage de version. Avec application_version = "latest", le build de l'image épingle un tag connu pour fonctionner (0.50.19) via l'argument de build propre à l'application CHANGEDETECTION_VERSION.

2. Services Google Cloud et comment les explorer

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms du service et des ressources figurent dans les sorties du déploiement.

A. Cloud Run — le service changedetection.io

changedetection.io s'exécute comme un service Cloud Run v2 à l'écoute sur le port 5000. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements progressifs sûrs. Comme le planificateur de récupération s'exécute dans le processus, le service est normalement limité à une seule instance toujours active.

Console : Cloud Run → sélectionnez le service pour voir 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"

Consultez App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Base de données — non utilisée

changedetection.io n'utilise aucune base de données SQL. database_type = NONE est fixé par Changedetection_Common ; aucune instance Cloud SQL n'est créée et il n'y a pas de job d'initialisation db-init. Tout l'état persistant réside dans le bucket GCS du stockage de données décrit ci-dessous.

C. Cloud Storage — le stockage de données

Un bucket Cloud Storage unique est provisionné automatiquement et monté sur /datastore en tant que volume GCS FUSE (DATASTORE_PATH = /datastore). Il contient le JSON de configuration des surveillances, les instantanés de pages et l'historique des modifications — tout ce que l'application conserve.

Console : Cloud Storage → Buckets.

CLI :

gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
gcloud storage ls gs://<data-bucket>/          # bucket name is in the Outputs
gcloud storage ls gs://<data-bucket>/url-watches.json

GCS FUSE nécessite l'environnement d'exécution gen2 (la valeur par défaut). Consultez App_CloudRun pour les options GCS FUSE et CMEK.

D. Cache et file d'attente — non utilisés

changedetection.io n'utilise ni Redis ni aucune file d'attente externe ; son planificateur de surveillances s'exécute dans le processus. enable_redis = false est défini explicitement et aucune entrée Redis n'est raccordée.

E. Secret Manager

Aucun secret d'application n'est injecté dans le conteneur — le jeton facultatif de l'API REST est généré dans l'interface web (Settings → API), et le stockage de données n'utilise aucune clé de chiffrement. Secret Manager reste disponible pour les éventuelles secret_environment_variables fournies par l'opérateur.

Console : Security → Secret Manager.

CLI :

gcloud secrets list --project "$PROJECT"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

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

F. Réseau et entrée

Le service est accessible par défaut à son URL run.app (ingress_settings = "all"), ce qui permet un accès public au tableau de bord depuis un navigateur. Un équilibreur de charge HTTPS externe avec domaine personnalisé, Cloud CDN et Cloud Armor peut être ajouté ; les paramètres d'ingress et le contrôle de sortie VPC régissent la connectivité.

Console : Cloud Run (URL du service) ; Network services → Load balancing.

CLI :

gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
gcloud compute addresses list --project "$PROJECT"

Consultez App_CloudRun.

G. Cloud Logging et Monitoring

Les journaux du conteneur sont envoyés vers Cloud Logging ; les métriques de Cloud Run vers Cloud Monitoring, avec des tests de disponibilité et des règles d'alerte facultatifs.

Console : Logging → Logs Explorer ; Monitoring → Dashboards / Alerting.

CLI :

gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application changedetection.io

Aucune configuration de base de données au premier déploiement. Il n'y a ni base de données ni job d'initialisation. Au premier démarrage, changedetection.io crée ses fichiers de stockage (url-watches.json et les répertoires d'historique par surveillance) sous /datastore s'ils n'existent pas déjà.
Aucune migration de schéma. Les mises à niveau du format du stockage de données sont gérées en interne par l'application au démarrage ; il n'y a aucune étape de migration distincte à exécuter.
Le stockage de données est le seul élément avec état. Tout ce que l'application conserve — surveillances, instantanés, historique des différences, configuration des notifications et éventuel mot de passe de l'interface — réside dans le bucket GCS du stockage de données. Protégez-le en conséquence ; recréer le bucket efface tout l'état.
Aucune authentification par défaut. Le tableau de bord est livré ouvert. Définissez un mot de passe sous Settings → General → Password immédiatement après le premier accès, et/ou activez IAP devant le service. Il n'existe ni compte administrateur ni identifiant par défaut.
Le jeton de l'API REST est créé dans l'interface. Pour utiliser l'API REST, générez un jeton sous Settings → API et transmettez-le dans l'en-tête x-api-key. Il n'est pas injecté via une variable d'environnement.
BASE_URL pour les liens des notifications. L'URL prévue du service est injectée sous BASE_URL, afin que le corps des notifications contienne des liens absolus fonctionnels. Vérifiez qu'elle correspond à l'URL réelle du service après le déploiement :
```
gcloud run services describe <service-name> \
  --region "$REGION" --project "$PROJECT" --format='value(status.url)'
```
Chemin de santé. Les sondes de démarrage et de vivacité ciblent / — l'interface web, qui renvoie HTTP 200 dès que le serveur Flask est prêt. Le premier démarrage est rapide (pas de migrations) ; la sonde de démarrage par défaut prévoit un délai initial de 15 secondes plus une fenêtre de 10 tentatives.
Contrainte de mise à l'échelle. Conservez max_instance_count = 1. Plusieurs instances partageraient le même stockage de données monté via FUSE et entreraient en concurrence lors des écritures ; l'application ne dispose d'aucune coordination distribuée.

Inspecter l'environnement en cours d'exécution :

gcloud run services describe <service-name> --region "$REGION" \
  --format='value(spec.template.spec.containers[0].env)'

4. Variables de configuration

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres propres à changedetection.io ou notables pour lui sont listés ; toutes les autres entrées sont héritées d'App_CloudRun avec leur comportement standard.