Comment résoudre les problèmes lors de la création d'un cluster ElastiCache ?

Brève description

Selon qu'il s'agit d'un cluster conçu par nos soins ou d'un cluster Amazon ElastiCache Serverless, la création du cluster peut échouer pour les raisons suivantes :

• Vous restaurez une sauvegarde depuis Amazon Simple Storage Service (Amazon S3), mais la restauration échoue avec une erreur.
• La capacité est insuffisante pour le type de nœud de cache demandé dans une zone de disponibilité ou une région AWS.
• Vous avez sélectionné un type de nœud de cache qui n'est pas pris en charge dans une zone de disponibilité spécifique de la région.
• Il n'y a pas suffisamment d'adresses IP libres dans le sous-réseau que vous avez utilisé pour créer un cluster de cache.
• ElastiCache ne peut pas accéder à la clé gérée par le client AWS Key Management Service (AWS KMS) que vous avez utilisée pour chiffrer un groupe de réplication.
• Votre cache n'est pas autorisé à créer un point de terminaison de cloud privé virtuel (VPC) pour ElastiCache sans serveur.
• L'utilisateur ou le rôle Gestion des identités et des accès AWS (AWS IAM) ne dispose pas des autorisations appropriées.
• Votre compte AWS requiert un quota de service plus élevé.
• Vous avez incorrectement configuré les paramètres spécifiques au moteur lors de la création du cluster.

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez la version la plus récente d'AWS CLI.

La restauration de votre sauvegarde Amazon S3 échoue avec une erreur

La restauration d'une sauvegarde depuis Amazon S3 peut échouer pour plusieurs raisons. Par exemple, ElastiCache ne peut pas récupérer le fichier ou le compartiment se trouve dans une autre région. Pour résoudre ce problème, consultez la section Comment résoudre l'erreur « Échec de création » ou « Autorisation refusée » qui survient lorsque j'essaie de restaurer mon cluster ElastiCache depuis S3 ?

La capacité est insuffisante pour le type de nœud de cache demandé dans une zone ou une région de disponibilité

Si AWS ne dispose pas d'une capacité à la demande suffisante, le message d'erreur suivant peut s'afficher lorsque vous créez un cluster :

