メインコンテンツまでスキップ

elastic_cluster

注記

このリソースの API は 非推奨 であり、未知の動作を引き起こす可能性があります。Multi-warehouse Based elastic cluster を使用して、マルチウェアハウスのエラスティック CelerData クラスターをデプロイすることを推奨します。

AWS EC2 インスタンス、Azure 仮想マシン、または GCP 仮想マシン上にシングルウェアハウスのエラスティック CelerData クラスターをデプロイします。

このリソースの実装は、クラスター全体のデプロイ手順の一部であり、データクレデンシャル、デプロイクレデンシャル、およびネットワーク構成の実装に依存しています。AWS、Azure、GCP 上でのクラスターのデプロイ手順の詳細については、Provision CelerData Cloud BYOC on AWS および Provision CelerData Cloud BYOC on Azure を参照してください。

サポートされているノードサイズ​

CelerData がサポートするインスタンスタイプについては、Supported instance types を参照してください。

使用例​

# celerdatabyoc_elastic_cluster リソース API は非推奨です
# リソース `celerdatabyoc_elastic_cluster_v2` を使用して、マルチウェアハウスのエラスティック CelerData クラスターをデプロイすることを推奨します。

resource "celerdatabyoc_elastic_cluster" "elastic_cluster_1" {
  deployment_credential_id = "<deployment_credential_resource_ID>"
  data_credential_id = "<data_credential_resource_ID>"
  network_id = "<network_configuration_resource_ID>"

  cluster_name = "<cluster_name>"
  coordinator_node_size = "<coordinator_node_instance_type>"
  coordinator_node_count = <coordinator_node_number>
  
  // optional
  coordinator_node_volume_config {
    vol_size = <vol_size>
    iops = <iops>
    throughput = <throughput>
  }
  // optional
  coordinator_node_configs = {
    <key> = <value>
  }

  compute_node_size = "<compute_node_instance_type>"
  compute_node_count = <compute_node_number>
  
  // optional
  compute_node_volume_config {
    vol_number = <vol_number>
    vol_size = <vol_size>
    iops = <iops>
    throughput = <throughput>
  }
  // optional
  compute_node_configs = {
    <key> = <value>
  }

  // optional
  scheduling_policy {
    policy_name = "auto-resume-suspend"
    description = "Auto resume/suspend"
    active_days = ["TUESDAY"]
    time_zone = "UTC" // IANA Time-Zone
    resume_at   = "09:00"
    suspend_at  = "18:00"
    enable      = true
  }

  default_admin_password = "<SQL_user_initial_password>"

  expected_cluster_state = "{Suspended | Running}"
    ldap_ssl_certs = [
    "<ssl_cert_s3_path>"
  ]
  resource_tags = {
    celerdata = "<tag_name>"
  }
  csp = "aws"
  region = "<AWS_VPC_region>"

  init_scripts {
      logs_dir    = "<log_s3_path>"
      script_path = "<script_s3_path>"
  }
  run_scripts_parallel = false
  query_port = 9030
  idle_suspend_interval = 64
}

引数リファレンス​

celerdatabyoc_elastic_cluster リソースには、以下の必須引数とオプション引数が含まれます。

必須:

  • cluster_name: (変更不可) クラスターの希望する名前。ユニークな名前を入力してください。

  • coordinator_node_size: クラスター内のコーディネーターノードのインスタンスタイプ。Supported Node Sizes の表からコーディネーターノードのインスタンスタイプを選択します。例えば、この引数を m6i.4xlarge に設定できます。

  • deployment_credential_id: (変更不可) 値を celerdatabyoc_aws_deployment_role_credential.deployment_role_credential.id に設定します。

  • data_credential_id: (変更不可) 値を celerdatabyoc_aws_data_credential.data_credential.id に設定します。

  • network_id: (変更不可) 値を celerdatabyoc_aws_network.network.id に設定します。

  • compute_node_size: クラスター内のコンピュートノードのインスタンスタイプ。Supported Node Sizes の表からコンピュートノードのインスタンスタイプを選択します。例えば、この引数を r6id.4xlarge に設定できます。

  • default_admin_password: (変更不可) クラスター admin ユーザーの初期パスワード。

  • expected_cluster_state: クラスターを作成する際に、作成するクラスターのステータスを宣言する必要があります。クラスターの状態は Suspended と Running に分類されます。プロビジョニング後にクラスターを開始したい場合は、この引数を Running に設定します。そうしない場合、プロビジョニング後にクラスターは停止されます。

  • csp: (変更不可) クラスターのクラウドサービスプロバイダー。AWS のみがサポートされています。

  • region: (変更不可) クラスターをホストするネットワークが属するクラウドプロバイダーのリージョン ID。Supported cloud platforms and regions を参照してください。

オプション:

  • coordinator_node_count: クラスター内のコーディネーターノードの数。有効な値: 1, 3, 5。デフォルト値: 1。

  • coordinator_node_volume_config: コーディネーターノードのボリューム構成。

    • vol_size: 各コーディネーターノードのディスクあたりのサイズ。単位: GB。デフォルト値: 150。このパラメータの値を増やすことのみ可能です。
    • iops: ディスクの iops。
    • throughput: ディスクのスループット。

  • coordinator_node_configs: コーディネーターノードの静的構成。

  • compute_node_count: クラスター内のコンピュートノードの数。有効な値: 0 でない正の整数。デフォルト値: 3。

  • compute_node_volume_config: コンピュートノードのボリューム構成。

    • vol_number: (変更不可) 各コンピュートノードのディスクの数。有効な値: [1,24]。デフォルト値: 2。
    • vol_size: 各コンピュートノードのディスクあたりのサイズ。単位: GB。デフォルト値: 100。このパラメータの値を増やすことのみ可能です。
    • iops: ディスクの iops。
    • throughput: ディスクのスループット。 ~> vol_number と vol_size 引数を使用してディスクスペースを指定できます。コンピュートノードにプロビジョニングされる合計ディスクスペースは vol_number * vol_size に等しいです。

  • compute_node_configs: コンピュートノードの静的構成。

  • ldap_ssl_certs: LDAP SSL 証明書を格納する AWS S3 バケット内のパス。複数のパスはカンマ (,) で区切る必要があります。CelerData は、S3 から LDAP SSL 証明書をアップロードすることで、SSL 経由の LDAP をサポートします。CelerData が証明書を正常に取得できるようにするには、ListObject および GetObject 権限を CelerData に付与する必要があります。アップロードされた証明書を削除するには、この引数を削除するだけです。

  • ranger_certs_dir: Ranger SSL 証明書を格納する AWS S3 バケット内の親ディレクトリパス。CelerData は、S3 から Ranger SSL 証明書をアップロードすることで、SSL 経由の Ranger をサポートします。CelerData が証明書を正常に取得できるようにするには、ListObject および GetObject 権限を CelerData に付与する必要があります。アップロードされた証明書を削除するには、この引数を削除するだけです。

注記

クラスターの expected_cluster_state が Running に設定されている間のみ、LDAP または Ranger SSL 証明書をアップロードまたは削除できます。

  • resource_tags: クラスターに添付するタグ (resource_tags は CelerData の概念です。AWS および Azure では、対応するリソースにタグとして追加されます。GCP Cloud では、対応する GCP リソースにラベルとして追加されます)。

  • init_scripts: スクリプトとスクリプト実行結果が格納されるパスを指定する構成ブロック。実行可能なスクリプトの最大数は 20 です。これらの引数でサポートされる形式については、Run scripts の scripts.logs_dir および scripts.script_path を参照してください。

    • logs_dir: スクリプト実行結果が格納される AWS S3 バケット内のパス。この S3 バケットは、celerdatabyoc_aws_data_credential リソースで指定したものと同じでも異なっていてもかまいません。
    • script_path: Terraform 経由で実行するスクリプトを格納する AWS S3 バケット内のパス。この S3 バケットは、celerdatabyoc_aws_data_credential リソースで指定したものでなければなりません。

  • run_scripts_parallel: スクリプトを並行して実行するかどうか。有効な値: true および false。デフォルト値: false。

  • run_scripts_timeout: スクリプト実行がタイムアウトするまでの時間。単位: 秒。デフォルト: 3600 (1 時間)。この項目の最大値は 21600 (6 時間) です。

  • query_port: クエリポートは、1-65535 の範囲内で 443 を除く必要があります。デフォルトのクエリポートは 9030 です。この引数はクラスターのデプロイ時にのみ指定でき、一度設定すると変更できません。

  • idle_suspend_interval: クラスターがアイドル状態でいられる時間 (分単位)。指定された時間が経過すると、クラスターは自動的に停止されます。自動停止機能はデフォルトで無効になっています。この機能を有効にするには、この引数を 15-999999 の範囲の整数に設定します。この機能を再度無効にするには、この引数を Terraform 構成から削除します。

  • scheduling_policy:(オプション、リスト) 指定された場合。CelerData は、EC2 のコストを大幅に節約するためにクラスターを自動的に停止し (EBS のコストのみが発生します)、スケジュールに従ってクラスターを再開します。

    • policy_name: (必須) ポリシー名。
    • description: (オプション) このポリシー戦略の説明。
    • active_days: (必須) クラスターのスケジューリングポリシーがトリガーされる日付を設定します。利用可能な値:
      • MONDAY
      • TUESDAY
      • WEDNESDAY
      • THURSDAY
      • FRIDAY
      • SATURDAY
      • SUNDAY
    • time_zone: (オプション) IANA タイムゾーンを指定します。デフォルト: UTC。
    • resume_at: (オプション) クラスターの自動再開時間。resume_at と suspend_at の両方を空にすることはできません。
    • suspend_at: (オプション) クラスターの自動停止時間。
    • enable: (必須) このスケジューリングポリシーを有効にするかどうか。true に指定すると、システムはこのポリシーに従ってクラスターのスケジューリングを行います。

関連情報​

AWS​

Azure​

GCP​