Detalles de servicio

• Nombre del servicio: El nombre puede ser cualquier cadena de caracteres y es el nombre que se utiliza en la web y en la CLI para identificar la nueva implementación.
• Grupo de recursos: si estás organizando tus servicios en grupos de recursos, especifica el grupo de recursos en este campo. De lo contrario, puede dejar el valor predeterminado. Para obtener más información, consulta « Gestión de grupos de recursos ».
• Ubicación: La región de la nube en la que se encuentra la implementación. En la 2.ª generación, Databases for MongoDB solo está disponible actualmente en las regiones de Montreal (ca-mon), Chennai - Airtel (in-che), Mumbai (in-mum), Fráncfort (eu-de), Washington (us-east), Madrid (eu-es), Sídney (au-syd), Dallas (us-south) y Londres (eu-gb).

Selecciona la plataforma para tu implementación.

• Gen 1: la plataforma original de IBM Cloud®, disponible en todos los centros de datos de IBM Cloud.
• Gen 2: la última plataforma de IBM Cloud®, basada en una arquitectura de redes definidas por software de alta seguridad. La 2.ª generación está optimizada para aplicaciones nativas de la nube y, actualmente, solo está disponible en Montreal, Chennai, Bombay, Fráncfort, Madrid, Sídney, Washington y Londres.

Para obtener más información, consulta la descripción general de la 1.ª generación(Clásica)y la 2.ª generación(VPC).

Modelo de alojamiento

En Gen 2, el único modelo de alojamiento disponible es «Isolated», una oferta segura de inquilino único destinada a cargas de trabajo empresariales complejas y de alto rendimiento. Para obtener más información, consulta « Isolated Compute ».

Asignación de recursos

Elige el tamaño inicial del servidor y la configuración del disco para tu implementación. El tamaño del servidor y la asignación de disco se aplican por cada miembro de la instancia.

• Capacidad del servidor: elige entre las configuraciones disponibles de « vCPU » y RAM para adaptarlas a las necesidades de tu carga de trabajo.
• Disco: Configura el tamaño inicial del disco para tu implementación. Utiliza el control deslizante para configurar la capacidad del disco. El tamaño del disco determina la asignación de IOPS. Cada GB de disco proporciona 5 IOPS.

El tamaño del disco se puede aumentar tras el aprovisionamiento, pero no se puede reducir para evitar la pérdida de datos.

Configuración del servicio

• Versión de la base de datos: Set only at deployment esta es la versión de su implementación de MongoDB. La consola destaca la versión recomendada para garantizar un rendimiento óptimo. Para obtener más información, consulta la política de versiones.
• Edición de la base de datos: Set only at deployment en la 2.ª generación, solo está disponible la edición Standard.
• Cifrado: Set only at deployment Si utilizasKey Protect, puedes seleccionar una instancia y una clave para cifrar el disco de la implementación. Si no utiliza su propia clave, el despliegue crea y gestiona automáticamente su propia clave de cifrado de disco.
• Puntos de conexión Set only at deployment[Set only at deployment- Para la 2.ª generación, solo se admiten puntos de conexión privados.

Después de seleccionar los valores adecuados, pulse Crear para iniciar el proceso de suministro.

Crear una instancia de servicio a través de la CLI

Antes de realizar el aprovisionamiento, sigue las instrucciones que figuran en la documentación para instalar la herramienta CLI de IBM Cloud.

1. Inicie sesión en IBM Cloud. Si utiliza un ID de usuario federado, es importante que cambie a un código de acceso de una sola vez (ibmcloud login --sso) o utilice una clave de API (ibmcloud --apikey key or @key_file) para la autenticación. Para obtener más información sobre cómo iniciar sesión mediante la CLI, consulta en Comandos generales de la CLI(ibmcloud) ibmcloud login.

   ibmcloud login
   

2. Puedes aprovisionar instancias de « IBM Cloud® Databases for MongoDB » en el modelo de alojamiento «Isolated Compute» en la plataforma Gen 2.

3. Configura tu base de datos con el siguiente comando :

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"host_flavor": "<host_flavor value>"}'
   

   Por ejemplo, para aprovisionar una instancia de Databases for MongoDB, utiliza un comando como este:

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

   Provisióna una instancia aislada de « Databases for MongoDB » con el mismo parámetro « host_flavor » -p, configurándolo con el tamaño de «Isolated» deseado. En la tabla 2 se enumeran los tamaños de alojamiento disponibles y sus parámetros de host_flavor value.

   Dado que la selección de configuraciones de los miembros incluye los valores de CPU y RAM (bx3d.4x20.encrypted tiene 4 CPU y 20 RAM), esta solicitud no admite a la vez una selección de tamaño «aislado» y selecciones separadas de asignación de CPU y RAM.

   Los campos del mandato se describen en la tabla siguiente.

   Campos del formato básico de comando

   Campo	Descripción	Distintivo
   INSTANCE_NAME Required	El nombre de la instancia puede ser cualquier cadena de caracteres y es el nombre que se utiliza en la web y en la CLI para identificar la nueva implementación.
   SERVICE_NAME Required	Nombre o ID del servicio. Para acceder a « Databases for MongoDB », utiliza databases-for-mongodb.
   SERVICE_PLAN_NAME Required	standard-gen2
   LOCATION Required	La ubicación en la que desea realizar la implementación. Para obtener una lista de regiones, utiliza el comando « ibmcloud regions ».
   RESOURCE_GROUP	El nombre del grupo de recursos. El valor predeterminado es default.	-g
   --parameters	Archivo JSON o serie JSON de parámetros para crear instancia de servicio	-p
   host_flavor	Para aprovisionar una instancia de Isolated Compute, utiliza {"host_flavor": "<host_flavor value>"}. En «Computación aislada», selecciona la configuración de CPU y RAM que desees. Para obtener más información, consulte la Tabla 2 que figura a continuación.

   Verás una respuesta similar a esta:

   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
   

   • Para comprobar el estado del aprovisionamiento, utiliza el siguiente comando :

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   Una vez finalizado el proceso, verás una respuesta similar a esta:

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

   • Opcional: Para eliminar una instancia de servicio, ejecuta el siguiente comando :

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

