서비스 세부사항

• 서비스 이름- 이름은 임의의 문자열로 지정할 수 있으며, 웹 및 CLI에서 새로운 배포를 식별하는 데 사용되는 이름입니다.
• 리소스 그룹- 서비스를 리소스 그룹으로 구성하는 경우, 이 필드에 해당 리소스 그룹을 지정하십시오. 그렇지 않으면 기본값으로 둘 수 있습니다. 자세한 정보는 리소스 그룹 관리를 참조하십시오.
• 위치- 배포의 퍼블릭 클라우드 지역.

호스팅 모델

• 독립형: 복잡하고 고성능이 요구되는 엔터프라이즈 워크로드를 위한 안전한 싱글 테넌트 솔루션.
• 공유형: 동적이며 정밀하게 조정되고 분리된 용량 선택을 지원하는 유연한 멀티테넌트 서비스.

Databases for Elasticsearch 플래티넘 기능은 격리된 컴퓨팅에서만 사용할 수 있습니다.

자세한 정보는 호스팅 모델 및 Databases for Elasticsearch 플랜 을 참조하십시오.

리소스 할당

자원 할당을 미세 조정하십시오. 사용 가능한 옵션은 선택한 호스팅 모델에 따라 다릅니다.

• 분리됨: 테이블을 사용하여 배치의 각 멤버에 대한 시스템 크기를 선택하고 디스크 크기를 지정하십시오.
• 공유: 기본적으로 가능한 가장 작은 자원 할당이 선택됩니다. 이는 소규모 애플리케이션 또는 테스트에 이상적입니다. 더 큰 할당의 경우 사용자 정의 타일을 선택하십시오. 이 타일은 2+개의 코어가 있는 유연한 자원 구성을 허용합니다.

공유 컴퓨팅 호스팅 모델은 명확성을 유지하기 위해 UI에 표시되지 않는 더 세분화된 자원 할당을 지원합니다. 자세한 정보는 호스팅 모델 을 참조하십시오.

요구사항에 따라 디스크 크기를 지정하십시오. 프로비저닝 후에는 늘릴 수 있지만 데이터 유실을 방지하기 위해 줄일 수는 없습니다.

서비스 구성

• 데이터베이스 버전: 배포 시에만 설정 데이터베이스의 배포 버전입니다. 최적의 성능을 보장하려면 선호하는 버전을 실행하십시오. 최신 부 버전이 자동으로 사용됩니다. 자세한 내용은 버전 정책를 참조하세요.
• 데이터베이스 에디션: 배포 시에만 설정 배포할 에디션을 선택합니다. 엔터프라이즈 또는 플래티넘 중에서 선택하세요. 플래티넘은 격리 호스팅 모델에서만 사용할 수 있습니다.
• 암호화: 배포 시에만 설정Key Protect 를 사용하는 경우 인스턴스와 키를 선택하여 배포의 디스크를 암호화할 수 있습니다. 자체 키를 사용하지 않는 경우 배치에서 자체 디스크 암호화 키를 자동으로 작성하고 관리합니다.
• 엔드포인트: 배포 시에만 설정 배포에서서비스 엔드포인트 를 구성합니다. 기본 설정은 ‘비공개’입니다.

적절한 설정을 선택한 후 작성을 클릭하여 프로비저닝 프로세스를 시작하십시오.

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> <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<Endpoint>"
   

   예를 들어, Databases for Elasticsearch 공유 컴퓨팅 호스팅 모델 인스턴스를 프로비저닝하려면 다음과 같은 명령을 사용하세요:

   ibmcloud resource service-instance-create test-database databases-for-elasticsearch enterprise us-south -p '{ "backup_id": "<BACKUP_CRN>", "version": "<VERSION_STRING>", "members_memory_allocation_mb": "4096" }' --service-endpoints="private"
   

   프로비저닝Databases for Elasticsearch 동일한 인스턴스가 있는 격리된 인스턴스 "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-elasticsearch enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"
   

   명령의 필드에 대해서는 다음 테이블에서 설명합니다.

   기본 명령 형식 필드

   필드	설명	플래그
   INSTANCE_NAME 필수	인스턴스 이름은 임의의 문자열로 지정할 수 있으며, 웹 및 CLI에서 새로운 배포를 식별하는 데 사용되는 이름입니다.
   SERVICE_NAME 필수	서비스의 이름 또는 ID입니다. Databases for Elasticsearch의 경우 databases-for-elasticsearch 를 사용하십시오.
   SERVICE_PLAN_NAME 필수	enterprise 또는 platinum. platinum 호스트 플레이버가 필요한 경우 isolated 호스트 플레이버가 필요합니다.
   LOCATION 필수	배포하려는 위치. 리젼 목록을 검색하려면 ibmcloud regions 명령을 사용하십시오.
   RESOURCE_GROUP	자원 그룹 이름입니다. 기본값은 default입니다.	-g
   --parameters	서비스 인스턴스를 작성하기 위한 매개변수의 JSON 파일 또는 JSON 문자열	-p
   members_host_flavor	격리 또는 공유 컴퓨팅 인스턴스를 프로비저닝하려면 {"members_host_flavor": "<members_host_flavor value>"} 를 사용하십시오. 공유 컴퓨팅의 경우 multitenant 값을 지정합니다. 격리된 컴퓨팅의 경우 원하는 CPU및 RAM 구성을 선택하십시오. 자세한 내용은 다음 표 또는 호스팅 모델 를 참조하세요.
   --service-endpoints 필수	배포의 서비스 엔드포인트(public, private 또는 public-and-private 중 하나)를 구성합니다.

   CLI에서 service-endpoints 는 매개변수가 아니라 플래그입니다.

