이 가이드는 Teleport와 Visual Studio Code의 원격 SSH 확장을 사용하는 방법을 설명합니다.

작동 방식#

Visual Studio Code Remote - SSH 확장은 로컬 SSH 클라이언트를 사용하여 원격 서버에 접근합니다. Teleport를 사용하여 로컬 SSH 클라이언트에 대한 설정을 생성할 수 있으며, 이 설정은 Teleport가 발급한 OpenSSH 인증서를 사용하여 Teleport로 보호된 Linux 서버에 연결하도록 클라이언트에게 지시합니다.

사전 요구 사항#

• A running Teleport cluster. If you want to get started with Teleport, sign up for a free trial or set up a demo environment.

• The `tsh` client.

  Installing \`tsh\` client

  1. Determine the version of your Teleport cluster. The `tsh` client must be at most one major version behind your Teleport cluster version. Send a GET request to the Proxy Service at /v1/webapi/find and use a JSON query tool to obtain your cluster version. Replace with the web address of your Teleport Proxy Service:

     $ TELEPORT_DOMAIN=
     $ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
     

  2. Follow the instructions for your platform to install `tsh` client:

• OpenSSH 클라이언트.
• Remote - SSH 확장을 위한 Remote - SSH 확장이 설치된 Visual Studio Code.
• 하나 이상의 Teleport SSH Service를 실행하는 Teleport Agent. 아직 설정하지 않은 경우, 시작하기 가이드를 읽어 설정 방법을 알아보세요.

1/3단계. 최초 설정#

Teleport 노드에 접근하도록 로컬 SSH 클라이언트를 설정하세요. 를 Teleport Proxy Service 주소로 바꾸고(Teleport Cloud 사용자의 경우 예: mytenant.teleport.sh), 를 Teleport 사용자로 바꾸세요.

# 프록시에 로그인:
$ tsh login --proxy  --user 

# 프록시에 대한 OpenSSH 설정 생성:
$ tsh config --proxy 

결과로 나온 설정 스니펫을 아래 경로에 있는 SSH 설정 파일에 추가하세요:

$ tsh.exe config | out-file .ssh\config -encoding utf8 -append

를 노드에서 사용하려는 사용자명으로 바꾸고 를 노드 이름으로 바꾸어 다음 명령으로 원하는 노드에 연결할 수 있어야 합니다:

$ ssh @.

alice@proxy.foo.example.com: Permission denied (publickey).
ERROR: exit status 255

kex_exchange_identification: Connection closed by remote host

2/3단계. Visual Studio Code 설정#

로컬 VS Code 인스턴스에 Remote - SSH 확장을 설치하세요. VS Code 창 왼쪽 하단에 새로운 "Window Indicator"(두 개의 화살표 아이콘)가 나타납니다.

호스트에 연결하기 전에 확장 설정에서 Remote.SSH: Use Local Server 설정을 false로 설정하세요. 플러그인별 설정을 찾으려면 @ext:ms-vscode-remote.remote-ssh 를 검색할 수 있습니다.

연결하려면 두 개의 화살표 아이콘을 클릭하고 "Connect to Host..."를 선택하세요. "+ Add New SSH Host..."를 선택하세요.

원격으로 개발하려는 각 호스트에 대해 다음과 같은 항목을 추가하세요:

alice@node000.foo.example.com

업데이트할 SSH 설정 파일을 선택하라는 메시지가 표시되면 1단계에서 생성한 파일을 선택하세요.

이렇게 하면 SSH 설정 파일에 새 노드가 작성됩니다. 이 파일에서 모든 노드를 편집하고 관리할 수 있습니다.

3/3단계. 원격 개발 세션 시작#

다음 방법 중 하나로 원격 개발 세션을 시작하세요:

1. 새 호스트를 추가한 후 열리는 알림에서 "Connect"를 클릭하세요.

2. Window Indicator를 다시 클릭하고 "Connect to Host"를 선택하세요. 드롭다운에서 방금 추가한 호스트와 설정 파일의 다른 호스트들을 볼 수 있습니다.

처음 연결 시 원격 OS를 설정하라는 메시지가 표시됩니다. 적절한 플랫폼을 선택하면 VS Code가 서버측 컴포넌트를 설치합니다. 완료되면 작동하는 편집기가 표시됩니다:

왼쪽 하단의 Window Indicator는 현재 연결된 원격 호스트를 강조 표시합니다.

다음 단계#

OpenSSH 호스트에 연결#

호스트 OS가 VS Code에서 지원되는 한 Teleport 클러스터에 연결된 모든 OpenSSH 호스트에서 원격으로 개발할 수 있습니다. OpenSSH 가이드를 참조하여 Teleport 인증서를 통해 원격 호스트가 인증하도록 설정하세요. 그 후 위에 설명된 절차를 사용하여 VS Code에서 호스트에 연결할 수 있습니다.

OpenSSH 클라이언트 사용#

이 가이드는 tsh config를 사용합니다. 추가 정보는 전용 가이드를 참조하세요.

추가 읽기 자료#

• VS Code 원격 개발