Outils pour utilisateurs

Outils du site


ujusum:x-ressources:windows-dev-platform

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
ujusum:x-ressources:windows-dev-platform [2026/06/21 13:42] – créée 88.174.75.218ujusum:x-ressources:windows-dev-platform [2026/06/21 14:00] (Version actuelle) – [8. Accéder depuis le navigateur Windows] 88.174.75.218
Ligne 1: Ligne 1:
 Pour continuer le développement sur un poste windows, installez Docker Desktop pour Windows avec WSL 2 comme backend. Pour continuer le développement sur un poste windows, installez Docker Desktop pour Windows avec WSL 2 comme backend.
  
-====== ====== ====== Étapes concrètes ====== ====== ======+===== Étapes concrètes =====
  
 +==== 1. Prérequis Windows ====
  
- 
- 
-1. Prérequis Windows 
 Windows 10 (21H2+) ou Windows 11 Windows 10 (21H2+) ou Windows 11
 Activer WSL 2 : ouvrez PowerShell en admin et exécutez Activer WSL 2 : ouvrez PowerShell en admin et exécutez
 wsl --install wsl --install
 Redémarrez, puis vérifiez avec wsl --list --verbose Redémarrez, puis vérifiez avec wsl --list --verbose
-2. Docker Desktop+ 
 +==== 2. Docker Desktop ====
 Téléchargez sur docker.com/products/docker-desktop Téléchargez sur docker.com/products/docker-desktop
 À l'installation, cochez "Use WSL 2 instead of Hyper-V" À l'installation, cochez "Use WSL 2 instead of Hyper-V"
 Une fois démarré, vos docker run et docker compose up fonctionnent depuis PowerShell, CMD ou le terminal WSL Une fois démarré, vos docker run et docker compose up fonctionnent depuis PowerShell, CMD ou le terminal WSL
-3. Votre stack (PostgreSQL + tout le reste)+ 
 +==== 3. Votre stack (PostgreSQL + tout le reste) ====
 Vos docker-compose.yml existants fonctionnent sans modification. Depuis la racine du repo : Vos docker-compose.yml existants fonctionnent sans modification. Depuis la racine du repo :
  
-docker compose up -d +<code>docker compose up -d</code> 
-4. Développement Node/pnpm+ 
 +==== 4. Développement Node/pnpm ====
 Deux options : Deux options :
  
Ligne 28: Ligne 29:
 Vérifiez que vos .env pointent vers localhost (pas 127.0.0.1 en IPv6) pour Postgres : Vérifiez que vos .env pointent vers localhost (pas 127.0.0.1 en IPv6) pour Postgres :
  
-DATABASE_URL=postgresql://user:pass@localhost:5432/rental+<code>DATABASE_URL=postgresql://user:pass@localhost:5432/rental</code> 
 Recommandation pour votre monorepo pnpm : optez pour l'Option A (WSL 2 + VS Code Remote). Vous aurez exactement le même environnement Linux que la prod, et les performances pnpm sont bien meilleures que sur le filesystem Windows natif. Recommandation pour votre monorepo pnpm : optez pour l'Option A (WSL 2 + VS Code Remote). Vous aurez exactement le même environnement Linux que la prod, et les performances pnpm sont bien meilleures que sur le filesystem Windows natif.
  
-====== Détaille de l'option A ======+===== Détail de l'option A =====
  
 Option A — WSL 2 + VS Code Remote (guide complet) Option A — WSL 2 + VS Code Remote (guide complet)
-1. Activer WSL 2 et installer Ubuntu+ 
 +==== 1. Activer WSL 2 et installer Ubuntu ==== 
 Dans PowerShell en administrateur : Dans PowerShell en administrateur :
  
 +<code>
 wsl --install wsl --install
 # Installe WSL 2 + Ubuntu par défaut # Installe WSL 2 + Ubuntu par défaut
 # Redémarrez Windows après # Redémarrez Windows après
 Au redémarrage, Ubuntu s'ouvre et vous demande un nom d'utilisateur/mot de passe Unix. Choisissez ce que vous voulez. Au redémarrage, Ubuntu s'ouvre et vous demande un nom d'utilisateur/mot de passe Unix. Choisissez ce que vous voulez.
 +</code>
  
 Vérifiez que c'est bien WSL 2 : Vérifiez que c'est bien WSL 2 :
  
 +<code>
 wsl --list --verbose wsl --list --verbose
 # NAME      STATE   VERSION # NAME      STATE   VERSION
 # Ubuntu    Running 2        ← doit être 2 # Ubuntu    Running 2        ← doit être 2
-2. Installer Docker Desktop+</code> 
 + 
 +==== 2. Installer Docker Desktop ==== 
 Téléchargez Docker Desktop sur docker.com Téléchargez Docker Desktop sur docker.com
 À l'installation : cochez "Use WSL 2 based engine" À l'installation : cochez "Use WSL 2 based engine"
Ligne 53: Ligne 63:
 Vérifiez depuis Ubuntu : Vérifiez depuis Ubuntu :
  
 +<code>
 docker --version docker --version
 docker compose version docker compose version
-3. Installer les outils de dev dans Ubuntu+</code> 
 + 
 +==== 3. Installer les outils de dev dans Ubuntu ==== 
 Ouvrez le terminal Ubuntu et installez la chaîne complète : Ouvrez le terminal Ubuntu et installez la chaîne complète :
  
 +<code>
 # Mise à jour système # Mise à jour système
 sudo apt update && sudo apt upgrade -y sudo apt update && sudo apt upgrade -y
Ligne 75: Ligne 90:
 # Outils courants # Outils courants
 sudo apt install -y curl wget unzip build-essential sudo apt install -y curl wget unzip build-essential
