Connettersi a un file system FSX per ONTAP con un collegamento Lambda
Per eseguire operazioni avanzate di gestione ONTAP , impostare una connessione tra l'account Workload Factory e uno o più file system FSx for ONTAP . Ciò comporta l'associazione di collegamenti Lambda nuovi ed esistenti e l'autenticazione dei collegamenti. L'associazione dei link consente di monitorare e gestire direttamente dal file system FSx for ONTAP determinate funzionalità che non sono disponibili tramite l'API Amazon FSx for ONTAP .
I link sfruttano AWS Lambda per eseguire codice in risposta a eventi e gestire automaticamente le risorse di calcolo richieste da tale codice. I link creati fanno parte del tuo account NetApp e sono associati a un account AWS.
È possibile creare un collegamento nel proprio account quando si definisce un file system FSx per ONTAP . Il collegamento viene utilizzato per quel file system e può essere utilizzato per altri file system FSx per ONTAP . È anche possibile associare un collegamento a un file system in un secondo momento.
I link richiedono l'autenticazione. È possibile autenticare i collegamenti utilizzando le credenziali archiviate nel servizio Workload Factory o con le credenziali archiviate in AWS Secrets Manager. È supportato un solo metodo di autenticazione per collegamento. Ad esempio, se selezioni l'autenticazione tramite collegamento con AWS Secrets Manager, non potrai modificare il metodo di autenticazione in un secondo momento.
|
AWS Secrets Manager non è supportato quando si utilizza un connettore. |
Associare un nuovo collegamento
L'associazione di un nuovo collegamento include la creazione e l'associazione di collegamenti.
Per creare collegamenti in questo flusso di lavoro sono disponibili due opzioni: automaticamente o manualmente. Per creare il link, devi lanciare uno stack AWS CloudFormation nel tuo account AWS.
-
Automaticamente: crea un collegamento con registrazione automatica tramite Workload Factory. Ciò richiede token per l'automazione della fabbrica del carico di lavoro e il codice CloudFormation ha vita breve e può essere utilizzato fino a sei ore.
-
Manualmente: crea un collegamento con registrazione manuale utilizzando CloudFormation o Terraform da Codebox. Il codice persiste, dandoti più tempo per completare l'operazione. Questa funzionalità è utile quando si lavora con team diversi, come quelli di sicurezza e DevOps, che potrebbero dover prima concedere le autorizzazioni necessarie per completare la creazione del collegamento.
-
Si consiglia di considerare quale opzione di creazione del collegamento si utilizzerà.
-
Devi avere almeno un file system FSX per ONTAP in una workload factory. Per scoprire o creare file system FSx per ONTAP, è necessario disporre di un account AWS con autorizzazioni per le istanze FSx per ONTAP e "aggiungere le credenziali in fabbrica del carico di lavoro" con autorizzazioni di sola lettura o lettura/scrittura per la gestione dell'archiviazione.
-
Per la connettività del collegamento, le seguenti porte devono essere aperte nel gruppo di sicurezza associato al file system FSx per ONTAP.
-
Per la console della fabbrica del carico di lavoro: porta 443 (HTTPS)
-
Per CloudShell: porta 22 (SSH)
-
-
Quando si aggiunge un collegamento utilizzando uno stack CloudFormation, è necessario disporre delle seguenti autorizzazioni nell'account AWS:
Details
"cloudformation:GetTemplateSummary", "cloudformation:CreateStack", "cloudformation:DeleteStack", "cloudformation:DescribeStacks", "cloudformation:ListStacks", "cloudformation:DescribeStackEvents", "cloudformation:ListStackResources", "ec2:DescribeSubnets", "ec2:DescribeSecurityGroups", "ec2:DescribeVpcs", "iam:ListRoles", "iam:GetRolePolicy", "iam:GetRole", "iam:DeleteRolePolicy", "iam:CreateRole", "iam:DetachRolePolicy", "iam:PassRole", "iam:PutRolePolicy", "iam:DeleteRole", "iam:AttachRolePolicy", "lambda:AddPermission", "lambda:RemovePermission", "lambda:InvokeFunction", "lambda:GetFunction", "lambda:CreateFunction", "lambda:DeleteFunction", "lambda:TagResource", "codestar-connections:GetSyncConfiguration", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer"
Utilizzare CloudFormation per creare e registrare automaticamente il collegamento all'interno di workload Factory.
-
Accedere utilizzando uno dei "esperienze di console".
-
Nella memoria di archiviazione, selezionare Vai all'inventario di archiviazione.
-
Nella scheda FSX per ONTAP, selezionare il menu a tre punti del file system a cui associare un collegamento, quindi selezionare Associa collegamento.
-
Nella finestra di dialogo Associa collegamento, selezionare Crea un nuovo collegamento e selezionare continua.
-
Nella pagina Crea collegamento, fornire quanto segue:
-
Nome collegamento: Immettere il nome che si desidera utilizzare per questo collegamento. Il nome deve essere univoco all'interno dell'account.
-
AWS Secrets Manager: Facoltativo. Consente alla workload Factory di recuperare le credenziali di accesso a FSX per ONTAP da AWS Secrets Manager.
Lo stack di distribuzione dei collegamenti aggiunge automaticamente la seguente espressione regolare ARN del gestore dei segreti predefinita alla policy di autorizzazione Lambda:
arn:aws:secretsmanager:<link_deployment_region>:<link_deployment_account_id>:secret:FSxSecret*
.È possibile creare segreti in allineamento con le autorizzazioni predefinite o assegnare autorizzazioni personalizzate per il criterio di collegamento.
Configurare l'endpoint privato VPC in AWS Secrets Manager è disattivato per impostazione predefinita. Se si seleziona questa opzione, il segreto viene memorizzato utilizzando l'endpoint privato VPC anziché localmente.
-
Autorizzazioni collegamento: seleziona una delle seguenti opzioni per le autorizzazioni collegamento:
-
Automatico: seleziona questa opzione in modo che il codice AWS CloudFormation crei automaticamente la policy di autorizzazione Lambda e il ruolo di esecuzione.
-
Fornito dall'utente: selezionare questa opzione per assegnare un ruolo di esecuzione Lambda specificato e le relative policy associate al collegamento Lambda. Le seguenti autorizzazioni sono richieste per la policy di autorizzazione Lambda .
secretsmanager:GetSecretValue
l'autorizzazione è richiesta solo se hai abilitato AWS Secrets Manager."ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface", "ec2:AssignPrivateIpAddresses", "ec2:UnassignPrivateIpAddresses", "secretsmanager:GetSecretValue"
Immettere l'ARN del ruolo di esecuzione Lambda nella casella di testo.
-
-
Tag: Se lo si desidera, aggiungere qualsiasi tag che si desidera associare a questo collegamento in modo da poter categorizzare più facilmente le risorse. Ad esempio, è possibile aggiungere un tag che identifica questo collegamento come utilizzato da FSX per i file system ONTAP.
Workload Factory recupera automaticamente l'account AWS, la posizione e il gruppo di sicurezza in base al file system FSx for ONTAP .
-
-
Selezionare Crea.
Viene visualizzata la finestra di dialogo Reindirizza a CloudFormation, in cui viene spiegato come creare il collegamento dal servizio AWS CloudFormation.
-
Seleziona continua per aprire la console di gestione AWS, quindi accedi all'account AWS per questo file system FSX per ONTAP.
-
Nella pagina creazione rapida stack, in funzionalità, selezionare Acknowledge that AWS CloudFormation May create IAM resources (riconosco che AWS CloudFormation potrebbe creare risorse IAM*).
Tenere presente che vengono concesse tre autorizzazioni a Lambda quando si avvia il modello CloudFormation. Workload Factory utilizza queste autorizzazioni quando si utilizzano i collegamenti.
"lambda:InvokeFunction", "lambda:GetFunction", "lambda:UpdateFunctionCode"
-
Selezionare Crea pila, quindi selezionare continua.
Puoi monitorare lo stato di creazione del collegamento nella pagina Eventi. L'operazione non dovrebbe richiedere più di 5 minuti.
-
Tornare all'interfaccia della workload Factory e si noterà che il collegamento è associato al file system FSX per ONTAP.
È possibile creare un collegamento utilizzando due strumenti Infrastructure-as-Code (IaC) di Codebox: CloudFormation o Terraform. Con questa opzione, puoi estrarre l'ARN per il collegamento da AWS CloudFormation e segnalarlo qui. Workload Factory registra manualmente il collegamento per te.
-
Accedere utilizzando uno dei "esperienze di console".
-
Nella memoria di archiviazione, selezionare Vai all'inventario di archiviazione.
-
Nella scheda FSX per ONTAP, selezionare il menu a tre punti del file system a cui associare un collegamento, quindi selezionare Associa collegamento.
-
Nella finestra di dialogo Associa collegamento, selezionare Crea un nuovo collegamento e selezionare continua.
-
Nella pagina Crea collegamento, seleziona CloudFormation o Terraform dalla casella del codice, quindi fornisci quanto segue:
-
Nome collegamento: Immettere il nome che si desidera utilizzare per questo collegamento. Il nome deve essere univoco all'interno dell'account.
-
AWS Secrets Manager: Facoltativo. Consente alla workload Factory di recuperare le credenziali di accesso a FSX per ONTAP da AWS Secrets Manager.
Lo stack di distribuzione dei collegamenti aggiunge automaticamente la seguente espressione regolare ARN del gestore dei segreti predefinita alla policy di autorizzazione Lambda:
arn:aws:secretsmanager:<link_deployment_region>:<link_deployment_account_id>:secret:FSxSecret*
.È possibile creare segreti in allineamento con le autorizzazioni predefinite o assegnare autorizzazioni personalizzate per il criterio di collegamento.
Configurare l'endpoint privato VPC in AWS Secrets Manager è disattivato per impostazione predefinita. Se si seleziona questa opzione, il segreto viene memorizzato utilizzando l'endpoint privato VPC anziché localmente.
-
Autorizzazioni collegamento: seleziona una delle seguenti opzioni per le autorizzazioni collegamento:
-
Automatico: seleziona questa opzione in modo che il codice AWS CloudFormation crei automaticamente la policy di autorizzazione Lambda e il ruolo di esecuzione.
-
Fornito dall'utente: selezionare questa opzione per assegnare un ruolo di esecuzione Lambda specificato e le relative policy associate al collegamento Lambda. Le seguenti autorizzazioni sono richieste per la policy di autorizzazione Lambda .
secretsmanager:GetSecretValue
l'autorizzazione è richiesta solo se hai abilitato AWS Secrets Manager."ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface", "ec2:AssignPrivateIpAddresses", "ec2:UnassignPrivateIpAddresses" "secretsmanager:GetSecretValue"
Immettere l'ARN del ruolo di esecuzione Lambda nella casella di testo.
-
-
Tag: Se lo si desidera, aggiungere qualsiasi tag che si desidera associare a questo collegamento in modo da poter categorizzare più facilmente le risorse. Ad esempio, è possibile aggiungere un tag che identifica questo collegamento come utilizzato da FSX per i file system ONTAP.
-
Registrazione del collegamento: seleziona CloudFormation o Terraform per le istruzioni su come registrare il collegamento e segui le istruzioni.
Tenere presente che vengono concesse tre autorizzazioni a Lambda quando si avvia il modello CloudFormation. Workload Factory utilizza queste autorizzazioni quando si utilizzano i collegamenti.
"lambda:InvokeFunction", "lambda:GetFunction", "lambda:UpdateFunctionCode"
+ Dopo aver creato correttamente lo stack, incollare l'ARN lambda nella casella di testo.
-
Workload Factory recupera automaticamente l'account AWS, la posizione e il gruppo di sicurezza in base al file system FSx for ONTAP .
-
-
Selezionare Crea.
Puoi monitorare lo stato di creazione del collegamento nella pagina Eventi. L'operazione non dovrebbe richiedere più di 5 minuti.
-
Tornare all'interfaccia della workload Factory e si noterà che il collegamento è associato al file system FSX per ONTAP.
La fabbrica del carico di lavoro associa il collegamento al file system FSx per ONTAP . È possibile eseguire operazioni ONTAP avanzate.
Associare un collegamento esistente a un file system FSX per ONTAP
Dopo aver creato un collegamento, associarlo a uno o più file system FSX per ONTAP.
-
Accedere utilizzando uno dei "esperienze di console".
-
Nella memoria di archiviazione, selezionare Vai all'inventario di archiviazione.
-
Nella scheda FSX per ONTAP, selezionare il menu a tre punti del file system a cui associare un collegamento, quindi selezionare Associa collegamento.
-
Nella pagina di collegamento Associa, selezionare Associa un collegamento esistente, selezionare il collegamento e selezionare continua.
-
Selezionare la modalità di autenticazione.
-
Workload Factory: Immettere la password due volte.
-
AWS Secrets Manager: Inserisci il segreto ARN.
Assicurarsi che l'ARN segreto contenga le seguenti coppie di chiavi valide, sebbene filesystemID sia facoltativo.
-
filesystemID = FSx_filesystem_id (facoltativo)
-
utente = FSx_user
-
password = password_utente
L'autenticazione con AWS Secrets Manager richiede un utente, ovvero l'FSx_user fornito oppure un altro utente creato sul file system FSx for ONTAP . L'utente predefinito è fsxadmin
se non fornisci un utente.
-
-
-
Selezionare Applica.
Il collegamento è associato al file system FSX per ONTAP. È possibile eseguire operazioni ONTAP avanzate.
Risolvere i problemi relativi all'autenticazione del collegamento di AWS Secrets Manager
- Problema
-
Il collegamento non dispone delle autorizzazioni necessarie per recuperare il segreto.
Risoluzione: Aggiungere le autorizzazioni dopo che il collegamento è attivo. Effettua l'accesso alla console AWS, individua il collegamento Lambda e modifica la policy di autorizzazione allegata.
- Problema
-
Il segreto non è stato trovato.
Risoluzione: Fornire l'ARN segreto corretto.
- Problema
-
Il segreto non è nel formato giusto.
Risoluzione: Vai su AWS Secrets Manager e modifica il formato.
Il segreto deve contenere le seguenti coppie di chiavi valide:
-
FilesystemID = FSX_filesystem_id
-
nome utente = FSx_user
-
password = password_utente
-
- Problema
-
Il segreto non contiene credenziali ONTAP valide per l'autenticazione del file system.
Risoluzione: Fornire credenziali in grado di autenticare i file system FSX per ONTAP in Gestione segreti AWS.