Tutorial: distribuzione su Amazon EKS con CodePipeline

Crea un cluster pubblico

1. Apri la console EKS, quindi scegli Crea cluster.

2. In Nome, assegna un nome al cluster. Scegli Avanti.

3. Scegli Crea.

Crea un VPC nella console

1. Apri la console VPC, quindi scegli Crea VPC.

2. In Impostazioni VPC, scegli VPC e altro.

3. Scegli di creare una sottorete pubblica e 4 sottoreti private. Seleziona Crea VPC.

4. Nella pagina delle sottoreti, scegli Privato.

Determina le sottoreti private nel tuo VPC

1. Accedi al tuo VPC e scegli l'ID VPC per aprire la pagina dei dettagli del VPC.

2. Nella pagina dei dettagli del VPC, scegli la scheda Mappa delle risorse.

3. Visualizza il diagramma e annota le tue sottoreti private. Le sottoreti vengono visualizzate con etichette che indicano lo stato pubblico o privato e ogni sottorete è mappata su una tabella di routing.

   

   Nota che un cluster privato avrà tutte le sottoreti private.

4. Crea una sottorete pubblica per ospitare il gateway NAT. È possibile allegare un solo gateway Internet a un VPC alla volta.

Crea un gateway NAT nella sottorete pubblica

1. Nella sottorete pubblica, create un gateway NAT. Accedi alla console VPC, quindi scegli i gateway Internet. Scegliere Crea gateway Internet.

2. In Nome, inserisci un nome per il tuo gateway Internet. Scegliere Crea gateway Internet.

Aggiungi il gateway NAT alle tabelle di routing per le tue sottoreti private

1. Accedi alla console VPC, quindi scegli Subnet.

2. Per ogni sottorete privata, sceglila e quindi scegli la tabella di routing per quella sottorete nella pagina dei dettagli. Scegli Modifica tabella di percorso.

3. Aggiorna la tabella di routing per la sottorete privata per indirizzare il traffico Internet verso il gateway NAT. Seleziona Aggiungi route. Scegli il gateway NAT tra le opzioni da aggiungere. Scegli il gateway Internet che hai creato.

4. Per la sottorete pubblica, crea una tabella di routing personalizzata. Verifica che l'elenco di controllo dell'accesso alla rete (ACL) per la tua sottorete pubblica consenta il traffico in entrata dalla sottorete privata.

5. Scegli Save changes (Salva modifiche).

Crea un cluster privato

1. Apri la console EKS, quindi scegli Crea cluster.

2. In Nome, assegna un nome al cluster. Scegli Avanti.

3. Specifica il tuo VPC e altre informazioni di configurazione. Scegli Crea.

Configura il tuo cluster

1. Collega sottoreti private solo nel cluster EKS nella scheda Rete. Collega le sottoreti private acquisite nella sezione Determina le sottoreti private nel tuo VPC in basso. Fase 1: (Facoltativo) Creare un cluster in Amazon EKS

2. Assicurati che le sottoreti private abbiano accesso a Internet poiché CodePipeline archivia e recupera gli artefatti dal bucket di artefatti S3 per la tua pipeline.

Per aggiornare la politica relativa CodePipeline al ruolo di servizio

1. Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

2. Dal pannello di controllo della console, scegli Roles (Ruoli).

3. Cerca il tuo ruolo CodePipeline di servizio, ad esempiocp-service-role.

4. Aggiungi una nuova politica in linea.

