Dettagli del servizio

• Nome servizio- Il nome può essere qualsiasi stringa ed è il nome utilizzato sul Web e nella CLI per identificare la nuova distribuzione.
• Gruppo di risorse- Se si organizzano i servizi in gruppi di risorse, specificare il gruppo di risorse in questo campo. Altrimenti, è possibile lasciare il valore predefinito. Per ulteriori informazioni, vedi Gestione dei gruppi di risorse.
• Posizione: la regione del cloud pubblico della distribuzione.

Modello di hosting

• Isolato: soluzione sicura a tenant singolo per carichi di lavoro aziendali complessi e ad alte prestazioni.
• Condivisa: offerta multi-tenant flessibile per selezioni di capacità dinamiche, ottimizzate e disaccoppiate.

Databases for Elasticsearch Le funzioni Platinum sono disponibili solo su Isolated Compute.

Per ulteriori informazioni, vedi Modelli di hosting e Databases for Elasticsearch piani.

Assegnazione delle risorse

Ottimizzare l'assegnazione delle risorse. Le opzioni disponibili differiscono in base al modello di host selezionato.

• Isolato: utilizzare la tabella per scegliere la dimensione della macchina per ciascun membro della distribuzione e specificare la dimensione del disco.
• Condiviso: per impostazione predefinita, viene selezionata l'allocazione di risorse più piccola possibile. Questo è l'ideale per piccole applicazioni o test. Per allocazioni più grandi, seleziona il riquadro Personalizzato, che consente la configurazione di risorse flessibili con 2 + core.

Il modello di host Shared Compute supporta allocazioni di risorse più dettagliate che non vengono mostrate nell'IU per mantenere la chiarezza. Per ulteriori informazioni, vedi Modelli di hosting.

Specificare la dimensione del disco in base ai requisiti. Può essere aumentato dopo il provisioning, ma non può essere diminuito per evitare la perdita di dati.

Configurazione del servizio

• Versione del database: Imposta solo al momento della distribuzione La versione di distribuzione del database. Per garantire prestazioni ottimali, eseguire la versione preferita. L'ultima versione secondaria viene utilizzata automaticamente. Per ulteriori informazioni, vedere Politiche di versione.
• Edizione del database: Imposta solo al momento della distribuzione Selezionare l'edizione che si desidera distribuire. Scegliete tra Enterprise e Platinum. Si noti che Platinum è disponibile solo sul modello di hosting isolato.
• Crittografia: Impostazione solo alla distribuzione Se si usaKey Protect, è possibile selezionare un'istanza e una chiave per crittografare il disco dell'installazione client. Se non si utilizza la propria chiave, la distribuzione crea e gestisce automaticamente la propria chiave di codifica del disco.
• Endpoint: Impostare solo alla distribuzione Configurare gliEndpoint del servizio sulla distribuzione. L'impostazione predefinita è " privato ".

Dopo aver selezionato le impostazioni appropriate, fare clic su Crea per avviare il processo di provisioning.

Crea un'istanza del servizio tramite la CLI

Prima del provisioning, segui le istruzioni fornite nella documentazione per installare lo strumento CLI IBM Cloud.

1. Accedi a IBM Cloud. Se utilizzi un ID utente federato, è importante che tu passi a un codice di accesso monouso (ibmcloud login --sso) oppure che utilizzi una chiave API (ibmcloud --apikey key or @key_file) per l'autenticazione. Per ulteriori informazioni su come effettuare l'accesso tramite la CLI, consultare la sezione " Comandi generali della CLI(ibmcloud) " all'indirizzo ibmcloud login.

   ibmcloud login
   

2. Seleziona il modello host su cui vuoi che venga eseguito il provisioning del tuo database. Puoi modificarlo in un secondo momento.

