VS Code를 사용한 라즈베리파이 접속

개요

Visual Studio Code(이하, VSCode)에서 제공하는 확장팩을 사용하면 원격 머신(Remote Machine)에 SSH로 연결하여 로컬 환경과 동일하게 소프트웨어를 개발할 수 있습니다.

이번 포스트는 VSCode를 이용하여 라즈베리파이에 연결해 보도록 하겠습니다.

사전작업

1. VSCode를 설치하는 PC의 운영체제가 Windows 10 이하 (ex. Windows 7)인 경우 SSH 클라이언트를 위한 Git for Windows를 설치합니다.

2. Visual Studio Code를 설치합니다.

3. Remote Development extension pack을 설치합니다.

 

작업

1. VSCode 우측의 원격 탐색기를 선택합니다.

2. SSH Target을 추가합니다.

   

   SSH Target 추가

3. SSH 접속 명령어를 입력합니다.

   ssh -p1234 pi@192.168.0.3

   

   SSH 명령 입력

4. 설정을 저장할 파일을 선택하라는 안내에서 파일의 경로가 영문으로 구성되어 있는지 확인합니다. 제 경우는 두 번째 선택지인 C:\ProgramData\ssh\ssh_config를 선택하였습니다.
   ※ windows7의 경우 파일이 없다는 오류가 나올 것이므로 해당 경로에 빈 파일을 미리 만들어 놓습니다.

5. 해당 파일을 열고 다시 한번 편집합니다.
   Host 항목에 적혀 있는 IP값(192.168.0.3)대신 rasp와 같은 영문자로 이루어진 이름으로 교체합니다.

   Host rasp
     HostName 192.168.0.3
     Port 1234
     User pi

6. VSCode를 재시작 (매우 중요합니다.)

7. 추가한 원격서버(rasp)를 선택하여 접속합니다.

사용자 암호대신 SSH키를 사용하여 연결하기

SSH키를 생성한 후, SSH 접속설정(config)에 IdentityFile항목을 추가합니다.

Host rasp
  HostName 192.168.0.3
  Port 1234
  User pi
  IdentityFile ~\.ssh\id_rsa

오류 해결

라즈베리파이에 VSCode를 사용하여 연결하고자 할 때, 오류가 발생하며 연결이 되지 않습니다.

open failed: administratively prohibited: open failed

이 경우 다음 순서에 따라 라즈베리파이의 sshd config를 수정합니다.

1. 라즈베리파이의 /etc/ssh/sshd_config 파일을 텍스트 편집기(예를 들어 vim)로 엽니다.

   $ sudo vim /etc/ssh/sshd_config

2. AllowTcpForwarding 항목을 찾아 no를 yes로 수정합니다.

3. 라즈베리파이를 재부팅합니다.

   $ sudo reboot

4. VSCode Remote-SSH를 이용하여 다시 연결해 봅니다.

참고

• Remote Development Tips and Tricks