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 de 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, consultez la section « Gestion des groupes de ressources ».
• Emplacement : la région cloud du déploiement. Sur la génération 2, le service Databases for MongoDB n'est actuellement disponible que dans les régions suivantes : Montréal (ca-mon), Chennai - Airtel (in-che), Mumbai (in-mum), Francfort (eu-de), Washington (us-east), Madrid (eu-es), Sydney (au-syd), Dallas (us-south) et Londres (eu-gb).

Sélectionnez la plateforme pour votre déploiement.

• Gen 1 : la plateforme d’origine d’ IBM Cloud®, disponible dans tous les centres de données d’ IBM Cloud.
• Gen 2 : la toute dernière plateforme de IBM Cloud®, reposant sur une architecture de réseau définie par logiciel hautement sécurisée. La génération 2 est optimisée pour les applications cloud natives et n'est actuellement disponible qu'à Montréal, Chennai, Mumbai, Francfort, Madrid, Sydney, Washington et Londres.

Pour plus d'informations, consultez la présentation de la génération 1(Classic)et de la génération 2(VPC).

Modèle d'hébergement

Sur Gen 2, le seul modèle d'hébergement disponible est « Isolated », une offre sécurisée à locataire unique destinée aux charges de travail d'entreprise complexes et hautement performantes. Pour plus d'informations, consultez la section « Isolated Compute ».

Allocation de ressources

Choisissez la taille initiale de l'hôte et la configuration du disque pour votre déploiement. La taille de l'hôte et l'allocation de disque s'appliquent à chaque membre de l'instance.

• Capacité de l'hôte : choisissez parmi les configurations disponibles en matière d' vCPU s et de mémoire vive (RAM) celle qui correspond le mieux aux besoins de votre charge de travail.
• Disque : Configurez la taille initiale du disque pour votre déploiement. Utilisez le curseur pour définir la capacité du disque. La taille du disque détermine l'allocation des IOPS. Chaque Go d'espace disque fournit 5 IOPS.

La taille du disque peut être augmentée après son allocation, mais ne peut pas être réduite afin d'éviter toute perte de données.

Configuration de service

• Version de la base de données : Set only at deployment il s'agit de la version de votre déploiement d' MongoDB. La console met en avant la version recommandée afin de garantir des performances optimales. Pour plus d'informations, consultez la politique de gestion des versions.
• Édition de la base de données : Set only at deployment sur la génération 2, seule l’édition Standard est disponible.
• Chiffrement : Set only at deployment Si vous utilisezKey Protect, vous pouvez sélectionner une instance et une clé 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 de terminaison Set only at deployment[Set only at deployment- Pour la génération 2, seuls les points de terminaison privés sont pris en charge.

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 l'interface de ligne de commande (CLI)

Avant de procéder au provisionnement, suivez les instructions fournies dans la documentation pour installer l'outil CLI « 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 connexion via l'interface de ligne de commande (CLI), consultez la section Commandes générales de la CLI(ibmcloud) sous ibmcloud login.

   ibmcloud login
   

2. Vous pouvez provisionner des instances d' IBM Cloud® Databases for MongoDB s selon le modèle d'hébergement « Isolated Compute » sur la plateforme Gen 2.

3. Préparez 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 '{"host_flavor": "<host_flavor value>"}'
   

   Par exemple, pour provisionner une instance Databases for MongoDB, utilisez une commande du type :

   ibmcloud resource service-instance-create test-database databases-for-mongodb standard-gen2 us-south -p '{"host_flavor": "bx3d.4x20.encrypted", "storage_gb": 10 }'
   

   Provisionnez une instance « Isolated » d’ Databases for MongoDB avec le même paramètre « host_flavor » -p, en le définissant sur la taille « Isolated » souhaitée. Les tailles d'hébergement disponibles et leurs paramètres d' host_flavor value s sont répertoriés dans le tableau 2.

   Étant donné que la sélection des configurations proposée aux membres inclut des options de nombre de cœurs de processeur et de mémoire vive (bx3d.4x20.encrypted correspond à 4 cœurs et 20 de mémoire vive), cette demande ne permet pas de choisir à la fois une configuration « Isolated » et des allocations distinctes pour le nombre de cœurs de processeur et la mémoire vive.

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

   Champs du format de base des commandes

   Zone	Description	Indicateur
   INSTANCE_NAME Required	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 de ligne de commande (CLI) pour identifier le nouveau déploiement.
   SERVICE_NAME Required	Nom ou ID du service. Pour « Databases for MongoDB », utilisez « databases-for-mongodb ».
   SERVICE_PLAN_NAME Required	standard-gen2
   LOCATION Required	L'emplacement où vous souhaitez effectuer le déploiement. Pour récupérer la liste des 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
   host_flavor	Pour provisionner une instance « Isolated Compute », rendez-vous sur {"host_flavor": "<host_flavor value>"}. Pour « Isolated Compute », sélectionnez la configuration de processeur et de mémoire vive souhaitée. Pour plus d'informations, consultez le tableau 2 ci-dessous.

   Vous verrez s'afficher une réponse du type :

   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, vous verrez s'afficher une réponse du type :

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

   • Facultatif : pour supprimer une instance de service, exécutez la commande suivante :

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

Le paramètre « host_flavor »

Le paramètre « host_flavor » définit la taille de votre instance Compute. Pour provisionner une instance « Isolated Compute », saisissez la valeur correspondant à la configuration de processeur et de mémoire vive souhaitée.

Le paramètre « --parameters »

La commande service-instance-create prend en charge un indicateur -p qui permet de transmettre des paramètres au format JSON au processus de provisionnement. Par exemple, vous pouvez transmettre des noms de ressources cloud (CRN) en tant que valeurs de paramètres; ceux-ci 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 création à partir d'une sauvegarde spécifique et que le déploiement de cette nouvelle base de données nécessite un hôte de plus grande taille ( 16x80 ), la commande se présente comme suit :

ibmcloud resource service-instance-create databases-for-mongodb <SERVICE_NAME> standard-gen2 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",
  "host_flavor": "bx3d.16x80.encrypted"
}'

