サービスの詳細

• サービス名- 任意の文字列を指定できます。これは、Web および CLI 上で新しいデプロイメントを識別するために使用される名前です。
• リソースグループ- サービスを リソースグループ ごとに整理している場合は、このフィールドにリソースグループを指定してください。 それ以外の場合は、この値をデフォルトのままにしておくことができます。 詳しくは、リソース・グループの管理を参照してください。
• 場所- 展開するパブリッククラウドのリージョン。

ホスティング・モデル

• Isolated： 複雑で高性能なエンタープライズワークロード向けの、セキュアなシングルテナント型ソリューション。
• Shared： 動的できめ細やかな調整が可能かつ独立した容量選択を実現する、柔軟なマルチテナント型サービス。

Databases for Elasticsearch プラチナ機能はIsolated Computeでのみ利用可能です。

詳しくは、 Hosting models および Databases for Elasticsearch plans を参照してください。

リソース割り振り

リソース割り振りを微調整します。 使用可能なオプションは、選択したホスティング・モデルによって異なります。

• 分離: この表を使用して、デプロイメントの各メンバーのマシン・サイズを選択し、ディスク・サイズを指定します。
• 共有: デフォルトでは、可能な限り最小のリソース割り振りが選択されます。 これは、小規模なアプリケーションやテストに最適です。 割り振り量が多い場合は、 「カスタム」 タイルを選択します。これにより、2 つ以上のコアを使用した柔軟なリソース構成が可能になります。

共有コンピュート・ホスティング・モデルは、明確さを維持するために UI に表示されない、よりきめの細かいリソース割り振りをサポートします。 詳しくは、 モデルのホスティング を参照してください。

要件に応じてディスク・サイズを指定します。 プロビジョニング後に増やすことはできますが、データ損失を防ぐために減らすことはできません。

サービス構成

• データベースのバージョン: 配置時のみ設定 データベースの配置バージョン。 最適なパフォーマンスを確保するには、優先バージョンを実行します。 最新のマイナー・バージョンが自動的に使用されます。 詳細については、バージョン管理ポリシーを参照してください。
• データベース エディション: 展開時のみ設定 展開するエディションを選択します。 エンタープライズまたはプラチナからお選びください。 プラチナはアイソレート・ホスティング・モデルでのみ利用可能です。
• 暗号化: 配置時のみ設定Key Protect を使用する場合、配置のディスクを暗号化するインスタンスとキーを選択できます。 独自の鍵を使用しない場合、デプロイメントは自動的に自身のディスク暗号鍵を作成して管理します。
• エンドポイント: デプロイ時にのみ設定サービス エンドポイント をデプロイ時に設定します。 デフォルトの設定は「 非公開 」です。

適切な設定を選択したら、作成をクリックしてプロビジョニング・プロセスを開始します。

CLI を使用したサービス・インスタンスの作成

プロビジョニングの前に、資料に記載されている指示に従って、 IBM Cloud CLI ツールをインストールします。

1. IBM Cloud にログインします。 フェデレーテッド・ユーザー ID を使用する場合は、ワンタイム・パスコード (ibmcloud login --sso) に切り替えるか、API キー (ibmcloud --apikey key or @key_file) を使用して認証することが重要です。 CLI を使用したログイン方法の詳細については、 ibmcloud login の「 一般的な CLI(ibmcloud)コマンド」を参照してください。

   ibmcloud login
   

2. データベースをプロビジョンする ホスティング・モデル を選択します。 これは後から変更できます。

