通过 IBM Cloud 控制台进行供应

通过指定以下参数从控制台进行部署。

通过 CLI 供应

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

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

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

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

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

   使用类似如下的命令:

   ibmcloud resource groups
   

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

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

   该命令如下所示:

   ibmcloud cdb regions --json
   

4. 选择 托管模型，您希望在该模型上配置数据库。 您可以稍后更改此内容。

主机味道代表有保证资源分配的固定大小。 要查看您所在地区提供哪些主机风味，请像这样调用 主机风味能力端点：

curl -X POST  https://api.{region}.databases.cloud.ibm.com/v5/ibm/capability/flavors  \
  -H 'Authorization: Bearer <>' \
  -H 'ContentType: application/json' \
  -d '{
    "deployment": {
      "type": "postgresql",
      "location": "us-south"
    },
  }'

这将返回：

{
  "deployment": {
    "type": "postgresql",
    "location": "us-south",
    "platform": "classic"
  },
  "capability": {
    "flavors": [
      {
        "id": "b3c.4x16.encrypted",
        "name": "4x16",
        "cpu": {
          "allocation_count": 4
        },
        "memory": {
          "allocation_mb": 16384
        },
        "hosting_size": "xs"
      },
      {
        "id": "b3c.8x32.encrypted",
        "name": "8x32",
        "cpu": {
          "allocation_count": 8
        },
        "memory": {
          "allocation_mb": 32768
        },
        "hosting_size": "s"
      },
      {
        "id": "m3c.8x64.encrypted",
        "name": "8x64",
        "cpu": {
          "allocation_count": 8
        },
        "memory": {
          "allocation_mb": 65536
        },
        "hosting_size": "s+"
      },
      {
        "id": "b3c.16x64.encrypted",
        "name": "16x64",
        "cpu": {
          "allocation_count": 16
        },
        "memory": {
          "allocation_mb": 65536
        },
        "hosting_size": "m"
      },
      {
        "id": "b3c.32x128.encrypted",
        "name": "32x128",
        "cpu": {
          "allocation_count": 32
        },
        "memory": {
          "allocation_mb": 131072
        },
        "hosting_size": "l"
      },
      {
        "id": "m3c.30x240.encrypted",
        "name": "30x240",
        "cpu": {
          "allocation_count": 30
        },
        "memory": {
          "allocation_mb": 245760
        },
        "hosting_size": "xl"
      },
      {
        "id": "multitenant",
        "name": "multitenant",
        "cpu": {
          "allocation_count": 0
        },
        "memory": {
          "allocation_mb": 0
        },
        "hosting_size": ""
      }
    ]
  }
}

如图所示，Databases for PostgreSQL区域中的 us-south 实例可用的隔离计算主机风味有

• b3c.4x16.encrypted
• b3c.8x32.encrypted
• m3c.8x64.encrypted
• b3c.16x64.encrypted
• b3c.32x128.encrypted
• m3c.30x240.encrypted

要将实例调配或扩展到 4 个 CPU 和 16384 兆内存，请使用新的 members_host_flavor 提交扩展命令：

    {
      "parameters": {
        "members_host_flavor": "b3c.4x16.encrypted"
      }
    }
    ```
To scale your instance up to 8 CPUs and `32768` megabytes of RAM, submit a scale command with a new `members_host_flavor`:

```sh {: pre}
{
        "parameters": {
            "members_host_flavor": "<members_host_flavor_value>"
        }
}

5. 获取所有信息后，使用 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": "<region>",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-redis-standard"
       "parameters": {
            "members_host_flavor": "<members_host_flavor_value>",
            "service_endpoints": "<ENDPOINT>",
            "version": "<version>"
      }
     }'
   

   例如，要创建共享计算实例，请按照以下示例操作：

   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": "us-south",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-redis-standard"
       "parameters": {
          "members_host_flavor": "multitenant",
          "service_endpoints": "private",
          "members_memory_allocation_mb": 16384,
          "members_cpu_allocation_count": 4
        }
      }'
   

提供一个具有相同 "members_host_flavor" 参数的 Databases for Redis 隔离实例，并将其设置为所需的隔离大小。 表 2 列出了可用的主机大小及其 members_host_flavor value 参数。 例如，{"members_host_flavor": "b3c.4x16.encrypted"}。 请注意，由于主机类型选择包括 CPU 和 RAM 大小（b3c.4x16.encrypted 为 4 CPU 和 16 RAM），因此该请求不接受隔离大小选择和单独的 CPU 和 RAM 分配选择。

   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": "us-south",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-redis-standard"
       "parameters": {
          "member_host_flavor": "b3c.4x16.encrypted",
          "service_endpoints":"private"
        }
      }'

参数 name，target，resource_group 和 resource_plan_id 都是必需的。

下面的表中描述了该命令中的字段。

附加参数列表

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

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

• disk_encryption_key_crn- KMS 密钥的 CRN（例如、Key Protect ），然后用于磁盘加密。 KMS 密钥 CRN 的格式为 crn:v1:<...>:key:<id>。

• backup_encryption_key_crn- KMS 密钥的 CRN（例如、Key Protect )，然后用于备份加密。 KMS 密钥 CRN 的格式为 crn:v1:<...>:key:<id>。

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

• members_memory_allocation_mb-要在数据库中的数据库成员之间共享的内存总量。 例如，如果值为 "8192"，并且有两个数据库成员，那么部署总共获得 8 GB 内存，每个成员获得 4 GB 内存。 如果省略，那么将使用数据库类型的缺省值。 此参数仅适用于“多租户”。

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

• members_cpu_allocation_count- 为部署启用并分配指定数量的内核。 例如，要对每个成员使用两个专用核心，请使用 "members_cpu_allocation_count":"2"。 如果省略，将应用默认的共享计算 CPU:RAM 比例。 此参数仅适用于“多租户”。

使用 Terraform 进行供应

使用 Terraform 管理基础架构，ibm_database Resource for Terraform 支持调配 Cloud Databases 部署。 另外，也可以使用 Terraform IBM 模块，通过 Terraform IBM 模块用于 Databases for Redis 管理基础设施。

选择 托管模型，您希望在该模型上配置数据库。 您可以稍后更改此内容。

提供一个 Databases for Redis 共享托管模型实例，并将 "host_flavor" 参数设置为 multitenant。 请参阅以下示例：

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-redis"
  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 = 8192
    }
    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" 参数的 Databases for Redis 隔离实例，并将其设置为所需的隔离大小。 表 1 列出了可用的主机大小及其 host_flavor value 参数。 例如，{"host_flavor": "b3c.4x16.encrypted"}。 请注意，由于主机类型选择包括 CPU 和 RAM 大小（b3c.4x16.encrypted 为 4 CPU 和 16 RAM），因此该请求不接受隔离大小选择和单独的 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-redis"
  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}"
}

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