服务详细信息

• 服务名称: 该名称可以是任何字符串，并且是 Web 和 CLI 中用于标识新部署的名称。
• 资源组: 如果要将服务组织到 资源组 中，请在此字段中指定资源组。 否则，可以将其保留为缺省值。 有关更多信息，请参阅 管理资源组。
• 位置：部署的公共云区域。

托管模型

• 隔离: 为复杂的高性能企业工作负载提供安全的单租户产品。
• 共享： 灵活的多租户服务，可提供动态、微调和解耦的容量选择。

Databases for MongoDB 企业功能仅适用于隔离计算。

有关更多信息，请参阅 托管模型 和 Databases for MongoDB 套餐。

资源分配

对资源分配进行微调。 可用选项因所选托管模型而异。

• 隔离: 使用表来选择部署的每个成员的机器大小，并指定磁盘大小。
• 共享: 缺省情况下，将选择最小的可能资源分配。 这是小型应用程序或测试的理想选择。 对于较大的分配，请选择 定制 磁贴，这将允许使用 2 + 核心进行灵活的资源配置。

共享计算托管模式支持更细粒度的资源分配，但为了保持清晰，用户界面中不显示这些资源分配。 有关详细信息，请参阅 托管模型。

根据您的需求指定磁盘大小。 可以在供应后增大此值，但不能减小此值以防止数据丢失。

服务配置

• 数据库版本： 仅在部署时设置 这是数据库的部署版本。 我们建议运行首选版本，以确保最佳性能。 有关详细信息，请参阅 版本控制政策。
• 数据库版本： 仅在部署时设置 从标准、企业或企业分片计划中选择。 请注意，共享主机不提供企业和企业分片计划。 有关详细信息，请参阅 计划。
• 加密: 仅在部署时设置 如果使用Key Protect，那么可以选择实例和密钥来加密部署的磁盘。 如果不使用自己的密钥，那么部署会自动创建和管理自己的磁盘加密密钥。
• 端点：仅在部署时设置配置服务终结点 在您的部署中。 默认设置为专用。

Databases for MongoDB 部署不能同时拥有公共端点和专用端点。

选择相应设置后，单击 创建 以启动供应过程。

通过 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. 选择要在其中供应数据库的 托管模型。 您可以稍后更改此内容。

3. 使用以下命令配置数据库

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"
   

例如，要配置 Databases for MongoDB 共享计算托管模型实例，请使用类似命令：

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

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

ibmcloud resource service-instance-create test-database databases-for-mongodb enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"

该命令的字段如下表所示。

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

members host flavor 参数

members_host_flavor 参数定义计算大小。

• 要配置共享计算实例，请指定 multitenant。 要配置隔离计算实例，请输入所需的 CPU 和 RAM 配置的适当值。

  成员主机风味大小参数

  成员主持风味	members_host_flavor 值
  共享计算	multitenant
  4 个 CPU x 16 RAM	b3c.4x16.encrypted
  8 个 CPU x 32 RAM	b3c.8x32.encrypted
  8 个 CPU x 64 RAM	m3c.8x64.encrypted
  16 个 CPU x 64 RAM	b3c.16x64.encrypted
  32 个 CPU x 128 RAM	b3c.32x128.encrypted
  30 个 CPU x 240 RAM	m3c.30x240.encrypted

  您会看到类似这样的回复：

  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-mongodb:us-south: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 <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-mongodb:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
  GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
  Location:              <LOCATION>
  Service Name:          databases-for-mongodb
  Service Plan Name:     standard
  Resource Group Name:   default
  State:                 active
  Type:                  service_instance
  Sub Type:              Public
  Locked:                false
  Service Endpoints:     private
  Created at:            2023-06-26T19:42:07Z
  Created by:            USER
  Updated at:            2023-06-26T19:53:25Z
  Last Operation:
                         Status    create succeeded
                         Message   Provisioning mongodb with version 7.17 (100%)
  

• 可选：要删除服务实例，请运行以下命令：

  ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
  

Cloud Databases 隔离计算不支持 CPU 和 RAM 自动扩展。 磁盘自动缩放可用。 如果您已配置隔离实例或从自动扩展部署切换过来，请使用 IBM Cloud® Monitoring 融合 查看资源情况，它提供内存、磁盘空间和磁盘 I/O 利用率指标。 要向实例添加资源，请手动缩放部署。

--parameters 参数

service-instance-create 命令支持 -p 标记，允许将 JSON 格式的参数传递给调配流程。 例如，您可以将“云资源名称”(CRN) 作为参数值传递，这些参数值唯一地标识云中的资源。 所有参数名称和值都作为字符串传递。

例如，如果数据库是根据特定备份配置的，而新数据库部署的三个成员总共需要 12 GB 内存，那么为每个成员配置 4 GB 内存的命令如下所示：

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

members_host_flavor 参数

members_host_flavor 参数定义计算大小。 要供应共享计算实例，请指定 multitenant。 要配置隔离计算实例，请输入所需的 CPU 和 RAM 配置的适当值。

Cloud Databases 隔离计算不支持 CPU 和 RAM 自动扩展。 磁盘自动缩放可用。 如果您已配置隔离实例或从自动扩展部署切换过来，请使用 IBM Cloud® Monitoring 融合 查看资源情况，它提供内存、磁盘空间和磁盘 I/O 利用率指标。 要向实例添加资源，请手动缩放部署。

附加参数列表

在 --parameters 对象中，您可以提供创建服务实例的其他信息，包括

• backup_id- 要还原的备份资源的 CRN。 备份必须由具有相同服务标识的数据库部署创建。 在供应后装入备份，并启动使用该数据的新部署。 备份 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>。

  要在备份中使用密钥，必须首先 启用服务到服务委托。

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

• members_disk_allocation_mb- 数据库内数据库成员共享的磁盘总量。 例如，如果值为 "30720"，并且有三个成员，那么部署的磁盘总容量为 30 GB，每个成员的磁盘容量为 10 GB。 如果省略，则使用数据库类型的默认值。 此参数仅适用于“多租户”。

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

• members_allocation_count- 数据库成员总数。 该参数仅适用于可水平扩展的数据库。

使用 Terraform 配置共享计算

提供一个 Databases for Elasticsearch 共享托管模型实例，并将 "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-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 = 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 MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

使用 Terraform 配置隔离计算

提供一个具有相同 "host_flavor" 参数的 Databases for MongoDB 隔离实例，并将其设置为所需的隔离大小。 表 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-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 MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

host flavor 参数

host_flavor 参数定义计算大小。

• Shared compute- 要配置共享计算实例，请指定 multitenant。
• 隔离计算- 要配置隔离计算实例，请输入所需的 CPU 和 RAM 配置的相应值。 请参见下表中的数值。

Cloud Databases 隔离计算不支持 CPU 和 RAM 自动扩展。 磁盘自动缩放可用。 如果您已配置隔离实例或从自动扩展部署切换过来，请使用 IBM Cloud® Monitoring 融合 查看资源情况，它提供内存、磁盘空间和磁盘 I/O 利用率指标。 要向实例添加资源，请手动缩放部署。