Aller au contenu principal

FreshRSS sur Google Cloud Run

FreshRSS sur Google Cloud Run

FreshRSS est un agrégateur de flux RSS et Atom gratuit, auto-hébergé et sous licence GPL-3.0 — un « lecteur de nouvelles » léger et multi-utilisateur écrit en PHP qui fonctionne derrière Apache et expose les API Google Reader et Fever pour les clients mobiles. Ce module déploie FreshRSS 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 FreshRSS 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 FreshRSS sur RAD, et comment cela se compare​

L'exécution de FreshRSS dans votre propre projet Google Cloud coûte environ 90,17 $ US/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 75 crédits (67,5 crédits — 10 % de moins — dans un projet géré par RAD). FreshRSS est un agrégateur de flux RSS et Atom gratuit, open source et auto-hébergé. Si vous déployez dans un projet géré par RAD, vous pouvez tout mettre en pause gratuitement et le reprendre plus tard — voir « Mettre en pause gratuitement » ci-dessous.

FreshRSS est également disponible sur GKE — voir le guide GKE si vous avez besoin d'une orchestration basée sur Kubernetes ; ce guide couvre l'option Cloud Run, moins coûteuse.

Ce que vous payez sur RAD​

Votre propre projetProjet géré par RAD
Frais de module75 crédits (une seule fois)67,5 crédits (une seule fois, 10 % de moins)
BuildsInclus 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 : le temps de build est toujours facturé à la minuteIdentique
Coût d'exécution Google Cloud~90,17 $ US/mois, facturé à votre propre compte de facturation Google au prix catalogue~71 crédits/jour (~7,10 $ US/jour), mesuré à l'heure au prix catalogue plus la marge de RAD

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : 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).

Coût d'exécution par défaut dans votre propre projet

Ressource$ US/mois (prix catalogue Google, us-central1)
Cloud Run, 1x vCPU / 2 Gio (chaud)19,72 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Total90,17 $ US

Comment cela se compare​

  • Il n'existe pas de version officiellement hébergée/cloud de FreshRSS à comparer, donc la comparaison honnête se fait avec une infrastructure auto-gérée, et non avec un SaaS concurrent.
  • Un VPS nu d'environ 1 vCPU / 2 Gio — un Hetzner CPX22 (2 vCPU/4 Go, ~24 $ US/mois), un DigitalOcean 2 vCPU/4 Go Droplet (24 $ US/mois), ou le propre Compute Engine e2-standard-2 de GCP (2 vCPU/8 Go, ~49 $ US/mois) — est généralement moins cher que le prix affiché de RAD ; un VPS d'une ou deux tailles inférieures serait encore moins cher.
  • Ce prix inférieur n'inclut pas le temps de l'administrateur : patcher le système d'exploitation, faire tourner les sauvegardes de base de données, renouveler les certificats TLS et surveiller les temps d'arrêt. Cloud SQL, Secret Manager et la surveillance gérés par RAD le font pour vous, ce qui est le véritable compromis, et non le prix affiché.
  • RAD ne prétend pas être moins cher qu'un VPS nu en termes d'argent — ce n'est généralement pas le cas. L'intérêt de RAD est ce qui est géré pour vous.

Mettre en pause gratuitement : supprimer un projet géré par RAD, le restaurer lorsque vous en avez besoin​

Si FreshRSS est exécuté dans un projet géré par RAD, vous pouvez arrêter de le payer entièrement sans le détruire. La suppression de ce projet délie d'abord sa facturation, puis demande à Google de supprimer purement et simplement le projet — la suppression logicielle récupérable de 30 jours de Google. Contrairement à la suppression du module FreshRSS seul, cela ne supprime pas Cloud SQL, aucune VM ou la ressource de calcul une par une : l'ensemble du projet s'arrête simplement, et rien n'est facturé pendant qu'il attend, car la facturation est déjà déliée.

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.

La restauration, dans les 30 jours et uniquement par le propriétaire du projet, demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter une mise à 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 à nouveau les frais de module. 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. Les frais de module de 67,5 crédits ne sont pas facturés à nouveau.

Ce qu'il faut pour cela : vous devez être propriétaire du projet (pas un projet dont RAD gère uniquement la facturation), vous devez le restaurer vous-même dans les 30 jours — après quoi Google le supprime définitivement — et la restauration est admise comme la création d'un nouveau projet, de sorte que 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/démo). Google indique que la plupart des services sont à nouveau entièrement fonctionnels dans les 36 heures suivant une restauration.

Un véritable écart : les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du projet, et ce bucket a la suppression logicielle de Cloud Storage explicitement désactivée, 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é FreshRSS 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.

Payer uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

