服務詳細資料

• 服務名稱: 名稱可以是任何字串，而且是在 Web 及 CLI 中用來識別新部署的名稱。
• 資源群組: 如果您要將服務組織成 資源群組，請在此欄位中指定資源群組。 否則，您可以保留預設值。 有關詳細信息，請參閱 管理資源組。
• 位置： 部署的公有雲區域。

代管模式

• 隔離: 針對複雜且高效能的企業工作負載提供安全單一租戶供應項目。
• 共享： 靈活的多租戶產品，可實現動態、微調和解耦的容量選擇。

Databases for MongoDB 企業功能僅在 Isolated Compute 上提供。

如需相關資訊，請參閱 管理模型 及 Databases for MongoDB 方案。

資源配置

細部調整您的資源配置。 可用的選項會根據您選取的管理模型而有所不同。

• 隔離: 使用表格來選擇部署中每一個成員的機器大小，並指定磁碟大小。
• 共用: 依預設，會選取可能的最小資源配置。 這適用於小型應用程式或測試。 對於較大的配置，請選取 自訂 磚，以容許具有 2 個以上核心的彈性資源配置。

共享運算託管模型支援更細粒度的資源分配，為保持清晰度，這些資源分配未顯示在 UI 中。 有關更多信息，請參閱 託管模式。

視您的需求而定，指定磁碟大小。 它可以在佈建之後增加，但無法減少以防止資料流失。

服務配置

• 資料庫版本：僅在部署時設定這是資料庫的部署版本。 我們建議運行首選版本以確保最佳效能。 有關更多信息，請參閱 版本控制政策。
• 資料庫版本： 僅在部署時設定 從 Standard、Enterprise 或 Enterprise Sharding 計劃中選擇。 請注意，企業和企業分片計劃不適用於共用主機。 有關更多信息，請參閱 計劃。
• 加密: 僅在部署時設定 如果您使用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"

規定一Databases for MongoDB具有相同的孤立實例 "members_host_flavor"-p參數，將其設定為所需的隔離大小。 可用的託管大小及其 members_host_flavor value 參數列於 表2。 例如，{"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 Isolated Compute 不支援 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 Isolated Compute 不支援 CPU 和 RAM 自動調整。 磁碟自動調整可用。 如果您已佈建隔離式實體，或從具有自動擴充功能的部署轉換過來，請使用 IBM Cloud® Monitoring 整合來監控您的資源，它可提供記憶體、磁碟空間和磁碟 I/O 使用率的指標。 若要將資源新增至實例，請手動調整部署。

附加參數列表

在 --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>。

  若要使用金鑰進行備份，您必須先 啟用服務到服務委派。

• members_memory_allocation_mb- 資料庫內的資料庫成員之間共享的記憶體總量。 例如，如果值為“12288”，並且有三個資料庫成員，則部署總共獲得 12 GB RAM，為每個成員提供 4 GB RAM。 如果省略，則會使用資料庫類型的預設值。 此參數僅適用於「多租戶」。

• 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 配置隔離計算

規定一Databases for MongoDB具有相同的孤立實例 "host_flavor" 參數，將其設定為所需的隔離大小。 可用的託管大小及其 host_flavor value 參數列於 表1。 例如，{"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 參數定義計算大小。

• 共享運算- 若要設定共用運算實例，請指定 multitenant。
• 隔離計算- 若要設定隔離計算實例，請輸入您所需的 CPU 和 RAM 配置的適當值。 請參閱下表中的值。

Cloud Databases Isolated Compute 不支援 CPU 和 RAM 自動調整。 磁碟自動調整可用。 如果您已佈建隔離式實體，或從具有自動擴充功能的部署轉換過來，請使用 IBM Cloud® Monitoring 整合來監控您的資源，它可提供記憶體、磁碟空間和磁碟 I/O 使用率的指標。 若要將資源新增至實例，請手動調整部署。