Aller au contenu principal

Linkwarden sur GKE Autopilot

Linkwarden sur GKE Autopilot

Linkwarden est un gestionnaire de signets open source auto-hébergé qui va au-delà de la simple sauvegarde de liens : chaque signet 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 interface graphique intégré, de sorte que vos liens continuent de fonctionner même après que la page source ait changé ou disparu. Ce module déploie Linkwarden sur GKE Autopilot en s'appuyant sur le socle App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

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 à 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 — veuillez vous référer au guide du socle App_GKE plutôt que de les répéter ici.


Coût de Linkwarden sur RAD et comparaison​

Le module GKE Autopilot de Linkwarden sur RAD coûte environ 129 $ 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). GKE convient à Linkwarden fonctionnant aux côtés d'autres charges de travail Kubernetes ; le module Cloud Run exécute le même Linkwarden pour environ 157 $ US par mois. 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 129 $ 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 129 $ US par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 131 crédits par jour, environ 3 930 par mois (environ 393 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster)
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

Pourquoi les deux colonnes diffèrent. Le chiffre géré par RAD inclut les frais de gestion du cluster GKE (environ 73 $ US par mois) et le socle partagé du projet. Dans votre propre projet, le niveau gratuit de Google couvre les frais de gestion d'un cluster par compte de facturation, ce que le chiffre du propre projet suppose. Il est estimé à partir des prix catalogue de Google, car il n'y a pas encore suffisamment d'historique GKE géré par RAD pour le mesurer, de sorte que la confirmation de déploiement ne le cite pas. Une deuxième application GKE dans le même projet géré par RAD partage le cluster et n'ajoute que ses propres pods.

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant des frais : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 $ US pour une recharge unique, et moins avec un forfait 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 de 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
Pod GKE Autopilot, 2x vCPU / 2 Gio72,16 $ 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
Frais de gestion du cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Totalenviron 129 $ US