5. Nell'editor delle politiche, inserisci quanto segue.

   • Per un cluster pubblico, aggiungi le seguenti autorizzazioni.

     JSON

     {
         "Version":"2012-10-17",
     
         "Statement": [
             {
                 "Sid": "EksClusterPolicy",
                 "Effect": "Allow",
                 "Action": "eks:DescribeCluster",
                 "Resource": "arn:aws:eks:us-east-1:111122223333:cluster/my-cluster"
             },
             {
                 "Sid": "EksVpcClusterPolicy",
                 "Effect": "Allow",
                 "Action": [
                     "ec2:DescribeDhcpOptions",
                     "ec2:DescribeNetworkInterfaces",
                     "ec2:DescribeRouteTables",
                     "ec2:DescribeSubnets",
                     "ec2:DescribeSecurityGroups",
                     "ec2:DescribeVpcs"
                 ],
                 "Resource": [
                     "*"
                 ]
             }
         ]
     }
     

   • Per un cluster privato, aggiungi le seguenti autorizzazioni. I cluster privati richiederanno autorizzazioni aggiuntive per il tuo VPC, se applicabili.

     JSON

     {
         "Version":"2012-10-17",
     
         "Statement": [
             {
                 "Sid": "EksClusterPolicy",
                 "Effect": "Allow",
                 "Action": "eks:DescribeCluster",
                 "Resource": "arn:aws:eks:us-east-1:111122223333:cluster/my-cluster"
             },
             {
                 "Sid": "EksVpcClusterPolicy",
                 "Effect": "Allow",
                 "Action": [
                     "ec2:DescribeDhcpOptions",
                     "ec2:DescribeNetworkInterfaces",
                     "ec2:DescribeRouteTables",
                     "ec2:DescribeSubnets",
                     "ec2:DescribeSecurityGroups",
                     "ec2:DescribeVpcs"
                 ],
                 "Resource": [
                     "*"
                 ]
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:CreateNetworkInterface",
                 "Resource": "*",
                 "Condition": {
                     "StringEqualsIfExists": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:CreateNetworkInterfacePermission",
                 "Resource": "*",
                 "Condition": {
                     "ArnEquals": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             },
             {
                 "Effect": "Allow",
                 "Action": "ec2:DeleteNetworkInterface",
                 "Resource": "*",
                 "Condition": {
                     "StringEqualsIfExists": {
                         "ec2:Subnet": [
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-03ebd65daeEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0e377f6036EXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE",
                             "arn:aws:ec2:us-east-1:ACCOUNT-ID:subnet/subnet-0db658ba1cEXAMPLE"
                         ]
                     }
                 }
             }
         ]
     }
     

6. Scegli Aggiorna policy.

1. Apri la console EKS e accedi al tuo cluster.

2. Scegliere la scheda Accesso.

3. Sotto le voci di accesso IAM, scegli Crea voce di accesso.

4. Nell'ARN principale di IAM, inserisci il ruolo che hai appena aggiornato per l'azione, ad esempiocp-service-role. Scegli Avanti.

5. Nella pagina Step 2: Aggiungi policy di accesso, in Nome policy, scegli la policy gestita per l'accesso, ad esempioAmazonEKSClusterAdminPolicy. Scegli Aggiungi policy. Scegli Avanti.

   Nota

   Questa è la politica utilizzata dall' CodePipeline azione per parlare con Kubernetes. Come best practice, per limitare le autorizzazioni nella tua policy con privilegi minimi anziché in quella amministrativa, allega invece una policy personalizzata.

6. Nella pagina di revisione, scegli Crea.

1. Crea o usa un repository esistente GitHub .

2. Crea una nuova struttura nel tuo repository per i tuoi file grafici Helm, come mostrato nell'esempio seguente.

   mychart
   |-- Chart.yaml
   |-- charts
   |-- templates
   |   |-- NOTES.txt
   |   |-- _helpers.tpl
   |   |-- deployment.yaml
   |   |-- ingress.yaml
   |   `-- service.yaml
   `-- values.yaml
   

3. Aggiungete il file al livello principale del vostro repository.

Creazione della pipeline

1. Apri la console all' CodePipeline indirizzo. https://console.aws.amazon.com/codepipeline/

2. Nella pagina Welcome (Benvenuto), pagina Getting started (Nozioni di base) o pagina Pipelines (Pipeline), scegliere Create pipeline (Crea pipeline).

3. Nella pagina Passaggio 1: scegli l'opzione di creazione, in Opzioni di creazione, scegli l'opzione Crea pipeline personalizzata. Scegli Avanti.

4. Nel passaggio 2: scegli le impostazioni della pipeline, in Nome della pipeline, inserisci. MyEKSPipeline

5. CodePipeline fornisce pipeline di tipo V1 e V2, che si differenziano per caratteristiche e prezzo. Il tipo V2 è l’unico tipo che puoi scegliere nella console. Per ulteriori informazioni, consulta tipi di pipeline. Per informazioni sui prezzi di CodePipeline, vedi Prezzi. https://aws.amazon.com/codepipeline/pricing/

6. In Ruolo di servizio, scegli il ruolo del servizio che hai aggiornato nel passaggio 3.

7. Lasciare i valori predefiniti delle impostazioni in Advanced settings (Impostazioni avanzate), quindi scegliere Next (Successivo).

8. Nella pagina Step 3: Add source stage, in Source provider, scegli di creare una connessione al tuo GitHub repository.

9. Nella pagina Passaggio 4: Aggiungi fase di compilazione, scegli Ignora.

10. Nella pagina Passaggio 5: Aggiungi fase di distribuzione, scegli Amazon EKS.

    

    1. In Tipo di configurazione Deploy, scegli Helm.

    2. Nella posizione del grafico di Helm, inserisci il nome della release, ad esempio. my-release Per la posizione del grafico di Helm, inserisci il percorso dei file del grafico di Helm, ad esempio. mychart

    3. Scegli Avanti.

11. Nella pagina Step 6: Review (Fase 6: esamina), esamina la configurazione della pipeline, quindi seleziona Create pipeline (Crea pipeline) per creare la pipeline.

    

12. Una volta eseguita correttamente la pipeline, scegli Visualizza dettagli per visualizzare i log dell'azione e visualizzare l'output dell'azione.