Aller au contenu principal

Outline sur GKE Autopilot

Outline sur GKE Autopilot

Outline est une base de connaissances et un wiki d'équipe open source de style Notion : documents Markdown collaboratifs en temps réel, recherche en texte intégral puissante et collections de documents imbriquées, authentifiés exclusivement via un fournisseur d'identité externe (OIDC, Google, Slack, etc.) plutôt que par son propre magasin de noms d'utilisateur/mots de passe. Ce module déploie Outline sur GKE Autopilot sur la base de la fondation App_GKE, qui provisionne et gère l'infrastructure partagée de Google Cloud et Kubernetes.

Ce guide se concentre sur les services cloud qu'Outline utilise et sur la façon 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 — reportez-vous au guide de la fondation App_GKE plutôt que de les répéter ici.


Ce que coûte Outline sur RAD, et comment cela se compare​

Pour une équipe de dix personnes, le module GKE Autopilot d'Outline sur RAD coûte environ 110 $ US par mois sans licence par utilisateur. GKE convient à un Outline qui doit rester opérationnel, s'adapter à plusieurs pods ou fonctionner aux côtés d'autres charges de travail Kubernetes. Pour le coût le plus bas, le module Cloud Run exécute le même Outline pour environ 82 $ US par mois. Les chiffres sont valables au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Si vous n'en avez besoin qu'occasionnellement — pour préparer une certification, une démo, une activité saisonnière — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que ces 110 $ US deviennent quelques dollars par mois. Voir Mettre 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éploiement175 crédits (17,50 $ US au prix de la recharge)157,5 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 font 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 (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 125 crédits par jour, soit environ 3 750 par mois (environ 375 $ 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

10 crédits coûtent 1 $ US pour une recharge ponctuelle, et moins avec un plan 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, donc 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 (valeur par défaut du module)Par mois
Pod GKE Autopilot, 1 vCPU / 2 Gio39,68 $ US
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD51,02 $ US
Serveur de fichiers NFS/cache (petite VM)13,43 $ US
Cloud NAT et réseau5 $ US
Cloud Storage (modules complémentaires, sauvegardes)1 $ US
Frais de gestion de cluster GKEpartagés entre toutes les applications GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 $
Totalenviron 110 $ US, ou environ 183 $ US sans le niveau gratuit
  • Le niveau gratuit de GKE couvre les frais de gestion d'un cluster Autopilot ou zonal par compte de facturation, il ne s'applique donc que si c'est votre seul cluster de ce type. Cloud SQL coûte le même prix en africa-south1 (Johannesburg) ; le pod et la VM coûtent environ 10 % de plus là-bas.
  • GKE Autopilot ne se met pas à l'échelle à zéro. Au moins un pod Outline fonctionne toujours, donc le coût ci-dessus est le même que quelqu'un l'utilise ou non ; des pods supplémentaires ne sont ajoutés qu'en cas de charge.
  • Évitez Filestore pour un petit déploiement. Le module utilise par défaut une petite VM NFS/cache. La plus petite instance de Filestore est de 1 Tio, ce qui coûte environ 164 $ US par mois à elle seule.

Comment cela se compare​

  • Outline vend son propre plan Cloud hébergé. Le plan Starter coûte un forfait de 10 $ US/mois pour une équipe de 10 membres maximum (getoutline.com/pricing, 8 octobre 2026), passant à 79 $ US/mois pour 11 à 100 membres ; les deux plans incluent les mêmes fonctionnalités.
  • Le chiffre du projet propre à RAD ci-dessus est plus élevé en termes monétaires car il s'agit d'une infrastructure dédiée, et non d'un service multi-locataire partagé — une instance Cloud SQL dédiée, un serveur de fichiers NFS et un service Cloud Run, plutôt qu'une part de l'infrastructure d'Outline.
  • Un VPS nu — Hetzner CPX22 ou un Droplet DigitalOcean 2 vCPU/4 Go, tous deux à environ 24 $ US/mois — est également moins cher que le chiffre du projet propre à RAD, au prix de l'exécution de PostgreSQL, Redis, des sauvegardes et des correctifs par vous-même. Outline n'a besoin que de 1 vCPU / 1-2 Gio, donc un niveau de VPS plus petit/moins cher que cela ferait probablement l'affaire.
  • Outline Cloud est le moins cher des trois jusqu'à ce qu'une équipe dépasse 10 membres ou ait besoin que les données restent dans son propre projet Google Cloud.

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

