Fenêtres de maintenance définies par le client

Gen 2

Définissez les jours et l'heure de début de la maintenance de votre déploiement. Cloud Databases contrôle la durée de la fenêtre de maintenance, et tous les travaux de maintenance sont terminés ou interrompus dans les 4 heures suivant l'heure de début prévue.

Disponibilité

Des plages horaires de maintenance définies par le client sont disponibles pour :

Databases for PostgreSQL dans eu-de.
Databases for MongoDB, Enterprise Edition, dans eu-de.

La prise en charge d'autres bases de données et régions sera ajoutée progressivement.

Configurez une plage horaire de maintenance quotidienne, sauf si votre entreprise exige que la maintenance soit effectuée uniquement certains jours spécifiques. Une fenêtre quotidienne permet de reporter les opérations de maintenance en attente ou inachevées, y compris les mises à jour de sécurité et de fiabilité, au lendemain plutôt que de les reporter à la semaine suivante

Ce que comprend la maintenance

La maintenance inclut toute modification ayant un impact direct sur votre déploiement, telle que :

Mises à jour des logiciels de bases de données et des images.
Mises à jour des nœuds de travail sur lesquels s'exécute votre déploiement.
Mises à jour concernant la sécurité, la fiabilité et la facilité de maintenance.

Ces modifications sont mises en œuvre pendant votre fenêtre de maintenance, même si elles n'ont pas d'impact visible sur le service. Les modifications que vous demandez vous-même, telles que la mise à l'échelle de votre déploiement, sont exécutées dès que vous en faites la demande.

Pendant la maintenance, votre déploiement peut basculer vers un nouveau serveur principal. Assurez-vous que vos applications peuvent se reconnecter automatiquement. Pour plus d'informations, consultez la section Haute disponibilité.

Plage horaire de maintenance par défaut

Vous n'avez pas besoin de définir une fenêtre de maintenance. Si vous ne le faites pas, Cloud Databases utilise la valeur par défaut régionale : une heure de début comprise entre 23 h 00 UTC et 10 h 00 UTC, du lundi au vendredi. L'heure exacte de début n'est pas indiquée.

Pour revenir aux paramètres régionaux par défaut après avoir défini votre propre fenêtre, réglez system_assigned sur true.

Exigences relatives aux fenêtres de maintenance

Vous ne pouvez définir qu'une heure de début. Vous ne pouvez pas définir de durée ni d'heure de fin. Le paramètre Cloud Databases contrôle la durée de la fenêtre de maintenance.
Indiquez l'heure de début en UTC en utilisant le format hh:mmZ.
Choisissez au moins un jour par semaine pour la maintenance. Il est recommandé de prévoir une plage horaire quotidienne pour la maintenance. Pour plus d'informations, consultez la section Si la maintenance ne se termine pas à temps.
Définissez votre heure de début au moins 60 minutes avant la plage de maintenance à laquelle vous souhaitez qu'elle s'applique.
Vous pouvez modifier votre plage de maintenance à tout moment. Les modifications prendront effet lors de la prochaine fenêtre de maintenance éligible. Si la maintenance est déjà terminée pour la journée, le calendrier mis à jour prend effet lors de la prochaine maintenance prévue.
Si vous modifiez la plage horaire de maintenance alors que celle-ci est en cours, l'opération de maintenance en cours ne redémarre pas. Le calendrier mis à jour s'applique à la prochaine fenêtre de maintenance éligible.
Les notifications de maintenance sont basées sur le calendrier en vigueur au moment où la notification est générée. Les modifications apportées peu avant une fenêtre de maintenance peuvent ne pas s'appliquer aux notifications déjà générées ou envoyées.

Fonctionnement des fenêtres de maintenance

La fenêtre de maintenance dure 4 heures à compter de l'heure de début prévue, et tous les travaux de maintenance sont achevés ou interrompus au cours de cette période.

Par exemple, si l'heure de début de la maintenance est 02h00 UTC :

