現在のリソースとホスティング・モデルを見直す

Resources " タブには、"Hosting model " と "Resource allocations " のタイルがあります。 これらのタイルは、現在のリソースとホスティングモデルを反映しています。 Configureを選択すると、各タイルの設定を調整することができます。

UI でのスケーリング

UIの Resources タブで、Resource allocations タイルのConfigureを選択する。 すると、リソースを調整できるパネルが開きます。

データベースがIsolated Computeホスティング・モデルを使用している場合、"Host sizes "テーブルが表示され、データベースのメンバーごとにvCPUとRAMの構成を選択できます。

共有コンピュート・ホスティング・モデルを使用している場合、メンバーあたり0.5 vCPUおよび4 GB RAMを提供するSmall構成、Small Customオプション、またはCustom構成が表示されます。 Small Customは、CLI、API、またはTerraformを使用してデータベースがスケーリングされたことを示し、よりきめ細かなリソースのスケーリングと、RAM値に対して日割り計算されたvCPUが自動的に割り当てられるオプションを提供します。 UI上では、SmallやCustomへのスケールは可能だが、CLIやAPI、Terraformで提供される細かな値へのスケールはできない。 Custom の場合、スライダをドラッグするか、入力ボックスの値を調整して、データベースのメンバごとのvCPUおよび RAM の値を選択します。

ディスク（GB/メンバー）」スライダーは、メンバーごとのディスク選択です。 スライダーをドラッグするか、入力ボックスの数字を調整して、ディスクのGB数を変更します。 なお、ディスクは1GB＝10IOPSでIOPSに連動している。

Members は、データベースのメンバー数です。 Elasticsearchの場合、メンバーは 3 に設定されています。

下部の計算機で見積もり総額を確認してください。 レガシー価格体系とも呼ばれるグランドフェザーコストがある場合、データベースインスタンスをスケーリングすると、レガシー価格の一部またはすべてが削除されることに注意してください。 祖父制度とその終了時期の詳細については、ホスティングモデル移行のタイム ラインを参照のこと。

完了したら、"*Apply changes "*をクリックし、スケーリング操作を開始します。

UIでホスティングモデルを切り替える

UIの Resources タブで、Hosting modelタイルのConfigureを選択する。 ホスティングモデルの選択を調整できるパネルが開きます。

最初のオプションは「ホスティングモデルの選択」です。 ここで、別のホスティングモデルに切り替えることができます。

その下には、選択した新しいホスティングモデルのリソースを調整するオプションも表示されます。 前のセクション「UIでのスケーリング」の指示に従って、リソースを調整してください。

*変更を適用]*をクリックして、このスケール操作をトリガーします。

現在のリソースとホスティング・モデルを見直す

IBM Cloud CLI クラウド・データベース・プラグインでは、デプロイメントのリソースの表示およびスケーリングがサポートされます。 コマンド cdb deployment-groups を使用することにより、調整可能なリソース・グループを含め、サービスの現在のリソース情報を確認できます。 使用可能なリソース・グループのいずれかをスケーリングするには、cdb deployment-groups-set コマンドを使用します。

たとえば、次のコマンドを使用すると、「example-deployment」という名前の配置のリソース グループを表示できます。 このコマンドは、データベースが Shared Compute インスタンスであるか Isolated Compute インスタンスであるかも、hostflavor 属性によって明らかにします。 hostflavor NULLの場合は、旧式のホスティングモデルである。

ibmcloud cdb deployment-groups example-deployment

これにより、以下の出力が生成されます。

Group   member
Count   3
|
+   Memory
|   Allocation              3072mb
|   Allocation per member   1024mb
|   Minimum                 3072mb
|   Step Size               384mb
|   Adjustable              true
|   Cpu Enforcement Ratio Ceiling   49152mb
|   Cpu Enforcement Ratio           8192mb
|
+   CPU
|   Allocation              0
|   Allocation per member   0
|   Minimum                 9
|   Step Size               3
|   Adjustable              true
|
+   HostFlavor
|   ID            multitenant
|   Name
|   HostingSize
|
+   Disk
|   Allocation              15360mb
|   Allocation per member   5120mb
|   Minimum                 15360mb
|   Step Size               3072mb
|   Adjustable              true

