outils:vscode:remotessh [WEBGE Wikis]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
 [[:outils:vscode:accueilvscode|{{ :iconemaison.jpg?nolink&25|Sommaire VSCode}}]]

===== IDE VSCode - L'extension Remote SSH =====
[Mise à jour le : 26/3/2025] <color #ed1c24>En cours de rédaction</color>

{{ :outils:vscode:remotessh.icons.png?nolink&100|}}
  * **Ressources**
    * 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.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>

----

\\

==== 1. Généralité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 //**Remote-SSH**// dans le gestionnaire d'extension et la sélectionner.
{{ :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 ====