Exemple

Pour créer une instance « Isolated Compute », suivez cet exemple :

```sh {: pre}
  curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
  "name": "my-instance",
  "target": "ca-mon",
  "resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
  "resource_plan_id": databases-for-mongodb-gen2-standard",
  "dataservices": {
    "mongodb": {
        "storage_gb": 10,
        "host_flavor": "bx3d.4x20.encrypted"
      },
    "encryption": {
      "disk": "crn:v1..."
    },
    "version": "8",
  },
}'
```
Provisionnez une instance « Isolated » de type « Databases for MongoDB » avec le même paramètre « `host_flavor` », en le définissant sur la taille « Isolated » souhaitée. Les tailles d'hébergement disponibles et leurs paramètres d' `host_flavor value` s sont répertoriés dans [le tableau 2](#members_host-flavor-parameter-api). Par exemple, `{"host_flavor": "bx3d.4x20.encrypted"}`.

Étant donné que la sélection des configurations proposée aux membres inclut des options de nombre de cœurs de processeur et de mémoire vive (bx3d.4x20.encrypted correspond à 4 cœurs et 20 de mémoire vive), cette demande ne permet pas de choisir à la fois une configuration « Isolated » et des allocations distinctes pour le nombre de cœurs de processeur et la mémoire vive.

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

Le paramètre « host_flavor »

Le paramètre « host_flavor » définit la taille de votre instance Compute. Pour provisionner une instance « Isolated Compute », saisissez la valeur correspondant à la configuration de processeur et de mémoire vive souhaitée.

Liste des paramètres supplémentaires

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

• 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 portant 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é pour le chiffrement du disque. Le CRN d'une clé KMS se présente sous la forme crn:v1:<...>:key:<id>.
• backup_encryption_key_crn- Le CRN d'une clé KMS ( Key Protect ), qui est ensuite utilisé pour le chiffrement des sauvegardes. Le CRN d'une clé KMS se présente sous la forme crn:v1:<...>:key:<id>.

Pour utiliser une clé pour vos sauvegardes, vous devez d'abord [activer la délégation de service à service](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok).
{: note}

Provisionnement de ressources de calcul isolées avec Terraform

Provisionnez une instance « Isolated » de type « Databases for MongoDB » avec le même paramètre « "host_flavor" », en le définissant sur la taille « Isolated » souhaitée. Les tailles d'hébergement disponibles et leurs paramètres d' host_flavor value s sont répertoriés dans le tableau 1. Par exemple, {"host_flavor": "bx3d.4x20.encrypted"}. Notez que, puisque la sélection de la configuration de l'hôte inclut les capacités du processeur et de la mémoire vive (bx3d.4x20.encrypted correspond à 4 processeurs et 16 de mémoire vive), cette requête n'accepte pas à la fois une sélection de taille « Isolated » et des sélections distinctes pour l'allocation du processeur et de la mémoire vive.

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 = "bx3d.4x20.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}"
}

Le paramètre « host flavor »

Le paramètre « host_flavor » définit la taille de votre instance Compute. Pour provisionner une instance « Isolated Compute », saisissez la valeur correspondant à la configuration de processeur et de mémoire vive souhaitée. Consultez les valeurs du tableau ci-dessous.