Utilización del catálogo

Cuando cree el despliegue desde el catálogo, debe especificar los siguientes parámetros.

1. Nombre de servicio: el nombre puede ser cualquier serie y es el nombre que se utiliza en la web y en la línea de mandatos para identificar el nuevo despliegue.

2. Región - La región en la que reside el despliegue.

3. Ubicación de copia de seguridad - La ubicación de las copias de seguridad del despliegue. Los usuarios pueden elegir copias de seguridad interregionales o regionales. Las copias de seguridad interregionales se pueden almacenar en varias regiones de una zona. Mientras que, las copias de seguridad regionales sólo se pueden almacenar en una región.

4. Grupo de recursos: si está organizando sus servicios en grupos de recursos, puede especificar el grupo de recursos en este campo. De lo contrario, puede dejar el valor predeterminado.

5. Instancia de KMS y clave de cifrado de disco -Si utiliza Key Protect o Hyper Protect Crypto Services, se pueden seleccionar una instancia y una clave para cifrar el disco del despliegue. Si no utiliza su propia clave, el despliegue crea y gestiona automáticamente su propia clave de cifrado de disco utilizando el servicio Key Protect . Si desea utilizar HPCS para el cifrado, debe suministrar una instancia de HPCS y generar o importar una clave. Actualmente, HPCS no está habilitado para EU-Cloud.

6. Clave de cifrado de copia de seguridad - Si utiliza Clave de cifrado de copia de seguridad, puede proporcionar su propia instancia y clave de KMS para cifrar sus copias de seguridad. Es un parámetro opcional y, si no se proporciona, se utilizará de forma predeterminada la instancia y la clave de KMS.

7. Asignación de CPU: elija recursos de cálculo dedicados para su despliegue. Con núcleos dedicados, el grupo de recursos recibe un host de un solo arrendatario con una reserva mínima garantizada de comparticiones de CPU. A continuación, se asigna a los despliegues el número de CPU que especifique. El valor predeterminado es standard plan si no se especifica en la solicitud de suministro utilizando la API o la CLI.

8. Puntos finales - Puede configurar los tipos de puntos finales de servicio en el despliegue. El valor predeterminado es que las conexiones con el despliegue se pueden realizar desde la red pública.

9. Alta disponibilidad - si los servicios deben estar altamente disponibles

10. Compatibilidad con Oracle - si la instancia de servicio debe tener habilitada la compatibilidad con Oracle

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

Mediante la línea de mandatos

La herramienta CLI de IBM Cloud es la que utiliza para comunicarse con IBM Cloud desde el terminal o la línea de mandatos. Para obtener más información, consulte Descargar e instalar la CLI de IBM Cloud.

Para crear un Cloud Databases despliegue, utilice la CLI para solicitar una instancia de servicio con el ID de servicio de la base de datos (o cola de mensajería) que desea suministrar.

Ejecute la siguiente actualización de mandato:

ibmcloud resource service-instance-create <service-name> <service-id> <service-plan-id> <region> --service-endpoints <SERVICE_ENDPOINTS_TYPE>

Encontrará más información general sobre este mandato en la Referencia de CLI para grupos de recursos.

Cuando se ejecuta el mandato, se inicia el despliegue de la base de datos. La base de datos tarda un rato en desplegarse. Puede comprobar su progreso en el panel de control de IBM Cloud o puede ejecutar el mandato siguiente:

ibmcloud resource service-instance-create <service-name>

Este mandato informa del estado actual de la instancia de servicio.

Cabeceras y parámetros adicionales:

El distintivo --service-endpoints le permite especificar qué tipos de puntos finales de servicio se deben incluir en el despliegue. El valor predeterminado es que las conexiones con el despliegue se pueden realizar desde la red pública. Los valores posibles son public, private, public-and-private. Si se omite el distintivo, el valor predeterminado es un punto final public.

El siguiente mandato de ejemplo especifica un punto final de servicio:

ibmcloud resource service-instance-create <service-name> --service-endpoints <endpoint-type>

El mandato service-instance-create da soporte a un distintivo -p, que permite pasar parámetros adicionales al proceso de suministro. Los parámetros están en formato JSON. Uno de estos valores de parámetro es el nombre de recurso de nube (CRN), que identifica de forma exclusiva un recurso en la nube. Todos los nombres y valores de parámetros se pasan como series.

Suministro mediante la API del controlador de recursos

Puede suministrar nuevos despliegues mediante la API del controlador de recursos. No obstante, para poder utilizar la API del controlador de recursos, necesita cierta preparación adicional.

1. Obtenga una señal de IAM de la señal de API.

2. Debe conocer el ID del grupo de recursos en el que desea realizar el despliegue. Esta información está disponible a través de la CLI de IBM Cloud. Puede consultar una lista de grupos de recursos con el mandato ibmcloud resource groups y el ID de un grupo de recursos con el mandato ibmcloud resource group.

3. Debe conocer la región en la que desea realizar el despliegue.

Después de tener toda la información, la siguiente solicitud de creación es un POST al punto final https://resource-controller.cloud.ibm.com/v2/resource_instances:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "dash
  }'

Los parámetros name, target, resource_group y resource_plan_id son obligatorios. Si es necesario, puede enviar parámetros adicionales en el cuerpo de la solicitud.

Encontrará más información sobre la API del controlador de recursos en su Referencia de API.

Lista de parámetros adicionales

• backup_id - Un CRN de un recurso de copia de seguridad desde el que restaurar. La copia de seguridad debe haber sido creada por un despliegue 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.

• backup_location - La ubicación de las copias de seguridad del despliegue.
• disk_encryption_key_crn -El CRN de una clave KMS, que luego se utiliza para el cifrado de disco. Un CRN de KMS tiene el formato crn:v1:<...>:key:<id>.
• backup_encryption_key_crn -El CRN de una clave KMS, que se utiliza a continuación para el cifrado de copia de seguridad. Un CRN de KMS tiene el formato crn:v1:<...>:key:<id>. Para utilizar una clave para las copias de seguridad, primero debe habilitar delegación de servicio a servicio.

• members_cpu_allocation_count: habilita y asigna el número de núcleos dedicados especificados a su despliegue. Por ejemplo, para utilizar dos núcleos dedicados por miembro, utilice "members_cpu_allocation_count":"2". Si se omite, el valor predeterminado "CPU compartida" utiliza recursos de cálculo en hosts compartidos.
• service-endpoints: selecciona los tipos Puntos finales de servicio soportados en el despliegue. Las opciones son public, private o public-and-private. Si se omite, el valor predeterminado es public. Tenga en cuenta que en la CLI, service-endpoints es un distintivo y no un parámetro.