VS Code를 샌드박스에 연결

VS Code를 샌드박스에 연결 (Connect VS Code to a sandbox)

Remote - SSH 확장으로 샌드박스 안에서 실행되는 VS Code 창을 여는 방법을 알아볼게요.

출처: 문서

본문

이 연결 지침은 로컬 샌드박스를 사용해요. 클라우드 SSH 설정은 SSH로 연결을 참고하세요.

Remote - SSH 확장을 사용해 샌드박스 안에서 실행되는 VS Code 창을 여세요. 에디터는 호스트에 남아 있고, 파일, 터미널, 확장은 격리된 샌드박스에서 실행돼요.

사전 요구 사항 (Prerequisites)

SSH 접근이 설정되어 있어야 해요. 에디터 및 앱 통합을 참고하세요.
Remote - SSH 확장(ms-vscode-remote.remote-ssh)이 VS Code에 설치되어 있어야 해요.

연결 (Connect)

터미널에서 샌드박스에 연결할 수 있는지 확인하세요:

$ ssh demo.sbx

VS Code에서 명령 팔레트를 열고 **Remote-SSH: Connect to Host...**를 실행하세요. demo.sbx 같은 샌드박스 호스트네임을 수동으로 입력하세요. VS Code가 연결되면 원격 폴더 선택기로 마운트된 워크스페이스를 선택하세요.

더 많은 연결 옵션은 VS Code의 원격 호스트 연결 지침을 참고하세요.

참고 사항 (Notes)

첫 연결은 샌드박스 안에 VS Code 서버를 설치하므로 시간이 조금 걸릴 수 있어요. 이후 연결은 더 빨라요.

macOS에서 재연결 루프

영향을 받는 VS Code 버전은 macOS에서 무한 재연결 루프에 빠질 수 있어요. 이런 경우 VS Code 사용자 설정에서 remote.SSH.useLocalServer를 false로 설정하세요:

{
  "remote.SSH.useLocalServer": false
}

자세한 내용은 microsoft/vscode-remote-release#11672를 참고하세요.

SSH 호스트 키 검증 실패

SSH 호스트를 추가한 후 VS Code가 SSH 구성에 중복되거나 잘못된 Host *.sbx 블록을 남길 수 있어요. VS Code 연결이 KnownHostsCommand 오류 또는 Host key verification failed를 보고하면, 마커 주석을 포함해 docker sandboxes (managed)로 표시된 SSH 구성 블록을 모두 제거하세요:

-# >>> docker sandboxes (managed) >>>
-Host *.sbx
-    User _default_user_
-    ProxyCommand "sbx" ssh proxy %n
-    ...
-    UserKnownHostsFile "~/.ssh/sbx_known_hosts"
-    KnownHostsCommand "sbx" ssh known-hosts %H
-    StrictHostKeyChecking yes
-# <<< docker sandboxes (managed) <<<

그런 다음 관리 블록을 다시 생성하세요:

$ sbx setup ssh

VS Code에서 샌드박스에 다시 연결하세요.

에디터 및 앱 통합 — SSH 접근이 동작하는 방식과 설정 방법

VS Code를 샌드박스에 연결