[Mise à jour le : 26/3/2025]

• Ressources
  • Documentation sur VSCode : Développement à distance via SSH

• Lectures connexes
  • Qu'est-ce que SSH ? | Le protocole Secure Shell (SSH)

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.

1. Ouvrir VSCode.
2. Entrer Remote-SSH dans le gestionnaire d'extension et la sélectionner.

Pour vous connecter à un hôte distant pour la première fois, procédez comme suit :

1. Vérifiez que vous pouvez vous connecter à l'hôte SSH en exécutant la commande suivante à partir d'un terminal / d'une fenêtre PowerShell en remplaçant user@hostnameselon le cas.

   *.bash

   ssh user@hostname
   # Or for Windows when using a domain / AAD account
   ssh user@domain@hostname

2. Dans VS Code, sélectionnez Remote-SSH : Se connecter à l’hôte… dans la palette de commandes ( F1 , Ctrl+Maj+P ) et utilisez la même chose user@hostnamequ’à l’étape 1.
   
   
3. Si VS Code ne peut pas détecter automatiquement le type de serveur auquel vous vous connectez, il vous sera demandé de sélectionner le type manuellement. Sélectionnez Linux pour un Raspberry Pi.
   
   
4. 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.
   
   et entrez le mot de passe de votre compte sur la machine (ici le raspberry pi).
   
   Résultat attendu
   
5. 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
   
6. 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 un site web situé un dossier sitele sur un Raspberry pi on entrera /var/www/html/sitele.
   
   
7. Une fois chargé, le dossier apparaît dans l'espace de travail. \\
   
8. À partir de là, installez toutes les extensions que vous souhaitez utiliser lorsque vous êtes connecté à l'hôte et commencez à éditer !

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.