SSH로 클러스터 노드 접속

VPC 환경에서 이용 가능합니다.

네이버 클라우드 플랫폼의 Cloud Hadoop 콘솔 또는 Web UI(Ambari, Hue 등)로 관리 작업 또는 애플리케이션을 제출할 수 있습니다. 그러나 직접 클라이언트를 실행하려면 SSH 방식으로 클러스터 노드에 접속해야 합니다.

사전 작업

클러스터 노드에 접속하기 위해서는 먼저 다음과 같은 작업과 준비가 필요합니다.

1. SSL VPN 설정

외부에서 네이버 클라우드 플랫폼 내부에 구성된 네트워크로 보안 접속하려면 SSL VPN이 설정되어 있어야 합니다.
다음 순서에 따라 SSL VPN 생성 및 설정해 주십시오.

a. SSL VPN 생성

1. 네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
2. Platform 메뉴의 VPC을 클릭하여 VPC 환경으로 변경해 주십시오.
3. Services > Security > SSL VPN 메뉴를 차례대로 클릭해 주십시오.
4. [SSL VPN 생성] 버튼을 클릭한 후 VPN을 생성해 주십시오.
   • 상태가 운영중으로 바뀌면 생성이 완료된 것입니다.
     
5. SSL VPN 생성 완료 시 발송되는 이메일에서 VPN 접속 경로를 확인해 주십시오.
   • SSL VPN 접속 경로를 Subnet의 Route Table에 추가해야합니다. 반드시 메일을 확인해 주십시오.
     
6. 다음과 같이 운영 중인 SSL VPN을 선택하고 [사용자 설정] 버튼을 클릭해 주십시오.
   
7. 사용자 설정 창에 SSL VPN 사용자 정보를 추가한 후 [적용] 버튼을 클릭해 주십시오. 향후 VPN에 접속할 때마다 사용자가 입력한 Email과 SMS로 OTP 인증 번호를 받게 됩니다.
   

b. Subnet의 Route Table에 VPN 대역 추가

Subnet의 Route Table에 VPN 대역을 추가하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Networking > VPC > Route Table 메뉴를 차례대로 클릭해 주십시오.
   • 생성한 Cloud Hadoop의 Subnet마다 Route Table이 생성된것을 확인할 수 있습니다.
2. 접속하려는 Route Table을 선택한 후 [Routes 설정] 버튼을 클릭해 주십시오.
   
3. 다음 세 가지 정보를 입력하고 Table Entry를 생성해 주십시오.
   • Destination: SSL VPN의 IP Pool
   • Target Type: SSL VPN
   • Target Name: 위에서 생성한 SSL VPN
     
4. 다른 Route Table에도 동일한 방법으로 진행해 주십시오.

c. SSL VPN 클라이언트 다운로드

생성한 SSL VPN을 이용해 Cloud Hadoop 클러스터에 접속하려면 클라이언트 프로그램을 설치해야 합니다.

SSL VPN 클라이언트를 다운로드하고 설치하는 방법은 다음과 같습니다.

1. SSL VPN 다운로드에서 SSL VPN Agent를 다운로드해 주십시오.
2. 압축을 풀고, mac OS의 경우 .dmg 파일을, Windows의 경우 .zip 파일을 사용하여 클라이언트를 설치해 주십시오.

설치가 완료되면 아래와 같은 애플리케이션을 확인할 수 있습니다.

d. SSL VPN 클라이언트 실행 및 접속

설치한 SSL VPN 클라이언트 실행 후, VPN 생성 시 선택한 VPC로 접속하는 방법은 다음과 같습니다.

1. 설치한 SSL VPN 클라이언트를 실행해 주십시오.
2. [VPN 추가] 버튼을 클릭한 후, VPN 관리 > [추가] 버튼을 클릭하여 주십시오.
3. 도메인과 아이디, 비밀번호를 입력한 후 [다음] 버튼을 클릭해 주십시오.
   • 도메인: VPN 생성 시 이메일로 전달받은 SSL VPN 경로
   • 아이디: SSL VPN 사용자 설정 시 지정한 Username
   • 비밀번호: SSL VPN 사용자 설정 시 지정한 Password
     
4. OPT 입력창에 SMS 및 이메일로 전송된 OTP 번호를 입력한 후, [추가] 버튼을 클릭해 주십시오.
5. VPN 추가 창에서 VPN 이름을 입력한 후, [완료] 버튼을 클릭해 주십시오.
6. 왼쪽 상단의 버튼을 클릭하거나 오른쪽 상단의 버튼을 클릭한 후, [홈] 을 클릭해 주십시오.