members host flavor 매개변수

members_host_flavor 매개변수는 컴퓨팅 크기 조정을 정의합니다.

공유 컴퓨트 인스턴스를 프로비저닝하려면 multitenant 을 지정합니다. 격리된 컴퓨팅 인스턴스를 프로비저닝하려면 원하는 CPU및 RAM 구성에 적절한 값을 입력하십시오.

다음과 같은 응답이 표시됩니다.

```text {: codeblock}
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-elasticsearch: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
```
- To check provisioning status, use the following command:

  ```sh {: pre}
  ibmcloud resource service-instance <INSTANCE_NAME>
  ```
  When complete, you will see a response like:

  ```text {: codeblock}
  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-elasticsearch:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
  GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
  Location:              <LOCATION>
  Service Name:          databases-for-elasticsearch
  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 elasticsearch with version 7.17 (100%)
  ```
- Optional: To delete a service instance, run the following command:

  ```sh {: pre}
  ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
  ```

Cloud Databases 격리된 컴퓨팅에서는 CPU 및 RAM 자동 확장 기능이 지원되지 않습니다. 디스크 자동 스케일링 기능을 사용할 수 있습니다. 격리 인스턴스를 프로비저닝했거나 자동 확장 기능이 있는 배포에서 전환한 경우, 메모리, 디스크 공간 및 디스크 I/O 사용률에 대한 메트릭을 제공하는 IBM Cloud® Monitoring 통합을 사용하여 리소스를 계속 주시하세요. 인스턴스에 리소스를 추가하려면 수동으로 배치의 크기를 조정하십시오.

--parameters 매개변수

service-instance-create 명령어는 -p 매개변수를 지원하며, 이를 통해 JSON 형식의 매개변수를 프로비저닝 프로세스로 전달할 수 있습니다. 예를 들어, 클라우드에서 자원을 고유하게 식별하는 매개변수 값으로 클라우드 자원 이름 (CRN) 을 전달할 수 있습니다. 모든 매개변수 이름 및 값은 문자열로 전달됩니다.

예를 들어, 특정 백업에서 데이터베이스를 프로비저닝하고 있으며, 새로 배포되는 데이터베이스가 3개의 멤버에 걸쳐 총 12GB의 메모리가 필요한 경우, 멤버당 4GB씩 할당하는 명령어는 다음과 같습니다:

ibmcloud resource service-instance-create databases-for-elasticsearch <INSTANCE_NAME> enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-elasticsearch: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 자동 확장 기능이 지원되지 않습니다. 디스크 자동 스케일링 기능을 사용할 수 있습니다. 격리 인스턴스를 프로비저닝했거나 자동 확장 기능이 있는 배포에서 전환한 경우, 메모리, 디스크 공간 및 디스크 I/O 사용률에 대한 메트릭을 제공하는 IBM Cloud® Monitoring 통합을 사용하여 리소스를 계속 주시하세요. 인스턴스에 리소스를 추가하려면 수동으로 배치의 크기를 조정하십시오.

Terraform으로 공유 컴퓨팅 프로비저닝하기

"host_flavor" 매개변수가 multitenant 로 설정된 Databases for Elasticsearch 공유 호스팅 모델 인스턴스를 프로비저닝합니다. 다음 예를 참조하십시오.

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-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  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 Elasticsearch database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

Terraform으로 격리된 컴퓨팅 프로비저닝하기

Databases for Elasticsearch 동일한 "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-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  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 Elasticsearch database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

host flavor 매개변수

host_flavor 매개변수는 컴퓨팅 크기 조정을 정의합니다.

• 공유 컴퓨트- 공유 컴퓨트 인스턴스를 프로비저닝하려면 multitenant 를 지정합니다.
• 격리 컴퓨팅- 격리 컴퓨팅 인스턴스를 프로비저닝하려면 원하는 CPU 및 RAM 구성에 적합한 값을 입력합니다. 다음 표의 값을 참조하세요.

Cloud Databases 격리된 컴퓨팅에서는 CPU 및 RAM 자동 확장 기능이 지원되지 않습니다. 디스크 자동 스케일링 기능을 사용할 수 있습니다. 격리 인스턴스를 프로비저닝했거나 자동 확장 기능이 있는 배포에서 전환한 경우, 메모리, 디스크 공간 및 디스크 I/O 사용률에 대한 메트릭을 제공하는 IBM Cloud® Monitoring 통합을 사용하여 리소스를 계속 주시하세요. 인스턴스에 리소스를 추가하려면 수동으로 배치의 크기를 조정하십시오.