View a markdown version of this page

Gestion des clusters élastiques Amazon DocumentDB - 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.

Gestion des clusters élastiques Amazon DocumentDB

Amazon DocumentDB assure régulièrement la maintenance des ressources du cluster élastique Amazon DocumentDB. La maintenance implique le plus souvent des mises à jour du moteur de base de données (maintenance du cluster élastique) ou du système d'exploitation sous-jacent du cluster élastique (mises à jour du système d'exploitation). Les mises à jour du moteur de base de données sont des correctifs obligatoires et incluent des correctifs de sécurité, des corrections de bogues et des améliorations apportées au moteur de base de données. Bien que la plupart des correctifs du système d'exploitation soient facultatifs, si vous ne les appliquez pas pendant un certain temps, le correctif peut être nécessaire et appliqué automatiquement pour maintenir votre niveau de sécurité. Appliquez les mises à jour du système d'exploitation à vos clusters élastiques Amazon DocumentDB dès qu'elles sont disponibles.

Les correctifs du moteur de base de données nécessitent que vous mettiez vos clusters élastiques Amazon DocumentDB hors ligne pendant une courte période. Une fois disponibles, ces correctifs sont automatiquement programmés pour être appliqués lors d'une prochaine fenêtre de maintenance planifiée de votre cluster élastique Amazon DocumentDB.

Les clusters élastiques ont leurs propres fenêtres de maintenance respectives. Les modifications du cluster élastique que vous avez choisi de ne pas appliquer immédiatement sont appliquées pendant la fenêtre de maintenance. Par défaut, lorsque vous créez un cluster élastique, Amazon DocumentDB attribue une fenêtre de maintenance à votre cluster élastique. Vous pouvez choisir la fenêtre de maintenance lors de la création d'un cluster élastique. Vous pouvez également modifier les fenêtres de maintenance à tout moment en fonction de vos planifications ou pratiques métier. Il est généralement conseillé de choisir des fenêtres de maintenance qui limitent l'impact de la maintenance sur votre application (par exemple, le soir ou le week-end).

Affichage des actions de maintenance d'Elastic Cluster en attente

Vous pouvez vérifier si une mise à jour de maintenance est disponible pour votre cluster élastique à l'aide du AWS CLI.

Si une mise à jour est disponible, vous pouvez procéder de l’une des manières suivantes :

  • Reportez une action de maintenance actuellement planifiée pour la prochaine fenêtre de maintenance (pour les correctifs du système d'exploitation uniquement).

  • Appliquer immédiatement les actions de maintenance.

  • Planifier le début des actions de maintenance au cours de votre prochaine fenêtre de maintenance.

  • Planifiez les actions de maintenance pour qu'elles démarrent pendant la fenêtre d'application que vous avez sélectionnée.

Le réglage de la fenêtre de maintenance détermine quand les opérations en attente démarrent, mais il ne limite pas la durée d'exécution totale de ces opérations.

Procédez comme suit AWS CLI pour déterminer quelles actions de maintenance sont en attente. Répertoriez toutes les actions de maintenance en attente :

aws docdb-elastic list-pending-maintenance-actions

Le résultat de cette opération ressemble à ce qui suit (format JSON) :

{ 'ResourcePendingMaintenanceActions': [ { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] }, ], 'NextToken': 'string' }

Obtenir l'action de maintenance en attente (le cas échéant) sur un resourceArn :

aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn

La sortie de cette opération ressemble à ceci (format JSON).

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' } ] } }

