プロビジョニング
第2世代
カタログ、 Cloud Databases CLIプラグイン、 Cloud Databases API、または Terraform を通じて、 IBM Cloud® Databases for MySQL のデプロイメントをプロビジョニングします。
IBM Cloud コンソールによるプロビジョニング
コンソールから、以下のパラメータを指定してデプロイします:
場所とプラットフォーム
- 場所- データベースを展開する地域を選択してください。 リストの各地域には、その地域でサポートされているプラットフォーム( Gen 1 または Gen 2 )が表示されており、製品選びの参考になります。
- プラットフォーム- データベースをデプロイするプラットフォームを選択してください。 ご利用いただけるオプションは、選択した地域によって異なります。 Gen 1 と Gen 2 の違いに関する詳細については、「 Gen 1 および Gen 2 の概要 」を参照してください。
サービスの詳細
- サービス名: 名前は任意の文字列に設定でき、Web や CLI で新しいデプロイメントを識別するために使用される名称です。
- リソースグループ: サービスを リソースグループごとに整理する場合は、このフィールドにリソースグループを指定してください。 それ以外の場合は、この値をデフォルトのままにしておくことができます。 詳細については、「 リソースグループの管理 」を参照してください。
- 場所: デプロイメントのパブリッククラウドリージョン。
デプロイ先のプラットフォームを選択してください。
- Gen 1: IBM Cloud® のオリジナルプラットフォームで、すべての IBM Cloud データセンターで利用可能です。
- Gen 2: IBM Cloud® の最新プラットフォーム。高度にセキュアなソフトウェア定義ネットワーク(SDN)アーキテクチャに基づいています。 Gen 2は、クラウドネイティブアプリケーション向けに最適化されています。
詳細については、「 Gen 1(Classic)および Gen 2(VPC)の概要 」を参照してください。
ホスティング・モデル
Gen 2 は、 Isolated Compute のみをサポートしています。 Isolated Compute は、複雑で高性能なエンタープライズワークロード向けに、専用リソースとハイパーバイザーレベルの分離を備えた、セキュアなシングルテナント型サービスを提供します。 詳細については、「 Isolated Compute 」を参照してください。
リソース割り振り
デプロイメントの初期ホストサイズとディスク構成を選択してください。 ホストのサイズおよびディスクの割り当ては、インスタンスの各メンバーごとに適用されます。 以下の表を参照し、ワークロードの要件に合わせて、 vCPU およびRAMの利用可能な構成を選択してください。
固定プロファイル
| ホスト・サイズ | vCPU x RAM |
|---|---|
| 4x20 | 4 vCPU × 20 GB RAM |
| 8x40 | 8 vCPU × 40 GB RAM |
| 16x80 | 16 vCPU × 80 GB RAM |
| 32x160 | 32 vCPU × 160 GB RAM |
| 48x240 | 48 vCPU × 240 GB RAM |
Flexプロファイル
| ホスト・サイズ | vCPU x RAM |
|---|---|
| 4x16 | 4 vCPU × 16 GB RAM |
| 8x32 | 8 vCPU × 32 GB RAM |
| 16x64 | 16 vCPU × 64 GB RAM |
| 32x128 | 32 vCPU × 128 GB RAM |
ディスク: デプロイメントの初期ディスクサイズを設定します。 スライダーを使ってディスク容量を設定してください。
プロビジョニング後にディスク容量を増やすことはできますが、データの損失を防ぐため、容量を減らすことはできません。
サービス構成
- データベースのバージョン: デプロイ時のみ設定 データベースのデプロイバージョン。 コンソールでは、最適なパフォーマンスを確保するために、推奨されるバージョンが強調表示されます。 Gen 2は MySQL 8.4に対応しています。 最新のマイナー・バージョンが自動的に使用されます。 詳細については、「 バージョン管理ポリシー 」を参照してください。
- 暗号化: デプロイ時のみ設定 もしKey Protect を使用する場合、インスタンスとキーを選択して、デプロイメントのディスクを暗号化できます。 独自の鍵を使用しない場合、デプロイメントは自動的に自身のディスク暗号鍵を作成して管理します。
- エンドポイント: デプロイ時のみ設定可能- Gen 2 はプライベートエンドポイントのみをサポートしています。
適切な設定を選択したら、作成をクリックしてプロビジョニング・プロセスを開始します。
CLI によるプロビジョニング
CLI を使用してサービスインスタンスを作成する
プロビジョニングを行う前に、ドキュメントに記載されている手順に従って、 IBM Cloud CLI ツールをインストールしてください。
-
IBM Cloud にログインします。 フェデレーテッド・ユーザー ID を使用する場合は、ワンタイム・パスコード (
ibmcloud login --sso) に切り替えるか、API キー (ibmcloud --apikey key or @key_file) を使用して認証することが重要です。 CLI を使用したログイン方法の詳細については、ibmcloud loginの「 一般的な CLI(ibmcloud)コマンド」を参照してください。ibmcloud login -
Gen 2 は、 Isolated Compute のみをサポートしています。 デプロイメントに使用する「Isolated Compute」のサイズを選択してください。
-
次のコマンドを実行して、データベースをプロビジョニングしてください:
ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"host_flavor": "<host_flavor value>"}' --service-endpoints="private"たとえば、 Databases for MySQL Gen 2 Isolated Compute インスタンスをプロビジョニングするには、次のようなコマンドを使用します
ibmcloud resource service-instance-create test-instance databases-for-mysql standard-gen2 in-che -g Default -p '{"dataservices": {"mysql": {"storage_gb": 10, "members": 2, "host_flavor": "bxf.4x16"}}}'利用可能なホスティング容量とその
host_flavor valueパラメータ を表2 に示します。 たとえば、{"host_flavor": "b3c.4x16.encrypted"}は、CPU 4コアとRAM 16 GBを搭載しています。 ホストのフレーバー選択にはCPUとRAMの容量が含まれるため、このリクエストでは、「Isolated」サイズの選択と、個別のCPUおよびRAMの割り当て選択を同時に指定することはできませんのでご注意ください。Gen 2 はプライベートエンドポイントのみをサポートしています。
--service-endpointsパラメータは、"private"に設定する必要があります。コマンド内のフィールドについては、以下の表で説明されています。
基本コマンド形式のフィールド フィールド 説明 フラグ INSTANCE_NAME必須インスタンス名は任意の文字列に設定でき、Web上やCLIで新しいデプロイメントを識別するために使用される名前です。 SERVICE_NAME必須サービスの名前または ID。 Databases for MySQL については、 databases-for-mysqlをご利用ください。SERVICE_PLAN_NAME必須スタンダードプラン ( standard-gen2)LOCATION必須デプロイしたい場所。 地域のリストを取得するには、 ibmcloud regionsコマンドを使用します。RESOURCE_GROUPリソースグループ名。 デフォルト値は defaultです。-g --parametersサービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列 -p host_flavorIsolated Compute インスタンスをプロビジョニングするには、 {"host_flavor": "<host_flavor value>"}を使用してください。 「Isolated Compute」では、ご希望のCPUおよびRAM構成を選択してください。 詳細については、以下の 表2 を参照してください。次のような応答が表示されます:
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-mysql:in-che:a/cf8d4161fa0243b9a2a5494cd7ff66b7:d79c8a28-cfe0-4e25-8952-16aaa11cc5f0:: GUID: d79c8a28-cfe0-4e25-8952-16aaa11cc5f0 Location: in-che State: provisioning Type: service_instance Sub Type: Public Allow Cleanup: false Locked: false One-time credentials: true Created at: 2026-06-15T10:36:00Z Updated at: 2026-06-15T10:36:01Z Last Operation: Status create in progress Message Started create instance operation- プロビジョニングの状態を確認するには、次のコマンドを実行してください:
ibmcloud resource service-instance <INSTANCE_NAME>完了すると、次のような応答が表示されます:
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-mysql:in-che:a/cf8d4161fa0243b9a2a5494cd7ff66b7:d79c8a28-cfe0-4e25-8952-16aaa11cc5f0:: GUID: d79c8a28-cfe0-4e25-8952-16aaa11cc5f0 Location: in-che Service Name: databases-for-mysql Service Plan Name: standard-gen2 Resource Group Name: Default State: active Type: service_instance Sub Type: Public Locked: false One-time credentials: true Created at: 2026-06-14T08:48:02Z Created by: USER Updated at: 2026-06-14T09:09:20Z Last Operation: Status create succeeded Message Provision completed successfully-
(任意)次のようなコマンドを実行して、インスタンスを削除します:
ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
host_flavor パラメータ
host_flavor パラメータは、Computeのサイズ設定を定義します。 Gen 2 は、 Isolated Compute のみをサポートしています。 ご希望のCPUおよびRAM構成に合わせて、適切な値を入力してください。
ホストのバリエーションを固定
| ホスト・サイズ | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x20 | 4 vCPU × 20 GB RAM | bx3d.4x20.encrypted |
| 8x40 | 8 vCPU × 40 GB RAM | bx3d.8x40.encrypted |
| 16x80 | 16 vCPU × 80 GB RAM | bx3d.16x80.encrypted |
| 32x160 | 32 vCPU × 160 GB RAM | bx3d.32x160.encrypted |
| 48x240 | 48 vCPU × 240 GB RAM | bx3d.48x240.encrypted |
Flexホストのバリエーション
| ホスト・サイズ | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x16 | 4 vCPU × 16 GB RAM | bxf.4x16.encrypted |
| 8x32 | 8 vCPU × 32 GB RAM | bxf.8x32.encrypted |
| 16x64 | 16 vCPU × 64 GB RAM | bxf.16x64.encrypted |
| 32x128 | 32 vCPU × 128 GB RAM | bxf.32x128.encrypted |
Cloud Databases の「Isolated Compute」では、一般提供(GA)時点でCPUおよびRAMの自動スケーリングはサポートされていません。 Isolatedインスタンスをプロビジョニングした場合、またはオートスケーリングが有効なデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring との連携機能を利用してリソースを監視してください。この機能では、メモリとディスク容量に関するメトリクスが提供されます。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングしてください。
--parameters パラメータ
service-instance-create コマンドは、 -p フラグをサポートしており、これによりJSON形式のパラメータをプロビジョニングプロセスに渡すことができます。 たとえば、クラウド上のリソースを一意に識別する「クラウドリソース名(CRN)」をパラメータ値として渡すことができます。 パラメーター名と値はすべて文字列として渡されます。
たとえば、特定のバックアップからデータベースをプロビジョニングする場合で、新しいデータベースの展開に3つのメンバー全体で合計12 GBのメモリが必要な場合、メンバーごとに4 GBを割り当てるコマンドは次のようになります
ibmcloud resource service-instance-create databases-for-mysql <SERVICE_NAME> standard-gen2 us-south \
-p \ '{
"backup_id": "crn:v1:blue:public:databases-for-mysql-gen2:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
"host_flavor": "bx3d.16x80.encrypted"
リソース・コントローラー API を使用したプロビジョニング
Resource Controller API を使用してプロビジョニングを行うには、以下の手順に従ってください。
-
IAMトークンを取得します。
-
デプロイ先とするリソース・グループの ID を知っている必要があります。 このコマンドを使用して、 アカウントリソースグループの一覧を取得します:
curl -X GET "https://resource-controller.cloud.ibm.com/v2/resource_groups?account_id=<YOUR_ACCOUNT>" -H "Authorization: Bearer <TOKEN>" -
Gen 2 プラットフォームの「 Isolated Compute 」ホスティングモデル上で、 IBM Cloud® Databases for MySQL インスタンスをプロビジョニングできます。
図に示すように、 Databases for MySQL インスタンスで利用可能な「Isolated Compute」ホストフレーバーは以下の通りです:
bx3d.4x20.encryptedbx3d.8x40.encryptedmx3d.8x80.encryptedbx3d.16x80.encryptedbx3d.32x160.encryptedbx3d.48x240.encrypted
host_flavorパラメータに関する詳細については、以下をご覧ください。 -
すべての情報を確認したら、 IBM Cloud リソースコントローラーを使用して、 新しいリソースインスタンスをプロビジョニングします。
curl -X POST \ https://resource-controller.cloud.ibm.com/v2/resource_instances \ -H "Authorization: Bearer <TOKEN>" \ -H 'Content-Type: application/json' \ -d '{ "name": "<INSTANCE_NAME>", "target": "<targeted-region>", "resource_group": "RESOURCE_GROUP_ID", "resource_plan_id": "<SERVICE_PLAN_NAME>", "dataservices": { "<db-service>":{ "host_flavor": "<members_host_flavor_value>", } } }'
例
Isolated Compute インスタンスを作成するには、次の例に従ってください
```sh {: pre}
curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
"name": "my-instance",
"target": "eu-gb",
"resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
"resource_plan_id": "databases-for-mysql-gen2-standard",
"dataservices": {
"mysql": {
"storage_gb": 10,
"host_flavor": "bx3d.4x20.encrypted"
},
"encryption": {
"disk": "crn:v1..."
},
"version": "8.4",
},
}'
```
「 Databases for MySQL 」のIsolatedインスタンスを、同じ `host_flavor` パラメータでプロビジョニングし、そのパラメータを希望するIsolatedサイズに設定します。 利用可能なホスティング容量とその `host_flavor value` パラメータ [を表2](#members_host-flavor-parameter-api) に示します。 例えば、`{"host_flavor": "bx3d.4x20.encrypted"}`です。
メンバーがホストするプランの構成にはCPUとRAMの容量が含まれているため(bx3d.4x20.encrypted はCPU 4コア、RAM 20GB)、このリクエストでは、「Isolated」サイズの選択と、個別のCPUおよびRAMの割り当て選択を同時に指定することはできません。
コマンド内のフィールドについては、以下の表で説明されています。
| フィールド | 説明 | フラグ |
|---|---|---|
name 必須 |
インスタンス名は任意の文字列に設定でき、Web上やCLIで新しいデプロイメントを識別するために使用される名前です。 | |
resource_plan_id 必須 |
サービスの名前または ID。 Databases for MySQL については、 databases-for-mysql-gen2-standard をご利用ください。 |
|
target 必須 |
デプロイしたい場所。 地域のリストを取得するには、 ibmcloud regions コマンドを使用します。 |
|
resource_group 必須 |
リソースグループ名。 デフォルト値は defaultです。 |
-g |
--parameters |
サービスインスタンスを作成するためのパラメータを格納したJSONファイルまたはJSON文字列。 詳細については、以下の情報をご覧ください。 | -p |
host_flavor |
Isolated Compute インスタンスをプロビジョニングするには、 {"host_flavor": "<members_host_flavor value>"} を使用してください。 「Isolated Compute」では、ご希望のCPUおよびRAM構成を選択してください。 詳細については、次の表を参照してください。 |
host_flavor パラメータ
host_flavor パラメータは、Computeのサイズ設定を定義します。 Isolated Compute インスタンスをプロビジョニングするには、希望する CPU および RAM の構成に合わせて適切な値を入力してください。
ホストのバリエーションを固定
| メンバーホストのフレーバー | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x20 | 4 vCPU × 20 GB RAM | bx3d.4x20.encrypted |
| 8x40 | 8 vCPU × 40 GB RAM | bx3d.8x40.encrypted |
| 16x80 | 16 vCPU × 80 GB RAM | bx3d.16x80.encrypted |
| 32x160 | 32 vCPU × 160 GB RAM | bx3d.32x160.encrypted |
| 48x240 | 48 vCPU × 240 GB RAM | bx3d.48x240.encrypted |
Flexホストのバリエーション
| メンバーホストのフレーバー | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x16 | 4 vCPU × 16 GB RAM | bxf.4x16.encrypted |
| 8x32 | 8 vCPU × 32 GB RAM | bxf.8x32.encrypted |
| 16x64 | 16 vCPU × 64 GB RAM | bxf.16x64.encrypted |
| 32x128 | 32 vCPU × 128 GB RAM | bxf.32x128.encrypted |
Cloud Databases の「Isolated Compute」では、CPUおよびRAMの自動スケーリングはサポートされていません。 Isolatedインスタンスをプロビジョニングした場合、またはオートスケーリングが有効なデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring との連携機能を利用してリソースを監視してください。この機能では、メモリとディスク容量に関するメトリクスが提供されます。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングしてください。
追加パラメーターのリスト
--parameters オブジェクトでは、サービスインスタンスを作成するために、次のような追加情報を指定できます
-
backup_id- リストア元となるバックアップ・リソースの CRN。 バックアップは、同じサービス ID を持つデータベースのデプロイによって作成される必要があります。 バックアップはプロビジョニングの後にロードされ、その後にそのデータを使用する新規デプロイメントが開始されます。 バックアップ CRN の形式はcrn:v1:<...>:backup:<uuid>です。 これを省略した場合、データベースは空のままプロビジョンされます。 -
version- プロビジョンするデータベースのバージョン。 省略した場合、データベースは最新のメジャー・バージョンとマイナー・バージョンを使用して作成されます。 -
disk_encryption_key_crn- KMS キーの CRN( Key Protect )のCRN。これはその後、ディスク暗号化に使用されます。 KMS キーの CRN は、crn:v1:<...>:key:<id>という形式になっています。 -
backup_encryption_key_crn- KMS キーの CRN( Key Protect )のCRN。これは、その後バックアップの暗号化に使用されます。 KMS キーの CRN は、crn:v1:<...>:key:<id>という形式になっています。バックアップにキーを使用するには、まず サービス間委任を有効にする 必要があります。
Terraform を使用したプロビジョニング
始めに:
Terraform を使用して、 ibm_database Terraform のリソース を通じてインフラストラクチャを管理し、 Cloud Databases のデプロイのプロビジョニングをサポートします。
データベースをプロビジョニングする ホスティングモデル を選択してください。 これは後から変更できます。
Terraform を使用した隔離されたコンピュートリソースのプロビジョニング
「 Databases for MySQL 」のIsolatedインスタンスを、同じ "host_flavor" パラメータでプロビジョニングし、そのパラメータを希望するIsolatedサイズに設定します。 利用可能なホスティング容量とその host_flavor value パラメータ を表1 に示します。
例えば、{"host_flavor": "bx3d.4x20.encrypted"}です。 ホストのフレーバー選択にはCPUとRAMの容量が含まれているため(bx3d.4x20.encrypted はCPU 4コア、RAM 16GB)、このリクエストでは、「Isolated」サイズの選択と、個別の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-mysql"
resource_group_id = data.ibm_resource_group.group.id
service_endpoints = "private"
tags = ["tag1", "tag2"]
adminpassword = "password12"
group {
group_id = "member"
host_flavor {
id = "bx3d.4x20.encrypted"
}
disk {
allocation_mb = 256000
}
}
users {
name = "user123"
password = "password12"
}
allowlist {
address = "172.168.1.1/32"
description = "desc"
}
}
output "ICD MySQL database connection string" {
value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}
host flavor パラメータ
host_flavor パラメータは、Computeのサイズ設定を定義します。 Isolated Compute インスタンスをプロビジョニングするには、希望する CPU および RAM の構成に合わせて適切な値を入力してください。 以下の表の値をご覧ください。
ホストのバリエーションを固定
| ホスト・サイズ | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x20 | 4 vCPU × 20 GB RAM | bx3d.4x20.encrypted |
| 8x40 | 8 vCPU × 40 GB RAM | bx3d.8x40.encrypted |
| 16x80 | 16 vCPU × 80 GB RAM | bx3d.16x80.encrypted |
| 32x160 | 32 vCPU × 160 GB RAM | bx3d.32x160.encrypted |
| 48x240 | 48 vCPU × 240 GB RAM | bx3d.48x240.encrypted |
Flexホストのバリエーション
| ホスト・サイズ | vCPU x RAM | host_flavor の値 |
|---|---|---|
| 4x16 | 4 vCPU × 16 GB RAM | bxf.4x16.encrypted |
| 8x32 | 8 vCPU × 32 GB RAM | bxf.8x32.encrypted |
| 16x64 | 16 vCPU × 64 GB RAM | bxf.16x64.encrypted |
| 32x128 | 32 vCPU × 128 GB RAM | bxf.32x128.encrypted |
Cloud Databases の「Isolated Compute」では、CPUおよびRAMの自動スケーリングはサポートされていません。 Isolatedインスタンスをプロビジョニングした場合、またはオートスケーリングが有効なデプロイメントから切り替えた場合は、 IBM Cloud® Monitoring との連携機能を利用してリソースを監視してください。この機能では、メモリとディスク容量に関するメトリクスが提供されます。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングしてください。