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 effectue 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 du 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, ils peuvent être nécessaires et appliqués automatiquement pour maintenir votre niveau de sécurité. Nous vous recommandons donc d'appliquer 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 s'appliquer lors d'une prochaine période 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).

Afficher les actions de maintenance du cluster élastique en attente

Vous pouvez voir si une mise à jour de maintenance est disponible pour votre cluster élastique en utilisant le AWS CLI.

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

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.

Utilisez l' AWS CLI opération suivante pour déterminer les actions de maintenance 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 (JSONformat) :

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

Obtenir une action de maintenance en attente (le cas échéant) sur une donnée resourceArn :

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

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

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

Paramètres :

Mises à jour du moteur de cluster élastique

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

Appliquer 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 :

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

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

Paramètres :

Appliquer les dates

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 :

Actions de maintenance créées par l'utilisateur

En tant qu'utilisateur ocumentDBelastic du cluster Amazon D, vous pouvez initier 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 :

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

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

Modification de 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 de l'opération de stockage à grande échelle) sont appliquées et nécessitent une interruption. Il n'est pas disponible uniquement pendant le minimum de temps nécessaire pour apporter les modifications nécessaires.

La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard sur une période 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, voirModification des configurations de clusters élastiques.

Mises à jour du système d'exploitation du cluster élastique

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 le niveau de sécurité global 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 ne sont pas soumises à une date précise pour les appliquer. Toutefois, si vous n'appliquez pas ces mises à jour pendant un certain temps, elles peuvent éventuellement devenir nécessaires et automatiquement appliquées pendant la période de maintenance de vos clusters. Cela permet de maintenir le niveau de sécurité de votre base de données. Pour éviter toute interruption imprévue, nous vous recommandons d'appliquer les mises à jour du système d'exploitation à votre cluster élastique Amazon DocumentDB dès qu'elles sont disponibles et de définir le créneau de maintenance de votre cluster au moment qui vous convient, en fonction des besoins de votre entreprise.