3. 以下のコマンドを使用して、データベースをプロビジョンします。

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<Endpoint>"
   

   例えば、Databases for Elasticsearch Shared Computeホスティングモデルのインスタンスをプロビジョニングするには、以下のようなコマンドを使います：

   ibmcloud resource service-instance-create test-database databases-for-elasticsearch enterprise us-south -p '{ "backup_id": "<BACKUP_CRN>", "version": "<VERSION_STRING>", "members_memory_allocation_mb": "4096" }' --service-endpoints="private"
   

   プロビジョニングDatabases for Elasticsearch同じインスタンスを分離 "members_host_flavor"-pパラメータを設定し、必要な分離サイズに設定します。 使用可能なホスティング・サイズとその members_host_flavor value パラメーターは、 表 2 にリストされています。 例えば、{"members_host_flavor": "b3c.4x16.encrypted"}です。 ホスト・フレーバーの選択には CPU と RAM のサイズ (b3c.4x16.encrypted は 4 個の CPU と 16 個の RAM) が含まれるため、この要求では、分離サイズの選択と、個別の CPU と RAM の割り振りの選択の両方は受け入れられないことに注意してください。

   ibmcloud resource service-instance-create test-database databases-for-elasticsearch enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"
   

   コマンド内のフィールドについては、以下の表で説明されています。

   基本的なコマンド形式のフィールド

   フィールド	説明	フラグ
   INSTANCE_NAME 必須	インスタンス名は任意の文字列に設定でき、Web や CLI で新しいデプロイメントを識別するために使用される名前です。
   SERVICE_NAME 必須	サービスの名前または ID。 Databases for Elasticsearchの場合、 databases-for-elasticsearch を使用します。
   SERVICE_PLAN_NAME 必須	enterpriseまたはplatinum。 platinum は isolated ホストフレーバーを必要とすることに注意してください。
   LOCATION 必須	デプロイ先の場所。 リージョンのリストを取得するには、 ibmcloud regions コマンドを使用します。
   RESOURCE_GROUP	リソース・グループ名。 デフォルト値は defaultです。	-g
   --parameters	サービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列	-p
   members_host_flavor	分離コンピュート・インスタンスまたは共有コンピュート・インスタンスをプロビジョンするには、 {"members_host_flavor": "<members_host_flavor value>"} を使用します。 Shared Computeには multitenant を指定します。 「分離されたコンピュート」の場合は、必要な CPU と RAM の構成を選択します。 詳細については、以下の表または ホスティングモデル を参照してください。
   --service-endpoints 必須	public、private、または public-and-private のいずれかで、デプロイの サービスエンドポイントを設定します。

   CLI では、「 service-endpoints 」はフラグであり、パラメータではありません。

members host flavor パラメーター

members_host_flavor パラメーターは、コンピュートのサイジングを定義します。

Shared Computeインスタンスをプロビジョニングするには、multitenant を指定します。 分離されたコンピュート・インスタンスをプロビジョンするには、目的の CPU と RAM の構成に適した値を入力します。

以下のような応答が表示されます。

```text {: codeblock}
Creating service instance INSTANCE_NAME in resource group default of account    USER...
OK
Service instance INSTANCE_NAME was created.
Name:                INSTANCE_NAME
ID:                  crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/   40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
Location:            LOCATION
State:               provisioning
Type:                service_instance
Sub Type:            Public
Service Endpoints:   private
Allow Cleanup:       false
Locked:              false
Created at:          2023-06-26T19:42:07Z
Updated at:          2023-06-26T19:42:07Z
Last Operation:
                      Status    create in progress
                      Message   Started create instance operation
```
- To check provisioning status, use the following command:

  ```sh {: pre}
  ibmcloud resource service-instance <INSTANCE_NAME>
  ```
  When complete, you will see a response like:

  ```text {: codeblock}
  Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
  OK

  Name:                  INSTANCE_NAME
  ID:                    crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
  GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
  Location:              <LOCATION>
  Service Name:          databases-for-elasticsearch
  Service Plan Name:     standard
  Resource Group Name:   default
  State:                 active
  Type:                  service_instance
  Sub Type:              Public
  Locked:                false
  Service Endpoints:     private
  Created at:            2023-06-26T19:42:07Z
  Created by:            USER
  Updated at:            2023-06-26T19:53:25Z
  Last Operation:
                          Status    create succeeded
                          Message   Provisioning elasticsearch with version 7.17 (100%)
  ```
