Coder sur GKE Autopilot
Coder est une plateforme open source auto-hébergée pour le provisionnement
d'environnements de développement distants ("espaces de travail") définis
sous forme de code avec Terraform. Elle est livrée sous la forme d'un
unique binaire Go (coder server) qui sert l'interface utilisateur/API du
plan de contrôle et proxyfie les connexions WebSocket pour les IDE de
navigateur et les sessions de terminal vers les espaces de travail en cours
d'exécution. Ce module déploie le plan de contrôle Coder sur GKE
Autopilot au-dessus de la fondation App_GKE, qui
provisionne et gère l'infrastructure partagée Google Cloud et Kubernetes. Le
provisionnement des espaces de travail réels nécessite en outre un
provisionneur configuré et une cible de calcul (par exemple un cluster
Kubernetes ou un modèle de VM cloud) configurés après le déploiement — ce
module ne met en place que le plan de contrôle.
Ce guide se concentre sur les services cloud que Coder 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 à chaque application 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 Coder sur RAD, et comment cela se compare
Le module GKE Autopilot de Coder sur RAD coûte environ 136,37 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 175 crédits (17,50 $ US). Coder est le plan de contrôle open source pour le provisionnement d'espaces de travail de développement distants définis par Terraform. Pour le coût le plus bas, le guide Cloud Run exécute le même Coder pour environ 167,44 $ US par mois ; choisissez GKE ici uniquement si Coder doit rester actif en continu, s'adapter à travers les pods ou s'exécuter à côté d'autres charges de travail Kubernetes.
Si Coder n'est nécessaire qu'occasionnellement — une démo, un essai, une charge de travail saisonnière ou d'étude — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires, de sorte que 136,37 $ US deviennent quelques dollars par mois. Voir Mettez-le en pause gratuitement, ci-dessous.
Ce que vous payez sur RAD
| Dans un projet Google Cloud que vous possédez | Dans un projet géré par RAD pour vous | |
|---|---|---|
| Frais de module, une fois par déploiement | 175 crédits (17,50 $ US au prix de la recharge) | 157,5 crédits (10 % de moins) |
| Builds | Inclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de build | Idem |
| Coût d'exécution Google Cloud | Facturé par Google à votre propre compte de facturation, environ 136,37 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 135 crédits par jour, environ 4 050 par mois (environ 405 $ US au prix de la recharge ; estimé à partir des prix catalogue Google, et incluant les frais de cluster) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est conservé en réserve |
10 crédits coûtent 1 $ US pour une recharge ponctuelle, moins sur un plan. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par chaque application 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 (valeur par défaut du module) | Par mois |
|---|---|
| Pod GKE Autopilot, 2x vCPU / 4 Gio | 79,35 $ US |
| Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 Go, zonal, 10 Go SSD | 51 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Frais de gestion de cluster GKE | partagés entre chaque application GKE du projet ; 0 $ si c'est votre seul cluster, sinon ~73 |
| Total | environ 136,37 $ US |
Comment cela se compare
- Si vous l'exécutez vous-même, un VPS exécutant le plan de contrôle Coder et PostgreSQL vous coûtera moins cher en espèces : dimensionné à environ 2 vCPU/4 Gio, un VPS comparable (Hetzner ou DigitalOcean) coûte environ 24 à 48 $ par mois, ou une VM GCP de classe
e2-standard-2environ 49 $ — plus votre propre temps pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL géré, Secret Manager et la surveillance de RAD couvrent pour vous. - RAD ne prétend jamais être moins cher que l'infrastructure nue en termes d'argent — ce n'est généralement pas le cas. La différence est ce que RAD gère pour vous : les correctifs, les sauvegardes, les secrets et la surveillance, plus la possibilité de mettre Coder en pause gratuitement plutôt que de payer pour une capacité inactive (voir ci-dessous).
- La majeure partie du coût d'exécution ci-dessus est la base de données PostgreSQL gérée (et, le cas échéant, le serveur de fichiers partagé) — la partie qu'une comparaison avec un VPS nu doit exécuter et sauvegarder à la main.
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si Coder 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 à Coder dont vous n'avez besoin qu'occasionnellement 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 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 qu'il attend. Contrairement à la suppression d'un module, cela ne supprime pas les ressources Cloud SQL ou GKE Autopilot une par une — 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 Update 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 405 $ US par mois pour le maintenir en fonctionnement. Déployez Coder, utilisez-le, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Update, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez les frais de module qu'une seule fois et les heures pendant lesquelles il a été réellement actif.
- 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 que la plupart des utilisations d'étude et de démo conviennent). 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 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é Coder et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive, ou un bucket en dehors du projet) avant de supprimer. 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 Autopilot 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) : 175 crédits (17,50 $ US) dans votre propre projet. La suppression ne permet d'économiser de l'argent que si Coder restait inutilisé pendant environ 4 jours ou plus dans votre propre projet (4,55 $ US par jour), ou environ 2 jours ou plus dans un projet géré par RAD (135 crédits par jour).
- 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 Coder alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
- Conservez vos données en premier. Les sauvegardes nocturnes 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.
- Notez vos paramètres. RAD ne recrée pas un déploiement supprimé pour vous ; vous entrez les paramètres à nouveau lorsque vous déployez.
Sessions de lab et environnements gérés
- Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant reçoit 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 est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.
Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; frais propres à RAD et estimations de crédits quotidiens 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. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
Le plan de contrôle de Coder est sans état — tout l'état, y compris ses clés de signature auto-générées, réside dans PostgreSQL — le déploiement relie donc un petit ensemble ciblé de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | GKE Autopilot | Binaire Go sur le port 3000, 2 vCPU / 4 Gio par défaut, un réplica (max_instance_count = 1) |
| Base de données | Cloud SQL pour PostgreSQL 15 | Requis — MySQL est rejeté au moment de la planification |
| Stockage d'objets | Cloud Storage | Un bucket storage provisionné automatiquement par Coder_Common |
| Secrets | Secret Manager | Uniquement le mot de passe de la base de données géré par la Fondation — Coder n'a pas de secret d'application propre |
| Ingress | Cloud Load Balancing | Ingress Kubernetes avec une IP statique globale réservée ; domaine personnalisé facultatif |
| Build de conteneur | Cloud Build + Artifact Registry | Enveloppe l'image amont ghcr.io/coder/coder avec un point d'entrée cloud |
Valeurs par défaut judicieuses à connaître d'emblée :
- PostgreSQL 15 est requis.
database_typeutilise par défautPOSTGRES_15; une validation au moment de la planification dansvalidation.tfrejette tout ce qui n'est pasPOSTGRES_13/14/15/NONE— MySQL n'est pas pris en charge. container_image_source = "custom"est requis, pas facultatif. L'image amontghcr.io/coder/coderne peut pas analyser le câblage de la base de données de la Fondation seule ; Cloud Build l'enveloppe avec un point d'entrée cloud qui assembleCODER_PG_CONNECTION_URLetCODER_ACCESS_URLau démarrage du conteneur.- Cloud SQL est atteint via le sidecar Auth Proxy sur la boucle locale. GKE
injecte
DB_HOST = 127.0.0.1; le point d'entrée construit un DSNpostgres://avecsslmode=disable(le proxy termine déjà la connexion TLS) et encode l'URL du mot de passe. - Pas de NFS, pas de Redis, et pas de secret d'application. Tout l'état de Coder —
espaces de travail, modèles, utilisateurs, sessions, file d'attente de build et
clés de signature auto-générées — réside dans PostgreSQL.
enable_nfsetenable_redissont tous deux par défautfalseet ne sont pas nécessaires pour un fonctionnement normal. - Pas de job de migration séparé. Coder exécute ses propres migrations de schéma au
démarrage ; le seul job d'initialisation est
db-init, qui crée la base de données et le rôle vides. - Un réplica par défaut.
min_instance_count = 1,max_instance_count = 1. Le mode multi-réplica de Coder est sa fonctionnalité de haute disponibilité, qui nécessite une licence premium : sans elle, les réplicas supplémentaires servent l'API et l'interface utilisateur mais ne rejoignent jamais le maillage de relais de Coder, de sorte que les sessions de terminal et SSH de l'espace de travail dépendraient du réplica choisi par l'équilibreur de charge. session_affinity = ClientIPmaintient le trafic de terminal/IDE d'un navigateur, riche en WebSocket, épinglé au même pod pendant toute la session.- Ingress et une IP statique sont provisionnés prêts à l'emploi
(
enable_custom_domain = true,reserve_static_ip = true).
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 du plan de contrôle Coder
Les pods Coder s'exécutent sur Autopilot, facturés pour le CPU/la mémoire que les pods
demandent réellement. Comme le plan de contrôle est sans état, la charge de travail s'exécute
comme un Deployment standard avec une stratégie RollingUpdate (pas de
contrainte Recreate basée sur NFS). L'exécution de plus d'un réplica nécessite
le mode haute disponibilité sous licence de Coder (voir ci-dessus).
- Console : Kubernetes Engine → Charges de travail → sélectionnez la charge de travail Coder 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"
kubectl logs -n "$NAMESPACE" deploy/<service-name> --tail=100
kubectl get hpa -n "$NAMESPACE"
Voir App_GKE pour la gestion d'Autopilot, de la mise à l'échelle HPA et du type de charge de travail (Deployment vs StatefulSet).
B. Cloud SQL pour PostgreSQL 15
Coder stocke tout — espaces de travail, modèles, utilisateurs, journaux d'audit, sessions et
ses propres clés de signature — dans une instance Cloud SQL pour PostgreSQL 15 gérée.
Les pods l'atteignent via le sidecar Cloud SQL Auth Proxy sur
127.0.0.1:5432 ; aucune IP publique n'est exposée. Lors du premier déploiement, le job db-init
crée la base de données et le rôle de l'application ; le propre moteur de migration de Coder
crée ensuite le schéma au démarrage du serveur.
- 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 se trouvent 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. Cloud Storage
Un bucket Cloud Storage dédié (suffixe storage) est provisionné
automatiquement par Coder_Common et le compte de service de la charge de travail se voit accorder
l'accès. Il n'est pas actuellement monté dans le conteneur Coder par défaut —
Coder ne nécessite pas de système de fichiers partagé, car l'état réside dans PostgreSQL.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~storage"
Voir App_GKE pour les options CMEK et les montages GCS Fuse (gcs_volumes)
si vous avez besoin d'en attacher un pour un workflow personnalisé.
D. Secret Manager
Coder est inhabituel parmi les applications avec état en ce qu'il ne crée aucun
secret d'application propre — il auto-génère ses clés de signature et
les persiste dans la base de données PostgreSQL coder au premier démarrage. La seule
crédentiel que Secret Manager détient est le mot de passe de la base de données géré par la Fondation.
Sur GKE, les secrets sont projetés dans les pods via le pilote CSI Secret Store.
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~coder"
gcloud secrets versions access latest --secret=<db-password-secret-name> --project "$PROJECT"
Voir App_GKE pour l'intégration et la rotation du Secret Store CSI.
E. Réseau et ingress
Par défaut, la charge de travail est exposée via un Ingress Kubernetes adossé à une
IP statique globale (reserve_static_ip = true afin que l'adresse survive aux
redéploiements). Un domaine personnalisé avec un certificat géré par Google peut être activé
via application_domains. Comme Coder proxyfie les connexions WebSocket de longue durée
pour le terminal web et le trafic d'application de l'espace de travail, conservez
session_affinity = ClientIP afin que les requêtes d'un client atterrissent sur le même pod pendant
la durée d'une session.
- 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 et les détails de l'IP statique.
F. Cloud Logging et Monitoring
Les sorties stdout/stderr des pods sont acheminées vers Cloud Logging ; les métriques GKE et Cloud SQL sont acheminées vers Cloud Monitoring. Des tests de disponibilité et des règles d'alerte facultatifs sont disponibles (uptime_check_config est désactivé par défaut).
- 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 Coder
- Configuration de la base de données au premier déploiement, pas de job de migration séparé. Le job
db-initexécutedb-init.shen utilisantpostgres:15-alpine. Il attend le sidecar Cloud SQL Auth Proxy, crée de manière idempotente le rôlecoderet la base de données, accorde les privilèges et réaffecte le propriétaire du schémapublic, puis signale au sidecar proxy de s'arrêter (--quitquitquit) afin que le pod du Job se termine. Coder exécute ensuite ses propres migrations de schéma au démarrage du serveur — il n'y a pas de job de migration dédié, contrairement aux applications avec une étapedb-migrateséparée. - Aucun compte administrateur n'est pré-provisionné. Le premier utilisateur à atteindre l'interface web après un démarrage réussi complète la configuration interactive de première exécution de Coder (création du compte administrateur initial). Il n'y a pas de secret de mot de passe administrateur auto-généré à récupérer.
- Assemblage du DSN au démarrage du conteneur, non intégré à l'image.
entrypoint.sh(dansCoder_Common/scripts/) construitCODER_PG_CONNECTION_URLà partir des valeursDB_*injectées par la Fondation, car le pilote Go de Coder attend une URLpostgres://et ne peut pas analyser la forme de mot-clé libpq. Sur GKE,DB_HOST=127.0.0.1(le sidecar Auth Proxy) se résout ensslmode=disable; le mot de passe est encodé en pourcentage RFC-3986 afin que les caractères spéciaux ne cassent pas l'URL.CODER_ACCESS_URLutilise par défautGKE_SERVICE_URLinjecté par la Fondation. - Le trafic riche en WebSocket nécessite un routage persistant. Le terminal web,
le proxying d'applications d'espace de travail et le
coder ssh/port-forward de la CLI utilisent tous des connexions WebSocket de longue durée via le plan de contrôle. Conservezsession_affinity = ClientIP(la valeur par défaut) afin que la connexion d'un client persiste sur un seul pod ;max_instance_countreste à 1 sauf si vous détenez une licence Coder avec haute disponibilité. - Chemins des sondes de santé. Les sondes de démarrage et de vivacité ciblent toutes deux HTTP
GET /healthavec un délai initial de 60 secondes ; la sonde de démarrage autorise jusqu'à 30 échecs à une période de 15 secondes pour absorber la migration de schéma au premier démarrage de Coder. La sonde de disponibilité fournie par Common (utilisée par le câblageadditional_services/readiness de la Fondation) cibleGET /healthzséparément. - La télémétrie est désactivée par défaut (
CODER_TELEMETRY_ENABLE = "false"), etCODER_VERBOSE = "false". - Plan de contrôle uniquement — les espaces de travail nécessitent un provisionneur + une cible. Ce
module déploie
coder server; l'exécution d'espaces de travail réels nécessite en outre la configuration d'un provisionneur et d'une cible de calcul (par exemple un autre cluster/espace de noms Kubernetes, ou des modèles de VM cloud) via le système de modèles de Coder après la première connexion. - Vérifier le déploiement :
kubectl get jobs -n "$NAMESPACE"
kubectl logs -n "$NAMESPACE" job/<db-init-job-name>
kubectl exec -n "$NAMESPACE" deploy/<service-name> -- env | grep CODER_
curl -s https://<service-url>/healthz
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 Coder sont listés ; toute autre entrée est héritée de App_GKE avec son comportement standard et ses valeurs par défaut.
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | coder | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_version | latest | Tag de version de Coder ; latest correspond à un tag épinglé (v2.24.1) via l'ARG de build CODER_VERSION spécifique à l'application afin qu'il ne se résolve jamais contre un ghcr.io/coder/coder:latest inexistant. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
container_image_source | custom | Requis — l'image amont ne peut pas être déployée pré-construite ; Cloud Build l'enveloppe avec le point d'entrée d'assemblage du DSN. |
container_port | 3000 | Port de liaison CODER_HTTP_ADDRESS de Coder. |
container_resources | cpu_limit=2000m, memory_limit=4Gi | 2 vCPU / 4 Gio par défaut pour le plan de contrôle. |
min_instance_count / max_instance_count | 1 / 1 | Limites des réplicas. Plus d'un réplica nécessite le mode haute disponibilité sous licence de Coder. |
enable_cloudsql_volume | true | Sidecar Auth Proxy (boucle locale) — requis sur GKE ; une garde au moment de la planification le rejette lorsque database_type = "NONE". |
enable_image_mirroring | true | Toujours activé pour Coder — l'image de base provenant de GHCR est mise en miroir dans Artifact Registry. |
Groupe 6 — Backend GKE et cluster
| Variable | Valeur par défaut | Description |
|---|---|---|
service_type | LoadBalancer | IP externe pour l'interface utilisateur/API de Coder. |
workload_type | null → Deployment | Déploiement (sans état, RollingUpdate standard). |
session_affinity | ClientIP | Routage persistant pour qu'une session WebSocket client atteigne le même pod. |
Groupe 13 — Système de fichiers (NFS)
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | false | Non requis — tout l'état est dans PostgreSQL. Si activé, nfs_mount_path doit être un répertoire réel, jamais un sous-chemin de /opt/coder (le binaire coder, un fichier). |
nfs_mount_path | /home/coder/data | Utilisé uniquement lorsque enable_nfs = true. |
Groupe 15 — Redis
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_redis | false | Non requis — les sessions et la file d'attente de build résident dans PostgreSQL, contrairement aux applications qui nécessitent un cache/une file d'attente externe. |
redis_host | "" | Pertinent uniquement si enable_redis = true ; une garde au moment de la planification exige soit redis_host soit enable_nfs = true. |
Groupe 16 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | POSTGRES_15 | Coder nécessite PostgreSQL 13+ ; MySQL est rejeté au moment de la planification (validation.tf). |
application_database_name | coder | Nom de la base de données. Immuable après le premier déploiement — le renommage recrée la base de données et orpheline tout l'état de Coder. |
application_database_user | coder | Utilisateur de la base de données de l'application ; mot de passe auto-généré dans Secret Manager. |
Groupe 19 — Domaine personnalisé, IP statique et réseau
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_custom_domain | true | Un Ingress Kubernetes est provisionné prêt à l'emploi. |
reserve_static_ip | true | IP externe stable sur les redéploiements. |
application_domains | [] | Noms d'hôtes personnalisés + certificat géré. |
Toutes les autres entrées suivent le comportement standard de App_GKE. Note :
elasticsearch_url, elasticsearch_username et
elasticsearch_password_secret sont déclarés dans variables.tf pour la parité du catalogue
mais ne sont pas transmis à l'appel de la Fondation dans main.tf — Coder
n'a pas d'intégration Elasticsearch dans ce module, donc les définir n'a aucun
effet.
5. Sorties
Ces valeurs sont renvoyées lors d'un déploiement réussi et constituent le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Kubernetes. |
namespace | Espace de noms dans lequel la charge de travail s'exécute. |
service_cluster_ip | ClusterIP intra-cluster. |
stage_service_cluster_ips | Carte des ClusterIP pour les services spécifiques à l'étape. |
service_external_ip | IP externe de l'équilibreur de charge (lorsqu'une IP statique est réservée). |
service_url | URL pour atteindre Coder. |
database_instance_name | Nom de l'instance Cloud SQL. |
database_name / database_user | Nom / utilisateur de la base de données de l'application. |
database_password_secret | Secret Secret Manager contenant le mot de passe de la base de données. |
database_host / database_port | Point de terminaison de la base de données (127.0.0.1 via le proxy d'authentification) / port. |
storage_buckets | Buckets Cloud Storage créés. |
network_name / network_exists / regions | Réseau VPC, présence, régions disponibles. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels | État et canaux de surveillance. |
initialization_jobs / db_import_job | Noms des jobs de configuration (db-init) et d'importation (facultatif). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants 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_name | Détails GitHub CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
kubernetes_ready | Indique si le cluster/la charge de travail est prêt. |
vpc_sc_enabled / vpc_sc_perimeter_name / vpc_sc_dry_run_mode | État VPC-SC. |
audit_logging_enabled / artifact_registry_cmek_enabled | Journalisation d'audit et état CMEK. |
6. Pièges de configuration et valeurs par défaut judicieuses
Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).
Validation héritée au moment de la planification. Ce module transmet sa configuration via le moteur de fondation App_GKE, qui valide les valeurs et les combinaisons au moment de la planification — un nombre d'instances hors plage, IAP activé sans identifiants OAuth,
quota_memory_*donné comme des entiers bruts. Coder_GKE ajoute en outre ses propres protections dansvalidation.tf(PostgreSQL uniquementdatabase_type, la précondition hôte Redis/NFS, le volume Cloud SQL vs le conflitdatabase_type = "NONE"). Une configuration invalide échoue la planification avec une erreur claire et nommée avant que toute ressource ne soit créée, de sorte que la plupart des erreurs ci-dessous sont détectées en amont plutôt qu'à l'application ou à l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
database_type | POSTGRES_15 (ou 13/14) | Critique | Tout moteur non-PostgreSQL est rejeté au moment de la planification ; en forcer un en contournant la protection rompt toutes les requêtes émises par Coder. |
application_database_name / application_database_user | Définir une fois | Critique | Immuable après le premier déploiement ; le renommage recrée la base de données/l'utilisateur et détruit tous les espaces de travail, modèles, utilisateurs et clés de signature auto-générées. |
container_image_source | custom | Critique | Le passage à prebuilt pointe GKE vers l'image brute ghcr.io/coder/coder, qui ne peut pas assembler CODER_PG_CONNECTION_URL à partir des variables de base de données de la Fondation et échoue au démarrage. |
enable_cloudsql_volume | true | Critique | Requis pour la connectivité de la base de données sur GKE ; une protection au moment de la planification le bloque également lorsque database_type = "NONE" pour éviter un sidecar proxy sans rien à connecter. |
nfs_mount_path (si enable_nfs=true) | Un répertoire réel, par ex. /home/coder/data | Critique | Le montage sur /opt/coder — le binaire coder lui-même — masque l'exécutable et le conteneur ne démarre pas. |
session_affinity | ClientIP | Élevé | Sans persistance, une session de terminal/IDE WebSocket en cours peut être acheminée vers un pod différent en cours de session et se déconnecter. |
enable_redis | false | Moyen | Non nécessaire — l'activer sans redis_host défini ou enable_nfs=true échoue à la validation au moment de la planification ; même correctement configuré, cela ajoute une dépendance inutilisée puisque Coder conserve tout l'état dans PostgreSQL. |
max_instance_count | 1 | Élevé | Coder multi-réplicas est une haute disponibilité, une fonctionnalité de licence premium ; les réplicas supplémentaires sans licence ne rejoignent jamais le maillage de relais, de sorte que les connexions d'espace de travail se rompent en fonction du réplica qui les sert. |
quota_memory_requests / _limits | unités binaires (4Gi, 8192Mi) | Critique | Les entiers bruts sont traités comme des octets et bloquent toute planification de pod dans l'espace de noms. |
reserve_static_ip | true | Moyen | Sans cela, l'IP externe peut changer lors des redéploiements, rompant le DNS, CODER_ACCESS_URL et toute redirection OAuth/OIDC enregistrée. |
backup_retention_days | 7 (augmenter pour la production) | Moyen | Trop court pour la rétention de conformité de l'historique des espaces de travail/modèles. |
elasticsearch_url / elasticsearch_username / elasticsearch_password_secret | Laisser non défini | Faible | Inerte dans ce module (non transmis à l'appel de la Fondation) — les définir n'a aucun effet et n'active pas l'intégration de la recherche. |
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 à Coder partagée avec la variante Cloud Run est décrite dans Coder_Common.
Guides connexes
- Lab pratique : Coder sur GKE Autopilot — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- Coder sur Google Cloud Run — la même application sur Cloud Run, lorsque vous avez besoin de l'autre cible de déploiement.
- Coder Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.