Comment faire pour résoudre les problèmes liés à une instance Amazon DocumentDB qui se trouve dans un état de réseau incompatible ?

Brève description

Un état de réseau incompatible se produit en raison d’un ou de plusieurs des problèmes suivants liés à l’instance Amazon DocumentDB :

• Aucune adresse IP n’est disponible dans le sous-réseau dans lequel l’instance Amazon DocumentDB a été lancée.
• Le sous-réseau répertorié dans le groupe de sous-réseau DB Amazon DocumentDB n’existe pas dans Amazon Virtual Private Cloud (Amazon VPC).
• Vous avez atteint votre quota de service pour les interfaces réseau élastiques dans la région AWS que vous utilisez.

Si vous rencontrez l’un de ces problèmes, votre instance Amazon DocumentDB risque de passer à l’état réseau incompatible lorsque vous effectuez l’une des actions suivantes :

• Modifiez la classe de l’instance Amazon DocumentDB.
• Ajoutez une nouvelle instance Amazon DocumentDB au cluster.
• Remplacez un hôte à la suite d’un événement de maintenance.
• Créez une instance Amazon DocumentDB une fois que les interfaces réseau élastiques ont atteint leur quota.
• Faites une restauration à partir d’une sauvegarde instantanée d’Amazon DocumentDB.
• Démarrez un cluster Amazon DocumentDB qui a été arrêté.

Résolution

L’état réseau incompatible signifie que l’instance Amazon DocumentDB peut encore être accessible au niveau de la base de données, mais que vous ne pouvez pas modifier ou redémarrer l’instance. Il est recommandé de toujours disposer d’une sauvegarde afin de pouvoir restaurer les données sur une autre instance si votre instance passe à l’état réseau incompatible.

Pour résoudre les problèmes liés à une instance Amazon DocumentDB en état réseau incompatible, choisissez l’une des solutions suivantes :

• Utilisez le dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration.
• Utilisez la console de gestion AWS.

Utiliser le dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration

Pour identifier la raison pour laquelle votre instance Amazon DocumentDB est dans un état réseau incompatible, utilisez le dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration. Pour éviter l’état réseau incompatible, utilisez ce dossier d’exploitation lorsque vous effectuez des modifications ou que vous démarrez une instance arrêtée.

Remarque : avant de commencer à utiliser le dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration, assurez-vous que votre utilisateur ou rôle AWS Identity and Access Management (IAM) dispose bien des autorisations requises. Pour plus d’informations, consultez la section Autorisations IAM requises de AWSSupport-ValidateRdsNetworkConfiguration.

Pour résoudre les problèmes à partir du dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration, procédez comme suit :

1. Connectez-vous à la console AWS Systems Manager et accédez au dossier d’exploitation AWSSupport-ValidateRdsNetworkConfiguration.
2. Sélectionnez Exécuter l'automatisation.
3. Saisissez ensuite les valeurs suivantes :
   Dans AutomationAssumeRole, saisissez l’ARN du rôle IAM qui permet à l’automatisation d’effectuer les actions en votre nom. Si vous ne spécifiez pas de rôle, l’automatisation utilise les autorisations de l’utilisateur qui lance le dossier d’exploitation.
   Pour DBInstanceIdentifier, saisissez l’identifiant d’instance de votre instance Amazon DocumentDB.
4. Sélectionnez Exécuter.
5. Une fois l’automatisation terminée, passez en revue les résultats détaillés dans la section Sorties. Le paramètre generateReport.report affiche un rapport consolidé de toutes les vérifications effectuées dans le cadre de ce dossier d’exploitation.
6. (Facultatif) Consultez la section ### [Next Steps] du rapport de sortie pour connaître les autres étapes de résolution des problèmes.

Utiliser la console de gestion AWS

Pour résoudre les problèmes à partir de la console de gestion AWS, procédez comme suit :

1. Ouvrez la console Amazon DocumentDB, puis choisissez Instances dans le volet de navigation.
2. Choisissez l’instance Amazon DocumentDB avec l’état réseau incompatible. Notez ensuite l’ID VPC dans les détails de l’instance.
3. Ouvrez la console Amazon VPC, puis choisissez Sous-réseaux dans le volet de navigation. Vérifiez que tous les groupes de sous-réseaux du VPC utilisé par le cluster Amazon DocumentDB existent et sont disponibles.
4. Assurez-vous que tous les sous-réseaux du groupe de sous-réseaux utilisé par le cluster Amazon DocumentDB disposent d’adresses IP disponibles.
5. Ouvrez la console Amazon Elastic Compute Cloud (Amazon EC2), puis assurez-vous que vous avez atteint le quota d’interfaces réseau Elastic. Si vous avez atteint le quota, demandez une augmentation du quota de service. Pour en savoir plus, consultezInterfaces réseau.

Si l’instance Amazon DocumentDB est déjà dans un état réseau incompatible, choisissez l’une des méthodes suivantes pour votre cluster Amazon DocumentDB :

• Créez une instance Amazon DocumentDB dans le cluster après avoir résolu le problème à l’origine de l’état de réseau incompatible. Une fois qu’un cluster est en cours d’exécution avec une nouvelle instance Amazon DocumentDB active, supprimez l’instance qui était dans un état réseau incompatible.
  Important : ne supprimez pas l’intégralité du cluster. Supprimez plutôt l’instance d’état réseau incompatible uniquement. Assurez-vous également que la nouvelle instance Amazon DocumentDB active se trouve bien dans le même cluster que l’ancienne instance d’état réseau incompatible.
• Arrêtez temporairement toute écriture sur l’instance Amazon DocumentDB, puis effectuez une reprise ponctuelle (PITR) afin de créer un cluster.

Informations connexes

Surveillance de l’état d’une instance Amazon DocumentDB