デプロイメントには 3 つのメンバーが存在し、合計 3072 MB の RAM と 15360 MB のディスクが割り振られています。 「メンバー当たり」の割り振りは、1024 MB の RAM と 5120 MB のディスクです。 Minimum は、設定できる最小の合計割り振り量です。 「step size (ステップ・サイズ)」は、合計割り振りの調整可能な最小単位です。

CLI でのリソースとスケーリング

cdb deployment-groups-set コマンドでは、RAMの総割り当て量またはディスクの総割り当て量をMB単位で設定できる。 例えば、「example-deployment」のメモリーを 1 メンバーあたり RAM 4096 MB (合計メモリー 12288 MB) にスケーリングするには、以下のコマンドを使用します。

ibmcloud cdb deployment-groups-set example-deployment member --memory 12288

CLIでデータベースのホスティング・モデルを決定する

以下のコマンドを使用して、 hostflavor 属性の値を確認します。 データベースが (共有または分離コンピュートではなく) 非推奨のホスティング・モデル上にある場合、これは NULL になります。

ibmcloud cdb groups <deployment_id> --json

CLIでホスティング・モデルを切り替える

データベースが 共有コンピュート ・インスタンスの場合、以下のコマンドを使用して、メモリー、CPU、およびディスクのオプションを調整できます。 データベースがShared Compute上にない場合、このコマンドはデータベースを別のホスティング・モデルからShared Computeホスティング・モデルに移動します。

ibmcloud cdb deployment-groups-set <deploymentid> <groupid> [--memory <val>] [--cpu <val>] [--disk <val>] [--hostflavor multitenant]

例えば、以下を使用して、Shared Computeインスタンスにスケールしたり、Shared Computeインスタンスをスケールアップします：

ibmcloud cdb deployment-groups-set crn:abc ... xyz:: member  --memory 24576 --cpu 6  --hostflavor multitenant

データベースが Isolated Compute インスタンスの場合、メモリーと CPU は、Isolated Compute サイズを選択することによって一緒に調整されます (表 1 のすべてのサイズを参照)。 ディスクは個別にスケーリングされます。 データベースがIsolated Compute上にない場合、このコマンドはデータベースを別のホスティング・モデルからIsolated Computeホスティング・モデルに移動します。

ホストのフレーバー選択にはCPUとRAMのサイズが含まれるため b3c.4x16.encrypted は4CPUと16RAM）、このリクエストはIsolatedサイズの選択とCPUとRAMの個別の割り当て選択の両方を受け付けないことに注意。

ibmcloud cdb deployment-groups-set <deploymentid> <groupid> [--disk <val>] [--hostflavor <hostflavor>]

例えば、以下を使用して、Isolated Computeインスタンスにスケールしたり、Isolated Computeインスタンスをスケールアップします：

ibmcloud cdb deployment-groups-set crn:abc ... xyz:: member  --hostflavor b3c.8x32.encrypted

現在のリソースとホスティング・モデルを見直す

サービスの_「概要」パネルに表示される「ファウンデーション・エンドポイント (Foundation Endpoint)」_には、API を使用してこのデプロイメントにアクセスするための基本 URL が示されています。 スケーリングをプログラムで管理または自動化する必要がある場合には、それを /groups エンドポイントで使用します。

デプロイメントの現在のリソースとスケーラブルなリソースを調べるには、/deployments/{id}/groups エンドポイントを使用します。 このコマンドは、データベースが Shared Compute インスタンスであるか Isolated Compute インスタンスであるかも、host_flavor 属性によって明らかにします。 host_flavor NULLの場合は、旧式のホスティングモデルである。

curl -X GET -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups'

API によるスケーリング

デプロイのメモリを各メンバーの RAM 4096 MB にスケールするには (3 つあるので合計 12288 MB)、 /deployments/{id}/groups/{group_id} API エンドポイントを使用します。

curl -X PATCH 'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups/member' \
-H "Authorization: Bearer $APIKEY" \
-H "Content-Type: application/json" \
-d '{"memory": {
        "allocation_mb": 12288
      }
    }'

APIでデータベースのホスティングモデルを決定する

以下のコマンドを使用して、 host_flavor 属性の値を確認します。 データベースが (共有または分離コンピュートではなく) 非推奨のホスティング・モデル上にある場合、これは NULL になります。

curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups -H 'Authorization: Bearer <>' \

APIでホスティング・モデルを切り替える