Si Outline 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 : supprimer tout le projet et le restaurer dans les 30 jours pour presque rien. Cela convient bien mieux à une utilisation occasionnelle — préparation d'une certification, environnement de démonstration, activité saisonnière — que l'exécution continue d'Outline.

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, sera utilisable après sa restauration. Par conséquent, 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 dissocie 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à dissociée, rien n'est facturé pendant cette période d'attente. Contrairement à la suppression d'un module, cela ne détruit pas Cloud SQL, une VM ou le cluster GKE un par un — tout le 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 restaurer 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.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 375 $ US par mois pour le maintenir en fonctionnement. Déployez Outline, utilisez-le pendant un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et le temps réel où Outline était actif.
  • Ce que cela nécessite. Vous devez posséder le 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 niveau (100 crédits pour le niveau sandbox qui convient à la plupart des utilisations d'étude et de démonstration). Google indique que la plupart des services fonctionnent à nouveau pleinement dans les 36 heures suivant une restauration.
  • Un véritable manque : le bucket de sauvegarde ne survit pas. Les sauvegardes d'Outline 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 apporté des modifications à Outline que vous souhaitez conserver, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer, comme pour le workflow de redéploiement ci-dessous. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

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

GKE Autopilot ne se met pas à l'échelle à zéro entre les requêtes. 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) : 175 crédits (17,50 $ US), car RAD recrée le projet et les services partagés avant Outline. La suppression ne permet d'économiser de l'argent que si Outline devait rester inutilisé pendant environ 5 jours ou plus, à la fois dans votre propre projet (environ 3,67 $ US par jour) et dans un projet géré par RAD (125 crédits par jour).
  • La majeure partie du coût d'exécution est généralement 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 d'Outline lorsque quelque chose d'autre partage le projet n'économise que la partie calcul d'Outline.
  • Conserver les données en premier. Les sauvegardes sont écrites 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 voulez la conserver.
  • RAD ne recrée pas un déploiement supprimé pour vous ; vous saisissez à nouveau les paramètres lors du déploiement.

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 sociétés 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 devient faible, la facturation est interrompue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.

Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; radmodules.dev/pricing pour les frais propres à RAD et les estimations de crédits quotidiens ; Supprimer et restaurer des projets pour la fenêtre de pause/restauration et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle ; Tarification Outline.


1. Vue d'ensemble​

Outline s'exécute comme une seule charge de travail Node.js avec une dépendance Redis obligatoire (utilisée pour la collaboration en temps réel et la coordination de session, pas seulement pour la mise en cache). Le déploiement relie un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculGKE AutopilotPod Node.js sur le port 3000, 1 vCPU / 2 Gio par défaut
Base de donnéesCloud SQL pour PostgreSQL 15Obligatoire — Outline (Sequelize) ne prend en charge que Postgres
Cache / coordinationRedis (auto-géré, co-hébergé sur la VM NFS par défaut)Obligatoire, non optionnel — Outline en a besoin même en réplica unique
Persistance des fichiersCloud Filestore (NFS)Les fichiers téléchargés persistent sous /var/lib/outline/data, partagés entre les pods
Stockage d'objetsCloud StorageDeux buckets provisionnés par défaut (...-storage, ...-data) ; aucun n'est monté dans le pod par défaut
SecretsSecret ManagerSECRET_KEY et UTILS_SECRET auto-générés ; mot de passe de la base de données
IngressCloud Load BalancingLoadBalancer externe avec une IP statique réservée par défaut ; domaine personnalisé optionnel + certificat géré, IAP, Cloud Armor

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

  • PostgreSQL 15 est effectivement obligatoire (database_type par défaut POSTGRES_15) — les migrations Sequelize d'Outline, l'extension de recherche pg_trgm et la logique de chaîne de connexion du point d'entrée supposent toutes Postgres.
  • Redis est requis, non optionnel. enable_redis = true par défaut ; avec enable_nfs = true (également par défaut), la fondation pointe REDIS_HOST vers l'IP du serveur NFS, qui co-héberge Redis — pas besoin de Memorystore séparé.
  • Multi-réplica par défaut (min_instance_count = 1, max_instance_count = 3) — contrairement à la plupart des applications basées sur NFS ici, Outline est conçu pour exécuter plusieurs réplicas simultanément (Redis coordonne l'état).
  • Les déploiements basés sur NFS utilisent toujours Recreate, arrêtant tous les réplicas avant de démarrer le nouvel ensemble — avec max_instance_count = 3, c'est une brève panne complète à chaque redéploiement, pas un déploiement progressif.
  • Deux buckets Cloud Storage sont créés mais inutilisés par défaut — un à partir de Outline_Common (storage), un à partir de la valeur par défaut de cette variante (data). Outline stocke effectivement les téléchargements sur NFS (FILE_STORAGE=local) ; aucun bucket n'est monté via gcs_volumes sauf configuration.
  • SECRET_KEY/UTILS_SECRET sont auto-générés dans Secret Manager et câblés à la fois comme références Secret Manager et comme explicit_secret_values bruts (une couverture de lecture après écriture ; le chemin Secret-Manager-ID l'emporte).
  • Un fournisseur d'authentification est requis avant que la connexion ne fonctionne. Les variables OIDC_* sont livrées vides ; Outline construit son redirect_uri OIDC à partir de URL, donc sans fournisseur configuré, il enregistre zéro méthodes d'authentification. Voir Section 3.
  • Le LoadBalancer par défaut est HTTP simple, ce qui bloque complètement les connexions OAuth tant qu'un domaine et TLS ne sont pas ajoutés — voir Section 6.

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

A. GKE Autopilot — la charge de travail Outline​

Les pods Outline sont planifiés sur Autopilot, qui facture le CPU/la mémoire que les pods demandent réellement. Parce que enable_nfs = true, le déploiement utilise la stratégie Recreate — avec max_instance_count > 1, cela signifie que chaque déploiement arrête tous les réplicas avant de démarrer l'ensemble de remplacement.

  • Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Outline pour 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" --selector app~outline
    kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
    kubectl describe pod -n "$NAMESPACE" -l app=<service-name>

Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle et du type de charge de travail (Deployment vs StatefulSet).

B. Cloud SQL pour PostgreSQL 15​

Outline stocke tous les documents, collections, utilisateurs et index de recherche dans une instance Cloud SQL pour PostgreSQL 15 gérée, accessible via le sidecar Cloud SQL Auth Proxy sur 127.0.0.1:5432 (enable_cloudsql_volume = true) ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init crée la base de données/l'utilisateur/les autorisations ; le point d'entrée personnalisé exécute les migrations Sequelize d'Outline à chaque démarrage de conteneur (idempotent).

  • 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 Secret Manager contenant le mot de passe sont tous dans les Sorties. Voir App_GKE pour le modèle de connexion, les sauvegardes automatisées et la rotation des mots de passe.

C. Redis​

La couche de collaboration/session et la limitation de débit de l'API d'Outline nécessitent Redis — ce n'est pas un niveau de cache optionnel comme pour de nombreuses applications. Par défaut, la fondation pointe REDIS_HOST vers l'IP interne de la VM du serveur NFS (elle co-héberge un processus Redis) ; définissez redis_host pour utiliser Memorystore à la place.

  • Console : Compute Engine → Instances de VM (Redis auto-hébergé sur la VM NFS), ou Memorystore → Instances Redis si vous êtes passé à une instance gérée.
  • CLI :
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E '^REDIS_'
    gcloud redis instances list --project "$PROJECT" --region "$REGION" # only if using Memorystore

Voir App_GKE pour la résolution de enable_redis/redis_host.

D. Cloud Filestore (NFS) et Cloud Storage​

Les fichiers téléchargés d'Outline (FILE_STORAGE=local) résident sur NFS (Cloud Filestore), monté à /var/lib/outline/data, partagé entre tous les pods. Deux buckets Cloud Storage (suffixes storage et data) sont également provisionnés automatiquement — aucun n'est monté dans le pod par défaut, car Outline est configuré pour le stockage local/NFS plutôt que pour le stockage d'objets compatible S3.

  • Console : Filestore → Instances ; Cloud Storage → Buckets.
  • CLI :
    gcloud filestore instances list --project "$PROJECT"
    kubectl get pvc -n "$NAMESPACE"
    gcloud storage buckets list --project "$PROJECT" --filter="name~outline"

Voir App_GKE pour les options CMEK et les montages GCS Fuse (gcs_volumes) si vous souhaitez connecter l'un des buckets provisionnés en tant que volume monté.

E. Secret Manager​

Deux secrets spécifiques à Outline sont générés automatiquement et stockés dans Secret Manager : SECRET_KEY (chiffre les cookies et les données sensibles au repos) et UTILS_SECRET (authentification interne API/utilitaires). Le mot de passe de la base de données est géré séparément par la fondation. Sur GKE, les valeurs sauvegardées par Secret Manager sont matérialisées dans le cluster en tant que secrets Kubernetes natifs par le contrôleur SecretSync (le CRD secretsyncs.secret-sync.gke.io), que la fondation App_GKE attend pendant le démarrage du cluster.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT" --filter="name~outline"
    gcloud secrets versions access latest --secret=<secret-key-secret-name> --project "$PROJECT"
    kubectl get secret -n "$NAMESPACE" # the SecretSync-materialised "<prefix>-secrets" object

Voir App_GKE pour l'intégration et la rotation de SecretSync/CSI.

F. Réseau et Ingress​

Par défaut, la charge de travail est exposée via une IP externe Cloud Load Balancing (service_type = LoadBalancer, reserve_static_ip = true, HTTP simple — pas de terminateur TLS). Un domaine personnalisé avec un certificat géré par Google peut être activé via enable_custom_domain + application_domains, ce qui est nécessaire pour que les connexions OAuth d'Outline fonctionnent (voir Section 6).

  • Console : Services réseau → Équilibrage de charge ; Réseau VPC → Adresses IP.
  • CLI :
    kubectl get svc,ingress -n "$NAMESPACE"
    gcloud compute addresses list --project "$PROJECT"

Voir App_GKE pour les domaines personnalisés, Cloud CDN, IAP, Cloud Armor et les détails des IP statiques.

G. Cloud Logging et Monitoring​

Les flux stdout/stderr des pods vers Cloud Logging ; les métriques GKE et Cloud SQL vers Cloud Monitoring. uptime_check_config est désactivé par défaut pour ce module (enabled = false) — activez-le une fois que l'application est accessible via HTTPS.

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

  • Configuration de la base de données lors du premier déploiement. Le job db-init exécute db-init.sh en utilisant postgres:15-alpine. Il se connecte à Cloud SQL via le sidecar Auth Proxy, crée de manière idempotente le rôle d'application et la base de données (appartenant à ce rôle), accorde les privilèges sur la base de données et le schéma public, puis signale au sidecar proxy de s'arrêter (quitquitquit) afin que le Job se termine. Peut être réexécuté en toute sécurité (execute_on_apply = true).
  • Les migrations s'exécutent à chaque démarrage de conteneur, et non dans un job séparé. Le entrypoint.sh personnalisé (intégré à l'image au moment de la build) assemble DATABASE_URL à partir des valeurs DB_* injectées par la plateforme (en fonction de si DB_HOST est un chemin de socket, 127.0.0.1, ou une IP privée), attend que Postgres accepte les connexions, exécute les migrations Sequelize d'Outline (sequelize db:migrate --env=production-ssl-disabled, idempotentes), et seulement ensuite exécute le serveur Node.
  • URL doit résoudre l'adresse publique, sinon OIDC enregistre zéro fournisseurs. Outline dérive son redirect_uri OIDC de URL. Contrairement à la variante Cloud Run (qui définit service_url_env_var_name = "URL" afin que la fondation injecte directement l'URL prédite), la variante GKE ne déclare aucune variable service_url_env_var_name — App_GKE injecte inconditionnellement l'URL calculée comme GKE_SERVICE_URL, et le point d'entrée applique URL="${CLOUDRUN_SERVICE_URL:-${GKE_SERVICE_URL:-}}" seulement si URL n'est pas déjà défini. Ainsi, un nouveau déploiement remplit URL automatiquement à partir de l'IP du LoadBalancer externe (ou https://<domain> une fois application_domains défini) — aucune surcharge manuelle URL n'est nécessaire, sauf si l'on force un nom d'hôte avant le provisionnement DNS/certificat.
  • Placeholders OIDC — l'opérateur doit configurer après le déploiement. OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_AUTH_URI, OIDC_TOKEN_URI, OIDC_USERINFO_URI sont livrés vides (OIDC_DISPLAY_NAME/OIDC_SCOPES sont pré-remplis). Définissez-les via environment_variables, ou de préférence liez OIDC_CLIENT_ID/OIDC_CLIENT_SECRET comme secret_environment_variables (voir Section 6). Enregistrez <URL>/auth/oidc.callback sur le même hôte que URL.
  • Sondes de santé. Démarrage : HTTP GET /, délai initial de 60 s, période de 10 s, seuil d'échec 6 (budget d'environ 120 s). Vivacité : HTTP GET /, délai initial de 60 s, période de 30 s, seuil d'échec 3 — le délai généreux couvre l'exécution de la migration au premier démarrage. FORCE_HTTPS est forcé à "false" par Outline_Common afin que ces sondes HTTP ne soient pas redirigées 301 vers un :443 sans écouteur derrière le LoadBalancer HTTP simple par défaut.
  • Contraintes de mise à l'échelle. min_instance_count = 1, max_instance_count = 3 par défaut. Parce que enable_nfs = true, les déploiements utilisent la stratégie Recreate — tous les réplicas sont arrêtés avant le démarrage des nouveaux, donc attendez-vous à une courte panne complète à chaque redéploiement (pas un déploiement progressif sans interruption).
  • Inspecter le job d'initialisation et la configuration en cours d'exécution :
    kubectl get jobs -n "$NAMESPACE"
    kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
    kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep -E '^(URL|OIDC_|REDIS_|DATABASE_URL)'

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement (correspondant aux balises {{UIMeta group=N}} dans variables.tf). Seuls les paramètres spécifiques ou notables pour Outline sont listés ; toutes les autres entrées sont héritées de App_GKE avec son comportement standard et ses valeurs par défaut.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameoutlineNom de base des ressources. Ne pas modifier après le premier déploiement.
application_versionlatestTag d'image outlinewiki/outline utilisé comme base de build personnalisée.

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

VariableValeur par défautDescription
container_port3000Le serveur Node.js d'Outline écoute sur le port 3000.
container_resources.cpu_limit / .memory_limit1000m / 2Gi1 vCPU / 2 Gio minimum recommandé.
min_instance_count / max_instance_count1 / 3Plafond par défaut plus élevé que la plupart des modules — Outline prend en charge le multi-réplica via la coordination Redis.
enable_cloudsql_volumetrueSidecar Auth Proxy (boucle locale 127.0.0.1:5432) — requis sur GKE.

Groupe 5 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables(voir Outline_Common)Pré-rempli avec PGSSLMODE, FORCE_HTTPS=false, FILE_STORAGE*, et des placeholders OIDC_* vides ; définissez le fournisseur d'authentification et, éventuellement, URL ici.
secret_environment_variables{}Références Secret Manager injectées via SecretSync ; utilisez-les pour OIDC_CLIENT_ID/OIDC_CLIENT_SECRET au lieu du texte brut.

Groupe 6 — Backend GKE et cluster​

VariableValeur par défautDescription
service_typeLoadBalancerIP externe pour l'interface utilisateur d'Outline ; HTTP simple par défaut.
workload_typenull → DeploymentDéploiement, stratégie Recreate (basé sur NFS).
session_affinityClientIPRoutage persistant pour qu'un client atteigne le même pod.

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

VariableValeur par défautDescription
enable_nfstrueRequis pour que les fichiers téléchargés persistent et soient partagés entre les réplicas.
nfs_mount_path/var/lib/outline/dataDoit correspondre à FILE_STORAGE_LOCAL_ROOT_DIR défini par Outline_Common.

Groupe 14 — Cloud Storage​

VariableValeur par défautDescription
storage_buckets[{ name_suffix = "data" }]Fusionné avec le bucket storage de Outline_Common — deux buckets sont créés ; aucun n'est utilisé par l'application par défaut.
gcs_volumes[]Non renseigné par défaut ; Outline utilise NFS, pas GCS Fuse, pour les téléchargements.

Groupe 15 — Redis​

VariableValeur par défautDescription
enable_redistrueRequis par Outline — ne pas désactiver.
redis_host""Laissez vide pour utiliser le Redis co-hébergé sur la VM NFS ; définissez pour une instance Memorystore externe.
redis_port6379Port Redis.

Groupe 16 — Backend de base de données​

VariableValeur par défautDescription
database_typePOSTGRES_15PostgreSQL uniquement — les migrations d'Outline et l'extension pg_trgm supposent Postgres.
application_database_nameoutlineNom de la base de données. Immuable après le premier déploiement.
application_database_useroutlineUtilisateur de la base de données de l'application ; mot de passe auto-généré dans Secret Manager.
postgres_extensions["pg_trgm"]Requis pour la recherche de documents en texte intégral d'Outline.

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

VariableValeur par défautDescription
enable_custom_domaintrueProvisionne un Ingress ; nécessaire pour un TLS réel (non-nip.io).
application_domains[]Définir un vrai nom d'hôte ici (plus un certificat) est ce qui permet réellement à service_url/URL d'être sur https:// — voir Section 6.
reserve_static_iptrueIP externe stable entre les redéploiements.

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

SortieDescription
service_nameNom du service Kubernetes.
namespaceEspace de noms dans lequel la charge de travail s'exécute.
service_cluster_ipClusterIP intra-cluster.
stage_service_cluster_ipsCarte des ClusterIPs pour les services spécifiques à chaque étape.
service_external_ipIP externe du LoadBalancer (lorsqu'une IP statique est réservée).
service_urlURL pour atteindre Outline (également injectée dans le conteneur sous le nom GKE_SERVICE_URL).
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 Secret Manager contenant le mot de passe de la base de données.
database_host / database_portPoint de terminaison / port de la base de données (127.0.0.1 via l'Auth Proxy).
storage_bucketsBuckets Cloud Storage créés.
network_name / network_exists / regionsRéseau VPC, présence, régions disponibles.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channelsÉtat et canaux de surveillance.
initialization_jobs / db_import_jobNoms des jobs de configuration (db-init) et d'importation (optionnel).
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de 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_nameDétails GitHub CI/CD.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.
kubernetes_readyIndique si le cluster/la charge de travail est prêt(e).
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_modeÉtat VPC-SC.
audit_logging_enabled / artifact_registry_cmek_enabledJournalisation d'audit et état CMEK.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

Validation héritée au moment de la planification. Ce module transmet sa configuration au moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un StatefulSet forcé à côté d'un paramètre sans état, IAP sans identités autorisées, quota_memory_* donné comme des entiers bruts, un container_port/backup_retention_days hors de portée. 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ètreValeur judicieuseRisqueConséquence en cas d'erreur
database_typePOSTGRES_15CritiqueLes migrations Sequelize d'Outline et l'extension de recherche pg_trgm supposent Postgres ; un moteur non-Postgres rompt le schéma et la recherche.
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 orpheline tous les documents.
SECRET_KEY (auto-généré)Ne jamais changerCritiqueSa rotation invalide tous les cookies de session existants et toutes les données chiffrées au repos avec l'ancienne clé.
URL / GKE_SERVICE_URL auto-injectéLaissé non défini (auto) ou explicitement l'URL publique réelleCritiqueS'il résout le mauvais hôte, l'OIDC redirect_uri d'Outline ne correspondra pas à ce qui est enregistré auprès de l'IdP, et/ou zéro fournisseur s'enregistrera — page de connexion inutilisable.
HTTPS devant le serviceConfigurer enable_custom_domain + application_domains + TLS avant d'activer l'authentificationCritiquePassport définit le cookie OAuth state secure: true ; sur le LoadBalancer L4 HTTP simple par défaut, /auth/<provider> renvoie 500 — Cannot send secure cookie over unencrypted connection. La page d'accueil se charge bien, masquant la vraie cause.
enable_redistrueCritiqueOutline nécessite Redis même avec un seul réplica ; le désactiver rompt la coordination en temps réel/de session et l'application ne fonctionnera pas correctement.
enable_nfstrueÉlevéLe désactiver rend les fichiers téléchargés éphémères — perdus lors de la recréation du pod — et rompt le partage entre les réplicas.
OIDC_CLIENT_ID / OIDC_CLIENT_SECRET déplacé de simple à secretDéfinir uniquement dans secret_environment_variables ; supprimer de environment_variables dans la même applicationÉlevéCeux-ci sont livrés comme des variables d'environnement de chaîne vide simples. Contrairement à l'impératif gcloud run services update de Cloud Run (qui nécessite une étape --remove-env-vars d'abord, avec l'erreur "déjà défini avec un type différent"), le commutateur de GKE est déclaratif — tofu apply rend la liste env souhaitée en une seule passe. Mais laisser la clé dans les deux cartes à la fois place deux entrées env du même nom dans la spécification du Pod (une value, une valueFrom.secretKeyRef) ; Kubernetes l'accepte, mais la valeur que le processus observe n'est pas vérifiée ici — supprimez la clé en texte brut lors de l'ajout de la clé sauvegardée par secret.
max_instance_count avec enable_nfs = trueComprendre le compromis RecreateÉlevéChaque redéploiement arrête tous les réplicas en cours d'exécution (pas seulement un pod de surtension) avant de démarrer l'ensemble de remplacement — une brève panne complète à chaque mise à jour, pire que le cas à réplica unique dans la plupart des autres modules basés sur NFS.
quota_memory_requests / _limitsunités binaires (4Gi, 8192Mi)CritiqueLes entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms.
reserve_static_iptrueMoyenSans cela, l'IP externe peut changer entre les redéploiements, rompant le DNS, l'URI de redirection OIDC enregistré et URL.
uptime_check_config.enabledfalse par défautMoyenPas d'alerte de panne automatique tant que vous ne l'activez pas — il est judicieux de le laisser désactivé tant que HTTPS/l'authentification ne sont pas configurés, car l'application est censée être inutilisable (en boucle de crash ou 500 à la connexion) jusqu'à ce moment-là.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la rétention de conformité.

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 à Outline partagée avec la variante Cloud Run — les secrets auto-générés, les variables d'environnement par défaut, entrypoint.sh/Dockerfile, et le job db-init — est décrite dans Outline_Common.

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