Si FreshRSS se trouve dans votre propre projet (ou si plus de 30 jours se sont écoulés sur un projet géré par RAD), la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer plus tard lorsque vous en aurez à nouveau besoin.

Un redéploiement coûte à nouveau les frais de module (les builds sont inclus) : 75 crédits (7,50 $ US) dans votre propre projet, ou 67,5 crédits sur un projet géré par RAD.

La suppression ne permet d'économiser de l'argent que si FreshRSS reste inutilisé suffisamment longtemps pour compenser ce coût de redéploiement par rapport à son propre coût d'exécution : environ 3 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 90,17 $ US/mois), ou environ 2 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~71 crédits/jour).

La majeure partie du coût d'exécution de FreshRSS est la base de données et 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 pendant que quelque chose d'autre partage le projet n'économise que la part de calcul de cette application sur le total ci-dessus.

Conservez d'abord les 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 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 fixée 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 cabinets 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 interrompue 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 de l'API Google Cloud Billing Catalog ; radmodules.dev/pricing pour les propres frais de RAD et les estimations de crédits quotidiens ; documentation de Google sur la suppression/restauration de projets pour les mécanismes de pause/restauration.

1. Vue d'ensemble​

FreshRSS s'exécute en tant que conteneur PHP/Apache sur Cloud Run v2. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2Service PHP/Apache sur le port 80, 1 vCPU / 2 Gio par défaut, une instance maintenue chaude (min_instance_count = 1)
Base de donnéesCloud SQL pour PostgreSQL 15Requis — le point d'entrée s'installe avec --db-type pgsql
Stockage persistantNFS (Filestore / auto-géré)Monté à /var/www/FreshRSS/data ; contient la configuration, l'état par utilisateur, le cache des flux. Pas de bucket GCS
CacheRedis (optionnel)Désactivé par défaut ; FreshRSS ne le requiert pas
SecretsSecret ManagerFRESHRSS_ADMIN_PASSWORD auto-généré ; mot de passe de la base de données
IngressURL Cloud Run / Cloud Load BalancingURL run.app par défaut ; équilibreur de charge HTTPS externe optionnel + domaine personnalisé

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

  • PostgreSQL 15 est le moteur pris en charge. Le point d'entrée du conteneur code en dur --db-type pgsql et le job db-init est uniquement Postgres ; le schéma est créé par l'installateur de FreshRSS au premier démarrage.
  • NFS est activé par défaut (enable_nfs = true) et monté à /var/www/FreshRSS/data. FreshRSS y écrit sa configuration générée (data/config.php), l'état par utilisateur, les articles mis en cache et les favicons — sans volume persistant, cet état est perdu à chaque démarrage à froid ou redéploiement.
  • FRESHRSS_ADMIN_PASSWORD est généré automatiquement et stocké dans Secret Manager. Il initialise le compte admin par défaut (et son mot de passe API pour les clients mobiles) lors de la première installation.
  • Une instance est maintenue chaude par défaut (min_instance_count = 1, max_instance_count = 1). Elle doit rester au moins à 1 : l'actualisation des flux s'exécute en tant que cron interne au conteneur (CRON_MIN = */15) qui n'existe que tant qu'une instance existe — voir le tableau des pièges.
  • max_instance_count = 1. Une seule instance possède le cron d'actualisation interne au conteneur et l'état de session/cache basé sur les fichiers ; l'exécution de plus d'une sans précaution duplique les actualisations de flux.
  • Le conteneur écoute sur le port 80 (Apache), pas 8080.
  • BASE_URL est défini à partir de l'URL de service prédite au moment de la planification et corrigé à l'exécution à partir de CLOUDRUN_SERVICE_URL, de sorte que les liens auto-référencés de FreshRSS et la redirection / → setup se résolvent sur l'hôte Cloud Run réel.

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

FreshRSS s'exécute en tant que service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre le nombre 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" \
    --filter="metadata.name~freshrss"
    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​

FreshRSS stocke toutes les données de l'application (flux, abonnements, articles, catégories, utilisateurs) dans une instance Cloud SQL pour PostgreSQL 15 gérée. Le service se connecte en privé via le Cloud SQL Auth Proxy sur un socket Unix ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init crée la base de données et l'utilisateur de l'application, et l'installateur de FreshRSS crée 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.

C. Stockage persistant (NFS)​

Le répertoire de données de FreshRSS (/var/www/FreshRSS/data) est sauvegardé par un volume NFS (enable_nfs = true), qui contient la configuration générée, l'état par utilisateur, les articles mis en cache et les favicons. Ce module ne déclare aucun bucket GCS — le contenu des flux est conservé dans PostgreSQL et le répertoire de données NFS.

  • Console : Filestore → Instances (NFS géré), ou Compute Engine → Instances de VM (serveur NFS auto-géré).
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    # Confirm the mount inside the running revision:
    gcloud run services describe <service-name> --region "$REGION" \
    --format='value(spec.template.spec.volumes)'