Cloud Databases Shared Computeインスタンスをスケールするには、host_flavor を multitenant に設定して、以下のコマンドを使用します。 データベースがShared Compute上にない場合、このコマンドはデータベースを別のホスティング・モデルからShared Computeホスティング・モデルに移動します。

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups/member
-H 'Authorization: Bearer <>'
-H 'Content-Type: application/json'
-d '{"host_flavor":
        {"id": "multitenant"},
      "cpu":
        {"allocation_count": 3},
      "memory":
        {"allocation_mb": 12288}
    }' \

任意のインスタンスを Cloud Databases 分離コンピュート・インスタンスにスケーリングしたり、別の分離コンピュート・サイズにスケーリングしたりするには、 host_flavor パラメーターを使用します。このパラメーターは、目的の分離コンピュート・サイズに設定されます。 使用可能なホスティング・サイズとその host_flavor 値パラメーターは、 表 1 にリストされています。 例えば、{"host_flavor": "b3c.4x16.encrypted"}です。 ホストのフレーバー選択はCPUとRAMのサイズを含むので(b3c.4x16.encrypted は4CPUと16RAMです)、このリクエストはIsolatedサイズの選択とCPUとRAMの個別の割り当て選択の両方を受け付けないことに注意してください。 以下のようなコマンドを使用して、 Cloud Databases API スケーリング・エンドポイントでスケーリングします。

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/groups/member
-H 'Authorization: Bearer <>'
-H 'Content-Type: application/json'
-d '{"host_flavor": {"id": "b3c.4x16.encrypted"}}' \

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

現在のリソースとホスティング・モデルを見直す

cpu { allocation_count = }、 memory {allocation_mb = }、 disk { allocation_mb = } のテラフォームスクリプトをチェックして、データベースへのリソース割り当てを見直す。 データベースが Shared Compute 型か Isolated Compute 型かを判断するために、host_flavor 設定を確認してください。 host_flavor 存在しない場合、データベースは旧式のホスティング・モデルを使用しています。

Terraform を使用したスケーリング

既存のインスタンスで Terraform スクリプトを実行する前に、 terraform plan コマンドを使用して、現在のインフラストラクチャーの状態を Terraform ファイルに定義されている目的の状態と比較します。 resource_group_id、 service plan、 version、 key_protect_instance、 key_protect_key、 backup_encryption_key_crn の各属性を変更すると、インスタンスが再作成されます。 Forces new resource 仕様の現在の引数参照のリストについては、 ibm_database Terraform レジストリーを参照してください。

興味のあるリソース用にTerraformスクリプトを調整することで、インスタンスをスケールさせる。 以下の例では、cpu、memory、disk の割り当てが指定されている。 ホストのフレーバー（Isolated ComputeまたはShared Compute Multitenant）を選択している場合は、スクリプトでホストのフレーバーを選択しておいてください。

変更を実行するには、terraform apply を実行してください。

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
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  group {
    group_id = "member"
    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 IBM Modules(TIM) を使うこともできます。 Databases for Elasticsearch を使うこともできます。

Terraformでホスティングモデルを切り替えて拡張する

データベースをスケーリングしたい ホスティングモデル を選択します。 これは後から変更できます。

Databases for ElasticsearchインスタンスをShared Computeホスティングフレーバーにスケールするには、"host_flavor" パラメータを multitenant に設定します。 これは、Shared Computeホスティングフレーバーにスケールアップしたい場合や、ホストフレーバーを維持したままリソースをスケールアップしたい場合に有効です。 変更を実装するには、 terraform apply を実行します。 以下の例を参照してください。

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
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  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}"
}

Databases for Elasticsearchインスタンスを同じ "host_flavor" パラメータでIsolated Computeにスケールし、希望のIsolatedサイズに設定します。 このコマンドは、データベースインスタンスを別のIsolated Computeサイズにスケールしたり、別のホストフレーバーからIsolated Computeホストフレーバーに移動したりするのに使用します。 使用可能なホスティング・サイズとその host_flavor value パラメーターは、 表 1 にリストされています。 例えば、{"host_flavor": "b3c.4x16.encrypted"}です。 ホストのフレーバー選択はCPUとRAMのサイズを含むので(b3c.4x16.encrypted は4CPUと16RAMです)、このリクエストはIsolatedサイズの選択とCPUとRAMの個別の割り当て選択の両方を受け付けないことに注意してください。

変更を実行するには、terraform apply を実行してください。

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
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  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}"
}