Ubicación y plataforma

• Ubicación: elige la región en la que deseas implementar tu base de datos. Cada región de la lista indica qué plataforma es compatible, Gen 1 o Gen 2, para ayudarte a elegir.
• Plataforma: selecciona la plataforma en la que deseas implementar tu base de datos. Las opciones disponibles dependen de la región que elijas. Para obtener más información sobre las diferencias entre la 1.ª generación y la 2.ª generación, consulta la sección «Descripción general de la 1.ª generación y la 2.ª generación ».

Detalles de servicio

• Nombre del servicio: el nombre puede ser cualquier cadena de caracteres y es el que se utiliza en la web y en la CLI para identificar la nueva implementación.
• Grupo de recursos: si está organizando sus servicios en grupos de recursos, especifique el grupo de recursos en este campo. De lo contrario, puede dejar el valor predeterminado. Para obtener más información, consulte Gestión de grupos de recursos.

Modelo de alojamiento

Para las implementaciones de Gen 2, solo está disponible el modelo de alojamiento «Isolated».

Aislado: Oferta segura de inquilino único para cargas de trabajo empresariales complejas y de alto rendimiento. Para obtener más información, consulta « Modelos de alojamiento ».

Asignación de recursos

Ajusta con precisión la asignación de recursos. Utilice las tablas para elegir el tamaño de máquina para cada miembro de su implementación y especifique el tamaño del disco.

Configuración del servicio

• Versión de la base de datos. [Se establece únicamente durante la implementación] {: tag-red}: la versión de implementación de tu base de datos. Para garantizar un rendimiento óptimo, utiliza la versión recomendada. La última versión menor se utiliza automáticamente. Para obtener más información, consulta la política de control de versiones.
• Cifrado: si utilizas Key Protect, se puede 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 finales que solo se configuran durante la implementación- Configura lospuntos finales del servicio en tu implementación. En la Gen 2, solo se admiten puntos finales 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. Selecciona el modelo de alojamiento en el que deseas que se configure tu base de datos. Puede cambiarlo más adelante.

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 '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<Endpoint>"
   

   Por ejemplo, para aprovisionar una instancia del modelo de alojamiento «Shared Compute» de Databases for PostgreSQL, utiliza un comando como este:

   ibmcloud resource service-instance-create test-database databases-for-postgresql standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "8192"}' --service-endpoints="private"
   

   Provisióna una instancia aislada de « Databases for PostgreSQL » con el mismo parámetro « "members_host_flavor" » -p, configurándolo con el tamaño de instancia aislada deseado. En la tabla 2 se enumeran los tamaños de alojamiento disponibles y sus parámetros de members_host_flavor value. Por ejemplo, {"members_host_flavor": "b3c.4x16.encrypted"}. Ten en cuenta que, dado que la selección del tipo de host incluye los tamaños de CPU y RAM (b3c.4x16.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.

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

   Los campos del mandato se describen en la tabla siguiente.

   Campos del formato básico de comando

   Campo	Descripción	Distintivo
   INSTANCE_NAME Obligatorio	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 Obligatorio	Nombre o ID del servicio. Para acceder a « Databases for PostgreSQL », utiliza databases-for-postgresql.
   SERVICE_PLAN_NAME Obligatorio	Plan estándar (standard)
   LOCATION Obligatorio	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
   members_host_flavor	Para aprovisionar una instancia de Isolated Compute, utiliza {"members_host_flavor": "<members_host_flavor value>"}. En «Computación aislada», selecciona la configuración de CPU y RAM que desees. Para obtener más información, consulta la siguiente tabla o la sección « Modelos de alojamiento ».
   --service-endpoints Obligatorio	Solo es compatible con private.

   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-postgresql: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_OR_CRN>
     

     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-postgresql:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
     GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
     Location:              <LOCATION>
     Service Name:          databases-for-postgresql
     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 postgresql with version 12 (100%)
     

   • (Opcional) Supresión de una instancia de servicio Para eliminar una instancia, ejecuta un comando como este:

     ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
     

El parámetro « members host flavor »

El parámetro « members_host_flavor » define el tamaño de tu recurso de Compute.

Para aprovisionar una instancia de Isolated Compute, especifica los valores de CPU y RAM que se ajusten a la configuración que desees.

El escalado automático de la CPU y la RAM no es compatible con « Cloud Databases » Isolated Compute; sin embargo, sí es compatible el escalado automático del disco. Supervisa tus recursos con la integración de « IBM Cloud® Monitoring », que realiza un seguimiento del uso de la memoria, el espacio en disco y las operaciones de E/S de disco. Para aumentar los recursos, amplía la implementación manualmente.

El parámetro « --parameters »

El comando service-instance-create admite un -p parámetro, lo 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 necesita un total de 12 GB de memoria repartidos entre tres miembros, el comando para asignar 4 GB por miembro sería el siguiente:

ibmcloud resource service-instance-create databases-for-postgresql <INSTANCE_NAME> standard us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "4096"
}' --service-endpoints="private"

El parámetro « host flavor »

El parámetro « members_host_flavor » define el tamaño de tu recurso de Compute.

Para aprovisionar una instancia de Isolated Compute, especifica los valores de CPU y RAM que se ajusten a la configuración que desees.

El escalado automático de la CPU y la RAM no es compatible con « Cloud Databases » Isolated Compute; sin embargo, sí es compatible el escalado automático del disco. Supervisa tus recursos con la integración de « IBM Cloud® Monitoring », que realiza un seguimiento del uso de la memoria, el espacio en disco y las operaciones de E/S de disco. Para aumentar los recursos, amplía la implementación manualmente.

Aprovisionamiento de recursos de computación aislados con Terraform

Provisióna una instancia aislada de « Databases for PostgreSQL » 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": "b3c.4x16.encrypted"}. Ten en cuenta que, dado que la selección del tipo de host incluye los tamaños de CPU y RAM (b3c.4x16.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-postgresql"
  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 Postgresql 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.

Computación aislada: para aprovisionar una instancia de computación aislada, especifica los valores de CPU y RAM que se ajusten a la configuración que desees.

El escalado automático de la CPU y la RAM no es compatible con « Cloud Databases » Isolated Compute; sin embargo, sí es compatible el escalado automático del disco. Supervisa tus recursos con la integración de « IBM Cloud® Monitoring », que realiza un seguimiento del uso de la memoria, el espacio en disco y las operaciones de E/S de disco. Para aumentar los recursos, amplía la implementación manualmente.