Exécution d'une mise à jour du correctif de la version du moteur d'un cluster

Dans cette section, nous expliquerons comment déployer une mise à jour de correctif à l'aide du AWS Management Console ou du AWS CLI. Une mise à jour de correctif est une mise à jour de la même version du moteur (par exemple, la mise à jour d'une version du moteur 3.6 vers une version du moteur 3.6 plus récente). Vous pouvez le mettre à jour immédiatement ou lors de la prochaine fenêtre de maintenance de votre cluster. Pour déterminer si votre moteur a besoin d'une mise à jour, consultezDétermination de la maintenance en attente. Notez que lorsque vous appliquez la mise à jour, votre cluster subira des temps d'arrêt.

Note

Si vous essayez de passer d'une version majeure du moteur à une autre, par exemple de la version 3.6 à la version 5.0, reportez-vous à la section Mise à niveau sur place de la version majeure d'Amazon DocumentDB ouMise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service. Une mise à niveau de version majeure sur place ne prend en charge que docdb 5.0 comme version du moteur cible.

Deux exigences de configuration sont requises pour obtenir les dernières mises à jour des correctifs pour la version du moteur d'un cluster :

• Le statut du cluster doit être disponible.

• Le cluster doit exécuter une version antérieure du moteur.

Using the AWS Management Console

La procédure suivante applique les mises à jour des correctifs à la version du moteur de votre cluster à l'aide de la console. Vous avez la possibilité de procéder à la mise à jour immédiatement ou lors de la prochaine fenêtre de maintenance de votre cluster.

1. Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.

2. Dans le panneau de navigation, choisissez Clusters. Dans la liste des clusters, choisissez le bouton sur la gauche du cluster que vous voulez mettre à niveau. Le statut du cluster doit être disponible.

   Astuce

   Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu () dans le coin supérieur gauche de la page.

3. Dans le menu Actions, choisissez l'une des options suivantes. Ces options de menu sont sélectionnables uniquement si le cluster que vous avez choisi n'exécute pas la version la plus récente du moteur.

   

   • Mettre à niveau maintenant —Lance immédiatement le processus de mise à niveau. Votre cluster est hors ligne pendant la mise à niveau vers la version la plus récente du moteur.

   • Mise à niveau à la fenêtre suivante : lance le processus de mise à niveau lors de la fenêtre de maintenance suivante du cluster. Votre cluster est hors ligne pendant la mise à niveau vers la version la plus récente du moteur.

4. Lorsque la fenêtre de confirmation s'ouvre, choisissez l'une des options suivantes :

   • Mise à niveau : pour mettre à niveau votre cluster vers la dernière version du moteur conformément au calendrier choisi à l'étape précédente.

   • Annuler : pour annuler la mise à niveau du moteur du cluster et continuer avec la version actuelle du moteur du cluster.

Using the AWS CLI

Vous pouvez appliquer des mises à jour de correctifs à votre cluster à l'aide de l'apply-pending-maintenance-actionopération AWS CLI et avec les paramètres suivants.

Paramètres

• --resource-identifier : obligatoire. Le ARN cluster Amazon DocumentDB que vous allez mettre à niveau.

• --apply-action : obligatoire. Les valeurs suivantes sont autorisées. Pour mettre à niveau la version du moteur de votre cluster, utilisez db-upgrade.

  • db-upgrade

  • system-update

• --opt-in-type : obligatoire. Les valeurs suivantes sont autorisées.

  • immediate—Appliquez immédiatement l'action de maintenance.

  • next-maintenance—Appliquez l'action de maintenance lors de la fenêtre de maintenance suivante.

  • undo-opt-in—Annulez toutes les demandes d'next-maintenanceopt-in existantes.

L'exemple de correctif suivant met à jour la version du moteur de sample-cluster vers la version 4.0.0.

Pour Linux, macOS ou Unix :

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

Pour Windows :

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

Le résultat de cette opération ressemble à ce qui suit.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}