Effectuer la maintenance en libre-service

Vous pouvez effectuer une maintenance en libre-service si vous devez appliquer les dernières mises à jour AlloyDB pour PostgreSQL à vos clusters dès que possible. La mise à jour vers la dernière version peut débloquer des fonctionnalités AlloyDB, appliquer des correctifs et vous permettre de définir une période de refus pour éviter les interruptions pendant les périodes sensibles.

Pour en savoir plus, consultez Présentation de la maintenance.

Cas d'utilisation de l'automaintenance

AlloyDB applique généralement la maintenance à vos clusters pour vous, en effectuant des opérations de maintenance pour mettre à niveau le logiciel de base de données dans les clusters. Par défaut, AlloyDB effectue la maintenance en dehors des heures d'ouverture régionales. Vous pouvez également définir un intervalle de maintenance pour définir une heure de maintenance planifiée de votre choix et recevoir des notifications concernant les prochaines maintenances planifiées. Pour une version et une version PostgreSQL données, la maintenance est d'abord effectuée pour les clusters sans période de maintenance, puis planifiée pour les clusters avec période de maintenance.

Vous pouvez décider d'effectuer une maintenance en libre-service pour les raisons suivantes :

  • La maintenance de votre cluster a été ignorée. Cela se produit si vous configurez une période de refus ou si votre cluster était dans un état d'amorçage lors de la migration.
  • Votre cluster doit être mis à jour avant la maintenance programmée.
  • Vous devez définir une période de refus sur un cluster qui n'est pas à jour. Les clusters dont les instances utilisent des versions antérieures ne sont pas toujours compatibles avec la définition de périodes de refus.
  • Vous souhaitez exécuter la maintenance à une fréquence personnalisée ou irrégulière. Dans ce cas, vous pouvez définir une période de refus, puis effectuer la maintenance en libre-service lorsque vous en avez besoin. Les périodes de refus ne bloquent pas la maintenance en libre-service.

Granularité des ressources pendant les mises à jour

AlloyDB n'accepte que la maintenance au niveau du cluster. Dans le cluster, AlloyDB détermine l'ordre des mises à jour des instances. AlloyDB tente d'effectuer la maintenance de chaque instance de manière indépendante. Il est donc possible que les instances utilisent des versions différentes. Par exemple, un cluster peut ignorer la maintenance sur les instances existantes en raison d'une période de refus, puis créer une instance sur la dernière version par la suite.

Afficher la dernière version disponible

Consultez les journaux des modifications de maintenance d'AlloyDB pour connaître la dernière version. Le journal des modifications est mis à jour une fois la maintenance appliquée aux clusters de toutes les régions. Pour en savoir plus sur la façon dont les dernières versions sont appliquées aux régions, consultez Dernière version.

Afficher la version actuelle d'une instance

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

L'affichage de la version n'est possible qu'au niveau de l'instance.

  1. Pour afficher la version de maintenance actuelle de l'instance, exécutez la commande gcloud alloydb instances describe :

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    Remplacez les éléments suivants :

    • INSTANCE_ID : ID de l'instance pour laquelle vous consultez la version.
    • CLUSTER_ID : ID du cluster dans lequel l'instance est placée.
    • LOCATION_ID : région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

  2. Dans la réponse, recherchez le champ maintenanceVersionName pour afficher la version exécutée par l'instance. Exemple :

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Mettre à jour le cluster vers la dernière version disponible

gcloud

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

Pour mettre à jour le cluster vers la dernière version, exécutez la commande gcloud alloydb clusters update avec l'indicateur maintenance-version :

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

Remplacez les éléments suivants :

  • CLUSTER_ID : ID du cluster à mettre à jour vers la dernière version.
  • LOCATION_ID : région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

Exemple de réponse :

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

Cet exemple met à jour ce cluster vers la dernière version. Pour obtenir la liste complète des paramètres de cet appel, consultez Méthode : projects.locations.clusters.patch.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • CLUSTER_ID : cluster à mettre à jour vers la dernière version.
  • PROJECT_ID : ID du projet dans lequel le cluster est placé.
  • LOCATION_ID : région Google Cloud dans laquelle se trouve ce cluster (par exemple, us-central1).

Pour mettre à jour votre cluster vers la dernière version, utilisez la requête PATCH suivante :

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_version_selection_policy}

Le paramètre de requête maintenance_version_selection_policy spécifie la version vers laquelle mettre à jour les instances du cluster.

Le corps JSON de la requête se présente comme suit :

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Étapes suivantes