View a markdown version of this page

AWSSupport-TroubleshootEC2ConnectivityToRedshift - AWS Systems Manager Référence du dossier d’exploitation Automation

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.

AWSSupport-TroubleshootEC2ConnectivityToRedshift

Description

Le AWSSupport-TroubleshootEC2ConnectivityToRedshift runbook fournit un dépannage complet pour les instances Amazon Elastic Compute Cloud (Amazon EC2) qui ne peuvent pas se connecter aux clusters Amazon Redshift. Il analyse systématiquement les chemins de connectivité réseau, les configurations de sécurité et fournit des recommandations de correction détaillées.

Le runbook prend en charge les scénarios de connectivité suivants :

  • Connectivité Amazon VPC identique  : connexion directe au sein du même Amazon Virtual Private Cloud (Amazon VPC).

  • Cross-Amazon Connectivité VPC  : connexion entre différents VPC à l'aide d'Amazon VPC peering ou de Transit Gateway. AWS

  • Clusters Amazon Redshift publics et privés  : différents modèles de connectivité en fonction de l'accessibilité des clusters.

  • Internet-based access  : instances Amazon EC2 se connectant à des clusters Amazon Redshift accessibles au public via Internet Gateway ou NAT Gateway.

Comment ça marche

Le runbook utilise Amazon VPC Reachability Analyzer comme outil de diagnostic principal pour identifier rapidement les problèmes de connectivité entre l'instance Amazon EC2 et le cluster Amazon Redshift. Si Reachability Analyzer n'est pas pris en charge dans votre AWS région ou échoue pour une raison quelconque, le runbook revient automatiquement à des contrôles de connectivité standard complets couvrant les groupes de sécurité, les ACL réseau, les tables de routage et la configuration DNS.

Important

L'exécution de ce runbook crée une analyse de l'analyseur d'accessibilité dans votre compte, ce qui entraîne des frais par analyse. Pour plus d'informations, consultez la section Analyse du réseau dans Amazon VPC Pricing.

Ce runbook crée un chemin d'informations sur le réseau et une analyse des informations sur le réseau dans votre compte à l'aide de Reachability Analyzer. Si le runbook se termine correctement, ces ressources sont supprimées. Si l'étape de nettoyage échoue, le chemin Network Insights n'est pas supprimé et vous devez le supprimer manuellement. Si vous ne supprimez pas le chemin Network Insights manuellement, il continue à être pris en compte dans le quota de votre AWS compte. Pour plus d'informations, voir Quotas pour Reachability Analyzer.

Les configurations au niveau du système d'exploitation, telles que l'utilisation d'un pare-feu, d'un proxy, d'un résolveur DNS local ou d'un fichier hôte, peuvent affecter la connectivité même si l'analyseur d'accessibilité renvoie un statut de. PASS

Passez en revue l'évaluation de tous les contrôles effectués par l'analyseur. Si un contrôle renvoie un statut deFAIL, cela peut affecter la connectivité même si le contrôle d'accessibilité global renvoie un statut de. PASS

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

/

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ec2:CreateNetworkInsightsPath

  • ec2:DeleteNetworkInsightsAnalysis

  • ec2:DeleteNetworkInsightsPath

  • ec2:DescribeInstances

  • ec2:DescribeInternetGateways

  • ec2:DescribeNatGateways

  • ec2:DescribeNetworkAcls

  • ec2:DescribeNetworkInsightsAnalyses

  • ec2:DescribeNetworkInsightsPaths

  • ec2:DescribeNetworkInterfaces

  • ec2:DescribeRouteTables

  • ec2:DescribeSecurityGroups

  • ec2:DescribeSubnets

  • ec2:DescribeTransitGatewayVpcAttachments

  • ec2:DescribeTransitGateways

  • ec2:DescribeVpcAttribute

  • ec2:DescribeVpcEndpoints

  • ec2:DescribeVpcPeeringConnections

  • ec2:DescribeVpcs

  • ec2:StartNetworkInsightsAnalysis

  • redshift:DescribeClusterSubnetGroups

  • redshift:DescribeClusters

