Documentation Index

Fetch the complete documentation index at: https://cli-gov.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

createCloudHadoopInstance

Prev Next

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

Cloud Hadoop 클러스터를 생성합니다.

구문

createCloudHadoopInstance 구문은 다음과 같습니다.

./ncloud vhadoop createCloudHadoopInstance \
    --vpcNo <vpc-no> \
    --edgeNodeSubnetNo <edge-node-subnet-no> \
    --masterNodeSubnetNo <master-node-subnet-no> \
    --workerNodeSubnetNo <worker-node-subnet-no> \
    --cloudHadoopClusterName <cluster-name> \
    --cloudHadoopClusterTypeCode <cluster-type-code> \
    --masterNodeDataStorageSize <master-node-storage-size> \
    --workerNodeDataStorageSize <worker-node-storage-size> \
    --bucketName <bucket-name> \
    --cloudHadoopAdminUserName <admin-user-name> \
    --cloudHadoopAdminUserPassword <admin-user-password> \
    --loginKeyName <login-key-name> \
    [--cloudHadoopImageProductCode <image-product-code>] \
    [--engineVersionCode <engine-version-code>] \
    [--cloudHadoopAddOnCodeList <add-on-code-list>] \
    [--useKdc <true|false>] \
    [--kdcRealm <kdc-realm>] \
    [--kdcPassword <kdc-password>] \
    [--useBootstrapScript <true|false>] \
    [--bootstrapScript <bootstrap-script>] \
    [--edgeNodeProductCode <edge-node-product-code>] \
    [--masterNodeProductCode <master-node-product-code>] \
    [--masterNodeDataStorageTypeCode <SSD|HDD>] \
    [--workerNodeProductCode <worker-node-product-code>] \
    [--workerNodeCount <worker-node-count>] \
    [--workerNodeDataStorageTypeCode <SSD|HDD>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

createCloudHadoopInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

createCloudHadoopInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--vpcNo String Required VPC 번호
--edgeNodeSubnetNo String Required 엣지 노드 Subnet 번호
--masterNodeSubnetNo String Required 마스터 노드 Subnet 번호
--workerNodeSubnetNo String Required 작업자 노드 Subnet 번호
--cloudHadoopClusterName String Required 클러스터 이름
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성
  • 중복 사용 불가
--cloudHadoopClusterTypeCode String Required 클러스터 타입 코드
--masterNodeDataStorageSize Integer Required 마스터 노드 스토리지 용량 (GB)
  • 100~2000 (10 GB 단위) | 4000 | 6000
--workerNodeDataStorageSize Integer Required 작업자 노드 스토리지 용량 (GB)
  • 100~2000 (10 GB 단위) | 4000 | 6000
--bucketName String Required Object Storage 버킷 이름
--cloudHadoopAdminUserName String Required 클러스터 관리자 계정 사용자 이름
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성
  • Ambari 콘솔 접속 시 필요
--cloudHadoopAdminUserPassword String Required 클러스터 관리자 계정 비밀번호
  • 영문 대문자, 숫자, 특수문자를 최소 1자씩 포함하여 9~20자 이내로 입력
  • 특수문자 ' " ₩ / & ` 및 공백 사용 불가
  • Ambari 콘솔 접속 시 필요
--loginKeyName String Required 인증키 이름
--kdcRealm String Conditional KDC Realm 정보
  • Realm 형태의 도메인 규칙만 허용
  • useKdc가 true인 경우, 필수 입력
--kdcPassword String Conditional KDC 관리자 계정 비밀번호
  • 영문 대문자, 숫자, 특수문자를 최소 1자씩 포함하여 9~20자 이내로 입력
  • 특수문자 ' " ₩ / & ` 및 공백 사용 불가
  • useKdc가 true인 경우, 필수 입력
--bootstrapScript String Conditional 부트스트랩 스크립트
  • 1~1,024 바이트
  • 버킷 내 폴더와 파일 이름 입력
  • 파일 이름은 영문만 허용하며 공백, 특수문자 사용 불가
  • 클러스터에 연동된 버킷으로만 스크립트 수행 가능
  • useBootstrapScript가 true인 경우, 필수 입력

선택 옵션

createCloudHadoopInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--cloudHadoopImageProductCode String Optional 클러스터 이미지 코드
--engineVersionCode String Optional 엔진 버전 코드
--cloudHadoopAddOnCodeList List Optional 클러스터 Add-on 컴포넌트 목록
  • 공백으로 구분하여 여러 개 입력 가능 (예시: --cloudHadoopAddOnCodeList PRESTO HBASE)
  • Cloud Hadoop 1.5 이상 버전에서 적용 가능
  • getCloudHadoopAddOnList 참조
--useKdc Boolean Optional 커버로스(Kerberos) 인증 구성의 사용 여부
  • true | false (기본값)
    • true: 사용
    • false: 사용 안 함
  • 사용할 경우, 마스터 노드에 KDC 서버 이중화 제공
--useBootstrapScript Boolean Optional 부트스트랩 스크립트 사용 여부
  • true | false (기본값)
    • true: 사용
    • false: 사용 안 함
  • 사용할 경우, 모든 노드에 스크립트 미리 실행
--edgeNodeProductCode String Optional 엣지 노드 서버 타입 코드
--masterNodeProductCode String Optional 마스터 노드 서버 타입 코드
--masterNodeDataStorageTypeCode String Optional 마스터 노드 스토리지 타입
  • cloudHadoopImageProductCode의 generationCode에 따라 기본값 상이
    • SSD (기본값) | HDD
  • 설치 이후 데이터 스토리지 타입 변경 불가
--workerNodeProductCode String Optional 작업자 노드 서버 타입 코드
--workerNodeCount Integer Optional 작업자 노드 수
  • 2~8 (기본값: 2)
--workerNodeDataStorageTypeCode String Optional 작업자 노드 스토리지 타입
  • cloudHadoopImageProductCode의 generationCode에 따라 기본값 상이
    • SSD (기본값) | HDD
  • 설치 이후 데이터 스토리지 타입 변경 불가

공통 옵션

vhadoop 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud Hadoop (VPC) 옵션을 참조해 주십시오.

예시

Cloud Hadoop 클러스터 생성 요청이 성공하면 클러스터의 구성 정보와 생성 상태가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vhadoop createCloudHadoopInstance \
    --vpcNo 12345678 \
    --edgeNodeSubnetNo 23456789 \
    --masterNodeSubnetNo 23456790 \
    --workerNodeSubnetNo 23456790 \
    --cloudHadoopClusterName cluster-01 \
    --cloudHadoopClusterTypeCode CORE_HADOOP_WITH_SPARK \
    --masterNodeDataStorageSize 100 \
    --workerNodeDataStorageSize 100 \
    --bucketName my-test-bucket \
    --cloudHadoopAdminUserName adminuser \
    --cloudHadoopAdminUserPassword Examplepw123! \
    --loginKeyName test-key \
    --cloudHadoopImageProductCode SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050 \
    --engineVersionCode HADOOP2.2 \
    --workerNodeCount 2 \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "createCloudHadoopInstanceResponse": {
    "totalRows": 1,
    "cloudHadoopInstanceList": [
      {
        "cloudHadoopInstanceNo": "34567890",
        "cloudHadoopClusterName": "cluster-01",
        "cloudHadoopInstanceStatusName": "creating",
        "cloudHadoopInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init 상태"
        },
        "cloudHadoopInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudHadoopClusterType": {
          "code": "CORE_HADOOP_WITH_SPARK",
          "codeName": "Core Hadoop with Spark : HDFS(3.1.1), YARN(3.1.1), Zookeeper(3.4.9), Ranger(2.0.0), HIVE(3.1.2), Hue(4.8.0), Zeppelin Notebook(0.11.2), Spark (2.4.8)"
        },
        "cloudHadoopVersion": {
          "code": "HADOOP2.2",
          "codeName": "Cloud Hadoop 2.2"
        },
        "cloudHadoopAddOnList": [],
        "ambariServerHost": "e-001-cluster-01-9d5z-hd",
        "clusterDirectAccessAccount": "sshuser",
        "loginKey": "test-key",
        "objectStorageBucket": "my-test-bucket",
        "cloudHadoopImageProductCode": "SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050",
        "isHa": true,
        "createDate": "2026-07-06T13:58:52+0900",
        "useDataCatalog": false,
        "accessControlGroupNoList": [],
        "cloudHadoopServerInstanceList": [
          {
            "cloudHadoopServerName": "e-001-cluster-01-9d5z-hd",
            "cloudHadoopServerRole": {
              "code": "E",
              "codeName": "Edge Node"
            },
            "cloudHadoopServerInstanceStatusName": "creating",
            "cloudHadoopServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "12345678",
            "vpcName": "vpc-01",
            "subnetNo": "23456789",
            "subnetName": "public-subnet",
            "isPublicSubnet": true,
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 17179869184,
            "createDate": "2026-07-06T13:58:52+0900"
          },
          {
            "cloudHadoopServerName": "m-001-cluster-01-9d5x-hd",
            "cloudHadoopServerRole": {
              "code": "M",
              "codeName": "Master Node"
            },
            "cloudHadoopServerInstanceStatusName": "creating",
            "cloudHadoopServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "12345678",
            "vpcName": "vpc-01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 17179869184,
            "createDate": "2026-07-06T13:58:52+0900"
          },
          {
            "cloudHadoopServerName": "m-002-cluster-01-9d5y-hd",
            "cloudHadoopServerRole": {
              "code": "M",
              "codeName": "Master Node"
            },
            "cloudHadoopServerInstanceStatusName": "creating",
            "cloudHadoopServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "12345678",
            "vpcName": "vpc-01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 17179869184,
            "createDate": "2026-07-06T13:58:52+0900"
          },
          {
            "cloudHadoopServerName": "d-001-cluster-01-9d60-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Data Node"
            },
            "cloudHadoopServerInstanceStatusName": "creating",
            "cloudHadoopServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "12345678",
            "vpcName": "vpc-01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 17179869184,
            "createDate": "2026-07-06T13:58:52+0900"
          },
          {
            "cloudHadoopServerName": "d-002-cluster-01-9d61-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Data Node"
            },
            "cloudHadoopServerInstanceStatusName": "creating",
            "cloudHadoopServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) 서버 Create OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc-01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 17179869184,
            "createDate": "2026-07-06T13:58:52+0900"
          }
        ]
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
사업자등록번호: 129-86-31394 통신판매업신고번호:제2009-경기성남-0510호
대표이사: 김유원 주소: 경기도 성남시 분당구 불정로 6 네이버 그린팩토리 17~26층, 13561 고객지원 대표전화: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.