FreshRSS sur GKE Autopilot
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 s'exécute derrière Apache et expose les API Google Reader et Fever pour les clients mobiles. Ce module déploie FreshRSS sur GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes.
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 Google Cloud Console et la ligne de commande. Pour les mécanismes communs à toutes les applications GKE — Workload Identity, ingress, autoscaling, 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_GKE 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 110,13 US$/mois en frais Google Cloud, en plus d'un coût de module RAD unique de 110 crédits (99 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 Cloud Run — voir le guide Cloud Run pour l'option à moindre coût ; ce guide couvre la variante GKE.
Ce que vous payez sur RAD
| Votre propre projet | Projet géré par RAD | |
|---|---|---|
| Frais de module | 110 crédits (une seule fois) | 99 crédits (une seule fois, 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 | Identique |
| Coût d'exécution Google Cloud | ~110,13 US$/mois, facturé à votre propre compte de facturation Google au prix catalogue | ~129 crédits/jour (~12,90 US$/jour), facturé à 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 : 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) |
|---|---|
| Pod GKE Autopilot, 1 vCPU / 2 Gio | 39,68 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$ |
| Frais de gestion de cluster GKE | partagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $ |
| Total | 110,13 US$ |
Comment cela se compare
- Il n'y a 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 le serait encore plus.
- 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. Le Cloud SQL géré, Secret Manager et la surveillance de 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 s'exécute 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 détruit 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 utilisé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. Étant donné que rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — il s'agit d'une vérification, et non d'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), de sorte qu'une restauration ne coûte normalement aucun crédit. Les frais de module de 99 crédits ne sont pas facturés à nouveau.
Ce qu'il faut : 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 niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude/démo). Google indique que la plupart des services sont à nouveau pleinement 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 la 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 façon : 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) : 110 crédits (11,00 US$) dans votre propre projet, ou 99 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 4 jours ou plus d'inactivité dans votre propre projet (par rapport à sa facture Google Cloud d'environ 110,13 US$/mois), ou environ 2 jours ou plus d'inactivité dans un projet géré par RAD (par rapport à ses ~129 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 alors que quelque chose d'autre partage le projet n'économise que la part de calcul propre à cette application du 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 celui-ci, alors copiez la dernière sauvegarde avant de la supprimer si vous souhaitez 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 d'une allocation 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 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 suspendue 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 comme une charge de travail web PHP/Apache. Le déploiement connecte un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Pods PHP/Apache sur le port 80, 1 vCPU / 2 Gio par défaut |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — le point d'entrée s'installe avec --db-type pgsql |
| Stockage persistant | NFS (Filestore / auto-géré) ou PVC de bloc | Répertoire de données à /var/www/FreshRSS/data ; contient la configuration, l'état par utilisateur, le cache des flux. Pas de bucket GCS |
| Cache | Redis (optionnel) | Désactivé par défaut ; FreshRSS ne le requiert pas |
| Secrets | Secret Manager | FRESHRSS_ADMIN_PASSWORD auto-généré ; mot de passe de la base de données |
| Ingress | Cloud Load Balancing | LoadBalancer externe, domaine personnalisé optionnel + certificat géré |
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 pgsqlet le jobdb-initest uniquement Postgres ; le schéma est créé par l'installateur de FreshRSS au premier démarrage. - Sur GKE, le proxy d'authentification Cloud SQL s'exécute en tant que sidecar
lié à
127.0.0.1:5432, de sorte que FreshRSS compose l'adresse de bouclage (DB_HOST = 127.0.0.1) — le point d'entrée traite le bouclage comme un hôte TCP en texte clair (le proxy termine TLS). - NFS est activé par défaut (
enable_nfs = true) et monté à/var/www/FreshRSS/data. FreshRSS y écrit sa configuration générée, l'état par utilisateur, les articles mis en cache et les favicons — sans volume persistant, cet état est perdu lors du redémarrage du pod. Un déploiement basé sur NFS utilise la stratégieRecreateafin que deux pods n'écrivent jamais le même volume pendant un déploiement. FRESHRSS_ADMIN_PASSWORDest généré automatiquement et stocké dans Secret Manager. Il amorce le compteadminpar défaut (et son mot de passe API) lors de la première installation.- L'affinité de session est
ClientIPpar défaut. Maintient les requêtes d'un client sur le même pod. - Un minimum de 1 réplica est maintenu (
min_instance_count = 1,max_instance_count = 1) ; GKE ne prend pas en charge la mise à l'échelle à zéro, donc le cron de rafraîchissement des flux dans le conteneur s'exécute toujours. - Une IP externe statique est réservée par défaut (
reserve_static_ip = true) et un Ingress de domaine personnalisé est provisionné par défaut (enable_custom_domain = true) — renseignezapplication_domainspour servir de vrais noms d'hôtes. - Le conteneur écoute sur le port 80 (Apache), pas 8080.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que vous avez exécuté
gcloud container clusters get-credentials <cluster> --region <region> --project <project>
et que PROJECT, REGION et NAMESPACE sont définis. L'espace de noms et les autres
identifiants sont signalés dans les Sorties du déploiement.
A. GKE Autopilot — la charge de travail FreshRSS
Les pods FreshRSS sont planifiés sur Autopilot, qui facture le CPU/la mémoire
réellement demandés par les pods. Étant donné que le répertoire de données est
basé sur NFS, le déploiement utilise la stratégie de mise à jour
Recreate plutôt qu'une mise à jour continue.
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail FreshRSS pour voir les pods et les événements. Kubernetes Engine → Services et Ingress affiche l'adresse IP externe.
- CLI :
kubectl get pods,svc -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
kubectl describe deploy -n "$NAMESPACE" <service-name>
Voir App_GKE pour savoir comment Autopilot, la mise à l'échelle et le type de charge de travail (Déploiement vs StatefulSet) sont gérés.
B. Cloud SQL pour PostgreSQL 15
FreshRSS stocke toutes les données de l'application (flux, abonnements, articles,
catégories, utilisateurs) dans une instance gérée de Cloud SQL pour PostgreSQL 15.
Les pods y accèdent en privé via le sidecar Cloud SQL Auth Proxy sur le
bouclage 127.0.0.1:5432 ; 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 sont tous affichés dans les Sorties. Pour le modèle de connexion, les sauvegardes et la rotation des mots de passe, voir App_GKE.
C. Stockage persistant (NFS / PVC)
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. Un PVC de bloc (StatefulSet) est un mode de persistance
alternatif via les variables du groupe 7 StatefulSet.
- Console : Filestore → Instances (NFS géré) ; Kubernetes Engine → Stockage (PVC).
- CLI :
gcloud filestore instances list --project "$PROJECT"
kubectl get pvc -n "$NAMESPACE"
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- ls /var/www/FreshRSS/data
Voir App_GKE pour le modèle de serveur NFS, les PVC de bloc et 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
amorce 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"
Le nom du secret du mot de passe de la base de données se trouve dans les Sorties. Voir App_GKE pour l'intégration et la rotation de Secret Store CSI.
F. Réseau et ingress
Par défaut, la charge de travail est exposée via une IP externe Cloud Load
Balancing avec une IP statique réservée, et un Ingress de domaine personnalisé
est provisionné. Ajoutez des noms d'hôtes via application_domains pour un certificat
géré par Google.
- Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
- CLI :
kubectl get ingress,svc -n "$NAMESPACE"
gcloud compute addresses list --project "$PROJECT"
Voir App_GKE pour les domaines personnalisés, Cloud CDN et les détails de l'IP statique.
G. Cloud Logging et Monitoring
Les flux stdout/stderr des pods vers Cloud Logging ; les métriques GKE et Cloud SQL vers Cloud Monitoring. Des vérifications de disponibilité et des politiques d'alerte optionnelles sont disponibles.
- Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud logging read 'resource.type="k8s_container" AND resource.labels.namespace_name="'"$NAMESPACE"'"' \
--project "$PROJECT" --limit 50
3. Comportement de l'application FreshRSS
- Configuration de la base de données au premier déploiement. Le Job
db-inits'exécute en utilisantpostgres: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.shdu conteneur résout l'hôte de la base de données (bouclage du proxy127.0.0.1sur GKE), puis exécute le proprecli/do-install.phpde FreshRSS (créedata/config.phpet le schéma) etcli/create-user.php(crée le compteadminà partir deFRESHRSS_ADMIN_PASSWORD), puis enchaîne le point d'entrée en amont. L'installation est idempotente — ignorée une fois quedata/config.phpexiste sur le volume persistant. - Cron de rafraîchissement des flux. L'image en amont démarre un cron
dans le conteneur (
CRON_MIN = */15) qui actualise les flux abonnés toutes les 15 minutes. Étant donné que GKE maintient au moins un réplica en cours d'exécution, le cron se déclenche toujours. - Identifiant administrateur. La connexion par défaut est
adminavec leFRESHRSS_ADMIN_PASSWORDgénéré ; la même valeur est définie comme mot de passe API utilisé par les clients mobiles Google Reader / Fever API. Modifiez-le dans l'interface utilisateur de FreshRSS après la première connexion — la rotation de la valeur Secret Manager seule ne réinitialisera pas un compte déjà installé. - Stratégie de déploiement. Avec NFS activé, le déploiement utilise
Recreate(pasRollingUpdate) afin que deux pods n'écrivent jamais simultanément le répertoire de données partagé — une mise à jour continue sur cette application avec état entraînerait un blocage sur les verrous de fichier/base de données. - Chemin de santé. La sonde de démarrage est une vérification TCP sur le
port 80 ; la sonde de vivacité est un GET HTTP sur
/i/, qui renvoie un200littéral 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/statusnon authentifié adapté aux vérifications de disponibilité. Accordez une fenêtre généreuse au premier démarrage pendant que l'installateur crée le schéma. - Définissez l'URL externe une fois l'IP connue. Confirmez l'IP du
LoadBalancer / l'hôte Ingress et définissez
BASE_URL(viaenvironment_variables) ouapplication_domainsafin que les liens auto-référencés de FreshRSS se résolvent correctement :kubectl get svc,ingress -n "$NAMESPACE"
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_GKE avec leur comportement standard et leurs valeurs par défaut.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | freshrss | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag 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_GKE.
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définissez false pour provisionner uniquement l'infrastructure. |
container_image_source | custom | FreshRSS livre un build personnalisé léger ; utilisez prebuilt uniquement avec un container_image externe. |
cpu_limit | 1000m | CPU par pod (1 vCPU). |
memory_limit | 2Gi | Mémoire par pod ; maintenez ≥ 512 Mio. |
min_instance_count | 1 | Réplicas minimum ; GKE requiert ≥ 1. Maintient FreshRSS et son cron de rafraîchissement en cours d'exécution. |
max_instance_count | 1 | Maintenez à 1 — un seul pod possède le cron de rafraîchissement et l'état basé sur les fichiers. |
container_port | 80 | FreshRSS/Apache écoute sur le port 80. |
enable_cloudsql_volume | true | Sidecar Cloud SQL Auth Proxy pour les connexions Postgres. |
timeout_seconds | 300 | Durée maximale de la requête (0–3600 secondes). |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 6 — Backend et cluster GKE
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | Comment le service Kubernetes est exposé. |
workload_type | null | Se résout en Deployment ; basé sur NFS, il utilise donc la stratégie Recreate. Définissez StatefulSet uniquement avec un PVC de bloc. |
session_affinity | ClientIP | Routage persistant pour qu'un client reste sur un seul pod. |
network_tags | ["nfsserver"] | nfsserver est requis lorsque enable_nfs = true. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 7 — StatefulSet
| Variable | Valeur par défaut | Description |
|---|---|---|
stateful_pvc_enabled | null | Active un PVC de bloc par pod comme alternative à NFS pour le répertoire de données. |
stateful_pvc_size | 10Gi | Taille de stockage du PVC par pod. |
stateful_pvc_mount_path | /var/www/FreshRSS/data | Chemin de montage du conteneur pour le PVC ; doit correspondre au chemin de montage NFS afin que le répertoire de données persiste de toute façon. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 10 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | TCP / 30s de délai, seuil 20 | Sonde de démarrage ; le seuil élevé permet le temps d'installation au premier démarrage. |
liveness_probe | HTTP /i/ 300s de délai | Sonde de vivacité ; /status est un point de terminaison JSON non authentifié alternatif. |
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 optionnelles. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | Monte un volume NFS persistant pour le répertoire de données FreshRSS. Gardez activé — requis pour persister la configuration et l'état par utilisateur. |
nfs_mount_path | /var/www/FreshRSS/data | Où le volume NFS est monté à l'intérieur du conteneur. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Version du moteur PostgreSQL. FreshRSS s'installe avec --db-type pgsql. |
application_database_name | freshrss | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
application_database_user | freshrss | Utilisateur de la base de données de l'application. Immuable après le premier déploiement. |
database_password_length | 32 | Longueur du mot de passe généré (16–64). |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Provisionne Ingress pour les noms d'hôtes personnalisés + certificat géré. |
application_domains | [] | Noms d'hôtes à servir ; définissez pour obtenir un certificat géré. |
reserve_static_ip | true | IP externe stable entre les redéploiements. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
Groupe 15 — Cache Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Désactivé par défaut ; FreshRSS ne requiert pas Redis. |
redis_host / redis_port | "" / 6379 | Point de terminaison Redis si activé. |
Toutes les autres entrées suivent le comportement standard d'App_GKE.
5. Sorties
Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
stage_service_cluster_ips | Carte des ClusterIPs pour les services spécifiques à l'étape. |
service_external_ip | IP externe du LoadBalancer (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre FreshRSS. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name | Nom de la base de données de l'application. |
database_user | Utilisateur de la base de données de l'application. |
database_password_secret | Secret Manager secret contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port. |
storage_buckets | Buckets Cloud Storage créés (FreshRSS n'en déclare aucun). |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
initialization_jobs / db_import_job | Noms des jobs de configuration (db-init) et d'importation (optionnel). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants du projet. |
cicd_enabled / cicd_configuration | État et détails CI/CD (dépôt, déclencheur, registre). |
github_repository_url / github_repository_owner / github_repository_name | Détails GitHub CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | État VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation 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 au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — une charge de travail
Deploymentavecstateful_pvc_enabled = true, IAP sans identités autorisées, des valeurs de quota de mémoire sans suffixes d'unité binaire, unredis_port/backup_retention_dayshors plage. Une configuration invalide fait échouer le plan 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'au moment de l'application ou de l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence en cas d'erreur |
|---|---|---|---|
enable_nfs (ou un PVC de bloc) | true | Critique | Sans volume persistant, le répertoire de données FreshRSS est éphémère — config.php, l'état par utilisateur et le cache sont effacés au redémarrage du pod, forçant une réinstallation. |
nfs_mount_path | /var/www/FreshRSS/data | Critique | Le montage ailleurs rend le répertoire de données éphémère (même effet que pas de NFS). |
application_database_name / application_database_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 orpheline toutes les données de flux. |
database_type | POSTGRES_15 | Critique | FreshRSS s'installe avec --db-type pgsql ; un moteur non-Postgres casse l'installateur et db-init. |
container_port | 80 | Élevé | FreshRSS/Apache écoute sur le port 80 ; un mauvais port fait échouer la sonde de démarrage et les pods ne deviennent jamais prêts. |
enable_cloudsql_volume | true | Élevé | Le sidecar Auth Proxy est requis pour la connectivité PostgreSQL sur le bouclage 127.0.0.1. |
max_instance_count | 1 | Élevé | L'exécution de plus d'un pod duplique le cron de rafraîchissement dans le conteneur et divise l'état de session/cache basé sur les fichiers ; une mise à jour continue sur le répertoire NFS partagé se bloque. |
session_affinity | ClientIP | Élevé | Sans persistance, les requêtes d'un client se dispersent sur les pods, perturbant les sessions connectées. |
min_instance_count | 1 | Élevé | GKE requiert min ≥ 1 ; la garde de validation rejette les valeurs invalides. Maintenir 1 maintient FreshRSS et son cron de rafraîchissement en cours d'exécution. |
quota_memory_requests / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers bruts sont des octets et bloquent toute planification de pod dans l'espace de noms. |
enable_iap | uniquement 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 connexion | Moyen | La 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. |
application_domains | Définir avec enable_custom_domain | Moyen | enable_custom_domain = true sans noms d'hôtes provisionne un Ingress qui ne sert aucun certificat géré. |
memory_limit | 2Gi | Moyen | Les valeurs inférieures à 512 Mio risquent un OOM en cas de rafraîchissement intensif des flux. |
Pour le comportement de la fondation référencé tout au long — IAM et Workload Identity, autoscaling, ingress et certificats, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_GKE. La configuration d'application spécifique à FreshRSS partagée avec la variante Cloud Run est décrite dans FreshRSS_Common.
Guides associés
- Lab pratique : FreshRSS sur GKE Autopilot — déployez-le étape par étape, avec les écrans de console et les commandes à chaque étape.
- FreshRSS sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- FreshRSS Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.