Actualización en la IU

1. Cree un nuevo Databases for Elasticsearch para probar el proceso de actualización.
   Cree el despliegue restaurando una copia de seguridad de su despliegue existente con la misma versión.

2. Dirija su aplicación de ensayo a la implantación de prueba.
   Actualice su aplicación de ensayo para que apunte a la implantación de prueba. Confirme que su aplicación de prueba puede conectarse correctamente a la implantación de ensayo y que la aplicación funciona como se espera. Realice las pruebas de rendimiento y funcionamiento necesarias del entorno de ensayo.

3. Actualice la versión principal de su despliegue de prueba haciendo clic en el botón Actualizar versión principal de la página Descripción general.
   Esto pondrá su base de datos en modo SOLO LECTURA mientras se completa el proceso de actualización. Tenga en cuenta el tiempo que tarda en completarse la actualización para que pueda utilizar la configuración de caducidad de actualización para contener las actualizaciones dentro de su ventana de mantenimiento.

4. Confirme que su aplicación de ensayo funciona con la nueva versión de la base de datos.
   Si su aplicación funciona, este paso confirma que debería ser seguro actualizar su base de datos de producción.

5. Actualice la implantación de su base de datos de producción a la nueva versión.
   Una vez que haya confirmado que su aplicación funciona correctamente utilizando la nueva versión de la base de datos, puede volver a la consola de gestión e iniciar el proceso de actualización de su despliegue de producción. En la sección Detalles de la implantación de la página Descripción general, haga clic en el botón Actualizar versión principal y siga los pasos.

   Una vez que se inicia el proceso de actualización in situ, no se puede detener ni revertir. Así, en el improbable caso de que se produzca un error, la implantación de su base de datos podría resultar irrecuperable. Por lo tanto, cree una copia de seguridad que luego pueda utilizar para restaurar en una nueva implantación. Si selecciona `Actualización de versión principal in situ con copia de seguridad', la copia de seguridad que se crea puede utilizarse para restaurar en una nueva implantación.

expiration for starting upgrade le permite configurar un periodo de "tiempo de espera" dentro del cual debe iniciarse el trabajo de actualización antes de que se cancele automáticamente. Además, pruebe la actualización por adelantado para asegurarse de que se completa en el plazo deseado. Si, por ejemplo, quieres completar la actualización en 1 hora, y has probado la actualización y sabes que tarda 30 minutos, entonces tu trabajo de actualización debe comenzar en los 30 minutos siguientes a que confirmes que quieres actualizar. Por lo tanto, fije la caducidad en 30 minutos, de modo que si no se inicia en ese tiempo, no sobrepase su ventana.

Actualización a través de la API

Utilice el siguiente comando para actualizar in situ:

curl -X PATCH https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version -H 'Authorization: Bearer <>' -H 'Content-Type: application/json' -d '{"version": "8.0"}'

expiration for starting upgrade le permite configurar un periodo de "tiempo de espera" dentro del cual debe iniciarse el trabajo de actualización antes de que se cancele automáticamente. Además, pruebe la actualización por adelantado para asegurarse de que se completa en el plazo deseado. Si, por ejemplo, quieres completar la actualización en 1 hora, y has probado la actualización y sabes que tarda 30 minutos, entonces tu trabajo de actualización debe comenzar en los 30 minutos siguientes a que confirmes que quieres actualizar. Por lo tanto, establezca la caducidad a una marca de tiempo de 30 minutos a partir de ahora, de modo que si no se inicia dentro de ese tiempo, no sobrepasará su ventana. La caducidad debe estar comprendida entre 5 minutos (por defecto) y 24 horas a partir de ahora. Para más información, consulte la API Cloud Databases.

Actualización a través de la CLI

Disponible en la versión del plugin CDB >= 0.20.0

Para ver la lista de transiciones de actualización y restauración permitidas para la implantación:

ibmcloud cdb deployment-capability-show <NAME|CRN> versions

Para actualizar el comando con los parámetros requeridos:

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION>

Para ver todos los detalles de los parámetros comando :

ibmcloud cdb deployment-version-upgrade --help

expiration for starting upgrade le permite configurar un periodo de "tiempo de espera" dentro del cual debe iniciarse el trabajo de actualización antes de que se cancele automáticamente. Además, pruebe la actualización por adelantado para asegurarse de que se completa en el plazo deseado. Si, por ejemplo, quieres completar la actualización en 1 hora, y has probado la actualización y sabes que tarda 30 minutos, entonces tu trabajo de actualización debe comenzar en los 30 minutos siguientes a que confirmes que quieres actualizar. Por lo tanto, fije la caducidad en 30 minutos, de modo que si no se inicia en ese tiempo, no sobrepase su ventana. La caducidad debe estar comprendida entre 5 minutos (por defecto) y 24 horas a partir de ahora. Hay dos formas de establecer la caducidad mediante la CLI --expire-in o --expire-at. Para obtener más información, consulta la ayuda del comando.

Actualización mediante Terraform

Disponible en la versión del proveedor de Terraform >= 1.79.2

Para actualizar, sólo tiene que añadir o cambiar el valor version en su configuración. También hay un indicador bool opcional, version_upgrade_skip_backup, que puede establecer para omitir la copia de seguridad.

No se recomienda omitir una copia de seguridad. Omitir una copia de seguridad antes de actualizar una versión es peligroso y puede provocar la pérdida de datos. Si la actualización falla en cualquier fase, no habrá una copia de seguridad inmediata desde la que restaurar.

La base de datos se pondrá en modo SOLO LECTURA durante la actualización. Se recomienda encarecidamente probar antes de actualizar.

La actualización puede requerir más tiempo que el tiempo de espera predeterminado. Se puede establecer un valor de tiempo de espera más largo utilizando el atributo timeouts.

Terraform tiene timeouts en lugar de timestamps de expiración. Por lo tanto, aumente su tiempo de espera, ya que su valor de actualización de tiempo de espera se utiliza como la expiración. Por ejemplo, si establece un tiempo de espera de 20 minutos, la caducidad se fijará en 20 minutos y si la actualización no se inicia en ese plazo, caducará y la actualización no se iniciará. Tenga en cuenta que la caducidad máxima es de 24 horas, por lo que aunque establezca un tiempo de espera de 36 horas, la actualización caducará si no se ha iniciado en las primeras 24 horas.

Si hay una actualización en curso, tenga en cuenta que algunas tareas pueden estar en cola y no procederán hasta que se complete la actualización de la versión.

Actualización en la IU

Para los nuevos modelos de alojamiento (computación aislada y computación compartida), la actualización a una nueva versión principal está disponible a través de la CLI y la API.

Puede actualizar a una nueva versión restaurando una copia de seguridad desde la página Copias de seguridad y restauración de su implantación en la consola IBM Cloud. Haga clic en Restaurar copia de seguridad en una copia de seguridad para abrir una página en una nueva pestaña en la que podrá cambiar algunas opciones para la nueva implantación. Una de ellas es la versión de la base de datos, que se rellena automáticamente con las versiones disponibles a las que puede actualizar. Selecciona una versión y haz clic en « Restaurar copia de seguridad » para iniciar el proceso de aprovisionamiento y restauración.

Actualización a través de la CLI

Cuando actualice y restaure desde la copia de seguridad mediante la CLI de IBM Cloud, utilice el mandato de suministro desde el controlador de recursos.

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_ID> <SERVICE_PLAN_ID> <REGION>

Los parámetros instance_name, service_id, service_plan_id y region son todos obligatorios. También debe indicar -p con los parámetros de versión y de ID de copia de seguridad en un objeto JSON. El nuevo despliegue se dimensiona automáticamente con el mismo disco y memoria que el despliegue de origen en el momento de la copia de seguridad.

ibmcloud resource service-instance-create example-upgrade databases-for-elasticsearch enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version":"8.0"
}'

Actualización a través de la API

Al igual que en el caso del aprovisionamiento a través de la API, debes seguir los pasos necesarios para utilizar la API del controlador de recursos antes de poder utilizarla para actualizar a partir de una copia de seguridad. A continuación, envíe una solicitud POST a la API. Los parámetros name, target, resource_group y resource_plan_id son obligatorios. Indica también la versión y el ID de la copia de seguridad. El nuevo despliegue tiene la misma asignación de memoria y de disco que el despliegue de origen en el momento de la copia de seguridad.

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": "us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-elasticsearch-enterprise",
    "backup_id": "crn:v1:bluemix:public:databases-for-elasticsearch:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
    "version":"8.0"
  }'

Actualización mediante Terraform

Utilice Terraform para restaurar una copia de seguridad de una versión anterior a una nueva versión.

1. Configure su backup_id. Para obtener más información, consulte backup_id.
2. Establezca su version en el atributo de versión. Para obtener más información, consulte version.

El código es el siguiente:

resource "ibm_database" "<your-instance>" {
  name                                 = "<your_database_name>"
  service                              = "databases-for-elasticsearch"
  plan                                 = "enterprise"
  location                             = "<region>"
  version                              = "<version>"
  backup_id                            = "<backup_id>"
}

Para más información, consulte el registro de Terraform en Cloud Databases. Como alternativa, puede utilizar Terraform IBM Modules(TIM) para crear una nueva instancia de base de datos a partir de una instancia de copia de seguridad. Para obtener más información, consulte Ejemplo de restauración a partir de una copia de seguridad.