`AWSSupport-TroubleshootEC2ConnectivityToRedshift`

Description

Il AWSSupport-TroubleshootEC2ConnectivityToRedshift runbook fornisce una risoluzione completa della risoluzione dei problemi per le istanze Amazon Elastic Compute Cloud (Amazon EC2) che non possono connettersi ai cluster Amazon Redshift. Analizza sistematicamente i percorsi di connettività di rete, le configurazioni di sicurezza e fornisce consigli dettagliati per la correzione.

Il runbook supporta i seguenti scenari di connettività:

Stessa connettività Amazon VPC: connessione diretta all'interno dello stesso Amazon Virtual Private Cloud (Amazon VPC).
Cross-Amazon Connettività VPC: connessione tra diversi VPC tramite Amazon VPC peering o Transit Gateway. AWS
Cluster Amazon Redshift pubblici e privati: diversi modelli di connettività basati sull'accessibilità del cluster.
Internet-based accesso: istanze Amazon EC2 che si connettono a cluster Amazon Redshift accessibili al pubblico tramite Internet Gateway o NAT Gateway.

Come funziona

Il runbook utilizza Amazon VPC Reachability Analyzer come strumento diagnostico principale per identificare rapidamente i problemi di connettività tra l'istanza Amazon EC2 e il cluster Amazon Redshift. Se Reachability Analyzer non è supportato nella AWS tua regione o non funziona per qualsiasi motivo, il runbook torna automaticamente a controlli di connettività standard completi riguardanti gruppi di sicurezza, ACL di rete, tabelle di routing e configurazione DNS.

Importante

L'esecuzione di questo runbook crea un'analisi Reachability Analyzer nell'account, che comporta un costo per analisi. Per ulteriori informazioni, consulta la sezione Analisi di rete nei prezzi di Amazon VPC.

Questo runbook crea un percorso di analisi della rete e un'analisi delle informazioni di rete nel tuo account utilizzando Reachability Analyzer. Se il runbook viene completato correttamente, queste risorse vengono eliminate. Se la fase di pulizia fallisce, il percorso di Network Insights non viene eliminato ed è necessario eliminarlo manualmente. Se non elimini manualmente il percorso di Network Insights, continuerà a essere conteggiato ai fini della quota del tuo AWS account. Per ulteriori informazioni, vedere Quotas for Reachability Analyzer.

Le configurazioni a livello di sistema operativo come l'uso di un firewall, un proxy, un resolver DNS locale o un file hosts possono influire sulla connettività anche se Reachability Analyzer restituisce uno stato di. PASS

Esamina la valutazione di tutti i controlli eseguiti dall'analizzatore. Se un controllo restituisce uno stato diFAIL, ciò potrebbe influire sulla connettività anche se il controllo di raggiungibilità complessivo restituisce uno stato di. PASS

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il 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

Policy IAM di esempio:



{
    "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": "*"
        }
    ]
}

Istruzioni

Segui questi passaggi per configurare l'automazione:

Aprire AWSSupport-TroubleshootEC2ConnectivityToRedshiftin Systems Manager in Documenti.
Scegli Esegui automazione.
Per i parametri di input, immettete quanto segue:
- AutomationAssumeRole (Facoltativo):
  
  L'ARN del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire azioni per conto dell'utente. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
  
  Tipo: AWS::IAM::Role::Arn
- SourceInstance (Obbligatorio):
  
  L'ID dell'istanza Amazon EC2 presenta problemi di connettività con il cluster Amazon Redshift.
  
  Tipo: AWS::EC2::Instance::Id
  
  Schema consentito: ^i-[0-9a-f]{8,17}$
- ClusterIdentifier (Obbligatorio):
  
  L'identificatore del cluster Amazon Redshift per la risoluzione dei problemi di connettività.
  
  Tipo: String
  
  Pattern consentito: ^[a-z][a-z0-9-]*[a-z0-9]$