Comparaison​

  • Linkwarden Cloud (3 $/utilisateur/mois, 2,25 $ annuellement, jusqu'à 30 000 liens/utilisateur — linkwarden.app/pricing) est moins cher en espèces pour la plupart des tailles d'équipe que l'auto-hébergement sur GKE ; l'intérêt de l'auto-hébergement est la souveraineté des données et l'absence de limite par lien, pas le prix.
  • Un GCE e2-standard-2 (2 vCPU/8 Go, environ 49 $/mois) est la comparaison auto-gérée de taille plus proche, moins le Postgres géré, les sauvegardes et l'autoscaling des pods inclus par RAD.
  • Ou consultez le guide Cloud Run pour l'option la moins chère.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand 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. La restauration ne peut donc 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. La facturation étant 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.
  • Une véritable lacune : 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​

GKE maintient au moins un pod en cours d'exécution, il ne se met donc jamais à 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 4,31 $ US par jour) et dans un projet géré par RAD (131 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 la 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'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 à 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 101 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 sous la forme d'un seul pod Next.js. 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 déploiement de worker séparé. Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod Next.js + Chrome sans interface graphique, 2 vCPU / 2 Gio par défaut, min_instance_count = 1
Base de donnéesCloud SQL pour PostgreSQL 15Requis — le schéma Prisma de Linkwarden est uniquement Postgres
Stockage d'objetsCloud Storage (volume GCS Fuse CSI)Monté par défaut à /data/data 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
IngressCloud Load BalancingLoadBalancer externe, domaine personnalisé facultatif + certificat géré, reserve_static_ip = true

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 interrompt la migration au premier démarrage.
  • DATABASE_URL se connecte via le bouclage du proxy cloud-sql. enable_cloudsql_volume = true est requis — il lance le sidecar proxy qui répond sur 127.0.0.1, que le point d'entrée cloud utilise avec sslmode=disable (le proxy termine déjà TLS). Cela diffère de la variante Cloud Run, qui se connecte via l'IP privée brute avec sslmode=require.
  • NEXTAUTH_URL est dérivé automatiquement, en ajoutant le suffixe /api/v1/auth requis à l'URL de service calculée.
  • reserve_static_ip = true par défaut. Le NEXTAUTH_URL de Linkwarden intègre l'URL du service au démarrage du conteneur, de sorte qu'une IP externe stable évite la course au repli DNS interne documentée pour d'autres applications à URL auto-référentes dans ce catalogue.
  • Un minimum de 1 réplica est maintenu (GKE ne prend pas en charge la mise à l'échelle à zéro) afin que le worker d'archivage en arrière-plan intégré au conteneur continue de traiter la file d'attente.
  • Chrome sans interface graphique s'exécute en processus avec le serveur web. Dimensionnez container_resources pour le pic de l'ensemble du conteneur (2 vCPU / 2 Gio par défaut ; 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 vers lequel le code de stockage de Linkwarden résout STORAGE_FOLDER. L'ensemble du conteneur de l'image s'exécute en tant que root, donc aucune substitution d'option de montage gcsfuse uid/gid n'est nécessaire (contrairement à certains autres modules GKE de ce catalogue).
  • Pas de super-utilisateur pré-initialisé. Le premier utilisateur à s'inscrire via le flux d'inscription NextAuth standard devient le propriétaire de l'instance.

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 rapportés dans les Sorties du déploiement.

A. GKE Autopilot — la charge de travail Linkwarden​

Les pods Linkwarden sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Linkwarden pour voir les pods, les révisions et les événements. Kubernetes Engine → Services et Ingress affiche l'IP externe.
  • CLI :
    kubectl get pods,svc -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour le fonctionnement d'Autopilot, de la mise à l'échelle et du cycle de vie des charges de travail.

B. Cloud SQL pour PostgreSQL 15​

Linkwarden stocke toutes les données d'application (signets, collections, tags, utilisateurs, métadonnées d'archive) dans une instance gérée de Cloud SQL pour PostgreSQL 15. Le sidecar cloud-sql-proxy (activé via enable_cloudsql_volume = true) écoute sur 127.0.0.1 ; le point d'entrée cloud connecte DATABASE_URL là avec sslmode=disable. 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_GKE 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 le pilote CSI GCS Fuse à /data/data par défaut — le chemin absolu vers lequel le code de stockage de Linkwarden résout STORAGE_FOLDER à l'exécution.

  • 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_GKE pour les options du pilote CSI GCS Fuse.

D. Secret Manager​

Un secret est généré automatiquement et stocké dans Secret Manager : NEXTAUTH_SECRET (signe les JWT de session NextAuth). Il est matérialisé dans l'espace de noms et injecté en tant que variable d'environnement de pod. Le mot de passe de la base de données est géré séparément par le socle.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"

Voir App_GKE pour les détails d'injection et de rotation.

E. Réseau et ingress​

Le service est exposé via un service Kubernetes LoadBalancer avec une IP statique réservée par défaut (reserve_static_ip = true). Un Ingress avec un domaine personnalisé et un certificat géré, Cloud CDN et Cloud Armor peuvent être superposés.

  • Console : Kubernetes Engine → Services et Ingress ; Services réseau → Équilibrage de charge.
  • CLI :
    kubectl get svc -n "$NAMESPACE" -o wide
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE.

F. Cloud Logging et Monitoring​

Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte facultatifs.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100 -f

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 le sidecar cloud-sql-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é.
  • 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.
  • 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.
  • 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.
  • 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 interface graphique pour la capture de captures d'écran/PDF/monolithes.
  • 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 pour le démarrage à froid de Next.js plus l'initialisation de Chrome/Playwright sans interface graphique.
  • Inspecter l'exécution du job :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<job-name>

4. Variables de configuration​

Les variables sont regroupées exactement comme 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_GKE 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 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.
application_display_nameLinkwardenNom lisible par l'homme affiché dans la console.
application_versionlatestLinkwarden publie une véritable balise latest en amont.

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

VariableValeur par défautDescription
deploy_applicationtrueDéfinir false pour provisionner uniquement l'infrastructure.
container_resources{ cpu_limit="2000m", memory_limit="2Gi" }L'archivage Chrome sans interface graphique s'exécute en processus ; augmenter la mémoire à 4Gi pour les charges de travail lourdes.
min_instance_count1GKE n'a pas de mise à l'échelle à zéro ; maintient le worker d'archivage en vie.
max_instance_count5Limite supérieure HPA.
container_port3000Linkwarden (Next.js) écoute sur le port 3000.
enable_cloudsql_volumetrueRequis — lance le sidecar cloud-sql-proxy auquel le point d'entrée se connecte.
enable_image_mirroringtrueMettre en miroir l'image Linkwarden dans Artifact Registry.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Variables d'environnement statiques. DATABASE_URL, NEXTAUTH_URL sont définies automatiquement — ne les définissez pas ici.
disable_browserfalseDéfinit DISABLE_BROWSER — ignore toutes les tâches d'archivage Chrome sans interface graphique.
archive_take_count5Liens traités par lot de worker en arrière-plan (ARCHIVE_TAKE_COUNT).

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerL'interface utilisateur web publique nécessite une exposition externe.
session_affinityClientIPRoutage persistant pour les cookies de session NextAuth.
namespace_name""Laisser vide pour générer automatiquement.

Groupe 13 — Système de fichiers (NFS)​

VariableValeur par défautDescription
enable_nfsfalseDésactivé par défaut — Linkwarden utilise un volume GCS à la place pour plus de simplicité.
nfs_mount_path/data/dataUtilisé uniquement lorsque enable_nfs = true.

Groupe 14 — Cloud Storage et Artifact Registry​

VariableValeur par défautDescription
gcs_volumes[] (revient à une valeur par défaut intégrée)Un volume « storage » par défaut monté à /data/data est automatiquement câblé, sauf si vous fournissez votre propre liste, qui le remplace entièrement.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15Fixe — le schéma Prisma de Linkwarden est uniquement Postgres.
application_database_namelinkwardenNom de la base de données PostgreSQL. Immuable après le premier déploiement.
application_database_userlinkwardenUtilisateur de la base de données de l'application.

Groupe 19 — Domaine personnalisé, IP statique et réseau​

VariableValeur par défautDescription
reserve_static_iptrueLe NEXTAUTH_URL de Linkwarden intègre l'URL du service au démarrage — une IP stable évite une course au repli DNS interne.
enable_custom_domaintrueProvisionner Ingress + certificat géré pour les noms d'hôtes personnalisés.

Groupe 15 — 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é 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 Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ip / service_external_ipIP interne au cluster / externe.
service_urlURL pour atteindre Linkwarden.
database_instance_nameNom de l'instance Cloud SQL.
database_name / database_userNom de la base de données / utilisateur de l'application.
database_password_secretSecret Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port.
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.
kubernetes_readyIndique si le cluster/la charge de travail est prêt.
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 du socle App_GKE, 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 en cas d'erreur
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.
application_database_name / application_database_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 interrompt complètement la migration Prisma au premier démarrage.
enable_cloudsql_volumetrue (requis)CritiqueLe désactiver supprime le sidecar cloud-sql-proxy dont dépend le point d'entrée — DATABASE_URL ne se connecte à rien.
min_instance_count1ÉlevéLa mise à l'échelle à 0 (non prise en charge par défaut sur GKE) arrêterait le worker d'archivage en arrière-plan.
container_resources.memory_limit2Gi minimumÉlevéL'archivage Chrome sans interface graphique manque de mémoire en dessous de ce seuil ; le serveur web peut toujours répondre tandis que l'archivage échoue silencieusement.
service_typeLoadBalancerÉlevéDéfinir ClusterIP sur une interface utilisateur de signets publique la rend inaccessible depuis un navigateur (un modèle de bug connu de copier-coller ailleurs dans ce catalogue).
reserve_static_iptrueMoyenfalse risque que le NEXTAUTH_URL intégré de Linkwarden se résolve en un DNS interne inaccessible si l'IP éphémère n'est pas connue au moment de l'application.
disable_browserfalse sauf si Chrome se comporte malMoyenLe laisser true désactive inutilement tout l'archivage de captures d'écran/PDF/monolithes.
gcs_volumesUtiliser la valeur par défaut intégréeMoyenFournir une liste personnalisée sans faire correspondre le chemin de montage /data/data rend le contenu archivé non inscriptible ou divisé entre les backends de stockage.

Pour le comportement du socle référencé tout au long — Workload Identity, ingress, autoscaling, 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 à Linkwarden partagée avec la variante Cloud Run 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.