Exemple de fenêtre de maintenance avec une heure de début à 02h00 UTC
Heure (UTC)	Que se passe-t-il?
02 h 00 - 06 h 00	La maintenance commence et les activités de maintenance sont lancées. Il se peut que votre déploiement bascule vers un nouveau serveur principal et que vos applications doivent se reconnecter.
Avant 6 h	Tous les travaux de maintenance sont terminés ou interrompus.

Lorsque vous choisissez une heure de début, prévoyez la plage horaire complète de 4 heures, et pas seulement l'heure de début. Choisissez un moment où le trafic sur votre application est au plus bas et où votre équipe opérationnelle est disponible.

Vos sauvegardes n'empiètent jamais sur votre fenêtre de maintenance. Cloud Databases ajuste automatiquement le calendrier des sauvegardes.

Définir une fenêtre de maintenance

Vous pouvez définir vos jours de maintenance et leur heure de début à l'aide de la console, de l'interface de ligne de commande (CLI), de l'API ou de Terraform.

Définir une fenêtre de maintenance dans la console

Vous pouvez configurer une fenêtre de maintenance lors de la création d'un déploiement ou après le provisionnement.

Dans la console IBM Cloud, créez un déploiement ou ouvrez un déploiement existant.
Accédez à la fenêtre Maintenance et cliquez sur Modifier.
Sélectionnez les jours de la semaine où la maintenance peut commencer. Il est recommandé de mettre en place un programme d'entretien quotidien.
Sélectionnez une heure de début de maintenance. Vous pouvez afficher l'heure en UTC ou dans votre fuseau horaire local.
Vérifiez le calendrier de maintenance, puis cliquez sur Enregistrer.

Pour revenir à la fenêtre de maintenance par défaut de votre région, cliquez sur Réinitialiser les paramètres par défaut.

Définir une fenêtre de maintenance à l'aide de l'interface de ligne de commande (CLI)

Vous pouvez définir une plage horaire de maintenance spécifique à l'aide de la commande suivante :

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

Vous pouvez définir une fenêtre de maintenance system_assigned à l'aide des commandes suivantes :

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

Définir une fenêtre de maintenance à l'aide de l'API

Vous pouvez définir une plage horaire de maintenance spécifique à l'aide de la requête suivante :

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

Vous pouvez définir une fenêtre de maintenance system_assigned à l'aide de la requête suivante :

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

Définir une fenêtre de maintenance à l'aide de Terraform

Vous pouvez définir une fenêtre de maintenance spécifique à l'aide de la requête Terraform suivante :

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

Vous pouvez définir une fenêtre de maintenance system_assigned à l'aide de la requête Terraform suivante :

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

Suivi de la maintenance

Lorsqu'une opération de maintenance est prévue pour votre déploiement, vous recevez une notification IBM Cloud Activity Tracker au moins 2 heures avant le début de l'opération de maintenance.

Les événements IBM Cloud Activity Tracker s sont également déclenchés à la suite de toute mise à jour d'une instance de service résultant d'une fenêtre de maintenance réussie. Consultez la liste complète des événements liés aux bases de données Activity Tracker.

Maintenance incomplète

La maintenance ne dépasse jamais la fin de votre fenêtre de maintenance. Si la maintenance est toujours en cours 4 heures après l'heure de début prévue, Cloud Databases l'interrompt. Le reste des travaux sera effectué lors de votre prochaine fenêtre de maintenance. Votre déploiement reste disponible pendant ce temps.

Définissez une plage horaire quotidienne pour la maintenance. Si vous ne sélectionnez qu'un seul jour par semaine, les opérations de maintenance qui n'ont pas été effectuées, y compris les correctifs de sécurité, sont reportées jusqu'à une semaine, en attendant votre prochaine fenêtre de maintenance. Avec une fenêtre de maintenance quotidienne, la maintenance reprend le lendemain, et votre déploiement reste à jour et sécurisé.

maintenance d'urgence

Dans des circonstances exceptionnelles, une maintenance d'urgence peut avoir lieu en dehors de la plage horaire de maintenance prévue, sans préavis. Dans ces cas-là, aucune intervention de maintenance planifiée n'est créée.