Exemple de politique IAM :


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ec2:CreateNetworkInsightsPath",
                "ec2:DeleteNetworkInsightsAnalysis",
                "ec2:DeleteNetworkInsightsPath",
                "ec2:DescribeInstances",
                "ec2:DescribeInternetGateways",
                "ec2:DescribeNatGateways",
                "ec2:DescribeNetworkAcls",
                "ec2:DescribeNetworkInsightsAnalyses",
                "ec2:DescribeNetworkInsightsPaths",
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeRouteTables",
                "ec2:DescribeSecurityGroups",
                "ec2:DescribeSubnets",
                "ec2:DescribeTransitGatewayVpcAttachments",
                "ec2:DescribeTransitGateways",
                "ec2:DescribeVpcAttribute",
                "ec2:DescribeVpcEndpoints",
                "ec2:DescribeVpcPeeringConnections",
                "ec2:DescribeVpcs",
                "ec2:StartNetworkInsightsAnalysis",
                "redshift:DescribeClusterSubnetGroups",
                "redshift:DescribeClusters"
            ],
            "Resource": "*"
        }
    ]
}
Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Ouvrez AWSSupport-TroubleshootEC2ConnectivityToRedshift dans le Gestionnaire de systèmes sous Documents.

  2. Choisissez Execute automation (Exécuter l’automatisation).

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole (Facultatif) :

      L'ARN du rôle AWS Identity and Access Management (IAM) qui permet à Systems Manager Automation d'effectuer des actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

      Type : AWS::IAM::Role::Arn

    • SourceInstance (Obligatoire) :

      L'ID d'instance Amazon EC2 rencontre des problèmes de connectivité avec le cluster Amazon Redshift.

      Type : AWS::EC2::Instance::Id

      Schéma autorisé : ^i-[0-9a-f]{8,17}$

    • ClusterIdentifier (Obligatoire) :

      L'identifiant du cluster Amazon Redshift pour le dépannage de la connectivité.

      Type : Chaîne

      Schéma autorisé : ^[a-z][a-z0-9-]*[a-z0-9]$

  4. Sélectionnez Execute (Exécuter).

  5. L'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • CollectEC2Metadata: collecte des métadonnées complètes sur l'instance Amazon EC2, notamment la configuration Amazon VPC, les détails du sous-réseau, les adresses IP, les groupes de sécurité et l'état de l'instance.

    • InitializeInstanceIP: initialise la variable IP source avec l'adresse IP privée de l'instance Amazon EC2. Cette variable est mise à jour dynamiquement tout au long du processus de dépannage en fonction du chemin de connectivité déterminé.

    • AnalyzeEC2SubnetType: analyse la configuration de routage des sous-réseaux de l'instance Amazon EC2 afin de déterminer le type de sous-réseau et les capacités de connectivité Internet. Identifie les adresses IP publiques de la passerelle NAT, le cas échéant.

    • CollectRedshiftMetadata: extrait la configuration complète du cluster Amazon Redshift, y compris les détails d'Amazon VPC, les informations sur les terminaux, la configuration des ports, les paramètres d'accessibilité publique, les groupes de sécurité et les détails de l'interface réseau.

    • CollectRedshiftSubnetInfo: extrait des informations détaillées sur la configuration du groupe de sous-réseaux du cluster Amazon Redshift, y compris tous les sous-réseaux associés et les détails d'Amazon VPC.

    • RunReachabilityAnalysis: exécute Amazon VPC Reachability Analyzer en tant qu'outil de diagnostic principal pour effectuer une analyse complète des chemins réseau entre l'instance Amazon EC2 et le cluster Amazon Redshift. Analyse les groupes de sécurité, les ACL réseau, les tables de routage et les interfaces réseau. Si cette étape échoue, le runbook recommence à effectuer des vérifications manuelles de connectivité à AnalyzeRedshiftSubnetType partir de.

    • BranchOnReachabilityResults: Détermine le chemin de dépannage en fonction des résultats de l'analyseur d'accessibilité. Si l'analyse aboutit et trouve un chemin réseau, passez directement à la validation DNS. Dans le cas contraire, continuez avec le dépannage manuel.

    • AnalyzeRedshiftSubnetType: analyse la configuration de routage des sous-réseaux du cluster Amazon Redshift afin de déterminer le type de sous-réseau et les capacités de connectivité Internet.

    • BranchOnCompareVpcIds: compare les ID Amazon VPC de l'instance Amazon EC2 et du cluster Amazon Redshift. Permet de résoudre les problèmes liés au même Amazon VPC si les deux ressources partagent un Amazon VPC ; sinon, passe à une analyse cross-Amazon VPC.

    • ValidateSameVpcRequirements: (chemin Same-Amazon VPC) Valide les exigences de connectivité en vérifiant que les sous-réseaux Amazon EC2 et Amazon Redshift disposent d'une configuration de routage locale appropriée.

    • DetectCrossVpcConnectivity: (chemin Cross-Amazon VPC) Détecte et analyse les méthodes de connectivité entre Amazon VPC. Recherche les connexions d'appairage Amazon VPC actives et les pièces jointes AWS Transit Gateway.

    • ValidateVpcPeeringRouting: (chemin d'appairage VPC) Valide le routage bidirectionnel entre les VPC Amazon EC2 et Amazon Redshift via la connexion d'appairage.

    • ValidateTransitGatewayRouting: (chemin AWS Transit Gateway) Valide la configuration des itinéraires de Transit Gateway en analysant les tables de routage, les associations et les propagations pour les deux pièces jointes Amazon VPC.

    • UpdateInstanceIPForPublicAccess: (Chemin d'accès public) Met à jour la variable IP source avec l'adresse IP publique ou l'adresse IP de passerelle NAT correcte pour la validation des groupes de sécurité dans les scénarios d'accès public.

    • CheckSecurityGroups: Valide les règles de groupe de sécurité pour l'instance Amazon EC2 et le cluster Amazon Redshift. Vérifie les règles entrantes sur les groupes de sécurité Amazon Redshift et les règles sortantes sur les groupes de sécurité Amazon EC2.

    • CheckNetworkACLs: valide les règles ACL réseau pour la connectivité entre les sous-réseaux Amazon EC2 et Amazon Redshift. Analyse les règles entrantes et sortantes, y compris les plages de ports éphémères pour le trafic de retour.

    • ValidateDNSConfiguration: valide les paramètres de configuration DNS pour les VPC Amazon EC2 et Amazon Redshift, y compris la prise en charge du DNS, les noms d'hôte DNS et les ensembles d'options DHCP.

    • GenerateFinalReport: génère un rapport de diagnostic complet consolidant tous les résultats, y compris des résumés des problèmes classés, des étapes de correction hiérarchisées, une analyse de la topologie du réseau et des recommandations détaillées.

  7. Une fois l'automatisation terminée, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution.

Sorties

  • GenerateFinalReport.DiagnosticReport- Un rapport de diagnostic complet contenant tous les résultats et des recommandations de remédiation.

  • GenerateFinalReport.OverallStatus- Le résultat de l'état général de la connectivité.

  • GenerateFinalReport.IssuesSummary- Un résumé classé de tous les problèmes identifiés.

  • GenerateFinalReport.InstanceIPFinalValue- L'adresse IP source finale utilisée lors de l'analyse.

  • GenerateFinalReport.ConnectivityMethod- Méthode de connectivité détectée entre l'instance Amazon EC2 et le cluster Amazon Redshift.

Références

AWS Systems Manager  Automatisation