El parámetro « host_flavor »

El parámetro « host_flavor » define el tamaño de tu recurso de Compute. Para aprovisionar una instancia de Isolated Compute, introduce el valor adecuado para la configuración de CPU y RAM que desees.

El parámetro « --parameters »

El comando service-instance-create admite un indicador -p que permite pasar parámetros en formato JSON al proceso de aprovisionamiento. Por ejemplo, puedes pasar nombres de recursos en la nube (CRN) como valores de parámetro, que identifican de forma única un recurso en la nube. Todos los nombres y valores de parámetros se pasan como series.

Por ejemplo, si se está creando una base de datos a partir de una copia de seguridad concreta y la nueva implementación de la base de datos requiere un host de mayor tamaño ( 16x80 ), el comando quedaría así:

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

Ejemplo

Para crear una instancia de Isolated Compute, sigue este ejemplo:

```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",
  },
}'
```
Provisióna una instancia aislada de « Databases for MongoDB » con el mismo parámetro « `host_flavor` », configurándolo con el tamaño de instancia aislada deseado. En [la tabla 2](#members_host-flavor-parameter-api) se enumeran los tamaños de alojamiento disponibles y sus parámetros de `host_flavor value`. Por ejemplo, `{"host_flavor": "bx3d.4x20.encrypted"}`.

Dado que la selección de configuraciones de los miembros incluye los valores de CPU y RAM (bx3d.4x20.encrypted tiene 4 CPU y 20 RAM), esta solicitud no admite a la vez una selección de tamaño «aislado» y selecciones separadas de asignación de CPU y RAM.

Los campos del mandato se describen en la tabla siguiente.

El parámetro « host_flavor »

El parámetro « host_flavor » define el tamaño de tu recurso de Compute. Para aprovisionar una instancia de Isolated Compute, introduce el valor adecuado para la configuración de CPU y RAM que desees.

Lista de parámetros adicionales

En el objeto --parameters puedes proporcionar información adicional para crear tu instancia de servicio, entre la que se incluye:

• backup_id - Un CRN de un recurso de copia de seguridad desde el que restaurar. La copia de seguridad debe crearse mediante una implementación de base de datos con el mismo ID de servicio. La copia de seguridad se carga después del suministro y se inicia el nuevo despliegue que utiliza estos datos. Un CRN de copia de seguridad tiene el formato crn:v1:<...>:backup:<uuid>. Si se omite, la base de datos se suministra vacía.
• version: la versión de la base de datos que se va a suministrar. Si se omite, la base de datos se crea con la versión principal y menor más reciente.
• disk_encryption_key_crn- El CRN de una clave KMS ( Key Protect ), que luego se utiliza para el cifrado de discos. El CRN de una clave KMS tiene el formato crn:v1:<...>:key:<id>.
• backup_encryption_key_crn- El CRN de una clave KMS ( Key Protect ), que luego se utiliza para el cifrado de las copias de seguridad. El CRN de una clave KMS tiene el formato crn:v1:<...>:key:<id>.

Para utilizar una clave en tus copias de seguridad, primero debes [habilitar la delegación de servicio a servicio](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok).
{: note}

Aprovisionamiento de recursos de computación aislados con Terraform

Provisióna una instancia aislada de « Databases for MongoDB » con el mismo parámetro « "host_flavor" », configurándolo con el tamaño de instancia aislada deseado. En la Tabla 1 se enumeran los tamaños de alojamiento disponibles y sus parámetros de host_flavor value. Por ejemplo, {"host_flavor": "bx3d.4x20.encrypted"}. Ten en cuenta que, dado que la selección del tipo de host incluye los tamaños de CPU y RAM (bx3d.4x20.encrypted corresponde a 4 CPU y 16 RAM), esta solicitud no admite a la vez una selección de tamaño «Aislado» y selecciones independientes de asignación de CPU y 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-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}"
}

El parámetro « host flavor »

El parámetro « host_flavor » define el tamaño de tu recurso de Compute. Para aprovisionar una instancia de Isolated Compute, introduce el valor adecuado para la configuración de CPU y RAM que desees. Consulta los valores de la siguiente tabla.