Détails du service

• Nom du service- Ce nom peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface en ligne de commande (CLI) pour identifier le nouveau déploiement.
• Groupe de ressources- Si vous organisez vos services en groupes de ressources, indiquez le groupe de ressources dans ce champ. Sinon, vous pouvez conserver le nom par défaut. Pour plus d'informations, voir Gestion des groupes de ressources.
• Emplacement- La région du cloud public du déploiement.

Modèle d'hébergement

• Isolé : offre sécurisée à locataire unique destinée aux charges de travail d'entreprise complexes et hautement performantes.
• Partagé : offre multi-locataires flexible permettant des choix de capacité dynamiques, précis et découplés.

Databases for Elasticsearch Les fonctionnalités Platinum ne sont disponibles que sur Isolated Compute.

Pour plus d'informations, voir Hosting models et plansDatabases for Elasticsearch.

Allocation de ressources

Affinez votre allocation de ressources. Les options disponibles diffèrent en fonction du modèle d'hébergement que vous avez sélectionné.

• Isolé: Utilisez le tableau pour choisir la taille de la machine pour chaque membre de votre déploiement et indiquez la taille du disque.
• Partagé: par défaut, la plus petite allocation de ressources possible est sélectionnée. Cette solution est idéale pour les petites applications ou les tests. Pour des allocations plus importantes, sélectionnez la vignette Personnalisé, qui permet une configuration flexible des ressources avec plus de 2 coeurs.

Le modèle d'hébergement de calcul partagé prend en charge des allocations de ressources à granularité plus fine qui ne sont pas affichées dans l'interface utilisateur pour maintenir la clarté. Pour plus d'informations, voir Modèles d'hébergement.

Indiquez la taille du disque en fonction de vos besoins. Il peut être augmenté après la mise à disposition, mais il ne peut pas être réduit pour éviter la perte de données.

Configuration de service

• Version de la base de données: Définie uniquement lors du déploiement La version de déploiement de votre base de données. Pour garantir des performances optimales, exécutez la version préférée. La dernière version mineure est utilisée automatiquement. Pour plus d'informations, voir Politique de mise à jour.
• Édition de la base de données: Définir uniquement lors du déploiement Sélectionnez l'édition que vous souhaitez déployer. Choisissez entre Enterprise et Platinum. Notez que Platinum n'est disponible que sur le modèle d'hébergement isolé.
• Cryptage: Configurer uniquement au déploiement Si vous utilisezKey Protect, une instance et une clé peuvent être sélectionnées pour crypter le disque du déploiement. Si vous n'utilisez pas votre propre clé, le déploiement crée et gère automatiquement sa propre clé de chiffrement de disque.
• Endpoints: Set only at deployment Configurez lesEndpoints de service sur votre déploiement. Le paramètre par défaut est « privé ».

Après avoir sélectionné les paramètres appropriés, cliquez sur Créer pour lancer le processus de mise à disposition.

Création d'une instance de service via l'interface de ligne de commande

Avant de mettre à disposition, suivez les instructions fournies dans la documentation pour installer l'outil d'interface de ligne de commande IBM Cloud.

1. Connectez-vous à IBM Cloud. Si vous utilisez un ID utilisateur fédéré, il est important de passer à un code d'accès à usage unique (ibmcloud login --sso) ou d'utiliser une clé d'API (ibmcloud --apikey key or @key_file) pour vous authentifier. Pour plus d'informations sur la procédure de connexion via l'interface de ligne de commande (CLI), consultez la section « Commandes générales de la CLI(ibmcloud) » à l'adresse ibmcloud login.

   ibmcloud login
   

2. Sélectionnez le modèle d'hébergement sur lequel vous souhaitez que votre base de données soit mise à disposition. Vous pourrez changer ces informations ultérieurement.

3. Mettez à disposition votre base de données à l'aide de la commande suivante:

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

   Par exemple, pour provisionner une instance de modèle d'hébergement Databases for Elasticsearch Shared Compute, utilisez une commande comme celle-ci :

   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"
   

   Mise à disposition d'unDatabases for Elasticsearch Instance isolée avec le même "members_host_flavor"-p paramètre, en le réglant à la taille isolée souhaitée. Les tailles d'hébergement disponibles et leurs paramètres members_host_flavor value sont répertoriés dans le Tableau 2. Par exemple, {"members_host_flavor": "b3c.4x16.encrypted"}. Etant donné que la sélection de la version d'hôte inclut des tailles d'UC et de mémoire RAM (b3c.4x16.encrypted est 4 UC et 16 RAM), cette demande n'accepte pas les deux, une sélection de taille isolée et des sélections d'allocation d'UC et de mémoire RAM distinctes.

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

   Les zones de la commande sont décrites dans le tableau qui suit.

   Champs du format de base de la commande

   Zone	Description	Indicateur
   INSTANCE_NAME Exigée	Le nom de l'instance peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface en ligne de commande (CLI) pour identifier le nouveau déploiement.
   SERVICE_NAME Exigée	Nom ou ID du service. Pour Databases for Elasticsearch, utilisez databases-for-elasticsearch.
   SERVICE_PLAN_NAME Exigée	enterprise ou platinum. Notez que platinum nécessite une saveur d'hôte isolated.
   LOCATION Exigée	L'emplacement où vous souhaitez effectuer le déploiement. Pour extraire une liste de régions, utilisez la commande ibmcloud regions.
   RESOURCE_GROUP	Nom du groupe de ressources. La valeur par défaut est default.	-g
   --parameters	Fichier JSON ou chaînes de paramètres JSON pour la création de l'instance de service	-p
   members_host_flavor	Pour mettre à disposition une instance de calcul isolée ou partagée, utilisez {"members_host_flavor": "<members_host_flavor value>"}. Pour Shared Compute, spécifiez une valeur de multitenant. Pour le calcul isolé, sélectionnez la configuration d'UC et de mémoire RAM souhaitée. Pour plus d'informations, voir le tableau suivant ou Modèles d'hébergement.
   --service-endpoints Exigée	Configurez les points d'extrémité du service de votre déploiement, soit public, private ou public-and-private.

   Dans l'interface en ligne de commande (CLI), « service-endpoints » est un indicateur, et non un paramètre.

