プロビジョニング

第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プロファイル

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 ツールをインストールしてください。

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

    ibmcloud login
    
  2. Gen 2 は、 Isolated Compute のみをサポートしています。 デプロイメントに使用する「Isolated Compute」のサイズを選択してください。

  3. 次のコマンドを実行して、データベースをプロビジョニングしてください:

    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_flavor Isolated 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ホストのバリエーション

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 を使用してプロビジョニングを行うには、以下の手順に従ってください。

  1. IAMトークンを取得します。

  2. デプロイ先とするリソース・グループの ID を知っている必要があります。 このコマンドを使用して、 アカウントリソースグループの一覧を取得します:

    curl -X GET "https://resource-controller.cloud.ibm.com/v2/resource_groups?account_id=<YOUR_ACCOUNT>" -H "Authorization: Bearer <TOKEN>"
    
  3. Gen 2 プラットフォームの「 Isolated Compute 」ホスティングモデル上で、 IBM Cloud® Databases for MySQL インスタンスをプロビジョニングできます。

    図に示すように、 Databases for MySQL インスタンスで利用可能な「Isolated Compute」ホストフレーバーは以下の通りです:

    • bx3d.4x20.encrypted
    • bx3d.8x40.encrypted
    • mx3d.8x80.encrypted
    • bx3d.16x80.encrypted
    • bx3d.32x160.encrypted
    • bx3d.48x240.encrypted

    host_flavor パラメータに関する詳細については、以下をご覧ください。

  4. すべての情報を確認したら、 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ホストのバリエーション

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ホストのバリエーション

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 との連携機能を利用してリソースを監視してください。この機能では、メモリとディスク容量に関するメトリクスが提供されます。 インスタンスにリソースを追加するには、デプロイメントを手動でスケーリングしてください。