classic_cluster

注記

このリソースの API は、ユーザーエクスペリエンスを簡素化するために、今後のバージョンで変更される可能性があります。クラシック CelerData クラスターは、マルチ AZ デプロイメントをサポートしていません。詳細については、Multi-AZ Deployment を参照してください。

クラシック CelerData クラスターを AWS EC2 インスタンス、Azure 仮想マシン、または GCP 仮想マシンにデプロイします。

最初のクラシッククラスターをセットアップし、1 つの FE ノードと 1 つの BE ノードで構成され、どちらも最大 4 つの CPU コアと 16 GB の RAM を提供するインスタンスタイプを使用する場合、クラスターは自動的に Free Developer Tier クラスターとして作成されます。これにより、CelerData Cloud BYOC の機能を最小限のコストで探索し、体験することができます。

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

サポートされているインスタンスタイプ

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

使用例

resource "celerdatabyoc_classic_cluster" "classic_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>"
  fe_instance_type = "<fe_node_instance_type>"
  fe_node_count = 1
  
  // optional
  fe_volume_config {
    vol_size = <vol_size>
    iops = <iops>
    throughput = <throughput>
  }
  // optional
  fe_configs = {
    <key> = <value>
  }

  be_instance_type = "<be_node_instance_type>"
  be_node_count = 1
  
  // optional
  be_volume_config {
    vol_number = <vol_number>
    vol_size = <vol_size>
    iops = <iops>
    throughput = <throughput>
  }
  // optional
  be_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>"
  ]
  ranger_certs_dir_path = "<ranger_config_s3_path>" // Example : "s3://your-bucket/ranger_config_dir"
  resource_tags = {
    celerdata = "<tag_name>"
  }
  csp = "{aws | azure}"
  region = "<cloud_provider_region>"

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

引数リファレンス

注記

このセクションでは、celerdatabyoc_classic_cluster リソースの引数のみを説明します。他のリソースの引数の説明については、対応するリソーストピックを参照してください。

このリソースには、次の必須引数とオプション引数が含まれています。

必須:

cluster_name: (変更不可) クラスターの希望する名前。
fe_instance_type: クラスター内の FE ノードのインスタンスタイプ。"Supported Instance Types" の表から FE インスタンスタイプを選択します。
deployment_credential_id: (変更不可) デプロイメントクレデンシャルの ID。
- クラスターを AWS にデプロイする場合、この引数を celerdatabyoc_aws_deployment_role_credential.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_aws_deployment_role_credential リソースの名前に置き換えます。
- クラスターを Azure にデプロイする場合、この引数を celerdatabyoc_azure_deployment_credential.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_azure_deployment_credential リソースの名前に置き換えます。
data_credential_id: (変更不可) データクレデンシャルの ID。
- クラスターを AWS にデプロイする場合、この引数を celerdatabyoc_aws_data_credential.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_aws_data_credential リソースの名前に置き換えます。
- クラスターを Azure にデプロイする場合、この引数を celerdatabyoc_azure_data_credential.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_azure_data_credential リソースの名前に置き換えます。
network_id: (変更不可) ネットワーク構成の ID。
- クラスターを AWS にデプロイする場合、この引数を celerdatabyoc_aws_network.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_aws_network リソースの名前に置き換えます。
- クラスターを Azure にデプロイする場合、この引数を celerdatabyoc_azure_network.<resource_name>.id に設定し、<resource_name> を celerdatabyoc_azure_network リソースの名前に置き換えます。
be_instance_type: クラスター内の BE ノードのインスタンスタイプ。"Supported Instance Types" の表から BE インスタンスタイプを選択します。
default_admin_password: (変更不可) クラスター admin ユーザーの初期パスワード。
expected_cluster_state: クラスターを作成する際に、作成するクラスターの状態を宣言する必要があります。クラスターの状態は Suspended と Running に分類されます。プロビジョニング後にクラスターを開始したい場合は、この引数を Running に設定します。そうしない場合、プロビジョニング後にクラスターは一時停止されます。
csp: (変更不可) クラスターのクラウドサービスプロバイダー。
- クラスターを AWS にデプロイする場合、この引数を aws に設定します。
- クラスターを Azure にデプロイする場合、この引数を azure に設定します。
region: (変更不可) クラスターをホストするネットワークが属するクラウドプロバイダーのリージョンの ID。 Supported cloud platforms and regions を参照してください。

オプション:

fe_node_count: クラスター内の FE ノードの数。有効な値: 1、3、5。デフォルト値: 1。
fe_volume_config: FE ノードのボリューム構成。
- vol_size: 各 FE のディスクあたりのサイズ。単位: GB。デフォルト値: 150。このパラメータの値を増やすことのみ可能です。
- iops: ディスクの iops。
- throughput: ディスクのスループット。
fe_configs: FE の静的構成。
be_node_count: クラスター内の BE ノードの数。有効な値: 0 以外の正の整数。デフォルト値: 3。
be_volume_config: BE ノードのボリューム構成。
- vol_number: (変更不可) 各 BE のディスクの数。有効な値: [1,24]。デフォルト値: 2。
- vol_size: 各 BE のディスクあたりのサイズ。単位: GB。デフォルト値: 100。このパラメータの値を増やすことのみ可能です。
- iops: ディスクの iops。
- throughput: ディスクのスループット。

注記

vol_number と vol_size 引数を使用してディスクスペースを指定できます。クラスター BE にプロビジョニングされた合計ディスクスペースは vol_number * vol_size に等しいです。

be_configs: BE の静的構成。
ldap_ssl_certs: (AWS のみで利用可能) LDAP SSL 証明書を格納する AWS S3 バケットのパス。複数のパスはカンマ (,) で区切る必要があります。CelerData は、S3 から LDAP SSL 証明書をアップロードすることで、SSL 経由の LDAP の使用をサポートします。CelerData が証明書を正常に取得できるようにするには、CelerData に ListObject および GetObject 権限を付与する必要があります。アップロードされた証明書を削除するには、この引数を削除するだけです。
ranger_certs_dir: (AWS のみで利用可能) Ranger SSL 証明書を格納する AWS S3 バケットの親ディレクトリパス。CelerData は、S3 から Ranger SSL 証明書をアップロードすることで、SSL 経由の Ranger の使用をサポートします。CelerData が証明書を正常に取得できるようにするには、CelerData に ListObject および GetObject 権限を付与する必要があります。アップロードされた証明書を削除するには、この引数を削除するだけです。

注記

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

resource_tags: クラスターに添付するタグ (resource_tags は ClelerData の概念であることに注意してください。AWS および Azure では、対応するリソースにタグとして追加されます。GCP Cloud では、対応する GCP リソースにラベルとして追加されます)。
init_scripts: (AWS のみで利用可能) スクリプトとスクリプト実行結果が格納されるパスを指定する構成ブロック。実行可能なスクリプトの最大数は 20 です。これらの引数でサポートされる形式については、Run scripts の scripts.logs_dir および scripts.script_path を参照してください。
- logs_dir: スクリプト実行結果が格納される AWS S3 バケットのパス。この S3 バケットは、celerdatabyoc_aws_data_credential リソースで指定する S3 バケットと同じでも異なっていてもかまいません。
- 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​

サポートされているインスタンスタイプ

使用例

引数リファレンス

参照

AWS

Azure

GCP