Détails du service

• Nom du service : le nom peut être n'importe quelle chaîne de caractères et c'est le nom qui est utilisé sur le web et dans le 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 à service exclusif pour des charges de travail d'entreprise complexes et hautement performantes.
• Shared: Offre multi-tenant flexible pour des sélections de capacité dynamiques, affinées et découplées.

Databases for MongoDB Les fonctionnalités d'entreprise ne sont disponibles que sur Isolated Compute.

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

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 Shared Compute prend en charge des allocations de ressources plus fines 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 Il s'agit de la version de déploiement de votre base de données. Nous recommandons d'utiliser la version préférée pour garantir des performances optimales. Pour plus d'informations, voir Politique de gestion des versions.
• Édition de la base de données : Défini uniquement lors du déploiement Sélectionnez Standard, Enterprise ou Enterprise Sharding plans. Notez que les plans Enterprise et Enterprise Sharding ne sont pas disponibles avec l'hébergement partagé. Pour plus d'informations, voir Des plans.
• Chiffrement: Défini uniquement lors du déploiement Si vous utilisezKey Protect, une instance et une clé peuvent être sélectionnées pour chiffrer 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.
• Points finaux : Définir uniquement lors du déploiement Configurez lePoints de terminaison du service sur votre déploiement. Le réglage par défaut est privé.

Un déploiement Databases for MongoDB ne peut pas avoir simultanément des points d'extrémité publics et privés.

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

Créer une instance de service via la CLI

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 façon de se connecter à l'aide de l'interface de commande, voir Commandes générales de l'interface de commande(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. Provisionnez votre base de données avec la commande suivante :

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

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

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"

Fournir une Databases for MongoDB instance isolée avec le même "members_host_flavor" -p paramètre, en le réglant sur la taille souhaitée de l'instance isolée. Tailles d'hébergement disponibles et leurs members_host_flavor value les paramètres sont répertoriés dans Tableau 2. Par exemple, {"members_host_flavor": "b3c.4x16.encrypted"}. Notez que puisque la sélection de la saveur de l'hôte inclut les tailles de CPU et de RAM (b3c.4x16.encrypted est 4 CPU et 16 RAM), cette requête n'accepte pas à la fois une sélection de taille isolée et des sélections séparées d'allocation de CPU et de RAM.

ibmcloud resource service-instance-create test-database databases-for-mongodb 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.

Dans le CLI, service-endpoints est un drapeau, pas 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 provisionner une instance de calcul isolé, saisissez la valeur appropriée pour la configuration de CPU et de RAM souhaitée.

  Paramètre de dimensionnement de la saveur de l'hôte des membres

  Les membres accueillent les saveurs	members_host_flavor valeur
  Traitement partagé	multitenant
  4 UC x 16 RAM	b3c.4x16.encrypted
  8 UC x 32 RAM	b3c.8x32.encrypted
  8 UC x 64 RAM	m3c.8x64.encrypted
  16 UC x 64 RAM	b3c.16x64.encrypted
  32 UC x 128 RAM	b3c.32x128.encrypted
  30 UC x 240 RAM	m3c.30x240.encrypted

  Vous verrez une réponse comme :

  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
  

• Pour vérifier l'état du provisionnement, utilisez la commande suivante :

  ibmcloud resource service-instance <INSTANCE_NAME>
  

  Une fois l'opération terminée, une réponse similaire à la suivante s'affiche:

  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%)
  

• En outre, il est possible de supprimer une instance de service en exécutant la commande suivante Pour supprimer une instance de service, exécutez la commande suivante :

  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 l'option -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 provisionnée à partir d'une sauvegarde particulière et que le déploiement de la nouvelle base de données nécessite un total de 12 Go de mémoire sur trois membres, la commande de provisionnement de 4 Go par membre se présente comme suit :

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"

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 provisionner une instance de calcul isolé, saisissez la valeur appropriée pour la configuration de CPU et de 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.

Liste des paramètres supplémentaires

Dans l'objet --parameters, vous pouvez fournir des informations supplémentaires pour créer votre instance de service :

• backup_id - CRN d'une ressource de sauvegarde à partir de laquelle la restauration doit être effectuée. La sauvegarde doit être créée par un déploiement de base de données avec le même identifiant de service. La sauvegarde est chargée après la mise à disposition et le nouveau déploiement démarre et utilise ces données. Un CRN de sauvegarde a le format crn:v1:<...>:backup:<uuid>. S'il est omis, la base de données est mise à disposition vide.

• version - Version de la base de données à mettre à disposition. S'il est omis, la base de données est créée avec la version majeure et la version mineure la plus récente.

• disk_encryption_key_crn- Le CRN d'une clé KMS ( Key Protect ), qui est ensuite utilisée pour le cryptage du disque. Le CRN d'une clé KMS se présente sous la forme suivante : crn:v1:<...>:key:<id>.

• backup_encryption_key_crn- Le CRN d'une clé KMS ( Key Protect ), qui est ensuite utilisée pour le cryptage des sauvegardes. Le CRN d'une clé KMS se présente sous la forme suivante : crn:v1:<...>:key:<id>.

  Pour utiliser une clé pour vos sauvegardes, vous devez d'abord activer la délégation de service à service.

• members_memory_allocation_mb - Quantité totale de mémoire à partager entre les membres de la base de données au sein de la base de données. Par exemple, si la valeur est "12288" et qu'il y a trois membres de la base de données, le déploiement obtient 12 Go de RAM au total, soit 4 Go de RAM par membre. En cas d'omission, la valeur par défaut pour le type de base de données est utilisée. Ce paramètre s'applique uniquement à ` multitenant'.

• members_disk_allocation_mb - Quantité totale de disque à partager entre les membres de la base de données au sein de la base de données. Par exemple, si la valeur est "30720", et qu'il y a trois membres, alors le déploiement obtient 30 Go de disque au total, ce qui donne 10 Go de disque par membre. En cas d'omission, la valeur par défaut pour le type de base de données est utilisée. Ce paramètre s'applique uniquement à ` multitenant'.

• members_cpu_allocation_count- Active et alloue le nombre de cœurs spécifiés à votre déploiement. Par exemple, pour utiliser deux coeurs dédiés par membre, utilisez "members_cpu_allocation_count":"2". S'il est omis, les ratios CPU:RAM par défaut de l'unité de calcul partagée seront appliqués. Ce paramètre s'applique uniquement à ` multitenant'.

• members_allocation_count- Le nombre total de membres de la base de données. Ce paramètre ne s'applique qu'aux bases de données évolutives horizontalement.

Provisionner des ressources informatiques partagées avec Terraform

Fournissez une instance de modèle d'hébergement partagé 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-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}"
}

Provisionnement de calcul isolé avec Terraform

Mise à disposition d'un Databases for MongoDB Instance isolée avec le même "host_flavor" paramètre, en le réglant à la taille isolée souhaitée. Les tailles d'hébergement disponibles et leurs host_flavor value paramètres sont énumérés dans le Tableau 1. Par exemple, {"host_flavor": "b3c.4x16.encrypted"}. Notez que puisque la sélection du type d'hôte inclut les tailles de CPU et de RAM (b3c.4x16.encrypted est 4 CPU et 16 RAM), cette demande n'accepte pas à la fois une sélection de taille isolée et des sélections d'allocation de CPU et de 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-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}"
}

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.