Paramètres :

  • ResourceArn—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.

  • Action—L'action de maintenance en attente appliquée à la ressource.

    Valeurs valides :

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • AutoAppliedAfterDate—Première fenêtre de maintenance après cette date. NEXT_MAINTENANCE OPT_INest ignoré dans ce cas.

  • ForcedApplyDate—Appliqué quelle que soit la fenêtre de maintenance. IMMEDIATE OPT_INest ignoré dans ce cas.

  • OptInStatus—Une valeur qui spécifie le type de demande d'opt-in ou annule une demande d'opt-in. Un type demande de confirmation de l'acceptation de type IMMEDIATE ne peut pas être annulée.

    Valeurs valides :

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

    • NEXT_MAINTENANCE—Appliquez l'action de maintenance au cours de la fenêtre de maintenance suivante pour la ressource.

    • APPLY_ON—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la prochaine fenêtre de maintenance pour la ressource.

    • UNDO_OPT_IN—Annulez toute demande existante NEXT_MAINTENANCE ou APPLY_ON optionnelle.

  • CurrentApplyDate: affiché si le type d'activation est défini. APPLY_ON

  • Description: description des options pour l'action de maintenance.

Mises à jour d'Elastic Cluster

Avec Amazon DocumentDB, vous pouvez choisir quand appliquer les opérations de maintenance. Vous pouvez décider à quel moment Amazon DocumentDB applique les mises à jour à l'aide du AWS CLI.

Appliquez les actions de maintenance en attente :

aws docdb-elastic apply-pending-maintenance-action --resource-arn string-arn --apply-action string-enum --opt-in-type string-enum [--apply-on string-date-range]

Paramètres :

  • --resource-arn—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.

  • --apply-action—L'action de maintenance en attente à appliquer à cette ressource.

    Valeurs valides :

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • --opt-in-type—Une valeur qui spécifie le type de demande d'opt-in ou annule une demande d'opt-in. Un type demande de confirmation de l'acceptation de type IMMEDIATE ne peut pas être annulée.

    Valeurs valides :

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

    • NEXT_MAINTENANCE—Appliquez l'action de maintenance au cours de la fenêtre de maintenance suivante pour la ressource.

    • APPLY_ON—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la prochaine fenêtre de maintenance pour la ressource.

    • UNDO_OPT_IN—Annulez toute demande existante NEXT_MAINTENANCE ou APPLY_ON optionnelle.

  • [--apply-on]—Obligatoire si le type d'inscription est défini. APPLY_ON Format : yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm (Cette option utilise l'heure UTC. L'heure de début peut être à tout moment dans le futur, entre un minimum de 30 minutes et un maximum de 14 jours, ou une force/apply date correspondant à une action en attente, selon la première de ces deux éventualités. La fenêtre horaire du début à la fin peut être d'un minimum de 30 minutes à un maximum de 8 heures.)

Le résultat de cette opération ressemble à ce qui suit (format JSON) :

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'SECURITY_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'IMMEDIATE', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } }

Paramètres :

  • ResourceArn—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.

  • Action—L'action de maintenance en attente appliquée à la ressource.

    Valeurs valides :

    • ENGINE_UPDATE

    • ENGINE_UPGRADE

    • SECURITY_UPDATE

    • OS_UPDATE

    • MASTER_USER_PASSWORD_UPDATE

  • AutoAppliedAfterDate—Première fenêtre de maintenance après cette date. NEXT_MAINTENANCE OPT_INest ignoré dans ce cas.

  • ForcedApplyDate—Appliqué quelle que soit la fenêtre de maintenance. IMMEDIATE OPT_INest ignoré dans ce cas.

  • OptInStatus—Une valeur qui spécifie le type de demande d'opt-in ou annule une demande d'opt-in. Un type demande de confirmation de l'acceptation de type IMMEDIATE ne peut pas être annulée.

    Valeurs valides :

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

    • NEXT_MAINTENANCE—Appliquez l'action de maintenance au cours de la fenêtre de maintenance suivante pour la ressource.

    • APPLY_ON—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la prochaine fenêtre de maintenance pour la ressource.

    • UNDO_OPT_IN—Annulez toute demande existante NEXT_MAINTENANCE ou APPLY_ON optionnelle.

  • CurrentApplyDate: affiché si le type d'activation est défini. APPLY_ON

  • Description: description des options pour l'action de maintenance.

Dates d'application

