透過 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. 您需要知道要部署至其中的資源群組 ID。 此資訊可透過 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 兆位元組或 RAM，請提交帶有新 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
        }
      }'
   

規定一Databases for Redis具有相同的孤立實例 "members_host_flavor" 參數，將其設定為所需的隔離大小。 可用的託管大小及其 members_host_flavor value 參數列於 表2。 例如，{"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。 備份必須由具有相同服務 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-要在資料庫內資料庫成員之間共用的記憶體總量。 例如，如果值為“8192”，並且有兩個資料庫成員，則部署總共獲得 8 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 比率。 此參數僅適用於「多租戶」。

使用 Terraform 佈建

使用 Terraform 管理基礎架構，透過 ibm_database Resource for Terraform 支援佈建 Cloud Databases 部署。 另外，您也可以使用 Terraform IBM Modules，透過 Terraform IBM Modules for 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}"
}

規定一Databases for Redis具有相同的孤立實例 "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-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 Script 之前，請使用 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。