-4. Cloner le repo dans WSL (important !)+</code> 
 + 
 +==== 4. Cloner le repo dans WSL (important !) ==== 
 Clonez dans le filesystem Linux, pas dans /mnt/c/ : Clonez dans le filesystem Linux, pas dans /mnt/c/ :
  
 # ✅ Bon — filesystem Linux, performances maximales # ✅ Bon — filesystem Linux, performances maximales
 +<code>
 cd ~ cd ~
 git clone git@github.com:hseb72/rental-platform.git git clone git@github.com:hseb72/rental-platform.git
 cd rental-platform cd rental-platform
 +</code>
  
 # ❌ Mauvais — filesystem Windows monté, 10x plus lent # ❌ Mauvais — filesystem Windows monté, 10x plus lent
 +<code>
 # /mnt/c/Users/vous/rental-platform # /mnt/c/Users/vous/rental-platform
-5. Installer VS Code + extension Remote WSL+</code> 
 + 
 +==== 5. Installer VS Code + extension Remote WSL ==== 
 Installez VS Code sur Windows normalement Installez VS Code sur Windows normalement
 Installez l'extension "WSL" (identifiant : ms-vscode-remote.remote-wsl) Installez l'extension "WSL" (identifiant : ms-vscode-remote.remote-wsl)
 Depuis le terminal Ubuntu, ouvrez le projet : Depuis le terminal Ubuntu, ouvrez le projet :
 +<code>
 cd ~/rental-platform cd ~/rental-platform
 code . code .
 +</code>
 # VS Code s'ouvre sur Windows mais exécute tout dans WSL # VS Code s'ouvre sur Windows mais exécute tout dans WSL
 Le bandeau en bas à gauche de VS Code affiche "WSL: Ubuntu" — vous êtes connecté. Le bandeau en bas à gauche de VS Code affiche "WSL: Ubuntu" — vous êtes connecté.
  
-6. Configurer Git SSH dans WSL+==== 6. Configurer Git SSH dans WSL ==== 
 # Générer une clé SSH (si pas déjà fait) # Générer une clé SSH (si pas déjà fait)
 +<code>
 ssh-keygen -t ed25519 -C "sebastien.raimondi@gmail.com" ssh-keygen -t ed25519 -C "sebastien.raimondi@gmail.com"
 +</code>
  
 # Afficher la clé publique à ajouter sur GitHub # Afficher la clé publique à ajouter sur GitHub
 +<code>
 cat ~/.ssh/id_ed25519.pub cat ~/.ssh/id_ed25519.pub
 +</code>
 Ajoutez cette clé dans GitHub → Settings → SSH keys. Ajoutez cette clé dans GitHub → Settings → SSH keys.
  
-7. Démarrer le projet+==== 7. Démarrer le projet ==== 
 +<code>
 cd ~/rental-platform cd ~/rental-platform
  
 # Variables d'environnement # Variables d'environnement
 cp apps/api/.env.example apps/api/.env cp apps/api/.env.example apps/api/.env
 +</code>
 +
 +<code>
 # Éditez avec vos valeurs (DATABASE_URL, JWT_SECRET, etc.) # Éditez avec vos valeurs (DATABASE_URL, JWT_SECRET, etc.)
 +</code>
  
 +<code>
 # Démarrer Postgres et autres services # Démarrer Postgres et autres services
 docker compose up -d docker compose up -d
Ligne 120: Ligne 157:
 # Lancer tous les services en dev # Lancer tous les services en dev
 pnpm dev pnpm dev
-8. Accéder depuis le navigateur Windows+</code> 
 + 
 +==== 8. Accéder depuis le navigateur Windows ==== 
 Tout fonctionne normalement depuis Edge/Chrome sur Windows : Tout fonctionne normalement depuis Edge/Chrome sur Windows :
  
-http://localhost:3001  → admin-portal +  * http://localhost:3000  → API NestJS 
-http://localhost:3002  → platform-console +  * http://localhost:3001  → admin-portal 
-http://localhost:3005  → tenant-website +  http://localhost:3002  → platform-console 
-http://localhost:3000  → API NestJS +  http://localhost:3003  → owner-portal 
-WSL 2 expose automatiquement les ports vers Windows.+  http://localhost:3004  → guest-portal 
 +  * http://localhost:3005  → tenant-website 
 +  * WSL 2 expose automatiquement les ports vers Windows.
  
 Récapitulatif visuel Récapitulatif visuel
 +
 +<code>
 Windows Windows
 ├── Docker Desktop (moteur de conteneurs) ├── Docker Desktop (moteur de conteneurs)
Ligne 143: Ligne 187:
 ├── redis (si utilisé) ├── redis (si utilisé)
 └── autres services docker-compose └── autres services docker-compose
-Astuce finale — terminal intégré+</code> 
 + 
 +==== Astuce finale — terminal intégré ====
 Dans VS Code connecté en WSL, le terminal intégré (`Ctrl+``) ouvre directement un bash Ubuntu. Vous n'avez plus besoin d'une fenêtre séparée. Tout — git, pnpm, prisma, docker — s'exécute là, dans Linux. Dans VS Code connecté en WSL, le terminal intégré (`Ctrl+``) ouvre directement un bash Ubuntu. Vous n'avez plus besoin d'une fenêtre séparée. Tout — git, pnpm, prisma, docker — s'exécute là, dans Linux.
ujusum/x-ressources/windows-dev-platform.1782042134.txt.gz · Dernière modification : 2026/06/21 13:42 de 88.174.75.218

DokuWiki Appliance - Powered by TurnKey Linux