- Optional: To delete a service instance, run the following command:

  ```sh {: pre}
  ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
  ```

CPUとRAMの自動スケーリングは、 Cloud Databases Isolated Computeではサポートされていません。 ディスクの自動スケーリングが使用可能です。 Isolated インスタンスをプロビジョニングした場合、または自動スケーリング付きのデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring を使用してリソースを監視してください。 は、メモリ、ディスク領域、およびディスク I/O 使用率のメトリクスを提供します。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングします。

--parameters パラメーター

service-instance-create コマンドは、 -p パラメータをサポートしており、これによりJSON形式のパラメータをプロビジョニングプロセスに渡すことができます。 例えば、クラウド内のリソースを一意的に識別するクラウド・リソース名 (CRN) をパラメーター値として渡すことができます。 パラメーター名と値はすべて文字列として渡されます。

たとえば、特定のバックアップからデータベースをプロビジョニングする場合で、新しいデータベースの展開に3つのメンバー全体で合計12 GBのメモリが必要な場合、メンバーごとに4 GBを割り当てるコマンドは次のようになります：

ibmcloud resource service-instance-create databases-for-elasticsearch <INSTANCE_NAME> enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "4096"
}' --service-endpoints="private"

members host flavor パラメーター

members_host_flavor パラメーターは、コンピュートのサイジングを定義します。 共有コンピュート・インスタンスをプロビジョンするには、 multitenant を指定します。 分離されたコンピュート・インスタンスをプロビジョンするには、目的の CPU と RAM の構成に適した値を入力します。

CPUとRAMの自動スケーリングは、 Cloud Databases Isolated Computeではサポートされていません。 ディスクの自動スケーリングが使用可能です。 Isolated インスタンスをプロビジョニングした場合、または自動スケーリング付きのデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring を使用してリソースを監視してください。 は、メモリ、ディスク領域、およびディスク I/O 使用率のメトリクスを提供します。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングします。

Terraformで共有コンピュートをプロビジョニングする

"host_flavor" パラメーターを multitenant に設定して、 Databases for Elasticsearch 共有ホスティング・モデル・インスタンスをプロビジョンします。 以下の例を参照してください。

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "eu-gb"
  service           = "databases-for-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  group {
    group_id = "member"
    host_flavor {
      id = "multitenant"
    },
    cpu {
      allocation_count = 6
    }
    memory {
      allocation_mb = 24576
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD Elasticsearch database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

Terraformで分離されたコンピュートをプロビジョニングする

Databases for Elasticsearch 分離インスタンスを同じ "host_flavor" パラメーターでプロビジョンし、目的の分離サイズに設定します。 使用可能なホスティング・サイズとその host_flavor value パラメーターは、 表 1 にリストされています。 例えば、{"host_flavor": "b3c.4x16.encrypted"}です。 ホスト・フレーバーの選択には CPU と RAM のサイズ (b3c.4x16.encrypted は 4 個の CPU と 16 個の RAM) が含まれるため、この要求では、分離サイズの選択と、個別の CPU と RAM の割り振りの選択の両方は受け入れられないことに注意してください。

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "eu-gb"
  service           = "databases-for-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  group {
    group_id = "member"
    host_flavor {
      id = "b3c.8x32.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD Elasticsearch database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

host flavor パラメーター

host_flavor パラメーターは、コンピュートのサイジングを定義します。

• 共有コンピュート- 共有コンピュート・インスタンスをプロビジョニングするには、multitenant を指定します。
• Isolated compute- Isolated Computeインスタンスをプロビジョニングするには、希望するCPUとRAMの構成に適切な値を入力します。 以下の表の値を参照。

CPUとRAMの自動スケーリングは、 Cloud Databases Isolated Computeではサポートされていません。 ディスクの自動スケーリングが使用可能です。 Isolated インスタンスをプロビジョニングした場合、または自動スケーリング付きのデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring を使用してリソースを監視してください。 は、メモリ、ディスク領域、およびディスク I/O 使用率のメトリクスを提供します。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングします。