Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AWSSupport-TroubleshootGlueConnection
Descrizione
Il AWSSupport-TroubleshootGlueConnections runbook aiuta a risolvere i problemi di connessione. AWS Glue L'obiettivo della connessione testata deve essere raggiunto tramite una connessione JDBC e può essere un Amazon Relational Database Service (Amazon RDS) cluster/instance, un cluster Amazon Redshift o qualsiasi altra destinazione accessibile tramite JDBC. Nei primi due casi, lo strumento Reachability Analyzer viene utilizzato per determinare se la connettività tra source (AWS Glue) e target (Amazon RDS o Amazon Redshift) è concessa.
Se la destinazione della connessione non è Amazon RDS né Amazon Redshift, la connettività viene comunque testata creando una AWS Lambda funzione nella stessa sottorete della AWS Glue connessione (un punto di presenza della rete) e controllando se il nome della destinazione è risolvibile e se è raggiungibile nella porta di destinazione.
Importante
Per eseguire i controlli di Reachability Analyzer, verranno create delle interfacce di rete elastiche in ciascuna delle sottoreti di origine dati della connessione. Assicurati di avere un numero sufficiente di IP gratuiti su tali sottoreti e che il consumo di un IP non influisca sul carico di lavoro prima di eseguire questa automazione.
Importante
Tutte le risorse create da questa automazione sono etichettate in modo da poter essere trovate facilmente. I tag utilizzati sono:
-
AWSSupport-TroubleshootGlueConnection: true -
AutomationExecutionId:Amazon EC2 Systems Manager Execution Id
Come funziona?
Il runbook esegue i seguenti passaggi:
-
Descrive la AWS Glue connessione per ottenere le informazioni di origine (sottorete e gruppi di sicurezza) per i controlli di connettività.
-
Recupera le informazioni di destinazione (sottorete e gruppi di sicurezza) dall'origine dati a cui si fa riferimento nell'URL JDBC o dai parametri e, se presenti.
DatasourceSecurityGroupsDatasourceSubnets -
Se l'origine dati presente nell'URL JDBC è un'istanza o un cluster Amazon RDS o un cluster Amazon Redshift, questa automazione crea ENI utilizzando le informazioni di origine e di destinazione raccolte nei passaggi precedenti e utilizza Reachability Analyzer per eseguire un controllo di connettività tra di esse.
-
Una funzione Lambda (punto di presenza di rete, nel contesto di questa automazione) viene utilizzata per eseguire i controlli di connettività L4 e risoluzione dei nomi.
-
La stessa funzione Lambda viene utilizzata per eseguire i controlli sull'endpoint Amazon S3.
-
Policy Simulator viene utilizzato per determinare se il ruolo IAM utilizzato nella connessione dispone delle autorizzazioni necessarie.
-
L'automazione verifica se il gruppo di sicurezza utilizzato dalla connessione ha la configurazione prevista.
-
Viene generato un report contenente le possibili cause dell'errore nell'operazione and/or di connessione di test e i test eseguiti con successo.
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.
-
cloudformation:CreateStack -
cloudformation:DeleteStack -
ec2:CreateNetworkInsightsPath -
ec2:CreateNetworkInterface -
ec2:CreateTags -
ec2:DeleteNetworkInsightsAnalysis -
ec2:DeleteNetworkInsightsPath -
ec2:DeleteNetworkInterface -
ec2:StartNetworkInsightsAnalysis -
iam:AttachRolePolicy -
iam:CreateRole -
iam:DeleteRole -
iam:DeleteRolePolicy -
iam:DetachRolePolicy -
iam:PutRolePolicy -
iam:TagRole -
lambda:CreateFunction -
lambda:DeleteFunction -
lambda:TagResource -
logs:CreateLogGroup -
logs:DeleteLogGroup -
logs:PutRetentionPolicy -
logs:TagResource -
glue:GetConnection -
glue:GetDataCatalogEncryptionSettings -
cloudformation:DescribeStacks -
cloudformation:DescribeStackEvents -
ec2:DescribeDhcpOptions -
ec2:DescribeNetworkInsightsPaths -
ec2:DescribeNetworkInsightsAnalyses -
ec2:DescribeSecurityGroupRules -
ec2:DescribeSecurityGroups -
ec2:DescribeSubnets -
ec2:DescribeVpcs -
ec2:DescribeVpcAttribute -
iam:GetRole -
iam:ListAttachedRolePolicies -
iam:SimulatePrincipalPolicy -
kms:DescribeKey -
lambda:InvokeFunction -
lambda:GetFunction -
s3:GetEncryptionConfiguration -
iam:PassRole
Importante
Oltre alle azioni sopra menzionate, AutomationAssumeRole dovrebbe essere allegata una policy gestita in modo che i test di Reachability Analyzer vengano eseguiti correttamente. AmazonVPCReachabilityAnalyzerFullAccessPolicy
Ecco un esempio di politica che potrebbe essere concessa per: AutomationAssumeRole
Istruzioni
Segui questi passaggi per configurare l'automazione:
-
Accedi
AWSSupport-TroubleshootGlueConnectiona Systems Manager in Documenti. -
Seleziona Execute automation (Esegui automazione).
-
Per i parametri di input, inserisci quanto segue:
-
AutomationAssumeRole (Facoltativo):
L'Amazon Resource Name (ARN) del ruolo AWS AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
-
TestConnectionRole (Obbligatorio)
L'Amazon Resource Name (ARN) del ruolo IAM utilizzato durante il test di connessione.
-
ConnectionName (Obbligatorio)
AWS Glue nome della connessione di test non riuscita che si desidera risolvere.
-
PersistReachabilityAnalyzerResults(Facoltativo)
Il flag che indica se i risultati dell'esecuzione di Reachability Analyzer devono essere conservati o meno. Impostazione predefinita:
false. -
PointOfPresenceLogRetentionPeriod(Facoltativo)
Il numero di giorni per cui verranno archiviati i log per il punto di presenza Lambda. Default:
7. -
DatasourceSubnets (Facoltativo)
Se l'origine dati originale non è disponibile, utilizzate questo parametro per fornire le sottoreti utilizzate in modo che i test di connettività vengano comunque eseguiti. Deve essere utilizzato con.
DatasourceSecurityGroupsEsempio:subnet-1,subnet-2. -
DatasourceSecurityGroups (Opzionale)
Se l'origine dati originale non è disponibile, utilizzate questo parametro per fornire i gruppi di sicurezza utilizzati in modo che i test di connettività vengano comunque eseguiti. Deve essere utilizzato con.
DatasourceSubnetsEsempio:sg-1,sg-2.
-
-
Seleziona Esegui.
-
L'automazione viene avviata.
-
Il runbook di automazione esegue i seguenti passaggi:
-
ParseInputs:
Questo passaggio convalida la combinazione di input. Se
DatasourceSubnetsvengono forniti entrambiDatasourceSecurityGroups, sono validi e vengono restituiti così come sono. Se non ne viene fornito nessuno, vengono restituiti due elenchi vuoti. Se ne viene fornito solo uno, il passaggio genera unValueException. -
GetConnectionDetails:
Questo passaggio restituisce i dettagli della AWS Glue connessione fornita.
-
ParseSecurityGroupList:
Questo passaggio viene utilizzato per concatenare l'
SecurityGroupIdListin aStringper un utilizzo futuro in questa automazione. -
GetConnectionData:
Determina, in base all'URL JDBC, il tipo di connessione tra:, e.
RedShiftRdsInstanceRdsClusterOtherInoltre, restituisce il dominio e la porta utilizzati nella connessione JDBC, Amazon VPC della connessione e i relativi server di nomi di dominio. -
GetNetworkDetails:
Ottiene le informazioni sulla sottorete e sul gruppo di sicurezza dal target Amazon RDS o Amazon Redshift.
-
Crea un modello EN:
Genera il AWS CloudFormation modello utilizzato per creare le interfacce di rete utilizzate per testare la connettività. Questo è necessario per eseguire lo strumento Reachability Analyzer.
-
Crea EniStack:
Crea lo CloudFormation stack dal modello creato nel passaggio precedente.
-
GetStackDetails:
Descrive lo CloudFormation stack creato nello stack precedente e recupera le
SourceNetworkInterfaceTargetNetworkInterfacesinformazioni. -
RunSourceToTargetCheck:
Esegue i controlli tra gli ENI di origine e di destinazione creati nel passaggio precedente utilizzando lo strumento Reachability Analyzer.
-
Elimina ENiStack:
Elimina lo stack che crea le interfacce di rete CloudFormation
-
CreateNetworkPointOfPresence:
CloudFormation crea la funzione Lambda utilizzata come punto di presenza di rete.
-
GetFunctionName:
Esegue una chiamata all'API di CloudFormation descrizione dello stack per recuperare il nome della funzione Lambda creata nel passaggio precedente.
-
RunEndpointChecks:
Utilizza il punto di presenza della rete per determinare se l'endpoint presente nella connessione JDBC è risolvibile e raggiungibile nella porta dichiarata.
-
Verifica la connettività S3:
Verifica la connettività di rete dalla AWS Glue connessione al servizio Amazon S3.
-
DeletePointOfPresence:
Elimina CloudFormation lo stack che crea il punto di presenza della rete Lambda.
-
TestIAMRolePermissions:
Verifica se il ruolo IAM utilizzato per il test dispone delle autorizzazioni necessarie per eseguirlo.
-
CheckConnectionSecurityGroupReferencingRule:
Verifica se il gruppo di sicurezza utilizzato nella AWS Glue connessione consente l'ingresso di tutto il traffico proveniente da se stesso. Restituirà un elenco dei gruppi di sicurezza senza questa regola, se presente.
-
GenerateReport:
Genera un rapporto contenente un elenco dei risultati (possibili ragioni dell'errore nel test di connessione) e dei passaggi successivi (tentativi di risolvere l'errore del test di connessione).
-
-
Al termine, consulta la sezione Output per i risultati dettagliati dell'esecuzione:
-
Risultati dell'automazione
In questa sezione, troverai scenari che descrivono le possibili cause del fallimento dell'operazione di connessione di test (risultati) e come possono essere corrette (passaggi successivi). Se l'automazione non riesce a trovare la causa del fallimento del test, anche questa verrà informata in questa sezione.
-
Test riusciti
In questa sezione, troverai gli scenari che informano su ciò che è stato testato con successo da questa automazione. I test superati sono utili nel caso in cui l'automazione non sia in grado di identificare la causa dell'errore della connessione di test, poiché riducono l'ambito dell'indagine indicando ciò che non contribuisce al problema.
-
Errori di automazione
In questa sezione, troverai scenari che descrivono i problemi che si sono verificati durante l'automazione, che potrebbero aver limitato il numero di test che l'automazione poteva eseguire. La descrizione dello scenario indicherà quale passaggio non è riuscito.
-
Riferimenti
Systems Manager Automation