OTP 인증이 완료되면 SSL VPN을 통해서 VPN을 만들때 선택한 VPC로 접근할 수 있습니다. 동일한 VPC/Subnet에 접근한다면, a~e 단계는 최초 한 번만 필요합니다.

2. 고정 IP를 ACG에 추가

클러스터 ACG에 고정 IP를 추가하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > Compute > Server > ACG 메뉴를 차례대로 클릭해 주십시오.
2. 접근하려는 클러스터의 ACG를 선택한 후 [ACG 설정] 버튼을 클릭해 주십시오.
3. 다음 네 가지 정보를 입력하고 ACG Rule을 추가해 주십시오.
   • 프로토콜: TCP
   • 접근 소스: SSH 통신을 하는 로컬 장비의 IP
   • 허용 포트: 22
   • 메모(선택)

mac OS 환경 SSH 접속

iTerm2를 이용한 접속 방법을 설명합니다. 다른 프로그램을 사용해도 같은 동작을 수행한다면 결과는 동일합니다.

chmod 400 </path/to/pem-key>
ssh -i </path/to/pem-key>  sshuser@<cluster-domain>

Host *
    PubkeyAcceptedKeyTypes +ssh-rsa

Windows 환경 SSH 접속

PuTTY 클라이언트를 이용한 접속 방법을 설명합니다. 다른 프로그램을 사용해도 같은 동작을 수행한다면 결과는 동일합니다.

다음 단계를 차례대로 진행해 주십시오.

• 1. 인증키(pem) 변환
• 2. 클러스터 노드 접속

1. 인증키(.pem) 변환

PuTTY에서는 Cloud Hadoop에서 생성된 프라이빗 키 형식(.pem)을 기본적으로 지원하지 않습니다. PuTTY에서 제공하는 PuTTYgen 애플리케이션을 사용하여, 인증키(.pem)를 PuTTY에서 사용하는 형식(.ppk)으로 변환할 수 있습니다. PuTTY를 사용하여 엣지 노드에 연결하기 전에 프라이빗 키를 .ppk 형식으로 변환해야 합니다.

1. PuTTYgen을 실행해 주십시오. (puttygen 다운로드)
2. Type of key to generate에서 RSA를 선택하고 [Load] 버튼을 클릭해 주십시오.
3. 해당 인증키(*.pem)를 선택한 후 [열기] 버튼을 클릭해 주십시오.
   • pem 형식의 파일을 찾으려면 모든 유형의 파일을 표시하는 옵션을 선택해 주십시오.
   • pem 파일은 현재 클러스터에 적용되어 있는 인증키의 파일명이며 사용자 로컬 PC에 해당 pem 파일이 저장되어 있어야 합니다.
   • pem 파일을 분실했을 경우 콘솔 > 서버 접속 관리 > 클러스터 직접 접속 인증키 관리 메뉴에서 접속하는 인증키를 변경할 수 있습니다. (클러스터 직접 접속 인증키 관리 참고)
4. 완료 확인 팝업창의 내용을 확인한 후 [확인] 버튼을 클릭해 주십시오.
5. [Save private key] 버튼을 클릭한 후 PuTTY에서 사용할 수 있는 ppk 형식의 파일로 저장해 주십시오.
   • PuTTYgen에서 암호 없이 키 저장에 대한 경고가 표시되면 [Yes] 버튼을 클릭해 주십시오.
   • 기존 생성한 인증키와 동일한 이름으로 저장해 주십시오. PuTTY가 자동으로 .ppk 파일 확장자를 추가합니다.

2. 클러스터 노드 접속

1. PuTTY를 실행해 주십시오. (PuTTY 다운로드)
2. Category 창에서 Session을 선택한 후 각 설정 항목에 아래와 같이 입력하십시오.
   • HostName(or IP address): sshuser@DNS (sshuser@DNS 중 DNS에는 해당 클러스터의 도메인 주소를 입력)
   • Port: 22
3. Category 창에서 Connection > SSH > Auth > Credentials를 선택해 주십시오.
4. Private key file for authentication에서 [Browse] 버튼을 클릭해 pem 파일을 변환하여 생성한 ppk 파일을 선택한 후 [Open] 버튼을 클릭해 주십시오.
5. 다음과 같이 엣지 노드에 정상적으로 접속되었는지 확인해 주십시오.