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

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

UI でのスケーリング

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

データベースがIsolated Computeホスティング・モデル上にある場合、"Host sizes "テーブルが表示されます。

共有コンピュート・ホスティング・モデルを使用している場合、メンバーあたり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 は、データベースのメンバー数です。 PostgreSQL,では、メンバは2に設定されています。

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

完了したら、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   2
|
+   Memory
|   Allocation                      8192mb
|   Allocation per member           4096mb
|   Minimum                         4096mb
|   Step Size                       256mb
|   Adjustable                      true
|   Cpu Enforcement Ratio Ceiling   32768mb
|   Cpu Enforcement Ratio           8192mb

|
+   CPU
|   Allocation              6
|   Allocation per member   3
|   Minimum                 6
|   Step Size               2
|   Adjustable              true
|
+   HostFlavor
|   ID            multitenant
|   Name
|   HostingSize
|
+   Disk
|   Allocation              10240mb
|   Allocation per member   5120mb
|   Minimum                 10240mb
|   Step Size               1024mb
|   Adjustable              true

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

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

cdb deployment-groups-set コマンドでは、RAMの総割り当て量またはディスクの総割り当て量をMB単位で設定できる。 例えば、"example-deployment "のメモリを、各メモリ・メンバーに対して4096MBのRAM（合計8192MB）に拡張するには、次のコマンドを使用する：

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

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

host_flavor 属性の値を確認するには、次のコマンドを使います。 データベースが非推奨のホスティングモデル(SharedやIsolated Computeではない)である場合、これはNULLになります。

ibmcloud cdb groups <INSTANCE_NAME_OR_CRN> --json

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

データベースが 共有コンピュート インスタンスの場合、以下のコマンドでメモリ、CPU、ディスクのオプションを調整できます。 これは、異なるホスティングモデルから共有コンピュートホスティングモデルにデータベースを移動する場合にも使用できます。

ibmcloud cdb deployment-groups-set <INSTANCE_NAME_OR_CRN> <GROUP_ID> [--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

データベースが 分離されたコンピュート インスタンスの場合、メモリとCPUは分離されたコンピュートサイズ（表1のすべてのサイズを参照）を選択することで一緒に調整されます。 ディスクは個別にスケーリングされる。 Cloud Databases Isolated Computeインスタンスをスケールするには、以下のようなコマンドを使用して、4 CPU x 16 RAMインスタンスにスケールします。 このコマンドは、データベースを別のホスティング・モデルからIsolated Computeホスティング・モデルに移動するためにも使用できます。

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

ibmcloud cdb deployment-groups-set <INSTANCE_NAME_OR_CRN> <GROUP_ID> [--disk <val>] [--hostflavor <hostflavor>]

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

ibmcloud cdb deployment-groups-set crn:abc ... xyz:: member  --hostflavor b3c.4x16.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 に拡張するには（2 つあるため、合計メモリは 8192 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": 8192
      }
    }'

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

host_flavor 属性の値を確認するには、以下のコマンドを使用する。 データベースが非推奨のホスティングモデル(SharedやIsolated Computeではない)である場合、これは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": 2},
      "memory":
        {"allocation_mb": 8192}
    }' \

インスタンスをCloud Databases Isolated Computeインスタンスにスケールしたり、異なるIsolated Computeサイズにスケールするには、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"}}' \

Isolated Computeでプロビジョニングやスケーリングを行う場合、CPUやRAMの割り当てはできません。 CPU と RAM を独立に選択するには、host_flavor パラメータに mulitenant を指定します。

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 Registry を参照してください。

興味のあるリソース用に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-epostgresql"
  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 PostgreSQL database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

あるいは、自動スケーリング機能をサポートする、オープンソースでエンタープライズ対応の Terraform IBM Modules(TIM) を使うこともできます。 Databases for PostgreSQL を使うこともできます。

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

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

Databases for PostgreSQL インスタンスを Shared compute hosting flavor にスケールするには、"host_flavor" パラメータを 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-postgresql"
  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 PostgreSQL database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

Databases for PostgreSQLインスタンスを、同じ "host_flavor" パラメータを使用してIsolated computeにスケールします。 このコマンドは、データベースインスタンスを別の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-postgresql"
  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 PostgreSQL database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}