Voir App_CloudRun pour le modèle de serveur NFS et les options GCS Fuse.

D. Redis (cache optionnel)​

Redis est désactivé par défaut (enable_redis = false) et FreshRSS ne le requiert pas. Il est exposé comme une option transférée pour la parité avec les modules PHP frères ; laissez-le désactivé à moins que vous n'ayez une raison spécifique de l'activer.

  • Console : Memorystore → Redis (si vous utilisez une instance gérée).
  • CLI :
    redis-cli -h <redis-host> ping

E. Secret Manager​

Un secret d'application est généré automatiquement : FRESHRSS_ADMIN_PASSWORD, qui initialise le compte admin par défaut et son mot de passe API lors de la première installation. 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" --filter="name~freshrss"
    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 à son URL run.app par défaut (ingress public). Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés ; 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 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 politiques d'alerte optionnels.

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

  • Configuration de la base de données au premier déploiement. Le job db-init s'exécute à l'aide de postgres:15-alpine. Il se connecte via le Cloud SQL Auth Proxy et crée de manière idempotente la base de données et l'utilisateur de l'application et accorde les privilèges. Le job peut être réexécuté en toute sécurité.
  • Installation au premier démarrage. Le platform-entrypoint.sh du conteneur résout l'hôte de la base de données, puis exécute le cli/do-install.php de FreshRSS (crée data/config.php et le schéma) et cli/create-user.php (crée le compte admin à partir de FRESHRSS_ADMIN_PASSWORD), puis chaîne le point d'entrée amont. L'installation est idempotente — elle est ignorée une fois que data/config.php existe sur le volume NFS.
  • Cron d'actualisation des flux. L'image amont démarre un cron interne au conteneur (CRON_MIN = */15) qui actualise les flux abonnés toutes les 15 minutes. Cela ne s'exécute que tant qu'une instance est active — c'est pourquoi min_instance_count est par défaut à 1. À 0, Cloud Run récupère l'instance inactive et les actualisations s'arrêtent jusqu'à ce que la prochaine requête réveille le service.
  • Identifiants d'administrateur. La connexion par défaut est admin avec le FRESHRSS_ADMIN_PASSWORD généré ; la même valeur est définie comme mot de passe API utilisé par les clients mobiles Google Reader / Fever API. Changez-le dans l'interface utilisateur de FreshRSS après la première connexion — la rotation de la seule valeur Secret Manager ne réinitialisera pas un compte déjà installé.
  • Chemin de santé. La sonde de démarrage est une vérification TCP sur le port 80 ; la sonde de vivacité est un HTTP GET sur /i/, qui renvoie un littéral 200 et rend à partir de la base de données (/ répond avec une redirection 302, qu'une vérification de santé de l'équilibreur de charge rejette). FreshRSS sert également un point de terminaison JSON non authentifié /status adapté aux tests de disponibilité. Prévoyez une fenêtre généreuse au premier démarrage pendant que l'installateur crée le schéma.
  • URL de base. BASE_URL est défini sur l'URL Cloud Run prédite au moment de la planification et corrigé à l'exécution à partir de CLOUDRUN_SERVICE_URL. Vérifiez la révision en cours :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
  • 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 FreshRSS sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namefreshrssNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameFreshRSSNom lisible par l'homme affiché dans la console.
application_versionlatestTag de l'image FreshRSS ; latest est épinglé à un tag connu et fonctionnel (1.26.3) au moment du build. Épinglez explicitement en production.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
container_image_sourcecustomFreshRSS livre un build personnalisé léger ; utilisez prebuilt uniquement avec un container_image externe.
cpu_limit1000mCPU par instance (1 vCPU).
memory_limit2GiMémoire par instance ; maintenez ≥ 512 Mio.
min_instance_count1Maintenez 1 pour que le cron d'actualisation des flux continue de fonctionner ; 0 active la mise à l'échelle à zéro et arrête les actualisations pendant l'inactivité.
max_instance_count1Maintenez à 1 — une seule instance possède le cron d'actualisation et l'état basé sur les fichiers.
container_port80FreshRSS/Apache écoute sur le port 80.
execution_environmentgen2Gen2 requis pour les montages NFS.
enable_cloudsql_volumetrueSocket Cloud SQL Auth Proxy pour les connexions Postgres.
timeout_seconds300Durée maximale de la requête (0–3600 secondes).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 5 — Accès et contrôle d'ingress​

