--- title: "createCloudHadoopInstance" slug: "cli-vhadoop-createcloudhadoopinstance" tags: ["Cloud Hadoop", "VPC"] updated: 2026-09-17T09:15:56Z published: 2026-09-17T09:15:56Z canonical: "cli.ncloud-docs.com/cli-vhadoop-createcloudhadoopinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createCloudHadoopInstance VPC 환경에서 이용 가능합니다. Cloud Hadoop 클러스터를 생성합니다. ## 구문 `createCloudHadoopInstance` 구문은 다음과 같습니다. ``` ./ncloud vhadoop createCloudHadoopInstance \ --vpcNo \ --edgeNodeSubnetNo \ --masterNodeSubnetNo \ --workerNodeSubnetNo \ --cloudHadoopClusterName \ --cloudHadoopClusterTypeCode \ --masterNodeDataStorageSize \ --workerNodeDataStorageSize \ --bucketName \ --cloudHadoopAdminUserName \ --cloudHadoopAdminUserPassword \ --loginKeyName \ [--cloudHadoopImageProductCode ] \ [--engineVersionCode ] \ [--cloudHadoopAddOnCodeList ] \ [--useDataCatalog ] \ [--useKdc ] \ [--kdcRealm ] \ [--kdcPassword ] \ [--useBootstrapScript ] \ [--bootstrapScript ] \ [--edgeNodeProductCode ] \ [--masterNodeProductCode ] \ [--masterNodeDataStorageTypeCode ] \ [--workerNodeProductCode ] \ [--workerNodeCount ] \ [--workerNodeDataStorageTypeCode ] \ [--regionCode ] \ [--output ] ``` ## 옵션 `createCloudHadoopInstance` 실행 시 지정할 수 있는 옵션을 설명합니다. ### 필수 옵션 `createCloudHadoopInstance`의 필수 옵션입니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | VPC 번호 - [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 참조 | | `--edgeNodeSubnetNo` | String | Required | 엣지 노드 Subnet 번호 - [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조 | | `--masterNodeSubnetNo` | String | Required | 마스터 노드 Subnet 번호 - [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조 | | `--workerNodeSubnetNo` | String | Required | 작업자 노드 Subnet 번호 - [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 참조 - Private Subnet에만 배치 가능 | | `--cloudHadoopClusterName` | String | Required | 클러스터 이름 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~15자 이내로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 중복 사용 불가 | | `--cloudHadoopClusterTypeCode` | String | Required | 클러스터 타입 코드 - [getCloudHadoopClusterTypeList](/docs/cli-vhadoop-getcloudhadoopclustertypelist) 참조 | | `--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 버킷 이름 - [getCloudHadoopBucketList](/docs/cli-vhadoop-getcloudhadoopbucketlist) 참조 | | `--cloudHadoopAdminUserName` | String | Required | 클러스터 관리자 계정 사용자 이름 - 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~15자 이내로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - Ambari 콘솔 접속 시 필요 | | `--cloudHadoopAdminUserPassword` | String | Required | 클러스터 관리자 계정 비밀번호 - 영문자, 숫자, 특수문자를 조합하여 8~20자 이내로 입력 - 특수문자 `'` `"` `₩` `/` `&` ``` 및 공백 사용 불가 - Ambari 콘솔 접속 시 필요 | | `--loginKeyName` | String | Required | 인증키 이름 - SSH 방식으로 노드에 직접 접속 시 필요 - [getCloudHadoopLoginKeyList](/docs/cli-vhadoop-getcloudhadooploginkeylist) 참조 | | `--kdcRealm` | String | Conditional | KDC Realm 정보 - Realm 형태의 도메인 규칙만 허용 - `useKdc`가 `true`인 경우, 필수 입력 | | `--kdcPassword` | String | Conditional | KDC 관리자 계정 비밀번호 - 영문자, 숫자, 특수문자를 조합하여 8~20자 이내로 입력 - 특수문자 `'` `"` `₩` `/` `&` ``` 및 공백 사용 불가 - `useKdc`가 `true`인 경우, 필수 입력 | | `--bootstrapScript` | String | Conditional | 부트스트랩 스크립트 - 1~1,024 바이트 - 버킷 내 폴더와 파일 이름 입력 - 파일 이름은 영문만 허용하며 공백, 특수문자 사용 불가 - 클러스터에 연동된 버킷으로만 스크립트 수행 가능 - `useBootstrapScript`가 `true`인 경우, 필수 입력 | ### 선택 옵션 `createCloudHadoopInstance`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다. | 옵션 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `--cloudHadoopImageProductCode` | String | Optional | 클러스터 이미지 코드 - [getCloudHadoopImageProductList](/docs/cli-vhadoop-getcloudhadoopimageproductlist)의 `productCode` 참조 - 미입력 시 제공 중인 최신 버전 적용 | | `--engineVersionCode` | String | Optional | 엔진 버전 코드 - 미입력 시 제공 중인 최신 버전 적용 - Rocky 클러스터 생성 시 입력 - [getCloudHadoopImageProductList](/docs/cli-vhadoop-getcloudhadoopimageproductlist) 참조 | | `--cloudHadoopAddOnCodeList` | List | Optional | 클러스터 Add-on 컴포넌트 목록 - 공백으로 구분하여 여러 개 입력 가능 (예시: `--cloudHadoopAddOnCodeList PRESTO HBASE`) - Cloud Hadoop 1.5 이상 버전에서 적용 가능 - [getCloudHadoopAddOnList](/docs/cli-vhadoop-getcloudhadoopaddonlist) 참조 | | `--useDataCatalog` | Boolean | Optional | Data Catalog 서비스 사용 여부 - `true` \| `false` (기본값) - `true`: Hive 메타스토어를 Data Catalog 서비스의 카탈로그를 통해 제공 - `false`: 사용 안 함 - 사용 조건 - Data Catalog 서비스 이용 신청 및 정상 운영 상태 - Cloud Hadoop 2.0 이상 버전 | | `--useKdc` | Boolean | Optional | 커버로스(Kerberos) 인증 구성의 사용 여부 - `true` \| `false` (기본값) - `true`: 사용 - `false`: 사용 안 함 - 사용할 경우, 마스터 노드에 KDC 서버 이중화 제공 | | `--useBootstrapScript` | Boolean | Optional | 부트스트랩 스크립트 사용 여부 - `true` \| `false` (기본값) - `true`: 사용 - `false`: 사용 안 함 - 사용할 경우, 모든 노드에 스크립트 미리 실행 | | `--edgeNodeProductCode` | String | Optional | 엣지 노드 서버 타입 코드 - 기본값: 최소 사양 (메모리, CPU 순) - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 | | `--masterNodeProductCode` | String | Optional | 마스터 노드 서버 타입 코드 - 기본값: 최소 사양 (메모리, CPU 순) - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 | | `--masterNodeDataStorageTypeCode` | String | Optional | 마스터 노드 스토리지 타입 - `cloudHadoopImageProductCode`의 `generationCode`에 따라 기본값 상이 - G2: `SSD` (기본값) \| `HDD` - G3: `CB2` (기본값) - 설치 이후 데이터 스토리지 타입 변경 불가 | | `--workerNodeProductCode` | String | Optional | 작업자 노드 서버 타입 코드 - 기본값: 최소 사양 (메모리, CPU 순) - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 | | `--workerNodeCount` | Integer | Optional | 작업자 노드 수 - `2`~`8` (기본값: `2`) | | `--workerNodeDataStorageTypeCode` | String | Optional | 작업자 노드 스토리지 타입 - `cloudHadoopImageProductCode`의 `generationCode`에 따라 기본값 상이 - G2: `SSD` (기본값) \| `HDD` - G3: `CB2` (기본값) - 설치 이후 데이터 스토리지 타입 변경 불가 | ### 공통 옵션 `vhadoop` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud Hadoop (VPC) 옵션](/docs/cli-vhadoop#%EC%98%B5%EC%85%98)을 참조해 주십시오. ## 예시 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-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" } ] } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```