« Failed to create cache node because requested AZ does not have sufficient capacity. Please try again with another AZ. » (Impossible de créer le nœud de cache car la capacité AZ demandée n'est pas suffisante. Veuillez réessayer avec une autre AZ.)

La capacité d'une zone ou d'une région de disponibilité change constamment. Pour résoudre ce problème, créez le cluster à un autre moment. Pour en savoir plus, consultez la section Messages d’erreur : InsufficientCacheClusterCapacity.

Une zone de disponibilité de la région ne prend pas en charge le type de nœud de cache

Certaines zones de disponibilité d'une région ne prennent pas en charge des types de nœuds de cache spécifiques. Si vous créez un cluster et que vous sélectionnez l'une de ces zones de disponibilité, le message d'erreur suivant s'affiche :

« Cache node type is not currently supported in the AZ. Retry the launch with no availability zone or different AZs » (Le type de nœud de cache n'est actuellement pas pris en charge dans l'AZ. Réessayez le lancement sans aucune zone de disponibilité ou AZ différente)

Pour vérifier la disponibilité d'un type de nœud de cache spécifique, utilisez la commande Amazon Elastic Compute Cloud (Amazon EC2) describe-instance-type-offerings de l'interface de ligne de commande AWS :

aws ec2 describe-instance-type-offerings --location-type availability-zone --filters Name=instance-type,Values=m5.large --region example-region --output table

Remarque : Vous devez remplacer example-region par votre région.

Il n'existe pas suffisamment d'adresses IP libres dans le sous-réseau que vous avez choisi

Si les sous-réseaux que vous utilisez pour votre cluster ElastiCache ne disposent pas d'un nombre suffisant d'adresses IP libres, le message d'erreur suivant peut s'afficher :

« Failed to create Cache Cluster due to insufficient Elastic Network Interface or free IP address » (Impossible de créer un cluster de cache en raison d'une interface réseau Elastic insuffisante ou d'une adresse IP libre)

Pour résoudre ce problème, identifiez le groupe de sous-réseaux que vous avez configuré pour le cluster ElastiCache. Puis, vérifiez chaque sous-réseau pour vérifier qu'il existe un nombre suffisant d'adresses IP libres. Pour plus d'informations, consultez la section Comment résoudre les erreurs d'adresse IP insuffisantes qui se produisent lors de l'activité de mise à l’échelle de mon Amazon VPC ?

Pour libérer des adresses IP, vous pouvez également supprimer les interfaces réseau Elastic non utilisées dans un sous-réseau. Vous pouvez également ajouter des sous-réseaux au groupe de sous-réseaux dans la zone de disponibilité requise pour allouer davantage d'adresses IP libres.

ElastiCache ne peut pas accéder à la clé gérée par le client AWS KMS

Avec le chiffrement au repos ElastiCache, vous pouvez utiliser un chiffrement au repos géré par les services par défaut ou votre propre clé AWS KMS symétrique gérée par le client. Si vous avez supprimé, désactivé ou révoqué des autorisations pour la clé KMS lors de la création de votre cluster, le message d'erreur suivant peut s'afficher :

« Failed to create instance test-cluster due to error accessing AWS Key Management Service (KMS) for Customer Master Key arn:aws:kms:us-east-1:123456:key/1abcd2 » (Impossible de créer un cluster de test d'instance en raison d'une erreur lors de l'accès à AWS Key Management Service (KMS) pour la clé principale client arn:aws:kms:us-east- 1:123456:key/1abcd2)

Il n'est pas recommandé de supprimer, de désactiver ou de révoquer les autorisations relatives à la clé AWS KMS que vous avez utilisée pour chiffrer un groupe de réplication. AWS KMS supprime les clés racine uniquement après une période d'attente d'au moins 7 jours. Pendant la période d'attente, vous pouvez annuler la suppression programmée. Si vous supprimez la clé AWS KMS, vous ne pourrez pas récupérer le cache.

Votre cache ElastiCache Serverless n'est pas autorisé à créer un point de terminaison de VPC

Lorsque vous créez un nouveau cluster ElastiCache Serverless, ElastiCache crée des points de terminaison de VPC dans les sous-réseaux sélectionnés de votre VPC. Vos applications utilisent les points de terminaison de VPC pour se connecter au cache. Si votre cache ne parvient pas à créer les points de terminaison de VPC, il se peut que vous rencontriez des problèmes d'autorisation. Pour résoudre les problèmes d'autorisation, consultez la section Comment résoudre les problèmes de création de clusters ElastiCache sans serveur ?

Votre utilisateur ou rôle IAM ne dispose pas des autorisations appropriées

Si votre utilisateur ou votre rôle IAM ne dispose pas des autorisations appropriées, le message d'erreur suivant peut s'afficher :

« An error occurred (AccessDenied) when calling the CreateReplicationGroup operation: User: arn:aws:sts::xxxxxxxxx:assumed-role/Hello123 is not authorized to perform: elasticache:CreateReplicationGroup on resource: arn:aws:elasticache:ap-southeast-2:xxxxxxxxxx:replicationgroup:ROLEA because no identity-based policy allows the elasticache:CreateReplicationGroup action. » (Une erreur s'est produite (AccessDenied) lors de l'appel de l'opération CreateReplicationGroup : L’utilisateur : arn:aws:sts::xxxxxxxxx:assumed-role/Hello123 n’est pas autorisé à effectuer : elasticache:CreateReplicationGroup sur la ressource : arn:aws:elasticache:ap-southeast-2:xxxxxxxxxx:replicationgroup:ROLEA car aucune politique basée sur l’identité n’autorise l’action elasticache:CreateReplicationGroup.)

Lorsque vous utilisez une politique IAM gérée sur mesure avec ElastiCache, effectuez l'une des actions suivantes :

• Utilisez la console IAM pour activer les autorisations permettant d'appeler iam:createServiceLinkedRole.
• Créez un rôle lié à un service ElastiCache. Pour plus d'informations, consultez la section Création d'un rôle lié à un service (IAM).

Votre compte AWS requiert un quota de service plus élevé

Votre compte comprend des quotas par défaut pour chaque service AWS, et chaque quota est spécifique à votre région.

Si votre compte ne dispose pas du quota de service requis, l'un des messages d'erreur suivants peut s'afficher :

• « Cache subnet group quota exceeded. You can have at most 500 cache subnet groups in this region. If you need more, please visit the Support Center and open a Service Limit Increase case. » (Quota du groupe de sous-réseaux de cache dépassé. Vous pouvez avoir au maximum 500 groupes de sous-réseaux de cache dans cette région. Pour de plus amples informations, consultez le centre de support et ouvrez un dossier d'augmentation de la limite de service.)
• « Customer node quota exceeded. You can have at most 1250 nodes in this region. If you need more, please visit the Support Center and open a Service Limit Increase case. » (Quota du groupe de sous-réseaux de cache dépassé. Vous pouvez avoir au maximum 500 groupes de sous-réseaux de cache dans cette région. Pour de plus amples informations, consultez le centre de support et ouvrez un dossier d'augmentation de la limite de service.)

Vous pouvez demander des augmentations pour certains quotas. Pour plus d'informations sur les quotas et sur la manière de les augmenter, consultez la section Quotas pour ElastiCache.

Vous avez incorrectement configuré les paramètres spécifiques de votre moteur

Si vous n'avez pas spécifié de groupe de paramètres pour la version de votre moteur, le message d'erreur suivant peut s'afficher :

« An error occurred (InvalidParameterCombination) when calling the CreateVolume operation: Expected a parameter group of family redis7 but found one of family redis6.x. User has to verify that Parameter Group used has engine version that matches the cluster that is created. » (Une erreur s’est produite (InvalidParameterCombination) lors de l’appel de l’opération CreateReplicationGroup : Groupe de paramètres de la famille redis7 attendu mais groupe de paramètres de la famille redis6.x détecté. L'utilisateur doit vérifier que la version du moteur du groupe de paramètres utilisé correspond au cluster créé).

Lorsque vous créez un cluster ElastiCache, assurez-vous que le groupe de paramètres correct correspond à la version du moteur et au type de mode de cluster.

Informations connexes

Comment fonctionne Elasticache