Ventanas de mantenimiento definidas por el cliente

Gen 2

Establece los días y la hora de inicio del mantenimiento de tu implementación. Cloud Databases controla la duración de la ventana de mantenimiento, y todas las tareas de mantenimiento se completan o se detienen en un plazo de 4 horas a partir de la hora de inicio programada.

Disponibilidad

Se ofrecen ventanas de mantenimiento definidas por el cliente para:

Databases for PostgreSQL es eu-de.
Databases for MongoDB, Enterprise Edition, en eu-de.

Con el tiempo se irá añadiendo compatibilidad con más bases de datos y regiones.

Configure una franja horaria diaria para el mantenimiento, a menos que su organización exija que el mantenimiento se realice únicamente en días concretos. Una ventana diaria permite que las tareas de mantenimiento pendientes o incompletas, incluidas las actualizaciones de seguridad y fiabilidad, se reanuden al día siguiente en lugar de tener que esperar hasta la semana siguiente

Qué incluye el mantenimiento

El mantenimiento incluye cualquier cambio que afecte directamente a su implementación, como por ejemplo:

Actualizaciones de software de bases de datos e imágenes.
Actualizaciones de los nodos de trabajo en los que se ejecuta tu implementación.
Actualizaciones sobre seguridad, fiabilidad y facilidad de mantenimiento.

Estos cambios se llevan a cabo durante su ventana de mantenimiento, incluso cuando no provocan un impacto visible en el servicio. Los cambios que solicites tú mismo, como el escalado de tu implementación, se ejecutan en el momento en que los solicites.

Durante el mantenimiento, es posible que su implementación se conmutara a un nuevo servidor principal. Asegúrate de que tus aplicaciones puedan volver a conectarse automáticamente. Para obtener más información, consulta Alta disponibilidad.

Ventana de mantenimiento predeterminada

No es necesario establecer una ventana de mantenimiento. Si no lo haces, Cloud Databases utiliza el valor predeterminado regional: una hora de inicio entre las 23:00 UTC y las 10:00 UTC, de lunes a viernes. No se indica la hora exacta de inicio.

Para volver a la configuración regional predeterminada después de haber establecido tu propia ventana, configura en system_assigned true.

Requisitos de la ventana de mantenimiento

Solo se puede establecer una hora de inicio. No se puede establecer una duración ni una hora de finalización. Cloud Databases controla la duración del periodo de mantenimiento.
Especifica la hora de inicio en UTC utilizando el hh:mmZ formato.
Selecciona al menos un día de mantenimiento a la semana. Se recomienda establecer una franja horaria diaria para el mantenimiento. Para obtener más información, consulta Si el mantenimiento no finaliza a tiempo.
Establece la hora de inicio al menos 60 minutos antes de la ventana de mantenimiento a la que quieras que se aplique.
Puede actualizar su ventana de mantenimiento en cualquier momento. Los cambios entrarán en vigor en la próxima ventana de mantenimiento correspondiente. Si el mantenimiento ya ha finalizado ese día, el horario actualizado entrará en vigor la próxima vez que se pueda realizar el mantenimiento.
Si actualizas la ventana de mantenimiento mientras este está en curso, la operación de mantenimiento actual no se reiniciará. El calendario actualizado se aplica a la próxima ventana de mantenimiento correspondiente.
Las notificaciones de mantenimiento se basan en el calendario vigente en el momento en que se genera la notificación. Es posible que los cambios realizados poco antes de un periodo de mantenimiento no se apliquen a las notificaciones que ya se hayan generado o enviado.

Cómo funcionan las ventanas de mantenimiento

La ventana de mantenimiento tiene una duración de 4 horas a partir de la hora de inicio prevista, y todos los trabajos de mantenimiento se completan o se interrumpen dentro de ese periodo.

Por ejemplo, si la hora de inicio del mantenimiento es las 02:00 UTC:

Ejemplo de ventana de mantenimiento con hora de inicio a las 02:00 UTC
Hora (UTC)	¿Qué ocurre?
02:00 - 6:00	Comienza el mantenimiento y se ponen en marcha las actividades de mantenimiento. Es posible que su implementación cambie a un nuevo servidor principal y que sus aplicaciones tengan que volver a conectarse.
Antes de las 06:00	Se han completado o suspendido todos los trabajos de mantenimiento.

Cuando elijas una hora de inicio, ten en cuenta el intervalo completo de 4 horas, no solo la hora de inicio. Elige un momento en el que tu aplicación tenga el menor tráfico posible y tu equipo de operaciones esté disponible.

Tus copias de seguridad nunca se solapan con tu ventana de mantenimiento. Cloud Databases ajusta automáticamente la programación de las copias de seguridad.

Establecer una ventana de mantenimiento

Puede configurar los días de mantenimiento y la hora de inicio mediante la consola, la CLI, la API o Terraform.

Configurar una ventana de mantenimiento en la consola

Puedes configurar una ventana de mantenimiento al crear una implementación o tras el aprovisionamiento.

