View a markdown version of this page

Exécution d'une mise à jour corrective de la version du moteur d'un cluster - Amazon DocumentDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Dans cette section, nous expliquerons comment déployer une mise à jour de correctif à l'aide du Console de gestion AWS ou du AWS CLI. Une mise à jour de correctif est une mise à jour effectuée dans la même version du moteur (par exemple, la mise à jour d'une version du moteur 3.6 vers une version plus récente du moteur 3.6). 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éterminer la maintenance en attente. Notez que lorsque vous appliquerez la mise à jour, votre cluster subira un certain temps d'arrêt.

Note

Si vous essayez de passer d'une version majeure d'un moteur à une autre, telle que 3.6 vers 5.0 ou 5.0 vers 8.0, consultez l'une Mise à niveau de la version majeure d'Amazon DocumentDB sur place ou l'autreMise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service.

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 Console de gestion AWS

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

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

  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 (Menu button.) 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.

    Image : Actions de mise à niveau d'Amazon DocumentDB

    • 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.

    • Mettre à niveau à la fenêtre suivante  : lance le processus de mise à niveau lors de la prochaine fenêtre de maintenance 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 selon le 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.

Parameters

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

  • --apply-action : obligatoire. Permet system-update d'appliquer une mise à jour du correctif du moteur au cluster.

  • --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-maintenanceinscription existantes.

Exemple

L'exemple suivant applique la mise à jour du correctif moteur àsample-cluster.

Pour Linux, macOS ou Unix :

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster \
   --apply-action system-update \
   --opt-in-type immediate

Pour Windows :

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster ^
   --apply-action system-update ^
   --opt-in-type immediate

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

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "system-update",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}