Paramètre members host flavor

Le paramètre members_host_flavor définit votre taille de calcul.

Pour provisionner une instance Shared Compute, spécifiez multitenant. Pour mettre à disposition une instance de calcul isolé, entrez la valeur appropriée pour la configuration d'UC et de mémoire RAM souhaitée.

Une réponse similaire à la suivante s'affiche:

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

La mise à l'échelle automatique du CPU et de la RAM n'est pas prise en charge sur Cloud Databases Isolated Compute. La mise à l'échelle automatique du disque est disponible. Si vous avez provisionné une instance isolée ou si vous êtes passé d'un déploiement avec autoscaling, gardez un œil sur vos ressources en utilisant l'intégration IBM Cloud® Monitoring, qui fournit des mesures pour la mémoire, l'espace disque et l'utilisation des E/S disque. Pour ajouter des ressources à votre instance, mettez à l'échelle manuellement votre déploiement.

Paramètre --parameters

La commande « service-instance-create » prend en charge le paramètre « -p », qui permet de transmettre des paramètres au format JSON au processus de provisionnement. Par exemple, vous pouvez transmettre des noms de ressource de cloud (CRN) en tant que valeurs de paramètre, qui identifient de manière unique une ressource dans le cloud. Tous les noms et les valeurs de paramètre sont transmis sous forme de chaînes.

Par exemple, si une base de données est en cours de provisionnement à partir d'une sauvegarde spécifique et que le déploiement de cette nouvelle base de données nécessite au total 12 Go de mémoire répartis sur trois nœuds, la commande permettant d'allouer 4 Go par nœud se présente comme suit :

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"

Paramètre members host flavor

Le paramètre members_host_flavor définit votre taille de calcul. Pour mettre à disposition une instance de calcul partagée, spécifiez multitenant. Pour mettre à disposition une instance de calcul isolé, entrez la valeur appropriée pour la configuration d'UC et de mémoire RAM souhaitée.

La mise à l'échelle automatique du CPU et de la RAM n'est pas prise en charge sur Cloud Databases Isolated Compute. La mise à l'échelle automatique du disque est disponible. Si vous avez provisionné une instance isolée ou si vous êtes passé d'un déploiement avec autoscaling, gardez un œil sur vos ressources en utilisant l'intégration IBM Cloud® Monitoring, qui fournit des mesures pour la mémoire, l'espace disque et l'utilisation des E/S disque. Pour ajouter des ressources à votre instance, mettez à l'échelle manuellement votre déploiement.

Provisionnement de l'informatique partagée avec Terraform

Mettez à disposition une instance de modèle d'hébergement partagé Databases for Elasticsearch avec le paramètre "host_flavor" défini sur multitenant. Voir l'exemple suivant :

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

Provisionnement de l'informatique isolée avec Terraform

Mettez à disposition une instance Databases for Elasticsearch isolée avec le même paramètre "host_flavor", en lui affectant la taille d'isolement souhaitée. Les tailles d'hébergement disponibles et leurs paramètres host_flavor value sont répertoriés dans le Tableau 1. Par exemple, {"host_flavor": "b3c.4x16.encrypted"}. Etant donné que la sélection de la version d'hôte inclut des tailles d'UC et de mémoire RAM (b3c.4x16.encrypted est 4 UC et 16 RAM), cette demande n'accepte pas les deux, une sélection de taille isolée et des sélections d'allocation d'UC et de mémoire RAM distinctes.

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

Paramètre host flavor

Le paramètre host_flavor définit votre taille de calcul.

• Compute partagé- Pour provisionner une instance de Compute partagé, spécifiez multitenant.
• Isolated compute- Pour provisionner une instance Isolated Compute, entrez la valeur appropriée pour votre configuration CPU et RAM souhaitée. Voir les valeurs dans le tableau suivant.

La mise à l'échelle automatique du CPU et de la RAM n'est pas prise en charge sur Cloud Databases Isolated Compute. La mise à l'échelle automatique du disque est disponible. Si vous avez provisionné une instance isolée ou si vous êtes passé d'un déploiement avec autoscaling, gardez un œil sur vos ressources en utilisant l'intégration IBM Cloud® Monitoring, qui fournit des mesures pour la mémoire, l'espace disque et l'utilisation des E/S disque. Pour ajouter des ressources à votre instance, mettez à l'échelle manuellement votre déploiement.