--- title: "SSH로 클러스터 노드 접속" slug: "hadoop-chadoop-3-2" updated: 2026-10-22T09:13:22Z published: 2026-10-22T09:13:22Z canonical: "guide-gov.ncloud-docs.com/hadoop-chadoop-3-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # SSH로 클러스터 노드 접속 Classic 환경에서 이용 가능합니다. 네이버 클라우드 플랫폼의 Cloud Hadoop 콘솔 또는 Web UI(Ambari, Hue 등)로 관리 작업 또는 애플리케이션을 제출할 수 있습니다. 그러나 직접 클라이언트를 실행하려면 SSH 방식으로 클러스터 노드에 접속해야 합니다. 참고 클러스터의 Public 도메인으로 SSH 접속하면 클러스터의 엣지 노드로 접속하게 됩니다. 그 외의 다른 노드는 엣지 노드에서 SSH로 접속할 수 있습니다. ## 사전 작업 클러스터 노드에 접속하기 위해서는 먼저 다음과 같은 작업과 준비가 필요합니다. | 항목 | 설명 | 가이드 | | --- | --- | --- | | ACG 설정 | 해당 클러스터의 ACG 설정에 접속하려는 장비의 IP 및 22번 포트 추가 접근 소스: 사용자의 고정IP (**[myIp]** 버튼을 클릭해 입력 가능) | [방화벽 설정(ACG)](/docs/compute-compute-2-3) | | 인증키 | 해당 클러스터 접속에 필요한 프라이빗 키(.pem) | [클러스터 직접 접속 인증키 관리](/docs/hadoop-chadoop-3-1#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%A7%81%EC%A0%91%EC%A0%91%EC%86%8D%EC%9D%B8%EC%A6%9D%ED%82%A4%EB%B3%80%EA%B2%BD) | | Public 도메인 | 해당 클러스터 노드 접속에 필요한 Public 도메인 주소 클러스터 상세 정보의 **Public 도메인** 항목에서 확인 가능 | [클러스터 상세 정보 확인](/docs/hadoop-chadoop-3-1#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0-%EC%83%81%EC%84%B8-%EC%A0%95%EB%B3%B4-%ED%99%95%EC%9D%B8) | | 공인 IP | 해당 클러스터 노드 접속에 필요한 공인 IP 클러스터 상세 정보의 **공인 IP** 항목에서 확인 가능 | [클러스터 상세 정보 확인](/docs/hadoop-chadoop-3-1#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0-%EC%83%81%EC%84%B8-%EC%A0%95%EB%B3%B4-%ED%99%95%EC%9D%B8) | ## 공인 IP를 ACG에 추가 클러스터 ACG에 고정 IP를 추가하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔의 Classic 환경에서 **Menu** > **All Services** > **Compute** > **Server** > **ACG** 메뉴를 차례대로 클릭해 주십시오. 2. 접근하려는 클러스터의 ACG를 선택한 후 **[ACG 설정]** 버튼을 클릭해 주십시오. 3. 다음 네 가지 정보를 입력하고 ACG Rule을 추가해 주십시오. - 프로토콜: TCP - 접근 소스: SSH통신을 하는 로컬 장비의 IP - 허용 포트: 22 - 메모(선택) ![chadoop-2-1-117_ko.png](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/chadoop-2-1-117_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T12%3A50%3A24Z&se=2026-10-29T13%3A50%3A24Z&sr=c&sp=r&sig=ZFVOSpGwaELpm0D%2BpaDo1niSx3W6uBEz3wfxDWWtzUY%3D) ## mac OS 환경 SSH 접속 iTerm2를 이용한 접속 방법을 설명합니다. 다른 프로그램을 사용해도 같은 동작을 수행한다면 결과는 동일합니다. ``` chmod 400 ssh -i sshuser@ ``` ## Windows 환경 SSH 접속 PuTTY 클라이언트를 이용한 접속 방법을 설명합니다. 다른 프로그램을 사용해도 같은 동작을 수행한다면 결과는 동일합니다. 다음 단계를 차례대로 진행해 주십시오. - [1. 인증키(pem) 변환](/docs/hadoop-chadoop-3-2#1%EC%9D%B8%EC%A6%9D%ED%82%A4pem%EB%B3%80%ED%99%98) - [2. 클러스터 노드 접속](/docs/hadoop-chadoop-3-2#2%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EB%85%B8%EB%93%9C%EC%A0%91%EC%86%8D) ### 1. 인증키(pem) 변환 PuTTY에서는 Cloud Hadoop에서 생성된 프라이빗 키 형식(.pem)을 기본적으로 지원하지 않습니다. PuTTY에서 제공하는 PuTTYgen 애플리케이션을 사용해 인증키를 PuTTY에서 사용하는 형식(.ppk)으로 변환할 수 있습니다. PuTTY를 사용하여 마스터 노드에 연결하기 전에 프라이빗 키를 이 형식(.ppk)으로 변환해야 합니다. 1. PuTTYgen을 실행해 주십시오. ([puttygen 다운로드](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)) 2. **Type of key to generate**에서 **RSA**를 선택하고 **[Load]** 버튼을 클릭해 주십시오. 3. 해당 인증키(*.pem)를 선택한 후 **[열기]** 버튼을 클릭해 주십시오. - pem 형식의 파일을 찾으려면 모든 유형의 파일을 표시하는 옵션을 선택해 주십시오. - pem 파일은 현재 클러스터에 적용되어 있는 인증키의 파일명이며 사용자 로컬 PC에 해당 pem 파일이 저장되어 있어야 합니다. - pem 파일을 분실했을 경우 **콘솔 > 서버 접속 관리 > 클러스터 직접 접속 인증키 관리** 메뉴에서 접속하는 인증키를 변경할 수 있습니다. ([클러스터 직접 접속 인증키 관리](/docs/hadoop-chadoop-3-1#%ED%81%B4%EB%9F%AC%EC%8A%A4%ED%84%B0%EC%A7%81%EC%A0%91%EC%A0%91%EC%86%8D%EC%9D%B8%EC%A6%9D%ED%82%A4%EB%B3%80%EA%B2%BD) 참고) 4. 완료 확인 팝업창의 내용을 확인한 후 **[확인]** 버튼을 클릭해 주십시오. 5. **[Save private key]** 버튼을 클릭한 후 PuTTY에서 사용할 수 있는 ppk 형식의 파일로 저장해 주십시오. - PuTTYgen에서 암호 없이 키 저장에 대한 경고가 표시되면 **[Yes]** 버튼을 클릭해 주십시오. - 기존 생성한 인증키와 동일한 이름으로 저장해 주십시오. PuTTY가 자동으로 .ppk 파일 확장자를 추가합니다. ### 2. 클러스터 노드 접속 1. PuTTY를 실행해 주십시오. ([PuTTY 다운로드](http://www.putty.org/)) 2. **Category** 창에서 **Session**을 선택한 후 각 설정 항목에 아래와 같이 입력해 주십시오. - **Host Name (or IP address)**: `sshuser@DNS` (`sshuser@DNS` 중 `DNS`에는 해당 클러스터의 공인 IP를 입력) - **Port**: `22` 3. **Category** 창에서 **Connection > SSH**를 선택해 확장한 후 **Auth** 항목을 클릭해 주십시오. 4. **[Browse]** 버튼을 클릭해 pem 파일을 변환하여 생성한 ppk 파일을 선택한 후 **[Open]** 버튼을 클릭해 주십시오. 5. 다음과 같이 엣지 노드에 정상적으로 접속되었는지 확인해 주십시오. ![chadoop-2-1-116_ko.png](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/chadoop-2-1-116_ko.png?sv=2026-02-06&spr=https&st=2026-10-29T12%3A50%3A24Z&se=2026-10-29T13%3A50%3A24Z&sr=c&sp=r&sig=ZFVOSpGwaELpm0D%2BpaDo1niSx3W6uBEz3wfxDWWtzUY%3D) 참고 **Ambari UI > Hosts** 메뉴에서 각 노드의 Private IP와 호스트명을 확인할 수 있습니다. Ambari UI에 접속하는 방법은 [Ambari UI](/docs/hadoop-chadoop-3-4#ambari-ui-%EC%A0%91%EC%86%8D) 가이드를 참고해 주십시오. - 엣지 노드에 접속한 후 `ssh {마스터 노드 호스트명}` 또는 `ssh {마스터 노드 Private IP}` 를 입력하여 마스터 노드(e.g. m-001, m-002)에 접속할 수 있습니다. ![chadoop-2-1-node.png](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/chadoop-2-1-node.png?sv=2026-02-06&spr=https&st=2026-10-29T12%3A50%3A24Z&se=2026-10-29T13%3A50%3A24Z&sr=c&sp=r&sig=ZFVOSpGwaELpm0D%2BpaDo1niSx3W6uBEz3wfxDWWtzUY%3D) - 데이터 노드(e.g. dn-001, dn-002)도 마스터 노드와 동일한 방법으로 접속할 수 있습니다. 엣지 노드에 접속한 후 `ssh {데이터 노드 호스트명}` 또는 `ssh {데이터 노드 Private IP}`로 접속해 주십시오. ![chadoop-2-1-node2.png](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/chadoop-2-1-node2.png?sv=2026-02-06&spr=https&st=2026-10-29T12%3A50%3A24Z&se=2026-10-29T13%3A50%3A24Z&sr=c&sp=r&sig=ZFVOSpGwaELpm0D%2BpaDo1niSx3W6uBEz3wfxDWWtzUY%3D)