En la consola de IBM Cloud, crea una implementación o abre una ya existente.
Ve a la ventana Mantenimiento y haz clic en Editar.
Selecciona los días de la semana en los que puede comenzar el mantenimiento. Se recomienda establecer un programa de mantenimiento diario.
Selecciona una hora de inicio del mantenimiento. Puedes mostrar la hora en UTC o en tu zona horaria local.
Revisa el calendario de mantenimiento y haz clic en Guardar.

Para volver a la ventana de mantenimiento predeterminada de la región, haz clic en Restablecer valores predeterminados.

Configurar una ventana de mantenimiento mediante la CLI

Puede establecer una ventana de mantenimiento específica utilizando el siguiente comando :

ibmcloud resource service-instance-create \
  <INSTANCE_NAME> \
  <SERVICE_NAME> \
  <SERVICE_PLAN_NAME> \
  <LOCATION> \
  -g <RESOURCE_GROUP> \
  -p '{
    "dataservices": {
      "maintenance": {
        "window": {
          "start_time": "05:00Z",
          "days": "Wednesday,Thursday"
        }
      }
    }
  }'

Puede configurar la ventana de mantenimiento system_assigned utilizando los siguientes comandos :

ibmcloud resource service-instance-create \
  <INSTANCE_NAME> \
  <SERVICE_NAME> \
  <SERVICE_PLAN_NAME> \
  <LOCATION> \
  -g <RESOURCE_GROUP> \
  -p '{
    "dataservices": {
      "maintenance": {
        "window": {
          "system_assigned": true
        }
      }
    }
  }'

Configurar una ventana de mantenimiento mediante la API

Puede establecer una ventana de mantenimiento específica mediante la siguiente solicitud:

curl -X POST \
  "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
  -H "Authorization: Bearer <IAM_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<DATABASE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP_ID>",
    "resource_plan_id": "<DATABASE_SERVICE_PLAN_ID>",
    "parameters": {
      "dataservices": {
        "maintenance": {
          "window": {
            "start_time": "05:00Z",
            "days": "Wednesday,Thursday"
          }
        }
      }
    }
  }'

Puede configurar la ventana de mantenimiento system_assigned mediante la siguiente solicitud:

curl -X POST \
  "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
  -H "Authorization: Bearer <IAM_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<DATABASE_INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP_ID>",
    "resource_plan_id": "<DATABASE_SERVICE_PLAN_ID>",
    "parameters": {
      "dataservices": {
        "maintenance": {
          "window": {
            "system_assigned": true
          }
        }
      }
    }
  }'

Configurar una ventana de mantenimiento con Terraform

Puedes establecer una ventana de mantenimiento específica utilizando la siguiente solicitud de Terraform:

maintenance_days = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
data "ibm_resource_group" "rg" {
  name = var.resource_group_name
}
resource "ibm_database" "cmw_test" {
  name              = "<DATABASE_INSTANCE_NAME>"
  resource_group_id = data.ibm_resource_group.rg.id
  service = "<DATABASE_SERVICE_NAME>"
  plan    = "<DATABASE_SERVICE_PLAN_ID>"
  location          = "<GEN2-REGION>"
  service_endpoints = "private"
  maintenance {
    window {
      start_time = "05:00Z"
      days       = var.maintenance_days
    }
  }
}

Puedes configurar la ventana de mantenimiento system_assigned utilizando la siguiente solicitud de Terraform:

data "ibm_resource_group" "rg" {
  name = var.resource_group_name
}
resource "ibm_database" "cmw_test" {
  name              = "<DATABASE_INSTANCE_NAME>"
  resource_group_id = data.ibm_resource_group.rg.id
  service = "<DATABASE_SERVICE_NAME>"
  plan    = "<DATABASE_SERVICE_PLAN_ID>"
  location          = "<GEN2-REGION>"
  service_endpoints = "private"
  maintenance {
    window {
      system_assigned = true
    }
  }
}

Seguimiento del mantenimiento

Cuando haya un mantenimiento pendiente para su implementación, recibirá un evento IBM Cloud Activity Tracker al menos 2 horas antes de que comience la actividad de mantenimiento.

Los eventos IBM Cloud Activity Tracker también se activan como resultado de cualquier actualización de una instancia de servicio tras una ventana de mantenimiento completada con éxito. Echa un vistazo a la lista completa de eventos de bases de datos Activity Tracker.

Mantenimiento incompleto

El mantenimiento nunca se prolonga más allá del final de tu ventana de mantenimiento. Si el mantenimiento sigue en marcha 4 horas después de la hora de inicio, Cloud Databases lo detiene. El trabajo restante se llevará a cabo durante tu próxima ventana de mantenimiento. Mientras tanto, su implementación seguirá estando disponible.

Establezca una franja horaria diaria para el mantenimiento. Si seleccionas solo un día a la semana, las tareas de mantenimiento que no se hayan completado, incluidas las correcciones de seguridad, quedarán pendientes hasta la siguiente ventana de mantenimiento, que puede tardar hasta una semana en llegar. Con una ventana diaria, el mantenimiento se reanuda al día siguiente y su implementación se mantiene actualizada y segura.

mantenimiento de emergencia

En circunstancias excepcionales, podría realizarse un mantenimiento de emergencia fuera del horario de mantenimiento programado y sin previo aviso. En estos casos, no se crean eventos de mantenimiento programado.