Webgune pour VS Code
Vos services Webgune directement dans l'éditeur : l'extension détecte le(s) dépôt(s) GitHub du
workspace — y compris dans des sous-dossiers (front/.git, back/.git, apps/x/.git…) —,
retrouve les services de la plateforme qui pointent dessus et permet de build/deploy,
rollback, suivre les logs de build et basculer l'auto-deploy sans quitter VS Code.
Connexion
Navigateur (recommandé, tous les comptes) — commande Webgune: Se connecter (navigateur)
ou bouton « Se connecter avec le navigateur » dans la vue :
l'extension ouvre dashboard/vscode-auth, vous autorisez, une clé API limitée
(services:read + services:write) est créée et renvoyée à VS Code via un serveur
loopback 127.0.0.1 (protégé par un state aléatoire, timeout 5 min).
Clé API collée (fallback) — Webgune: Se connecter avec une clé API : collez une clé
wgk_… créée manuellement dans le dashboard.
La clé est stockée dans le SecretStorage (trousseau de l'OS), jamais dans les settings.
Révocable à tout moment côté dashboard.
Interface
La vue Webgune (barre d'activité) est une webview avec de vrais boutons — une carte
par service matché :
- pastille de statut (vert en ligne / jaune pulsé pendant un build / rouge en erreur), branche, projet ;
- dernier déploiement (message de commit + ancienneté) ;
- boutons Déployer, Logs de build, Rollback ;
- liens : toggle Auto-deploy, Sans cache, Logs runtime, Dashboard, Ouvrir l'app.
La status bar montre le premier service matché ; le polling passe à 4 s pendant un build.
Détection des dépôts
Deux sources fusionnées : l'API de l'extension git intégrée et un scan filesystem des
sous-dossiers de chaque racine du workspace (profondeur 2, node_modules/dist/.next…
ignorés), qui lit les url = des .git/config (worktrees/submodules supportés via le
fichier gitdir:). Seuls les remotes GitHub sont matchés contre le sourceUrl des services.
Commandes (palette)
| Commande |
Effet |
| Se connecter (navigateur) |
mini-OAuth via le dashboard |
| Se connecter avec une clé API |
fallback clé collée |
| Build & Deploy (± sans cache) |
POST /redeploy puis logs de build suivis en direct |
| Logs de build |
snapshot + suivi live par polling (2,5 s) tant que le build tourne |
| Logs du service |
snapshot des logs runtime du pod (tail 300) |
| Rollback vers un déploiement… |
QuickPick des déploiements réussis tagués + confirmation |
| Activer/Désactiver l'auto-deploy |
bascule Service.autoDeploy (webhook push) |
| Ouvrir dans le dashboard / l'application |
liens externes |
Configuration
| Setting |
Défaut |
Rôle |
webgune.apiUrl |
https://api.webgune.cloud |
API backend (mettre http://localhost:8000 en dev) |
webgune.dashboardUrl |
https://webgune.dev |
Dashboard (page d'autorisation + liens) |
webgune.refreshIntervalSeconds |
15 |
Rafraîchissement de la vue |
Développement
cd vscode-extension
bun install
bun run compile # tsc → out/
# F5 dans VS Code (Run Extension) pour tester, ou :
bun run package # .vsix via vsce
Notes :
- les logs sont récupérés par polling REST (le WebSocket du backend est authentifié par
cookie de session uniquement, inaccessible avec une clé API) ;
- la connexion navigateur nécessite que le frontend expose la page
/vscode-auth
(frontend/app/[locale]/vscode-auth/page.tsx).