code-server sur Google Cloud Run
code-server est la version open source (MIT) de Visual Studio Code de Coder qui s'exécute sur un serveur distant et est entièrement accessible via le navigateur — un IDE complet avec la marketplace d'extensions VS Code, un terminal intégré et des serveurs de langage, le tout soutenu par un espace de travail persistant. Ce module déploie code-server sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.
Ce guide se concentre sur les services cloud que code-server utilise et sur la manière de les explorer et de les exploiter depuis la console Google Cloud et la ligne de commande. Pour les mécanismes communs à chaque application Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — reportez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.
Ce que coûte CodeServer sur RAD, et comment cela se compare
CodeServer sur le module Cloud Run de RAD coûte environ 32,57 $ US par mois dans un projet Google Cloud que vous possédez, plus des frais de module uniques de 40 crédits (4 $ US). CodeServer est la version open source de VS Code de Coder qui s'exécute dans le navigateur sur un espace de travail cloud persistant. GKE Autopilot convient à CodeServer qui doit rester actif, s'adapter à plusieurs pods ou s'exécuter aux côtés d'autres charges de travail Kubernetes ; pour le coût le plus bas, ce module Cloud Run est généralement le bon choix — consultez le guide GKE si vous avez besoin de l'autre.
Si CodeServer 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 les 32,57 $ US deviennent quelques dollars par mois à la place. 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 | 40 crédits (4 $ US au prix de la recharge) | 36 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 32,57 $ US par mois pour la configuration par défaut (tableau ci-dessous) | Mesuré à l'heure en crédits ; RAD publie 23 crédits par jour, environ 690 par mois (environ 69 $ US au prix de la recharge) |
| Qui possède quoi | Vous possédez le projet et sa facturation ; RAD le déploie et le met à jour | RAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde minimum acheté est maintenu en réserve |
Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).
10 crédits coûtent 1 $ US pour une recharge 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 toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas une deuxième base de données.
Coût d'exécution par défaut dans votre propre projet (us-central1, prix catalogue Google) :
| Ressource (valeur par défaut du module) | Par mois |
|---|---|
| Cloud Run, 1x vCPU / 1 Gio (chaud) | 13,14 $ US |
| Serveur de fichiers NFS/cache (petite VM) | 13,43 $ US |
| Cloud NAT et réseau | 5 $ US |
| Cloud Storage (modules complémentaires, sauvegardes) | 1 $ US |
| Total | environ 32,57 $ US |
Comment cela se compare
- GitHub Codespaces, l'équivalent géré le plus proche, est gratuit pour les particuliers jusqu'à 120 heures-cœur (60 heures sur une machine à 2 cœurs) et 15 Go-mois de stockage, puis 0,18 $/heure pour une machine à 2 cœurs (doublant avec le nombre de cœurs) plus 0,07 $/Go-mois pour le stockage.
- Si vous l'exécutez vous-même, un petit VPS exécutant code-server vous coûtera
moins cher en espèces : une machine Hetzner CPX22 ou DigitalOcean 2 vCPU/4 Go
coûte environ 24 $ par mois, ou une GCP
e2-standard-2environ 49 $ par mois — plus votre propre temps pour les sauvegardes, les correctifs de sécurité et les mises à niveau, que Cloud SQL, Secret Manager et la surveillance gérés par RAD couvrent pour vous. - RAD ne prétend jamais être moins cher que l'infrastructure nue en termes monétaires — 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, ainsi que la possibilité de mettre CodeServer en pause gratuitement plutôt que de payer pour une capacité inactive (voir ci-dessous).
Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le lorsque vous en avez besoin
Si CodeServer 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 à CodeServer 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, sera utilisable 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 l'attente. Contrairement à la suppression d'un module, cela ne supprime pas les ressources VM ou Cloud Run 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éactiver 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 69 $ US par mois pour le maintenir en fonctionnement. Déployez CodeServer, 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 pour les heures où il était 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é CodeServer 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.
Ne payez que pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer
Cloud Run conserve une instance chaude, il ne se met donc pas entièrement à l'échelle zéro par 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 déployer à nouveau lorsque vous en avez besoin.
- Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 40 crédits (4,00 $ US) dans votre propre projet. La suppression ne permet d'économiser de l'argent que si CodeServer devait rester inutilisé pendant environ 5 jours ou plus, que ce soit dans votre propre projet ou dans un projet géré par RAD.
- La majeure partie du coût d'exécution est généralement le serveur de fichiers ou de cache partagé. Il ne s'arrête que si rien d'autre dans le projet ne l'utilise, donc la suppression de CodeServer alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
- Conservez d'abord vos données. Les sauvegardes nocturnes sont écrites dans un bucket à l'intérieur du déploiement et sont supprimées avec celui-ci, donc 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 à nouveau les paramètres 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 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 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'elle dit sur les objets Cloud Storage sans suppression logicielle ; GitHub Codespaces. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.
1. Vue d'ensemble
code-server s'exécute comme un conteneur unique autonome sur Cloud Run v2. Contrairement aux applications basées sur une base de données, il connecte un ensemble délibérément minimal de services Google Cloud :
| Capacité | Service Google Cloud | Notes |
|---|---|---|
| Calcul | Cloud Run v2 | Conteneur unique écoutant sur le port 8080 ; 1 vCPU / 1 Gio par défaut |
| Espace de travail persistant | Cloud Filestore (NFS) | /home/coder est sur le partage NFS par défaut ; le bucket de l'espace de travail est monté là via GCS FUSE uniquement si NFS est désactivé |
| Base de données | Aucune | database_type = NONE — code-server n'a pas de base de données SQL |
| Cache et file d'attente | Aucun | Redis est explicitement désactivé (enable_redis = false) |
| Secrets | Secret Manager | PASSWORD de l'éditeur auto-généré (quand enable_password = true) |
| Ingress | URL Cloud Run / Cloud Load Balancing | L'ingress par défaut est all — accessible publiquement par défaut ; le PASSWORD auto-généré protège la page de connexion |
Valeurs par défaut judicieuses à connaître d'emblée :
- Pas de base de données et pas de Redis. code-server est un conteneur
unique ; tout l'état réside dans le volume de l'espace de travail.
database_typeest fixé àNONEpar la couche d'application partagée et Redis est désactivé. - L'ingress est
all(public) par défaut. Le service est accessible depuis l'internet public dès la sortie de la boîte, protégé par lePASSWORDauto-généré. Conservezenable_password = truechaque fois queingress_settings = "all", ou passez àingress_settings = "internal"pour restreindre l'accès au VPC. - Un
PASSWORDd'éditeur aléatoire est généré automatiquement et stocké dans Secret Manager. Il protège la page de connexion. La désactivation deenable_passwordsert l'éditeur sans authentification — uniquement sûr derrière l'ingressinternal. - L'espace de travail est sur NFS à
/home/coder. Les paramètres, les extensions et les projets ouverts y persistent. Conservezenable_nfs = true: sur le repli GCS FUSE, l'installation d'une extension échoue, car GCS FUSE ne peut pas renommer un répertoire. Nécessite l'environnement d'exécutiongen2(par défaut). - Instance unique par conception.
min_instance_count = max_instance_count = 1. code-server conserve l'état de l'éditeur par session en mémoire et possède un volume d'espace de travail ; la mise à l'échelle au-delà d'une instance diviserait les sessions et risquerait des écritures concurrentes sur le même volume. - Les sondes de santé atteignent
/healthz, pas/health./healthzn'est pas authentifié et renvoie200une fois que le serveur écoute ;/healthrenvoie401lorsqu'un mot de passe est défini et ferait échouer la sonde. - L'image est un mince wrapper sur
codercom/code-server, construite et mise en miroir dans Artifact Registry via Cloud Build ;latestse fixe à4.99.1au moment du build.
2. Services Google Cloud et comment les explorer
Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de
services et de ressources sont rapportés dans les Sorties du
déploiement.
A. Cloud Run — le service code-server
code-server s'exécute comme un service Cloud Run v2 écoutant sur le port 8080.
Chaque déploiement crée une révision immuable ; comme l'application est à
instance unique et avec état, conservez min = max = 1 et évitez le fractionnement du
trafic entre les révisions concurrentes.
- Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les logs et les métriques.
- CLI :
gcloud run services list --project "$PROJECT" --region "$REGION" --filter="metadata.name~codeserver"
gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"
Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et le fractionnement du trafic.
B. Cloud Storage — le volume de l'espace de travail
Le seul emplacement avec état est /home/coder — l'espace de travail de l'utilisateur,
les paramètres VS Code et les extensions installées. Par défaut, c'est le chemin
de montage NFS, qui survit aux redéploiements de révisions et aux événements de
mise à l'échelle. Un bucket Cloud Storage dédié est également provisionné ;
il est monté comme un volume GCS FUSE à /home/coder uniquement lorsque enable_nfs = false,
où les installations d'extensions échouent.
- Console : Cloud Storage → Buckets.
- CLI :
gcloud storage buckets list --project "$PROJECT" --filter="name~codeserver"
gcloud storage ls gs://<workspace-bucket>/ # bucket name is in the Outputs
NFS et GCS FUSE nécessitent tous deux l'environnement d'exécution gen2 (par
défaut). Voir App_CloudRun pour les options GCS FUSE et
CMEK.
C. Secret Manager — le mot de passe de l'éditeur
Lorsque enable_password = true (par défaut), un PASSWORD aléatoire de 24 caractères est généré et
stocké dans Secret Manager, puis injecté comme variable d'environnement PASSWORD du
conteneur pour protéger la page de connexion. Il n'y a pas de mot de passe de
base de données (pas de base de données).
- Console : Sécurité → Secret Manager.
- CLI :
gcloud secrets list --project "$PROJECT" --filter="name~codeserver AND name~password"
gcloud secrets versions access latest --secret=<secret-name> --project "$PROJECT"
Voir App_CloudRun pour les détails sur l'injection et la rotation des secrets.
D. Réseau et ingress
Le service utilise par défaut l'ingress all — accessible depuis
l'internet public, avec le PASSWORD auto-généré protégeant la page de connexion.
Pour restreindre l'accès au VPC, définissez ingress_settings = "internal", ou superposez un
équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et
Cloud Armor.
- Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
- CLI :
gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
gcloud compute addresses list --project "$PROJECT"
Voir App_CloudRun.
E. Cloud Logging et Monitoring
Les logs des conteneurs sont envoyés à Cloud Logging ; les métriques Cloud Run sont envoyées à Cloud Monitoring, avec des tests de disponibilité et des stratégies d'alerte facultatifs. Un point de terminaison public est requis pour qu'un test de disponibilité puisse atteindre le service.
- Console : Logging → Explorateur de logs ; Monitoring → Tableaux de bord / Alertes.
- CLI :
gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50
3. Comportement de l'application code-server
- Pas de configuration de base de données au premier déploiement.
code-server n'a pas de base de données SQL et pas de job d'initialisation. Le
service démarre dès que le conteneur démarre et se lie à
0.0.0.0:8080(défini viaBIND_ADDR). - Pas de migrations. La mise à niveau du
application_versiondéploie simplement une nouvelle révision sur la nouvelle image ; il n'y a pas de schéma à migrer. - L'espace de travail est le seul état durable. Tout ce qui se trouve sous
/home/coder— dossiers ouverts,settings.json, raccourcis clavier et chaque extension installée — persiste sur le partage NFS. Le supprimer efface l'espace de travail. - La connexion est protégée par le secret
PASSWORD. Avecenable_password = true, l'éditeur demande le mot de passe généré. Récupérez-le depuis Secret Manager (§2C). S'il est désactivé, toute personne atteignant l'URL obtient un IDE non authentifié — ne l'exécutez ainsi que derrière l'ingressinternal. - Chemin de santé. Les sondes de démarrage et de vivacité ciblent le point
de terminaison non authentifié
/healthz(renvoie200une fois que le serveur HTTP écoute). Ne pas pointer les sondes vers/healthlorsqu'un mot de passe est défini — il renvoie401et la révision ne devient jamais prête. Vérifiez l'environnement et le port de la révision en cours d'exécution :gcloud run services describe <service-name> \
--region "$REGION" --project "$PROJECT" \
--format='value(spec.template.spec.containers[0].env)' - Mise à l'échelle à instance unique. Conservez
min = max = 1. Les sessions d'éditeur sont conservées en mémoire et le volume de l'espace de travail a un seul rédacteur.
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 code-server sont listés ; toutes les autres entrées sont héritées de App_CloudRun avec son comportement standard.
Groupe 1 — Projet et identité
| Variable | Valeur par défaut | Description |
|---|---|---|
project_id | (requis) | Projet Google Cloud cible. |
region | us-central1 | Région pour le service et les ressources régionales. |
Groupe 2 — Environnement de déploiement
| Variable | Valeur par défaut | Description |
|---|---|---|
tenant_id | demo | Suffixe court qui rend les noms de ressources uniques par environnement. |
support_users | [] | E-mails ayant accès au projet et aux alertes de surveillance. |
resource_labels | {} | Étiquettes appliquées à toutes les ressources. |
Groupe 3 — Identité de l'application
| Variable | Valeur par défaut | Description |
|---|---|---|
application_name | codeserver | Nom de base des ressources. Ne pas modifier après le premier déploiement. |
application_display_name | code-server | Nom lisible par l'homme affiché dans la console. |
application_version | latest | Tag de l'image code-server ; latest se fixe à 4.99.1 au moment du build. Fixez-le à une version spécifique en production. |
enable_password | true | Générer un PASSWORD d'éditeur aléatoire et le demander à la connexion. Laisser activé pour tout déploiement accessible publiquement. |
Groupe 4 — Exécution et mise à l'échelle
| Variable | Valeur par défaut | Description |
|---|---|---|
deploy_application | true | Définir false pour provisionner uniquement l'infrastructure. |
cpu_limit | 1000m | CPU par instance ; augmenter pour les serveurs de langage lourds. |
memory_limit | 1Gi | Mémoire par instance ; dimensionner en fonction des espaces de travail et des extensions que vous exécutez. |
min_instance_count | 1 | Maintenir à 1 — éditeur à instance unique ; évite les retards de démarrage à froid pendant le chargement de l'index. |
max_instance_count | 1 | Maintenir à 1 — un volume d'espace de travail, session en mémoire. |
container_port | 8080 | code-server écoute sur 8080. |
execution_environment | gen2 | Requis pour GCS FUSE (montage de l'espace de travail) et NFS. |
timeout_seconds | 300 | Durée maximale de la requête (0–3600 secondes). |
enable_cloudsql_volume | false | code-server n'a pas de Cloud SQL — laisser à false. |
enable_image_mirroring | true | Mettre en miroir l'image code-server dans Artifact Registry. |
Groupe 5 — Accès et contrôle d'ingress
| Variable | Valeur par défaut | Description |
|---|---|---|
ingress_settings | all | Public par défaut (protégé par le secret PASSWORD). Définir internal pour restreindre l'accès au VPC. |
vpc_egress_setting | PRIVATE_RANGES_ONLY | Acheminer uniquement le trafic RFC 1918 via VPC. |
enable_iap | false | Exiger la connexion Google devant l'éditeur. |
iap_authorized_users / iap_authorized_groups | [] | Qui peut accéder via IAP. |
Groupe 6 — Variables d'environnement et secrets
| Variable | Valeur par défaut | Description |
|---|---|---|
environment_variables | {} | Paramètres non secrets supplémentaires (par exemple { TZ = "UTC" }). BIND_ADDR est défini automatiquement. |
secret_environment_variables | {} | Mappage de la variable d'environnement → nom du secret Secret Manager. |
secret_propagation_delay | 30 | Secondes à attendre après la création du secret avant de continuer. |
Groupe 11 — Stockage et système de fichiers
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_nfs | true | Doit rester true sur Cloud Run : /home/coder contient les paramètres, les extensions et les projets, et l'installation d'une extension échoue sur GCS FUSE (il ne peut pas renommer un répertoire). |
nfs_mount_path | /home/coder | Chemin de montage si NFS est activé. |
gcs_volumes | [] | Montages GCS FUSE supplémentaires ; le bucket de l'espace de travail est ajouté automatiquement à /home/coder uniquement lorsque enable_nfs = false. |
manage_storage_kms_iam / enable_artifact_registry_cmek | false | Options CMEK. |
Groupe 12 — Backend de base de données
| Variable | Valeur par défaut | Description |
|---|---|---|
database_type | NONE | Non référencé — code-server n'a pas de base de données SQL ; fixé à NONE par CodeServer_Common. |
database_password_length | 32 | Non référencé — transmis à la fondation pour compatibilité. |
Groupe 14 — Observabilité et santé
| Variable | Valeur par défaut | Description |
|---|---|---|
startup_probe | HTTP /healthz délai de 15s | Sonde de démarrage ; utilise le point de terminaison non authentifié. |
liveness_probe | HTTP /healthz délai de 30s | Sonde de vivacité ; utilise le point de terminaison non authentifié. |
health_check_config | HTTP /health | Sonde structurée alternative (point de terminaison authentifié). |
uptime_check_config | { enabled=false, path="/health" } | Test de disponibilité Cloud Monitoring facultatif (nécessite un point de terminaison public). |
alert_policies | [] | Stratégies d'alerte métriques. |
Groupe 23 — VPC Service Controls et journalisation d'audit
| Variable | Valeur par défaut | Description |
|---|---|---|
enable_vpc_sc | false | Appliquer un périmètre VPC-SC (nécessite organization_id). |
vpc_cidr_ranges / vpc_sc_dry_run | (défini) | CIDR de niveau d'accès / mode simulation. |
enable_audit_logging | false | Journaux d'audit Cloud détaillés. |
Toutes les autres entrées suivent le comportement standard d'App_CloudRun.
5. Sorties
Retournées lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.
| Sortie | Description |
|---|---|
service_name | Nom du service Cloud Run. |
codeserver_url | URL de l'éditeur code-server (port 8080). Accessible uniquement au sein du VPC lorsque l'ingress est internal. |
service_location | Région dans laquelle le service s'exécute. |
stage_services | Détails du service spécifiques à l'étape (Cloud Deploy). |
load_balancer_ip / load_balancer_url | IP / URL de l'équilibreur de charge HTTPS externe (lorsqu'il est activé). |
storage_buckets | Buckets Cloud Storage créés (le bucket de l'espace de travail). |
network_name / network_exists / regions | Réseau VPC, présence, régions. |
container_image / container_registry | Image déployée et dépôt Artifact Registry. |
monitoring_enabled / monitoring_notification_channels / uptime_check_names | État de la surveillance, canaux, tests de disponibilité. |
initialization_jobs | Noms des jobs d'initialisation fournis par l'utilisateur (aucun par défaut). |
deployment_id / tenant_id / resource_prefix | Identifiants de nommage. |
project_id / project_number | Identifiants de projet. |
cicd_enabled / github_repository_url / github_repository_owner / github_repository_name / cicd_configuration | État et détails CI/CD. |
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_id | Registre et déclencheur de build. |
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 du plan. Ce module transmet sa configuration au moteur de la fondation App_CloudRun, qui valide les valeurs et les combinaisons au moment du plan — un environnement d'exécution
gen1avec des montages GCS FUSE/NFS, IAP sans identités autorisées, untimeout_secondshors plage, etc. 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'apply ou de l'exécution.
| Paramètre | Valeur judicieuse | Risque | Conséquence si incorrect |
|---|---|---|---|
enable_password | true (garder activé pour l'ingress public) | Critique | La désactivation avec ingress_settings = "all" expose un IDE entièrement non authentifié — y compris un terminal — à Internet. |
enable_nfs | true (par défaut) | Critique | Le partage NFS à /home/coder est le seul état persistant. La désactivation de NFS déplace l'espace de travail sur GCS FUSE, où les installations d'extensions échouent. |
startup_probe / chemin liveness_probe | /healthz | Élevé | Pointer les sondes vers /health alors qu'un mot de passe est défini renvoie 401 ; la révision ne devient jamais prête. |
max_instance_count | 1 | Élevé | La mise à l'échelle au-delà de 1 divise les sessions d'éditeur entre les instances et risque des écritures concurrentes sur le volume d'espace de travail unique. |
min_instance_count | 1 | Moyen | La mise à l'échelle à zéro (0) ajoute une latence de démarrage à froid et remonte l'espace de travail à la prochaine requête. |
execution_environment | gen2 | Élevé | gen1 ne peut pas monter NFS ou GCS FUSE — le volume de l'espace de travail échoue et l'état est perdu au redémarrage. |
ingress_settings | all + mot de passe (ou internal) | Élevé | all sans mot de passe publie un IDE ouvert ; internal bloque tout accès au navigateur depuis l'extérieur du VPC. |
enable_cloudsql_volume | false | Faible | code-server n'a pas de base de données ; l'activation ajoute un sidecar Auth Proxy inutilisé. |
memory_limit | 1Gi+ | Moyen | Les serveurs/extensions de langage lourds peuvent manquer de mémoire en dessous de 1 Gio. |
Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à code-server partagée avec la variante GKE est décrite dans CodeServer_Common.
Guides associés
- Lab pratique : code-server sur Cloud Run — déployez-le étape par étape, avec les écrans de la console et les commandes à chaque étape.
- code-server sur GKE Autopilot — la même application sur Kubernetes, pour quand vous avez besoin de l'autre cible de déploiement.
- CodeServer Common — Configuration d'application partagée — la configuration partagée par les deux cibles de déploiement.
- Déployé aux côtés de Coder sur Google Cloud Run, Gitea sur Google Cloud Run, Hoppscotch sur Google Cloud Run dans la solution Environnements de développement cloud.
Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.