Linkwarden sur Google Cloud Run
Linkwarden est un gestionnaire de favoris open source auto-hébergé qui va au-delà de la simple sauvegarde de liens : chaque favori peut être automatiquement archivé sous forme de capture d'écran pleine page, de PDF et d'instantané "monolithe" en un seul fichier à l'aide d'un Chrome sans tête intégré, afin que vos liens continuent de fonctionner même après que la page source ait changé ou disparu. Ce module déploie Linkwarden 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 Linkwarden 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 Linkwarden sur RAD, et comment cela se compare
Linkwarden sur le module Cloud Run de RAD coûte environ 157 US$ par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 110 crédits (11,00 US$). Linkwarden lui-même est gratuit et open source (AGPL), il s'agit donc du coût d'infrastructure pour exécuter votre propre archive, sans frais par utilisateur et sans limite de liens. Si vous n'en avez besoin qu'occasionnellement, un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 157 US$ deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 110 crédits (11,00 US$ au prix de la recharge) | 99,0 crédits (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 | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 157 US$ par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 102 crédits par jour, soit environ 3 060 par mois (environ 306 US$ au prix de la recharge) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve |
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).
10 crédits coûtent 1 US$ pour une recharge unique, et moins avec un abonnement mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (par défaut du module) | Par mois |
|---|---|
| Cloud Run, 2x vCPU / 2 Gio (alwaysOn) | 99,90 US$ |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51,02 US$ |
| Cloud NAT et réseau | 5,00 US$ |
| Cloud Storage (modules complémentaires, sauvegardes) | 1,00 US$ |
| Total | environ 157 US$ |
Comment cela se compare
- Le projet de Linkwarden vend Linkwarden Cloud hébergé sur linkwarden.app/pricing : un plan unique à 3 $/utilisateur/mois (2,25 $/utilisateur/mois facturé annuellement), jusqu'à 30 000 liens par utilisateur, avec un essai gratuit de 14 jours.
- Pour une petite équipe, Linkwarden Cloud est clairement moins cher en espèces que les 157 US$ de RAD — cinq utilisateurs coûtent environ 15 $/mois mensuellement ou 11,25 $/mois annuellement. L'auto-hébergement sur RAD rentabilise son coût une fois qu'une équipe est suffisamment grande, ou valorise le fait de garder l'archive (et le rendu d'instantanés headless-Chrome) entièrement dans son propre projet plutôt que celui d'un tiers, ou ne veut pas de limite par lien.
- Un VPS nu (Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go, environ 24 US$/mois) est encore moins cher en espèces, avec le compromis habituel de devoir gérer vous-même Postgres, l'archiveur headless-Chrome, les sauvegardes et les correctifs.
- Voir le guide GKE si vous préférez l'exécuter aux côtés d'autres charges de travail Kubernetes.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Linkwarden s'exécute dans un projet géré par RAD pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à Linkwarden dont vous n'avez besoin qu'occasionnellement — un projet de cours, une démo, une évaluation de courte durée — que de le faire fonctionner en continu.
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 fiable 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.
- Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne supprime pas Cloud SQL ou le calcul propre à Linkwarden un par un — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
- La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à 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 les frais de module à nouveau. 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.
- Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : 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 et de démonstration). Google indique que la plupart des services sont de nouveau pleinement fonctionnels dans les 36 heures suivant une restauration.
- Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes nocturnes de Linkwarden sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, 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é Linkwarden et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer, comme pour le flux de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.
Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
La configuration par défaut de ce module maintient Cloud Run en fonctionnement continu (CPU toujours alloué), il ne se met donc pas à l'échelle à zéro de lui-même. L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la façon d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 110 crédits (11,00 US$), car RAD recrée le projet et les services partagés avant Linkwarden. La suppression ne permet d'économiser de l'argent que si Linkwarden devait rester inutilisé pendant environ trois jours ou plus, à la fois dans votre propre projet (environ 5,23 US$ par jour) et dans un projet géré par RAD (102 crédits par jour).
- Supprimez tout ce que Linkwarden utilise. La majeure partie du coût d'exécution est généralement la base de données. Elle ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de Linkwarden alors que quelque chose d'autre partage le projet n'économise que la partie calcul propre à Linkwarden.
- Conservez d'abord vos 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 Linkwarden pour une classe. Chaque participant dispose de Linkwarden dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite 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 à l'avance, 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 sociétés de conseil. Un partenaire exécute Linkwarden 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 de l'engagement, 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 Google Cloud de l'API Cloud Billing Catalog ; frais RAD et estimation quotidienne de 72 crédits de radmodules.dev/pricing ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'il dit sur les objets Cloud Storage sans suppression logicielle. Tarification Linkwarden Cloud. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
Linkwarden s'exécute comme un conteneur Node.js/Next.js unique sur Cloud Run v2. Le serveur web et un worker d'archivage en arrière-plan s'exécutent côte à côte dans le MÊME conteneur (via concurrently) — il n'y a pas de service worker séparé. Le déploiement relie un ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur Next.js + Chrome sans tête, 2 vCPU / 2 Gio par défaut, min_instance_count = 1 (le worker en arrière-plan doit continuer à fonctionner) |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — le schéma Prisma de Linkwarden est uniquement Postgres |
| Stockage d'objets | Cloud Storage (volume GCS Fuse) | Monté à /data/data par défaut pour les captures d'écran/PDF/monolithes archivés |
| Cache et file d'attente | Aucun | Le worker d'archivage interroge directement PostgreSQL ; aucune dépendance Redis/BullMQ |
| Secrets | Secret Manager | NEXTAUTH_SECRET auto-généré ; mot de passe de la base de données |
| Ingress | URL Cloud Run / Cloud Load Balancing | URL run.app par défaut ; équilibreur de charge HTTPS externe facultatif + domaine personnalisé |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est obligatoire. Le schéma Prisma de Linkwarden code en dur le fournisseur
postgresql; la sélection de tout autre moteur rompt la migration au premier démarrage. DATABASE_URLse connecte via l'IP privée, pas le socket. Un chemin de répertoire de socket Unix Cloud SQL contient des deux-points qui rompent l'analyse DSN d'autorité d'URL de Prisma, de sorte que le point d'entrée cloud utilise toujours l'IP privée Cloud SQL injectéeDB_IP(la vraie) avecsslmode=require.NEXTAUTH_URLest dérivé automatiquement, en ajoutant le suffixe/api/v1/authrequis à l'URL de service Cloud Run calculée — ne le définissez jamais manuellement avec un modèle littéral$(VAR)(Cloud Run le transmet tel quel).min_instance_count = 1etcpu_always_allocated = truepar défaut. Le worker d'archivage en arrière-plan dans le conteneur doit continuer à traiter la file d'attente entre les requêtes ; la mise à l'échelle à zéro arrêterait l'archivage.- Chrome sans tête s'exécute en processus avec le serveur web. Contrairement à Crawl4AI (un service supervisord séparé), l'archivage de captures d'écran/PDF/monolithes de Linkwarden partage le même conteneur/processus que le serveur Next.js — dimensionnez
memory_limit/cpu_limitpour le pic de l'ensemble du conteneur, pas seulement le serveur web. Par défaut : 2 vCPU / 2 Gio ; augmentez la mémoire à 4 Gio pour les charges d'archivage lourdes. - Un volume GCS est monté automatiquement à
/data/data. C'est le chemin absolu que le code de stockage de Linkwarden résout enSTORAGE_FOLDER(vérifié par rapport à l'image construite), de sorte que le contenu archivé persiste après les redémarrages sans nécessiter de NFS (enable_nfs = falsepar défaut). - Pas de superutilisateur pré-initialisé. Le premier utilisateur à s'inscrire via le flux d'inscription NextAuth standard devient le propriétaire de l'instance.
DISABLE_BROWSERest un repli documenté, pas une valeur par défaut. Si le sandbox gVisor de Cloud Run a du mal à lancer le Chrome sans tête intégré (une classe de risque similaire à l'incompatibilité documentée Prowlarr s6-overlay/gVisor ailleurs dans ce catalogue), définissezdisable_browser = truepour ignorer toutes les tâches d'archivage dépendantes du navigateur tout en conservant les fonctionnalités de métadonnées/balises/collections de liens. Vérifiez en direct avant de supposer que cela est nécessaire.
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 Linkwarden
Linkwarden s'exécute comme un service Cloud Run v2 qui s'adapte automatiquement en fonction de la charge des requêtes entre les nombres d'instances minimum et maximum. 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
Linkwarden stocke toutes les données de l'application (favoris, collections, tags, utilisateurs, métadonnées d'archive) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le point d'entrée cloud se connecte directement via l'IP privée de Cloud SQL (DB_IP), et non via le socket Unix du proxy d'authentification — une exigence spécifique à Prisma, car un chemin de répertoire de socket rompt l'analyse DSN de l'autorité d'URL. Lors du premier déploiement, un job d'initialisation crée la base de données et l'utilisateur de l'application ; Linkwarden exécute ensuite son propre prisma migrate deploy à chaque démarrage de conteneur.
- 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. Cloud Storage (contenu archivé)
Un bucket Cloud Storage dédié est provisionné automatiquement et monté via GCS Fuse à /data/data par défaut — le chemin absolu que le code de stockage de Linkwarden résout en STORAGE_FOLDER à l'exécution. Les processus web et worker résolvent tous deux ce même chemin malgré qu'ils s'exécutent à partir de répertoires de travail différents à l'intérieur du conteneur.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT"
gcloud storage ls gs://<data-bucket>/ # bucket name is in the Outputs
Voir App_CloudRun pour les options GCS Fuse et CMEK.
D. Secret Manager
Un secret est généré automatiquement et stocké dans Secret Manager : NEXTAUTH_SECRET (signe les JWT de session NextAuth). 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"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_CloudRun pour les détails d'injection et de rotation.
E. Réseau et ingress
Le service est accessible à son URL run.app par défaut. 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.
F. 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 tests de disponibilité et des stratégies d'alerte facultatifs.
- 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 Linkwarden
- Configuration de la base de données au premier déploiement. Un job d'initialisation exécute
db-init.shen utilisantpostgres:15-alpine. Il se connecte via l'IP privée de Cloud SQL 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é. - Les migrations de schéma s'exécutent à chaque démarrage. L'image de base de Linkwarden
CMDexécuteprisma migrate deployavant de démarrer les processus web et worker, de sorte que la mise à niveau de la version de l'application applique automatiquement les modifications de schéma — il n'y a pas de job de migration séparé. NEXTAUTH_SECRETest immuable après le premier démarrage. Généré une fois et écrit dans Secret Manager. Sa rotation invalide toutes les sessions actives, forçant tous les utilisateurs à se reconnecter.- Pas de compte administrateur pré-initialisé. Le premier utilisateur à s'inscrire via le flux d'inscription NextAuth standard devient le propriétaire de l'instance — il n'y a pas de credential par défaut à récupérer.
- Worker d'archivage en arrière-plan. Un processus séparé (
worker.ts, exécuté viaconcurrentlyaux côtés du serveur web dans le même conteneur) interroge directement PostgreSQL et traite les liens en file d'attente par lots (ARCHIVE_TAKE_COUNT, par défaut5). Chaque lot lance des instances Chrome sans tête pour la capture de captures d'écran/PDF/monolithes — le CPU/la mémoire augmentent brièvement pendant chaque lot. - Chemin de santé. Les sondes de démarrage et de vivacité par défaut sont
/— Linkwarden n'a pas de point de terminaison de santé dédié confirmé. La sonde de démarrage permet une fenêtre généreuse (délai initial de 60 s, seuil de 30 échecs) pour absorber le démarrage à froid de Next.js plus l'initialisation de Chrome sans tête/Playwright. - 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 Linkwarden sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.
Groupe 1 / 2 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
tenant_id | demo | Court suffixe qui rend les noms de ressources uniques par environnement. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | linkwarden | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
display_name | Linkwarden | Nom lisible par l'homme affiché dans la console. |
application_version | latest | Linkwarden publie une véritable balise latest en amont — cela épingle/suit la vraie version amont, contrairement à d'autres modules de build personnalisés. |
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. |
cpu_limit | 2000m | 2 vCPU — l'archivage Chrome sans tête s'exécute en processus avec le serveur web. |
memory_limit | 2Gi | Minimum pour Chromium sans tête intégré ; augmentez à 4Gi pour les charges de travail PDF/capture d'écran lourdes. |
cpu_always_allocated | true | Maintient le worker d'archivage en arrière-plan en traitement entre les requêtes. |
min_instance_count | 1 | Maintient le worker d'archivage en vie ; la mise à l'échelle à zéro arrêterait l'archivage en arrière-plan. |
max_instance_count | 5 | Limite supérieure de l'autoscaling. |
container_port | 3000 | Linkwarden (Next.js) écoute sur le port 3000. |
execution_environment | gen2 | Requis pour les montages GCS Fuse. |
enable_cloudsql_volume | true | Conservé pour la parité ; le point d'entrée se connecte directement via DB_IP, pas le socket. |
enable_image_mirroring | true | Mettre en miroir l'image Linkwarden dans Artifact Registry. |
Groupe 5 — Accès et contrôle d'ingress
Standard ingress_settings, vpc_egress_setting, enable_iap — voir
App_CloudRun.
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres supplémentaires non secrets. DATABASE_URL, NEXTAUTH_URL, PORT et HOSTNAME sont définis automatiquement — ne les définissez pas ici. |
disable_browser | false | Définit DISABLE_BROWSER — ignore toutes les tâches d'archivage Chrome sans tête. Solution de repli si le sandbox de Cloud Run se comporte mal avec Chrome. |
archive_take_count | 5 | Liens traités par lot de worker en arrière-plan (ARCHIVE_TAKE_COUNT). |
secret_environment_variables | {} | Mappage de variable d'environnement → nom de secret Secret Manager. |
Groupe 11 — Stockage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Désactivé par défaut — Linkwarden utilise un volume GCS à la place pour plus de simplicité. |
gcs_volumes | [] (revient à une valeur par défaut intégrée) | Un volume "storage" par défaut monté à /data/data est câblé automatiquement, sauf si vous fournissez votre propre liste, qui le remplace entièrement. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Fixe — le schéma Prisma de Linkwarden est uniquement Postgres. |
db_name | linkwarden | Nom de la base de données PostgreSQL. Immuable après le premier déploiement. |
db_user | linkwarden | Utilisateur de la base de données de l'application. Mot de passe auto-généré dans Secret Manager. |
Groupe 13 — Jobs et tâches planifiées
| Variable | Valeur par défaut | Description |
|---|---|---|
initialization_jobs | [] | Laissez vide pour utiliser le job db-init intégré. Linkwarden exécute ses propres migrations Prisma au démarrage — aucun job de migration séparé n'est nécessaire. |
cron_jobs | [] | Non utilisé par défaut. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe / liveness_probe | HTTP / | Linkwarden n'a pas de point de terminaison de santé dédié confirmé ; fenêtre de temps généreuse pour le démarrage à froid + l'initialisation de Chrome. |
uptime_check_config | { enabled=false, path="/" } | Test de disponibilité Cloud Monitoring ; désactivé par défaut. |
Groupe 21 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Non utilisé par Linkwarden — son worker d'archivage interroge directement PostgreSQL. Conservé pour la parité des variables de la Fondation. |
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.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
service_url | URL run.app par défaut du service. |
service_location | Région dans laquelle le service s'exécute. |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / 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 / port de la base de données. |
storage_buckets | Buckets Cloud Storage créés. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
initialization_jobs | Noms des jobs de configuration. |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
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 la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment de la planification. La plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si erroné |
|---|---|---|---|
NEXTAUTH_SECRET (auto-généré) | Ne jamais faire pivoter après le premier démarrage | Critique | Sa rotation invalide toutes les sessions actives, forçant tous les utilisateurs à se reconnecter. |
db_name / db_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 détruit toutes les données. |
database_type | POSTGRES_15 (fixe) | Critique | Tout autre moteur rompt entièrement la migration Prisma au premier démarrage. |
min_instance_count | 1 | Élevé | La mise à l'échelle à zéro arrête le worker d'archivage en arrière-plan entre les requêtes — les liens en file d'attente ne sont jamais archivés. |
memory_limit | 2Gi minimum | Élevé | L'archivage Chrome sans tête manque de mémoire en dessous de ce seuil ; le serveur web peut toujours répondre tandis que l'archivage échoue silencieusement. |
enable_nfs + gcs_volumes | Laissez enable_nfs=false, utilisez le volume GCS par défaut | Moyen | L'activation de NFS sans désactiver également le câblage du volume GCS par défaut peut laisser le contenu archivé réparti sur deux backends de stockage. |
disable_browser | false sauf si Chrome échoue sur le sandbox de Cloud Run | Moyen | Le laisser à true désactive inutilement tout l'archivage de captures d'écran/PDF/monolithes — Linkwarden devient une simple liste de liens. |
archive_take_count | 5 (par défaut) | Faible | Les grandes valeurs augmentent fortement le CPU/la mémoire pendant chaque lot (instances Chrome sans tête concurrentes). |
ingress_settings | all pour une utilisation normale | Moyen | La restriction à internal bloque le flux de connexion/inscription public nécessaire pour le compte propriétaire de première exécution. |
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 à Linkwarden partagée avec la variante GKE est décrite dans Linkwarden_Common.
Guides associés
- Lab pratique : Linkwarden sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Linkwarden sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- Linkwarden Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Memos sur Google Cloud Run, Trilium sur Google Cloud Run, Wallabag sur Google Cloud Run, FreshRSS sur Google Cloud Run dans la solution Connaissances personnelles et lecture.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.