Effectuer la maintenance en libre-service

Vous pouvez effectuer une maintenance en libre-service si vous devez appliquer les dernières mises à jour d'AlloyDB pour PostgreSQL à vos clusters dès que possible. La mise à jour vers la dernière version peut déverrouiller 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 la maintenance en libre-service

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 éventuellement définir un intervalle de maintenance pour définir une heure de maintenance planifiée préférée et recevoir des notifications concernant la maintenance planifiée à venir. Pour une version et une version PostgreSQL données, la maintenance est d'abord effectuée pour les clusters sans intervalles de maintenance, puis planifiée pour les clusters avec intervalles de maintenance.

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

  • Votre cluster a ignoré la maintenance. Cela se produit si vous configurez une période de refus ou si votre cluster était en état d'amorçage lors de la migration.
  • Votre cluster nécessite une mise à jour avant la maintenance planifiée.
  • Vous devez définir une période de refus sur un cluster qui n'est pas à jour. Les clusters avec des instances sur des versions antérieures ne sont pas toujours compatibles avec la définition de périodes de refus.
  • Vous souhaitez exécuter la maintenance selon une cadence personnalisée ou irrégulière. Dans ce cas, vous pouvez définir une période de refus, puis effectuer une 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 lors des mises à jour

AlloyDB n'est compatible qu'avec la maintenance au niveau du cluster. Dans le cluster, AlloyDB détermine l'ordre des mises à jour des instances. AlloyDB tente et effectue la maintenance de chaque instance indépendamment. Il est donc possible que les instances soient sur 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.

Afficher la dernière version disponible

Consultez les journaux des modifications de maintenance d'AlloyDB pour 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 l'application des dernières versions aux régions, consultez Dernière version.

Afficher la version actuelle d'une instance

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

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

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

    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 affichez la version.
    • CLUSTER_ID: ID du cluster dans lequel l'instance est placée.
    • LOCATION_ID : région dans laquelle se trouve ce cluster, par exemple us-central1. Google Cloud

  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 la Google Cloud CLI, ou vous pouvez utiliser Cloud Shell.

Pour mettre à jour le cluster vers la dernière version, exécutez la gcloud alloydb clusters update commande avec l'option 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 dans laquelle se trouve ce cluster, par exemple us-central1. Google Cloud

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 dans laquelle se trouve ce cluster, par exemple us-central1. Google Cloud

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 de la requête JSON se présente comme suit :

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Étape suivante