通过 IBM Cloud 控制台进行供应

通过指定以下参数从控制台进行供应:

通过 CLI 供应

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-etcd:us-east: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

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

通过资源控制器 API 进行供应

执行以下步骤以使用 资源控制器 API进行供应。

1. 获取 来自 API 令牌的 IAM 令牌。

2. 您需要知道要部署到的资源组的标识。 此信息可通过 IBM Cloud CLI 获取。

   使用类似如下的命令:

   ibmcloud resource groups
   

3. 您需要了解要部署到的区域。

   要列出可从当前区域供应部署的所有区域，请使用 Cloud Databases CLI 插件。

   该命令如下所示:

   ibmcloud cdb regions --json
   

   获取所有信息后，使用 IBM Cloud 资源控制器 供应新的资源实例。

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer <>' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "my-instance",
       "target": "blue-us-south",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-etcd-standard",
       "parameters": {
                "members_host_flavor":"b3c.4x16.encrypted",
                "service_endpoints":"private",
                "version": "<version>"
              }
     }'
   

   要创建共享计算实例，请参考以下示例：

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
       -d '{ \
       "name": "my-instance", \
       "target": "us-south", \
       "resource_group": "<RESOURCE_GROUP_ID>", \
       "resource_plan_id": "<SERVICE_PLAN_NAME>", \
       "parameters": {
         "members_host_flavor": "multitenant",
         "service_endpoints": "private",
         "members_memory_allocation_mb": 16384,
         "members_cpu_allocation_count": 4
       } \
     }' \
   

    Provision a Databases for etcd Isolated instance with the same `"members_host_flavor"` parameter, setting it to the desired Isolated size. Available hosting sizes and their `members_host_flavor value` parameters are listed in [Table 2](#members_host-flavor-parameter-api). For example, `{"members_host_flavor": "b3c.4x16.encrypted"}`. Note that since the host flavor selection includes CPU and RAM sizes (`b3c.4x16.encrypted` is 4 CPU and 16 RAM), this request does not accept both, an Isolated size selection and separate CPU and RAM allocation selections.
   

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
       -d '{ \
       "name": "my-instance", \
       "target": "us-south", \
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711", \
       "resource_plan_id": "<SERVICE_PLAN_NAME>", \
       "parameters": {
       "members_host_flavor": "b3c.4x16.encrypted",
       "service_endpoints": "private"
       } \
     }' \
   

   参数 name、target、resource_group、resource_plan_id 和 service_endpoints 都是必填项。

host_flavor 参数定义计算大小。 输入所需大小的相应值。 要供应共享计算实例，请指定 multitenant。

在 Cloud Databases 隔离计算上不支持 CPU 和 RAM 自动缩放。 磁盘自动缩放可用。 如果已供应隔离实例或通过自动缩放从部署切换，请使用 IBM Cloud® Monitoring 集成 来监视资源，该集成提供内存，磁盘空间和磁盘 I/O 利用率的度量值。 要向实例添加资源，请手动缩放部署。

附加参数列表

• backup_id-要从中复原的备份资源的 CRN。 备份必须由具有相同服务标识的数据库部署创建。 在供应后装入备份，并启动使用该数据的新部署。 备份 CRN 的格式为 crn:v1:<...>:backup:<uuid>。 如果省略，那么会将数据库配置为空。

• version-要供应的数据库的版本。 如果省略，那么将使用最新的主版本和次版本创建数据库。

• disk_encryption_key_crn-随后用于磁盘加密的 KMS 密钥 (例如，Hyper Protect Crypto Services 或 Key Protect) 的 CRN。 KMS 密钥 CRN 的格式为 crn:v1:<...>:key:<id>。

• backup_encryption_key_crn-随后用于备份加密的 KMS 密钥 (例如，Hyper Protect Crypto Services 或 Key Protect) 的 CRN。 KMS 密钥 CRN 的格式为 crn:v1:<...>:key:<id>。

  要将密钥用于备份，必须首先 启用服务到服务委派。

• members_memory_allocation_mb-要在数据库中的数据库成员之间共享的内存总量。 例如，如果值为 "6144"，并且有三个数据库成员，那么部署将获取总共 6 GB 的 RAM，从而为每个成员提供 2 GB 的 RAM。 如果省略，那么将使用数据库类型的缺省值。 此参数仅适用于“多租户”。

• members_disk_allocation_mb-要在数据库中的数据库成员之间共享的磁盘总量。 例如，如果值为 "30720"，并且有三个成员，那么部署将获得总计 30 GB 的磁盘，从而为每个成员提供 10 GB 的磁盘。 如果省略，那么将使用数据库类型的缺省值。 此参数仅适用于“多租户”。

• members_cpu_allocation_count-启用指定的专用核心数并将其分配给您的部署。 例如，要对每个成员使用两个专用核心，请使用 "members_cpu_allocation_count":"2"。 如果省略，那么缺省值“共享 CPU”将使用共享主机上的计算资源。 此参数仅适用于“多租户”。

• service_endpoints- 您的部署支持的 服务端点、public 或 private。

  在 CLI 中，service-endpoints 是一个标志，而不是参数。

使用 Terraform 进行供应

使用 Terraform 通过 ibm_database Resource for Terraform 支持供应 Cloud Databases 部署来管理基础结构。

在现有实例上执行 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。

要通过隔离计算供应实例，请执行以下操作:

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-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  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 Etcd database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

要通过共享计算供应实例，请执行以下操作:

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-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword                = "password12"
  group {
    group_id = "member"
    host_flavor {
      id = "multitenant"
    },
    cpu {
      allocation_count = 3
    }
    memory {
      allocation_mb = 12288
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD Etcd database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

host_flavor 参数定义隔离计算大小。 输入所需大小的相应值。 要供应共享计算实例，请指定 multitenant。

在 Cloud Databases 隔离计算上不支持 CPU 和 RAM 自动缩放。 磁盘自动缩放可用。 如果已供应隔离实例或通过自动缩放从部署切换，请使用 IBM Cloud® Monitoring 集成 来监视资源，该集成提供内存，磁盘空间和磁盘 I/O 利用率的度量值。 要向实例添加资源，请手动缩放部署。