Afficher et définir les heures de maintenance

Cette page explique comment effectuer les actions suivantes liées à la maintenance du cluster AlloyDB pour PostgreSQL:

  • Définissez, affichez et effacez un intervalle de maintenance pour votre cluster principal et secondaire.
  • Consultez les événements de maintenance à venir planifiés pour votre cluster principal et secondaire.

Pour obtenir une présentation du fonctionnement de la maintenance avec les clusters AlloyDB, consultez la section À propos de la maintenance.

Définir un intervalle de maintenance sur un cluster

Console

  1. Accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Sur la page Présentation, dans Maintenance, cliquez sur Modifier.

  4. Dans Intervalle de maintenance, sélectionnez le jour de la semaine pour cet intervalle de maintenance.

    L'option par défaut est Toute fenêtre. Lorsque vous créez un cluster, cette fenêtre de maintenance par défaut lui est attribuée.

  5. Sélectionnez l'heure de la journée pour cet intervalle de maintenance.

  6. Cliquez sur Mettre à jour pour enregistrer les modifications.

gcloud

Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.

Pour définir un intervalle de maintenance sur un cluster, exécutez la commande gcloud clusters update avec les options --maintenance-window-day et --maintenance-window-hour:

gcloud alloydb clusters update CLUSTER_ID \
  --region REGION \
  --maintenance-window-day DAY_OF_WEEK \
  --maintenance-window-hour HOUR_OF_DAY

Remplacez les éléments suivants :

  • CLUSTER_ID: cluster sur lequel définir la période de maintenance.

  • REGION: région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

  • DAY_OF_WEEK: jour de la semaine, dans le fuseau horaire UTC, pour cet intervalle de maintenance. Les valeurs valides sont MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY et SUNDAY.

    La valeur par défaut est Toute fenêtre. Lorsque vous créez un cluster, cette fenêtre de maintenance par défaut lui est attribuée.

  • HOUR_OF_DAY: entier compris entre 0 et 23 représentant l'heure de la journée, dans le fuseau horaire UTC, pour cet intervalle de maintenance.

Si vous modifiez le paramètre d'intervalle de maintenance alors que la maintenance du cluster est déjà en cours ou planifiée, ces modifications ne prennent effet qu'une fois la maintenance en cours ou planifiée terminée.

Effacer un intervalle de maintenance

Console

  1. Accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Sur la page Présentation, dans Maintenance, cliquez sur Modifier.

  4. Dans Intervalle de maintenance, sélectionnez N'importe quel intervalle.

  5. Cliquez sur Mettre à jour pour enregistrer les modifications.

gcloud

Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.

Pour supprimer l'intervalle de maintenance d'un cluster, exécutez la commande gcloud clusters update avec l'option --maintenance-window-any:

gcloud alloydb clusters update CLUSTER_ID \
  --region REGION \
  --maintenance-window-any

Remplacez les éléments suivants :

  • CLUSTER_ID: cluster sur lequel définir la période de maintenance.

  • REGION: région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

Afficher l'intervalle de maintenance d'un cluster

Console

  1. Accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Sur la page Vue d'ensemble, sous Maintenance, consultez les détails de la période de maintenance de votre cluster.

gcloud

Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.

Pour consulter la période de maintenance actuelle d'un cluster, exécutez la commande gcloud alloydb clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region REGION

Remplacez les éléments suivants :

  • CLUSTER_ID: cluster sur lequel définir la période de maintenance.

  • REGION: région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

Si une fenêtre de maintenance est définie pour le cluster, la sortie de la commande inclut des lignes semblables aux suivantes:

maintenanceUpdatePolicy:
  maintenanceWindows:
  - day: TUESDAY
    startTime:
      hours: 23

Si la sortie n'inclut pas de section maintenanceUpdatePolicy, aucun intervalle de maintenance n'est défini pour le cluster.

Afficher les opérations de maintenance à venir sur un cluster

Console

  1. Accédez à la page Clusters.

    accéder aux clusters

  2. Recherchez votre cluster, puis consultez la colonne Maintenance pour en savoir plus sur l'intervalle de maintenance à venir.

gcloud

Pour utiliser gcloud CLI, vous pouvez installer et initialiser Google Cloud CLI ou utiliser Cloud Shell.

Pour afficher les prochaines opérations de maintenance planifiées pour un cluster pour lequel un intervalle de maintenance est défini, exécutez la commande gcloud clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region REGION

Remplacez les éléments suivants :

  • CLUSTER_ID: cluster sur lequel définir la période de maintenance.

  • REGION: région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

Si le cluster prévoit un événement de maintenance, le résultat de la commande inclut des lignes semblables aux suivantes:

maintenanceSchedule:
  startTime: 2024-07-03T09:46:40Z

L'horodatage au format UTC spécifie le moment auquel AlloyDB prévoit de commencer à mettre à jour le logiciel système de tous les nœuds de ce cluster.

Activer les notifications de maintenance

Pour recevoir une notification par e-mail automatique chaque fois qu'un événement de maintenance est planifié ou annulé pour un cluster pour lequel un intervalle de maintenance est défini, utilisez la consoleGoogle Cloud pour activer la réception de ces messages:

  1. Accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur un cluster dans la colonne Nom de la ressource.

  3. Sur la page Présentation, dans Maintenance, cliquez sur Modifier dans la ligne Notifications:.

  4. Cliquez sur Communication.

  5. Sur la ligne AlloyDB, Intervalle de maintenance, activez l'option dans la colonne Adresse e-mail.

Chaque utilisateur devant recevoir des notifications doit activer lui-même l'option.