Aller au contenu principal

Linkwarden sur Google Cloud Run

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édezDans un projet géré par RAD pour vous
Frais de module, une fois par déploiement110 crédits (11,00 US$ au prix de la recharge)99,0 crédits (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 : ils sont toujours facturés à la minute pour le temps de buildIdem
Coût d'exécution Google CloudFacturé 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 quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD 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 SSD51,02 US$
Cloud NAT et réseau5,00 US$
Cloud Storage (modules complémentaires, sauvegardes)1,00 US$
Totalenviron 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 CloudNotes
CalculCloud Run v2Conteneur 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éesCloud SQL pour PostgreSQL 15Requis — le schéma Prisma de Linkwarden est uniquement Postgres
Stockage d'objetsCloud Storage (volume GCS Fuse)Monté à /data/data par défaut pour les captures d'écran/PDF/monolithes archivés
Cache et file d'attenteAucunLe worker d'archivage interroge directement PostgreSQL ; aucune dépendance Redis/BullMQ
SecretsSecret ManagerNEXTAUTH_SECRET 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 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_URL se 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ée DB_IP (la vraie) avec sslmode=require.
  • NEXTAUTH_URL est dérivé automatiquement, en ajoutant le suffixe /api/v1/auth requis à 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 = 1 et cpu_always_allocated = true par 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_limit pour 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 en STORAGE_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 = false par 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_BROWSER est 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éfinissez disable_browser = true pour 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.sh en utilisant postgres: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 CMD exécute prisma migrate deploy avant 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_SECRET est 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é via concurrently aux 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éfaut 5). 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é​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.
tenant_iddemoCourt suffixe qui rend les noms de ressources uniques par environnement.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_namelinkwardenNom de base des ressources. Ne pas modifier après le premier déploiement.
display_nameLinkwardenNom lisible par l'homme affiché dans la console.
application_versionlatestLinkwarden 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​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner uniquement l'infrastructure.
cpu_limit2000m2 vCPU — l'archivage Chrome sans tête s'exécute en processus avec le serveur web.
memory_limit2GiMinimum pour Chromium sans tête intégré ; augmentez à 4Gi pour les charges de travail PDF/capture d'écran lourdes.
cpu_always_allocatedtrueMaintient le worker d'archivage en arrière-plan en traitement entre les requêtes.
min_instance_count1Maintient le worker d'archivage en vie ; la mise à l'échelle à zéro arrêterait l'archivage en arrière-plan.
max_instance_count5Limite supérieure de l'autoscaling.
container_port3000Linkwarden (Next.js) écoute sur le port 3000.
execution_environmentgen2Requis pour les montages GCS Fuse.
enable_cloudsql_volumetrueConservé pour la parité ; le point d'entrée se connecte directement via DB_IP, pas le socket.
enable_image_mirroringtrueMettre 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​

VariableValeur par défautDescription
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_browserfalseDé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_count5Liens 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​

VariableValeur par défautDescription
enable_nfsfalseDé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​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — le schéma Prisma de Linkwarden est uniquement Postgres.
db_namelinkwardenNom de la base de données PostgreSQL. Immuable après le premier déploiement.
db_userlinkwardenUtilisateur 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​

VariableValeur par défautDescription
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é​

VariableValeur par défautDescription
startup_probe / liveness_probeHTTP /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​

VariableValeur par défautDescription
enable_redisfalseNon 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.

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.
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.
container_image / container_registryImage déployée et dépôt Artifact Registry.
initialization_jobsNoms des jobs de configuration.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants 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ètreValeur judicieuseRisqueConséquence si erroné
NEXTAUTH_SECRET (auto-généré)Ne jamais faire pivoter après le premier démarrageCritiqueSa rotation invalide toutes les sessions actives, forçant tous les utilisateurs à se reconnecter.
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 détruit toutes les données.
database_typePOSTGRES_15 (fixe)CritiqueTout autre moteur rompt entièrement la migration Prisma au premier démarrage.
min_instance_count1É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_limit2Gi 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_volumesLaissez enable_nfs=false, utilisez le volume GCS par défautMoyenL'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_browserfalse sauf si Chrome échoue sur le sandbox de Cloud RunMoyenLe laisser à true désactive inutilement tout l'archivage de captures d'écran/PDF/monolithes — Linkwarden devient une simple liste de liens.
archive_take_count5 (par défaut)FaibleLes grandes valeurs augmentent fortement le CPU/la mémoire pendant chaque lot (instances Chrome sans tête concurrentes).
ingress_settingsall pour une utilisation normaleMoyenLa 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.

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