VSCode를 이용한 서버 SSH 접속 및 원격 도커 제어하기

이전에 MobaXterm을 이용한 서버 접속 방법을 적어보았습니다.

https://mungkhs1.tistory.com/46

3. MobaXterm (Docker+Nginx_proxy+SSL+Github action)

 

이번에는 VSCode를 이용하여 직접 서버에 SSH로 접속을 하고, 서버의 도커 컨테이너, 이미지, 볼륨 등을 관리해 보도록 하겠습니다. 당연히 VSCode는 설치가 되어 있다 가정하고 시작합니다.

 

1. Remote-SSH extensions 설치

- VSCode에서 Remote-SSH extensions를 설치합니다.

 

-  화면 아래쪽에 아래와 같은 녹색 부분이 생깁니다. 이 부분을 눌러줍니다.

 

-  화면 윗부분 메뉴에서 'Open SSH Configuration File...' 을 선택합니다.

 

- 그 다음 메뉴에서 'C:\Users\****\.ssh\config'를 선택합니다.

 

-  아래 내용처럼 서버 정보(여러개의 서버 예시)를 입력하고 저장을 합니다. 단, IdentityFile 부분은 SSH 접속을 위한 개인키 파일 경로를 입력해야 하는데, 이 부분은 아랫부분에서 자세히 설명을 하도록 하겠습니다.

 

2. SSH 개인키(pem) 생성 방법

- 우선 SSH키를 생성하는 방법은 여러가지가 있으며, 여기서는 아래에 링크된 이전 게시글에서 이미 생성하여, 서버 접속시 사용하고 있는 기존 ppk 파일을 이용할 것입니다.

https://mungkhs1.tistory.com/13

오라클 클라우드 프리티어 서버 구축 작업2 (인스턴스 생성, SSH 접속)

 

- 윈도우즈용 VSCode에서 Remote-SSH를 이용하여 접속하려면 ppk 파일 형식이 아닌 pem 파일 형식을 사용해야 하며, 또한 pem 파일의 권한 부분을 수정해 주어야 사용이 가능합니다.(조금 복잡함.)

 

가. ppk 파일 => pem 파일 변경

1) PuttyGen 프로그램을 실행시킨 후 Load 버튼을 눌러 기존 사용중이던 ppk 파일을 불러옵니다.

 

2) Conversions-Export OpenSSH key 를 눌러 줍니다. 경고창은 예를 눌러줍니다.

 

'원하는 파일명.pem' 을 입력한 후 저장 버튼을 눌러줍니다.

 

이제 PuttyGen 프로그램은 닫아줍니다.

 

나. mungkhs.pem 파일의 권한 수정

- 위에서 만든 mungkhs.pem 파일을 바로 이용하면 아래와 같은 에러가 나며 접속이 되지 않습니다.

 

- 윈도우에서는 pem 파일의 권한 관련 부분 수정이 조금 복잡하네요. 아래 과정을 잘 따라하세요.

1)  mungkhs.pem 파일의 속성창을 연 후, 보안탭에서 고급을 눌러줍니다.

 

2) '상속 사용 안 함'을 누른 후 첫번째 항목을 선택합니다. 그럼 아래 점선 부분이 없음으로 변경됩니다.

 

3) 맨 앞부분의 아이콘이 한사람 모양만 빼고, 나머지 두사람 모양은 모두 제거한 후 적용, 확인을 눌러줍니다.

 

- 이제 개인키 생성이 모두 완료 되었습니다.

 

3. VSCode로 SSH 접속

가. 좌측 하단 녹색 부분을 누른 후, Connect to Host... 를 선택합니다.

 

나. 접속을 할 서버를 선택합니다.

 

다.  그럼 새 창이 열리면서 아래과 같이 나오며, Linux를 선택합니다.  (아래 화면은 처음 접속시에만 나오며,  서버에 VSCode 관련 파일들이 설치되기 때문에 시간이 다소 걸립니다.)

 

라. SSH 연결이 되면 맨아래에 접속 서버가 보이며, Explorer-Open Folder를 누른 후, 서버의 경로 선택 후 OK를 눌러주면, 서버의 디렉토리 및 파일들이 보입니다. 

 

마. 이제 서버에 있는 파일들을 아주 손쉽게 편집을 할 수 있습니다. 또한, Terminal-New Terminal 을 누르면 아랫쪽에 터미널 창이 열려 필요한 작업을 할 수 있습니다.

 

바. (참고) 서버 접속시 왼쪽 Remote Explorer을 눌러 접속할 수도 있습니다.

 

4. Remote-SSH extensions 설치

가. 아래처럼 Docker extensions을 설치합니다.

 

나. 왼쪽 도커를 눌러보면, 아래처럼 컨테이너, 이미지, 네트워크, 볼륨 등을 바로 확인할 수 있으며, 여기에서 도커와 관련한 모든 작업을 마우스 만으로 아주 손쉽게 할 수 있습니다.

 

다. 또한, Explorer 에서 docker-compose.yml 파일을 이용하여 마우스로 손쉽게 컨테이너 생성 등의 작업을 할 수 있습니다.