VariableValeur par défautDescription
ingress_settingsallall autorise l'accès public.
enable_iapfalseExiger la connexion Google devant FreshRSS.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
enable_nfstrueMonte un volume NFS persistant pour le répertoire de données FreshRSS. Maintenez activé — requis pour persister la configuration et l'état par utilisateur.
nfs_mount_path/var/www/FreshRSS/dataOù le volume NFS est monté à l'intérieur du conteneur.
create_cloud_storage / storage_bucketstrue / []FreshRSS ne déclare aucun bucket propre ; ajoutez ici si nécessaire.
gcs_volumes[]Montages de volumes GCS Fuse optionnels (nécessite gen2).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 12 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Version du moteur PostgreSQL. FreshRSS s'installe avec --db-type pgsql.
db_namefreshrssNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_userfreshrssUtilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager.
database_password_length32Longueur du mot de passe généré (16–64).

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probeTCP / 30s de délai, seuil 20Sonde de démarrage ; le seuil élevé permet le temps d'installation au premier démarrage.
liveness_probeHTTP /i/ 300s de délaiSonde de vivacité ; /status est un point de terminaison JSON non authentifié alternatif.
uptime_check_configdésactivé, chemin /Test de disponibilité Cloud Monitoring ; désactivé par défaut.
alert_policies[]Politiques d'alerte métrique.

Toutes les autres entrées suivent le comportement standard d'App_CloudRun.

Groupe 21 — Cache Redis​

VariableValeur par défautDescription
enable_redisfalseDésactivé par défaut ; FreshRSS ne requiert pas Redis.
redis_host / redis_port"" / 6379Point de terminaison Redis si activé.

Toutes les autres entrées suivent le comportement standard d'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.

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 / utilisateur de la base de données de l'application.
database_password_secretSecret Manager secret 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 (FreshRSS n'en déclare aucun).
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, tests de disponibilité.
initialization_jobsNoms des jobs de configuration (db-init).
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).

Validation héritée au moment de la planification. Ce module transmet sa configuration via le moteur de fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification — un environnement d'exécution gen1 avec des montages NFS, IAP sans identités autorisées, un redis_port/backup_retention_days hors de portée, un database_type qui ne correspond pas à une extension activée. Une configuration invalide fait échouer la planification 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ètreValeur judicieuseRisqueConséquence en cas d'erreur
enable_nfstrueCritiqueLe désactiver place le répertoire de données FreshRSS sur un disque éphémère — config.php, l'état par utilisateur et le cache sont effacés à chaque démarrage à froid/redéploiement, forçant une réinstallation.
nfs_mount_path/var/www/FreshRSS/dataCritiqueLe monter ailleurs rend le répertoire de données éphémère (même effet que pas de NFS).
db_name / db_userDéfinir une foisCritiqueImmuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et orpheline toutes les données de flux.
database_typePOSTGRES_15CritiqueFreshRSS s'installe avec --db-type pgsql ; un moteur non-Postgres casse l'installateur et db-init.
enable_backup_importfalse sauf restaurationCritiqueL'activation sans un backup_uri valide fait échouer le job d'importation.
container_port80ÉlevéFreshRSS/Apache écoute sur le port 80 ; un mauvais port fait échouer la sonde de démarrage et le service ne devient jamais prêt.
enable_cloudsql_volumetrueÉlevéLe socket Auth Proxy évite l'exigence SSL du TCP direct par IP privée vers Cloud SQL Postgres ; le désactiver peut rompre la connectivité.
min_instance_count1 (par défaut) pour une actualisation fiableÉlevéAvec 0 (mise à l'échelle à zéro), le cron d'actualisation des flux interne au conteneur se met en pause pendant l'inactivité ; les flux ne sont mis à jour que lorsqu'une requête réveille le service.
max_instance_count1ÉlevéL'exécution de plus d'une instance duplique le cron d'actualisation interne au conteneur et divise l'état de session/cache basé sur les fichiers.
enable_iapuniquement pour les déploiements privésÉlevéIAP bloque toutes les requêtes non authentifiées, y compris les clients mobiles utilisant l'API Google Reader / Fever.
FRESHRSS_ADMIN_PASSWORD (auto-généré)Modifier dans l'interface utilisateur après la première connexionMoyenLa rotation du secret seul ne réinitialise pas un compte déjà installé ; le premier mot de passe reste valide jusqu'à ce qu'il soit modifié dans l'application.
memory_limit2GiMoyenDes valeurs inférieures à 512 Mio risquent un OOM en cas d'actualisation intensive des flux.
application_versionÉpingler en productionMoyenlatest se résout en un tag épinglé au moment du build, mais l'épinglage explicite rend les mises à niveau délibérées.

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 à FreshRSS partagée avec la variante GKE est décrite dans FreshRSS_Common.

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