3. Eseguire il provisioning del database con il seguente comando:

   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>"
   

   Ad esempio, per eseguire il provisioning di un'istanza del modello di hosting Databases for Elasticsearch Shared Compute, utilizzare un comando come:

   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"
   

   Disposizione aDatabases for Elasticsearch Istanza isolata con lo stesso "members_host_flavor"-p parametro, impostandolo sulla dimensione isolata desiderata. Le dimensioni host disponibili e i relativi parametri members_host_flavor value sono riportati nella Tabella 2. Ad esempio, {"members_host_flavor": "b3c.4x16.encrypted"}. Tieni presente che poiché la selezione del flavor host include le dimensioni di CPU e RAM (b3c.4x16.encrypted è 4 CPU e 16 RAM), questa richiesta non accetta entrambe, una selezione di dimensione isolata e selezioni di allocazione di CPU e RAM separate.

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

   I campi nel comando sono descritti nella seguente tabella.

   Campi del formato del comando di base

   Campo	Descrizione	Indicatore
   INSTANCE_NAME Richiesto	Il nome dell'istanza può essere qualsiasi stringa ed è il nome utilizzato sul web e nella CLI per identificare la nuova distribuzione.
   SERVICE_NAME Richiesto	Nome o ID del servizio. Per Databases for Elasticsearch, utilizza databases-for-elasticsearch.
   SERVICE_PLAN_NAME Richiesto	enterprise o platinum. Si noti che platinum richiede un sapore di host isolated.
   LOCATION Richiesto	La posizione in cui si desidera effettuare la distribuzione. Per richiamare un elenco di regioni, utilizzare il comando ibmcloud regions.
   RESOURCE_GROUP	Il nome del gruppo di risorse. Il valore predefinito è default.	-g
   --parameters	File o stringa JSON dei parametri per creare l'istanza del servizio	-p
   members_host_flavor	Per eseguire il provisioning di un'istanza di elaborazione condivisa o isolata, utilizzare {"members_host_flavor": "<members_host_flavor value>"}. Per Shared Compute, specificare un valore di multitenant. Per il calcolo isolato, selezionare la CPU e la configurazione RAM desiderate. Per ulteriori informazioni, consultare la tabella seguente o Modelli di hosting.
   --service-endpoints Richiesto	Configurare gli endpoint del servizio della distribuzione, sia public, private o public-and-private.

   Nella CLI service-endpoints è un indicatore, non un parametro.

Il parametro members host flavor

Il parametro members_host_flavor definisce il dimensionamento del calcolo.

Per eseguire il provisioning di un'istanza di Shared Compute, specificare multitenant. Per eseguire il provisioning di un'istanza Isolate Compute, immetti il valore appropriato per la tua configurazione di CPU e RAM desiderata.

Verrà visualizzata una risposta come:

```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>
  ```

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.

Il parametro --parameters

Il comando service-instance-create supporta un parametro -p, che consente di passare al processo di provisioning parametri in formato JSON. Ad esempio, puoi passare i CRN (Cloud Resource Name) come valori di parametro, che identificano in modo univoco una risorsa nel cloud. Tutti i nomi e i valori dei parametri vengono passati come stringhe.

Ad esempio, se si sta eseguendo il provisioning di un database da un particolare backup e la nuova distribuzione del database necessita di un totale di 12 GB di memoria su tre membri, il comando per eseguire il provisioning di 4 GB per membro si presenta come segue:

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"

Il parametro members host flavor

Il parametro members_host_flavor definisce il dimensionamento del calcolo. Per eseguire il provisioning di un'istanza di calcolo condiviso, specificare multitenant. Per eseguire il provisioning di un'istanza Isolate Compute, immetti il valore appropriato per la tua configurazione di CPU e RAM desiderata.

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.

Provisioning del calcolo condiviso con Terraform

Esegui il provisioning di un'istanza del modello di hosting condiviso Databases for Elasticsearch con il parametro "host_flavor" impostato su multitenant. Vedi il seguente esempio:

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}"
}

Provisioning di calcolo isolato con Terraform

Esegui il provisioning di una istanza isolata Databases for Elasticsearch con lo stesso parametro "host_flavor", impostandola sulla dimensione isolata desiderata. Le dimensioni host disponibili e i relativi parametri host_flavor value sono riportati nella Tabella 1. Ad esempio, {"host_flavor": "b3c.4x16.encrypted"}. Tieni presente che poiché la selezione del flavor host include le dimensioni di CPU e RAM (b3c.4x16.encrypted è 4 CPU e 16 RAM), questa richiesta non accetta entrambe, una selezione di dimensione isolata e selezioni di allocazione di CPU e RAM separate.

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}"
}

Il parametro host flavor

Il parametro host_flavor definisce il dimensionamento del calcolo.

• Compute condiviso- Per eseguire il provisioning di un'istanza di Shared Compute, specificare multitenant.
• Isolated compute- Per eseguire il provisioning di un'istanza Isolated Compute, immettere il valore appropriato per la configurazione di CPU e RAM desiderata. Vedere i valori nella tabella seguente.

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.