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 :

  • Même connectivité Amazon VPC : 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é du cluster.

  • Internet-based accès : 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 principal outil de diagnostic 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 AWS votre région ou échoue pour une quelconque raison, 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 Reachability Analyzer dans votre compte, 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 parcours 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 d'accès aux informations sur le réseau manuellement, il continue à être pris en compte dans le quota de votre AWS compte. Pour plus d'informations, consultez la section 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 d'hôtes, peuvent affecter la connectivité même si l'Analyzer de Reachability renvoie un statut de. PASS

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

Exécuter 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-TroubleshootEC2ConnectivityToRedshiftdans Systems Manager sous Documents.

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

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • 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 lance 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 de manière dynamique 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: Récupère la configuration complète du cluster Amazon Redshift, y compris les détails d'Amazon VPC, les informations sur les points de terminaison, la configuration des ports, les paramètres d'accessibilité publics, les groupes de sécurité et les détails de l'interface réseau.

    • CollectRedshiftSubnetInfo: Récupère 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 du chemin 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 revient aux contrôles de connectivité manuels à AnalyzeRedshiftSubnetType partir de.

    • BranchOnReachabilityResults: Détermine le chemin de dépannage en fonction des résultats de Reachability Analyzer. Si l'analyse aboutit et trouve un chemin réseau, passe directement à la validation DNS. Dans le cas contraire, poursuivez 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 identifiants 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, passez à une analyse entre 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 de peering 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: (AWS Transit Gateway path) Valide la configuration de l'itinéraire 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 du groupe de sécurité dans les scénarios d'accès public.

    • CheckSecurityGroups: valide les règles du 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 du 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 le support 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 par catégorie, 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 connaître les résultats détaillés de l'exécution.

Sorties

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

  • GenerateFinalReport.OverallStatus- Le résultat global de l'état de connectivité.

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

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

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

Références

AWS Systems Manager  Automatisation