Différences

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

--- outils:vscode:remotessh [2025/03/26 07:59] – phil
+++ outils:vscode:remotessh [2025/03/27 07:11] (Version actuelle) – [IDE VSCode - L'extension Remote SSH] phil
@@ Ligne 2: / Ligne 2: @@
 ===== IDE VSCode - L'extension Remote SSH =====
-[Mise à jour le : 26/3/2025]
+[Mise à jour le : 26/3/2025] <color #ed1c24>En cours de rédaction</color>
 {{ :outils:vscode:remotessh.icons.png?nolink&100|}}
   * **Ressources**
-    * Documentation sur <html><a href="https://docs.platformio.org/en/latest/what-is-platformio.html" target="_blank">PlatformIO.org</a></html>
+    * Documentation sur VSCode : <html><a href="https://code.visualstudio.com/docs/remote/ssh" target="_blank">Développement à distance via SSH</a></html>
   * **Lectures connexes**
-    * <html><a href="https://www.youtube.com/watch?v=_el8cUKFpJo" target="_blank">Vidéo - VSCode et platformIO</a></html>
+    * <html><a href="https://www.cloudflare.com/fr-fr/learning/access-management/what-is-ssh/#:~:text=Le%20protocole%20Secure%20Shell%20(SSH)%20est%20une%20m%C3%A9thode%20permettant%20d,les%20connexions%20entre%20les%20appareils." target="_blank">Qu'est-ce que SSH ? | Le protocole Secure Shell (SSH)</a></html>
-    * <html><a href="https://randomnerdtutorials.com/vs-code-platformio-ide-esp32-esp8266-arduino/" target="_blank">Premiers pas avec VS Code et PlatformIO IDE pour ESP32 et ESP8266</a></html>
-    * <html><a href="https://dev.to/frankleonrose/minimal-freertos-with-platformio-2aca" target="_blank">Minimal FreeRTOS with Platformio</a></html>
+----
+\\
 ==== 1. Généralités ====
-PlatformIO est un outil professionnel multi-plateforme, multi-architecture et multi-framework destiné aux ingénieurs en systèmes embarqués et aux développeurs de logiciels qui écrivent des applications pour des produits embarqués.
+L' extension Visual Studio Code **Remote - SSH** permet d'ouvrir un dossier distant sur n'importe quelle machine disposant d'un serveur **SSH** et de profiter pleinement des fonctionnalités de VS Code. Une fois connecté à un serveur, il est possible d'interagir avec les fichiers et les dossiers de la machine distante.
+{{ :outils:vscode:architecture-ssh.png?nolink |}}
 ==== 2. Installer l'extension dans VSCode ====
   - Ouvrir **VSCode**.
-  - Entrer //**PlatformIO**// dans le gestionnaire d'extension et la sélectionner.
+  - Entrer //**Remote-SSH**// dans le gestionnaire d'extension et la sélectionner.
-{{ :outils:vscode:platformio11.png?nolink |}}
+{{ :outils:vscode:extremotessh.png?nolink |}}
+\\
+==== 3. Configuration de l'hôte SSH pour un Raspberry pi ====
+=== 3.1 Se connecter à l'hôte distant ===
+**Première connexion** \\
+  - Vérifiez que vous pouvez vous connecter à l'hôte SSH en exécutant la commande suivante dans un terminal.<code bash *.bash>
+ssh user@hostname # user est le nom de l'utilisateur et hostname l'IP de la machine
+</code>
+  - Dans VS Code, sélectionnez **Remote-SSH : Se connecter à l’hôte...** dans la palette de commandes (F1) et entrez le même user@hostname. \\ {{ :outils:vscode:rssh1.png?nolink |}} \\
+  - Si VS Code ne peut pas détecter automatiquement le type de serveur auquel vous vous connectez, il vous sera demandé de le sélectionner manuellement. \\ \\ Sélectionnez **Linux** pour un **Raspberry Pi**. \\  {{ :outils:vscode:rssh2.png?nolink |}} \\
+  - Une fois que vous avez sélectionné une plateforme, elle sera stockée dans les paramètres VS Code sous la propriété //remote.SSH.remotePlatform//.\\ ** Confirmez** la demande de connexion. \\  {{ :outils:vscode:rssh3.png?nolink |}} \\ et entrez le mot de passe de votre compte sur la machine (ici le raspberry pi). \\ {{ :outils:vscode:rssh4.png?nolink |}} \\ Résultat attendu {{ :outils:vscode:rssh5.png?nolink |}} \\
+  - Une fois connecté, une fenêtre vide s'affichera. Vous pouvez consulter la barre d'état pour savoir à quel hôte vous êtes connecté. \\ //Exemple// \\ {{ :outils:vscode:rssh6.png?nolink |}}
+  - Vous pouvez ensuite ouvrir n'importe quel dossier ou espace de travail sur la machine distante en utilisant **Fichier > Ouvrir le dossier...** comme vous le feriez localement! \\ \\ //Exemple // : pour accéder au code d'un site web situé dans un dossier //sitele// sur un **Raspberry pi** on entrera /var/www/html/sitele. \\ {{ :outils:vscode:rssh7.png?nolink |}} \\
+  - Une fois chargé, le dossier apparaît dans l'espace de travail. \\{{ :outils:vscode:rssh8.png?nolink |}} \\
+  - À partir de là, les extensions doivent s'installer pour être utilisables sur la machine distante et vous pouvez commencer à éditer !
+\\
+=== 3.2 Se déconnecter ====
+Pour fermer la connexion une fois les fichiers modifiés sur l'hôte distant terminés, sélectionnez **Fichier > Fermer la connexion distante** pour vous déconnecter de l'hôte.
+\\
+==== 4. Mémoriser les hôtes et les paramètres avancés ====
+\\
+==== 5. Gestion des extensions ====