Scegli Esegui.
L'automazione viene avviata.
Il documento esegue le seguenti operazioni:
- CollectEC2Metadata: raccoglie metadati completi sull'istanza Amazon EC2, tra cui configurazione Amazon VPC, dettagli di sottorete, indirizzi IP, gruppi di sicurezza e stato dell'istanza.
- InitializeInstanceIP: inizializza la variabile IP di origine con l'indirizzo IP privato dell'istanza Amazon EC2. Questa variabile viene aggiornata dinamicamente durante tutto il processo di risoluzione dei problemi in base al percorso di connettività determinato.
- AnalyzeEC2SubnetType: analizza la configurazione di routing della sottorete dell'istanza Amazon EC2 per determinare il tipo di sottorete e le funzionalità di connettività Internet. Identifica gli indirizzi IP pubblici del gateway NAT, se presenti.
- CollectRedshiftMetadata: recupera la configurazione completa del cluster Amazon Redshift, inclusi i dettagli di Amazon VPC, le informazioni sugli endpoint, la configurazione delle porte, le impostazioni di accessibilità pubblica, i gruppi di sicurezza e i dettagli dell'interfaccia di rete.
- CollectRedshiftSubnetInfo: recupera informazioni dettagliate sulla configurazione del gruppo di sottoreti del cluster Amazon Redshift, incluse tutte le sottoreti associate e i dettagli di Amazon VPC.
- RunReachabilityAnalysis: esegue Amazon VPC Reachability Analyzer come strumento diagnostico principale per eseguire un'analisi completa del percorso di rete tra l'istanza Amazon EC2 e il cluster Amazon Redshift. Analizza gruppi di sicurezza, ACL di rete, tabelle di routing e interfacce di rete. Se questo passaggio fallisce, il runbook torna ai controlli manuali di connettività a partire da. AnalyzeRedshiftSubnetType
- BranchOnReachabilityResults: determina il percorso di risoluzione dei problemi in base ai risultati di Reachability Analyzer. Se l'analisi ha esito positivo e trova un percorso di rete, passa direttamente alla convalida DNS. In caso contrario, continua con la risoluzione manuale della risoluzione dei problemi.
- AnalyzeRedshiftSubnetType: analizza la configurazione di routing della sottorete del cluster Amazon Redshift per determinare il tipo di sottorete e le funzionalità di connettività Internet.
- BranchOnCompareVpcIds: confronta gli ID Amazon VPC dell'istanza Amazon EC2 e del cluster Amazon Redshift. Percorre la risoluzione dei problemi relativi allo stesso Amazon VPC se entrambe le risorse condividono un Amazon VPC; in caso contrario, procede all'analisi tra Amazon VPC.
- ValidateSameVpcRequirements: (percorso Same-Amazon VPC) Convalida i requisiti di connettività controllando che sia le sottoreti Amazon EC2 che Amazon Redshift abbiano una corretta configurazione di routing locale.
- DetectCrossVpcConnectivity: (percorso Cross-Amazon VPC) Rileva e analizza i metodi di connettività tra Amazon VPC. Cerca connessioni peering Amazon VPC attive e allegati Transit AWS Gateway.
- ValidateVpcPeeringRouting: (percorso di peering VPC) Convalida il routing bidirezionale tra Amazon EC2 e Amazon Redshift VPC tramite la connessione peering.
- ValidateTransitGatewayRouting: (AWS Transit Gateway path) Convalida la configurazione del percorso Transit Gateway analizzando tabelle di routing, associazioni e propagazioni per entrambi gli allegati Amazon VPC.
- UpdateInstanceIPForPublicAccess: (Percorso di accesso pubblico) Aggiorna la variabile IP di origine con l'IP pubblico o l'IP del gateway NAT corretto per la convalida dei gruppi di sicurezza in scenari di accesso pubblico.
- CheckSecurityGroups: convalida le regole dei gruppi di sicurezza sia per l'istanza Amazon EC2 che per il cluster Amazon Redshift. Controlla le regole in entrata sui gruppi di sicurezza Amazon Redshift e le regole in uscita sui gruppi di sicurezza Amazon EC2.
- CheckNetworkACLs: convalida le regole ACL di rete per la connettività tra le sottoreti Amazon EC2 e Amazon Redshift. Analizza le regole in entrata e in uscita, inclusi gli intervalli di porte temporanei per il traffico di ritorno.
- ValidateDNSConfiguration: convalida le impostazioni di configurazione DNS per i VPC Amazon EC2 e Amazon Redshift, inclusi supporto DNS, nomi host DNS e set di opzioni DHCP.
- GenerateFinalReport: Genera un report diagnostico completo che consolida tutti i risultati, inclusi riepiloghi dei problemi suddivisi per categoria, passaggi di risoluzione prioritari, analisi della topologia di rete e consigli dettagliati.
Al termine dell'automazione, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

Output

GenerateFinalReport.DiagnosticReport- Un rapporto diagnostico completo con tutti i risultati e le raccomandazioni per la correzione.
GenerateFinalReport.OverallStatus- Il risultato complessivo dello stato di connettività.
GenerateFinalReport.IssuesSummary- Un riepilogo suddiviso per categorie di tutti i problemi identificati.
GenerateFinalReport.InstanceIPFinalValue- L'indirizzo IP di origine finale utilizzato durante l'analisi.
GenerateFinalReport.ConnectivityMethod- Il metodo di connettività rilevato tra l'istanza Amazon EC2 e il cluster Amazon Redshift.

Riferimenti

Automazione di AWS Systems Manager

Convenzioni dei documenti

Amazon Redshift

AWSConfigRemediation-DeleteRedshiftCluster