Chaque action de maintenance a une date d'application que vous pouvez trouver lors de la description des actions de maintenance en attente. Lorsque vous lisez le résultat des actions de maintenance en attente depuis le AWS CLI, trois dates sont répertoriées :

  • CurrentApplyDate—La date à laquelle l'action de maintenance sera appliquée immédiatement ou au cours de la prochaine fenêtre de maintenance. Si la maintenance est facultative, cette valeur peut être nulle.

  • ForcedApplyDate—La date à laquelle la maintenance sera automatiquement appliquée, indépendamment de votre fenêtre de maintenance.

  • AutoAppliedAfterDate—Date après laquelle la maintenance sera appliquée pendant la fenêtre de maintenance du cluster.

User-created actions de maintenance

En tant qu'utilisateur du cluster Amazon DocumentDBEelastic, vous pouvez lancer des mises à jour des configurations de vos clusters.

Actualisation du mot de passe principal du cluster

aws docdb-elastic update-cluster --cluster-arn string-arn [--admin-user-password string] [--auth-type string-enum] [--apply-method string-enum] [--apply-on string-date-range] #... other parameters of the API that follow here are not relevant for this configuration

Paramètres :

  • --cluster-arn—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle l'action de maintenance sera appliquée.

  • [--admin-user-password]—Le mot de passe associé à l'utilisateur administrateur.

  • [--auth-type]—Le type d'authentification utilisé pour déterminer où récupérer le mot de passe utilisé pour accéder à l'Elastic Cluster. Les types valides sont PLAIN_TEXT ouSECRET_ARN.

  • [--apply-method]—Une valeur qui spécifie le type de méthode appliqué. Les valeurs autorisées sont IMMEDIATE et APPLY_ON. La valeur par défaut est IMMEDIATE.

  • [--apply-on]—Obligatoire si apply-method c'est APPLY_ON le cas. Format : yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm (Cette option utilise l'heure UTC. L'heure de début peut être à tout moment dans le futur, d'un minimum de 30 minutes à un maximum de 14 jours. La fenêtre horaire du début à la fin peut être d'un minimum de 30 minutes à un maximum de 8 heures.)

Le résultat de cette opération ressemble à ce qui suit (format JSON) :

{ 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'MASTER_USER_PASSWORD_UPDATE', 'OptInStatus': 'APPLY_ON', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } }

Modifier vos fenêtres de maintenance Amazon DocumentDB

Le créneau de maintenance doit intervenir au moment où l'utilisation est la plus faible, il peut donc s'avérer nécessaire de le modifier de temps en temps. Votre cluster élastique n'est pas disponible pendant cette période uniquement si des modifications du système (telles qu'une modification des opérations de stockage de la balance) sont appliquées et nécessitent une panne. Il n'est pas disponible pendant la durée minimale requise pour apporter les modifications nécessaires.

Par défaut, il s'agit d'une fenêtre de 30 minutes sélectionnée au hasard parmi un intervalle de 8 heures pour chaque région Amazon Web Services, survenant un jour aléatoire de la semaine.

Pour modifier la fenêtre de maintenance, consultezModification des configurations d'Elastic Cluster.

Mises à jour du système d'exploitation Elastic Clu

Les clusters élastiques Amazon DocumentDB nécessitent parfois des mises à jour du système d'exploitation. Amazon DocumentDB met à niveau le système d'exploitation vers une version plus récente afin d'améliorer les performances de la base de données et la posture de sécurité globale des clients. Les mises à jour du système d'exploitation ne modifient pas la version du moteur de cluster d'un cluster élastique Amazon DocumentDB.

La plupart des mises à jour du système d'exploitation pour les clusters élastiques Amazon DocumentDB sont facultatives et aucune date n'est définie pour leur application. Toutefois, si vous n'appliquez pas ces mises à jour pendant un certain temps, elles peuvent éventuellement devenir obligatoires et appliquées automatiquement pendant la fenêtre de maintenance de vos clusters. Cela permet de maintenir le niveau de sécurité de votre base de données. Pour éviter toute interruption inattendue, appliquez les mises à jour du système d'exploitation à votre cluster élastique Amazon DocumentDB dès qu'elles sont disponibles, et définissez la fenêtre de maintenance de votre cluster à un moment adapté aux besoins de votre entreprise.