VSCode

vscode 를 사용한 ssh 사용 방법입니다.

Install VSCode

Setup 공식 문서: https://code.visualstudio.com/docs/setup/setup-overview

VSCode Download: https://code.visualstudio.com/download

VSCode 의 설치는 프로그램을 다운받은 다음 실행하면 됩니다. OS 별 자세한 설치방법은 Setup 공식 문서를 참고해 주시기 바랍니다.

Install Extension

VSCode 를 설치하였으면 ssh 를 사용하기 위한 Extension 을 추가로 설치해야합니다. 좌측 Extentions 항목(단축키: ctrl+shift+x)을 선택한 뒤, Remote Development 를 검색하여 Install 버튼을 눌러 설치해주시면 됩니다.

Remote Development Extension

Register GSDS Server

Remote Development 설치를 완료하였으면, F1 을 눌러서 Remote-SSH: Connect to Host 를 선택합니다.

그다음 Add New SSH Host 를 선택하고, 아래와 같이 ssh 명령어를 작성해주시면 됩니다.

이후 ssh 하는 정보를 저장해둘 파일을 선택해야 하는데, 각자 적절하게 선택하시면 됩니다. (config 로 끝나는 파일 중 하나 선택하시면 됩니다.)

정상적으로 추가하였다면 Remote Development 를 설치하면서 왼쪽에 추가된 Remote Explorer 를 선택하였을 때 SSH 탭에 추가한 서버가 나타나 있을 것입니다.

만약 추가한 서버를 ip 대신 특정 이름을 붙이고 싶은 경우에는 SSH 탭 오른쪽에 있는 ⚙️ 를 선택하고, 서버를 추가하는 과정에 선택한 ssh config 파일을 선택합니다. 이후 Host 옆에 있는 ip 를 특정 이름으로 바꾸면, 아래와 같이 ip 대신 해당 이름으로 표기될 것입니다.

ssh config 예시

Access Remote Server

추가한 서버를 VSCode 로 열기 위해서는 Remote Explorer 에서 추가한 서버를 선택하면 됩니다. 이후 서버에 해당하는 OS 를 선택합니다. (GSDS 서버의 경우 Ubuntu 20.04 LTS 이 설치되어 있으므로 Linux 를 선택하시면 됩니다.)

그 다음 Continue 를 선택하여 서버 등록을 마무리해 줍니다.

마지막으로 password 를 입력해주시면 서버에 접속할 수 있습니다.

간혹, 서울대 정책으로 인해 아래와 같은 창이 뜨는 경우가 있는데 이 경우 Retry 를 선택하고 다시 반복해주시면 됩니다.

다만, 아래 창이 2~3번 연속적으로 등장하면, 서버 접근에 문제가 있는 경우니 잘못된 부분이 없는지 다시 한번 확인해주시기 바랍니다.

마지막으로 왼쪽 Explorer (Ctrl+Shift+E)를 선택하고 Open Folder를 사용하여 VSCode 를 통해 열고자 하는 서버에 있는 폴더(Workspace)를 선택하시면 됩니다.

너무 많은 데이터가 저장되어 있는 폴더를 선택하여 열 경우, VSCode 에서 수 많은 IO(데이터이동)을 발생시킬 수 있습니다. 이는 서버 속도 저하의 원인이 될 수 있으므로, 꼭 필요한 데이터만 있는 폴더를 Worksapce 로 선택해주시기 바랍니다.

서버의 데이터를 열고 있는 VSCode 에서 설치된 Extension 들은 서버에 저장되고, 이러한 Extension 들은 사용자가 원치 않는 상황에서도 동작하며 서버에 부하를 줄 수 있습니다.

따라서 가능하면 Extension 들을 설치하지 않는 것을 추천드리며, 꼭 필요한 경우에는 해당 Extension 을 사용하지 않은 경우에는 꼭 비활성화를 시키기 바랍니다.