Press CTRL+K to open search

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>] \
    [--useDataCatalog <true|false>] \
    [--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|CB2>] \
    [--workerNodeProductCode <worker-node-product-code>] \
    [--workerNodeCount <worker-node-count>] \
    [--workerNodeDataStorageTypeCode <SSD|HDD|CB2>] \
    [--regionCode <KR|SGN|JPN>] \
    [--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 (10GB単位) | 4000 | 6000
--workerNodeDataStorageSize Integer Required ワーカーノードストレージ容量 (GB)
  • 100~2000 (10GB単位)| 4000 | 6000
--bucketName String Required Object Storageのバケット名
--cloudHadoopAdminUserName String Required クラスタ管理者アカウントのユーザー名
  • 英字の小文字、数字、記号の-を組み合わせて3~15文字以内で入力
  • 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用
  • Ambariコンソールへのアクセス時に必要
--cloudHadoopAdminUserPassword String Required クラスタ管理者アカウントのパスワード
  • 英字、数字、記号を組み合わせて8~20文字以内で入力
  • 記号の' " ₩ / & `およびスペースは使用不可
  • Ambariコンソールへのアクセス時に必要
--loginKeyName String Required 認証キー名
--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 クラスタイメージコード
--engineVersionCode String Optional エンジンバージョンコード
--cloudHadoopAddOnCodeList List Optional クラスタ Add-onコンポーネントリスト
  • スペースで区切って複数入力可能 (例: --cloudHadoopAddOnCodeList PRESTO HBASE)
  • Cloud Hadoop 1.5以降のバージョンで適用可能
  • 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 エッジノードのサーバタイプコード
--masterNodeProductCode String Optional マスターノードのサーバタイプコード
--masterNodeDataStorageTypeCode String Optional マスターノードのストレージタイプ
  • cloudHadoopImageProductCodeのgenerationCodeに応じてデフォルト値が異なる
    • G2: SSD (デフォルト) | HDD
    • G3: CB2 (デフォルト)
  • インストール後、データストレージのタイプは変更不可
--workerNodeProductCode String Optional ワーカーノードのサーバタイプコード
--workerNodeCount Integer Optional ワーカーノード数
  • 2~8 (デフォルト: 2)
--workerNodeDataStorageTypeCode String Optional ワーカーノードのストレージタイプ
  • cloudHadoopImageProductCodeのgenerationCodeに応じてデフォルト値が異なる
    • G2: SSD (デフォルト) | HDD
    • G3: CB2 (デフォルト)
  • インストール後、データストレージのタイプは変更不可

共通オプション

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-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"
  }
}
事業者登録番号: 129-86-31394 通信販売業申告番号:第2009-京畿城南-0510号
代表取締役: キム・ユウォン アドレス: 13561 京畿道 城南市 盆唐区 仏亭路6 グリーンファクトリー, 17~26F お客様センターの代表電話: 1544-5876
© NAVER Cloud Corp. All Rights Reserved.