Tutorial: distribuisci un'applicazione su Amazon EKS

Per avviare un ambiente di sviluppo

1. Apri la CodeCatalyst console all'indirizzo https://codecatalyst.aws/.

2. Vai al tuo progetto,codecatalyst-eks-project.

3. Nel riquadro di navigazione, scegli Codice, quindi scegli Archivi di origine.

4. Scegli il nome del tuo repository di origine,. codecatalyst-eks-source-repository

5. In alto scegli Create Dev Environment, quindi scegli AWS Cloud9 (nel browser).

6. Assicurati che le opzioni Work in existing branch e main siano selezionate, quindi scegli Crea.

   Il tuo ambiente di sviluppo viene avviato in una nuova scheda del browser e il tuo repository (codecatalyst-eks-source-repository) viene clonato al suo interno.

Per installare e configurare kubectl

1. Nel terminale Dev Environment, inserisci:

   curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl

2. Inserisci:

   chmod +x ./kubectl

3. Inserisci:

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin

4. Inserisci:

   echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

5. Inserisci:

   kubectl version --short --client

6. Verifica che venga visualizzata una versione.

   Ora hai installatokubectl.

Per installare e configurare eksctl

1. Nel terminale Dev Environment, inserisci:

   curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp

2. Inserisci:

   sudo cp /tmp/eksctl /usr/bin

3. Inserisci:

   eksctl version

4. Verifica che venga visualizzata una versione.

   Ora hai installatoeksctl.

Per verificare che AWS CLI sia installato

1. Nel terminale Dev Environment, inserisci:

   aws --version

2. Verificate che appaia una versione per verificare che AWS CLI sia installata.

   Completa le procedure rimanenti per configurarlo AWS CLI con le autorizzazioni necessarie per l'accesso AWS.

1. Crea un utente IAM dell'Identity Center, come segue:

   1. Accedi a AWS Management Console e apri la AWS IAM Identity Center console all'indirizzo https://console.aws.amazon.com/singlesignon/.

      (Potresti dover scegliere Abilita se non hai mai effettuato l'accesso a IAM Identity Center prima.)

      Nota

      Assicurati di accedere utilizzando Account AWS il dispositivo connesso al tuo CodeCatalyst spazio. Puoi verificare quale account è connesso accedendo al tuo spazio e scegliendo la scheda AWSAccount. Per ulteriori informazioni, consulta Creare uno spazio.

   2. Nel riquadro di navigazione, scegli Users (Utenti), quindi scegli Add user (Aggiungi utente).

   3. In Nome utente, inserisci:

      codecatalyst-eks-user

   4. In Password, scegli Genera una password monouso da condividere con questo utente.

   5. In Indirizzo e-mail e Conferma indirizzo e-mail, inserisci un indirizzo e-mail che non sia già presente in IAM Identity Center.

   6. In Nome, inserisci:

      codecatalyst-eks-user

   7. In Cognome, inserisci:

      codecatalyst-eks-user

   8. In Nome visualizzato, mantieni:

      codecatalyst-eks-user codecatalyst-eks-user

   9. Scegli Next (Successivo).

   10. Nella pagina Aggiungi utente ai gruppi, scegli Avanti.

   11. Nella pagina Rivedi e aggiungi utente, esamina le informazioni e scegli Aggiungi utente.

       Viene visualizzata una finestra di dialogo con password monouso.

   12. Scegli Copia, quindi incolla le informazioni di accesso in un file di testo. Le informazioni di accesso sono costituite dal portale di AWS accessoURL, un nome utente e una password monouso.

   13. Scegli Chiudi.

2. Crea un set di autorizzazioni, come segue:

   1. Nel riquadro di navigazione, scegli Set di autorizzazioni, quindi scegli Crea set di autorizzazioni.

   2. Scegli Set di autorizzazioni predefinito, quindi seleziona AdministratorAccess. Questa politica fornisce autorizzazioni complete a tutti. Servizi AWS

   3. Scegli Next (Successivo).

   4. In Nome del set di autorizzazioni, rimuovi AdministratorAccess e inserisci:

      codecatalyst-eks-permission-set

   5. Scegli Next (Successivo).

   6. Nella pagina Rivedi e crea, esamina le informazioni e scegli Crea.

3. Assegna il set di autorizzazioni acodecatalyst-eks-user, come segue:

   1. Nel riquadro di navigazione, scegli Account AWS, quindi seleziona la casella di controllo accanto a Account AWS quella a cui hai attualmente effettuato l'accesso.

   2. Scegli Assegna utenti o gruppi.

   3. Scegli la scheda Users (Utenti);

   4. Seleziona la casella di controllo accanto a. codecatalyst-eks-user

   5. Scegli Next (Successivo).

   6. Seleziona la casella di controllo accanto acodecatalyst-eks-permission-set.

   7. Scegli Next (Successivo).

   8. Controlla le informazioni e scegli Invia.

      Ora le hai assegnate codecatalyst-eks-user e codecatalyst-eks-permission-set Account AWS le hai assegnate insieme.

4. Le chiavi codecatalyst-eks-user di accesso e il token di sessione di Ottain, come segue:

   1. Assicurati di avere il portale di AWS accesso URL e il nome utente e la password monouso percodecatalyst-eks-user. Prima avresti dovuto copiare queste informazioni in un editor di testo.

      Nota

      Se non disponi di queste informazioni, vai alla pagina dei codecatalyst-eks-user dettagli in IAM Identity Center, scegli Reimposta password, Genera una password monouso [...] e Reimposta nuovamente la password per visualizzare le informazioni sullo schermo.

   2. Esci da AWS.

   3. Incolla il portale di AWS accesso URL nella barra degli indirizzi del browser.

   4. Accedi con:

      • Nome utente:

        codecatalyst-eks-user

      • Password:

        one-time-password

   5. In Imposta nuova password, inserisci una nuova password e scegli Imposta nuova password.

      Sullo schermo viene visualizzata una Account AWScasella.

   6. Scegli Account AWS, quindi scegli il nome Account AWS a cui hai assegnato l'codecatalyst-eks-userutente e il set di autorizzazioni.

   7. Accantocodecatalyst-eks-permission-set, scegli Riga di comando o Accesso programmatico.

   8. Copia i comandi al centro della pagina. Sono simili ai seguenti:

      export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
      export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
      export AWS_SESSION_TOKEN="session-token"

      ... dove session-token è una stringa casuale lunga.

5. Aggiungere le chiavi di accesso e il token di sessione a AWS CLI, come segue:

   1. Tornate al vostro ambiente di CodeCatalyst sviluppo.

   2. Al prompt del terminale, incolla i comandi che hai copiato. Premere Invio.

      Ora lo hai configurato AWS CLI con chiavi di accesso e un token di sessione. Ora puoi AWS CLI utilizzarlo per completare le attività richieste da questo tutorial.

      Importante

      Se in qualsiasi momento durante questo tutorial visualizzi messaggi simili a:

      Unable to locate credentials. You can configure credentials by running "aws configure".

      O:

      ExpiredToken: The security token included in the request is expired

      ... è perché la tua AWS CLI sessione è scaduta. In questo caso, non eseguire il aws configure comando. Utilizzate invece le istruzioni riportate nel passaggio 4 di questa procedura, che inizia con, Obtain codecatalyst-eks-user's access key and session token per aggiornare la sessione.

Come creare un cluster

1. Vai al tuo ambiente di sviluppo.

2. Crea un cluster e dei nodi:

   eksctl create cluster --name codecatalyst-eks-cluster --region us-west-2

   Dove:

   • codecatalyst-eks-cluster viene sostituito con il nome che vuoi assegnare al cluster.

   • us-west-2 viene sostituito dalla tua regione.

   Dopo 10-20 minuti, viene visualizzato un messaggio simile al seguente:

   EKS cluster "codecatalyst-eks-cluster" in "us-west-2" region is ready

   Nota

   Vedrai più waiting for CloudFormation stack messaggi durante la AWS creazione del cluster. Si tratta di un comportamento normale.

3. Verifica che il cluster sia stato creato correttamente:

   kubectl cluster-info

   Verrà visualizzato un messaggio simile al seguente, che indica l'avvenuta creazione del cluster:

   Kubernetes master is running at https://long-string.gr7.us-west-2.eks.amazonaws.com
   CoreDNS is running at https://long-string.gr7.us-west-2.eks.amazonaws.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Per creare un archivio di immagini in Amazon ECR

1. Vai al tuo ambiente di sviluppo.

2. Crea un repository vuoto in AmazonECR:

   aws ecr create-repository --repository-name codecatalyst-eks-image-repo

   Replace (Sostituisci) codecatalyst-eks-image-repo con il nome che vuoi assegnare al ECR repository Amazon.

   Questo tutorial presuppone che tu abbia dato un nome al tuo repository. codecatalyst-eks-image-repo

3. Visualizza i dettagli del ECR repository Amazon:

   aws ecr describe-repositories \
         --repository-names codecatalyst-eks-image-repo
   

4. Nota il “repositoryUri”: valore, ad esempio,111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo.

   Ne avrai bisogno in seguito quando aggiungerai il repository al tuo flusso di lavoro.

Per aggiungere il file index.html

1. Vai al tuo ambiente di sviluppo.

2. Incodecatalyst-eks-source-repository, crea una cartella chiamatapublic-html.

3. In/public-html, crea un file chiamato index.html con il seguente contenuto:

   <html>
     <head>
       <title>Hello World</title>
       <style>
         body {
         background-color: black;
         text-align: center;
         color: white;
         font-family: Arial, Helvetica, sans-serif;
         }  
       </style>
     </head>
     <body>
       <h1>Hello, World!</h1>
     </body>
   </html>

4. Alla riga di comando del terminale, digitate:

   cd /projects/codecatalyst-eks-source-repository

5. Aggiungi, esegui il commit e invia:

   git add .
   git commit -m "add public-html/index.html"
   git push

   index.htmlViene aggiunto al tuo repository in una public-html cartella.

Per aggiungere il Dockerfile

1. Incodecatalyst-eks-source-repository, crea un file chiamato Dockerfile con il seguente contenuto:

   FROM httpd:2.4
   COPY ./public-html/index.html /usr/local/apache2/htdocs/index.html
   EXPOSE 80

   Non includere un'estensione di file.

   Importante

   Il Dockerfile deve risiedere nella cartella principale del repository. Il Docker build comando del flusso di lavoro si aspetta che sia presente.

2. Aggiungi, esegui il commit e invia:

   git add .
   git commit -m "add Dockerfile"
   git push

   Il Dockerfile viene aggiunto al tuo repository.

Per aggiungere un file deployment.yaml

1. Incodecatalyst-eks-source-repository, crea una cartella chiamata. Kubernetes

2. In/Kubernetes, crea un file chiamato deployment.yaml con il seguente contenuto:

   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
     labels:
       app: my-app
   spec:
     type: LoadBalancer
     selector:
       app: my-app
     ports:
       - protocol: TCP
         port: 80
         targetPort: 80
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: codecatalyst-eks-container
           # The $REPOSITORY_URI and $IMAGE_TAG placeholders will be replaced by actual values supplied by the build action in your workflow
           image: $REPOSITORY_URI:$IMAGE_TAG
           ports:
           - containerPort: 80

3. Aggiungi, esegui il commit e invia:

   git add .
   git commit -m "add Kubernetes/deployment.yaml"
   git push

   Il deployment.yaml file viene aggiunto al tuo repository in una cartella chiamataKubernetes.

1. Per creare una politica di fiducia per entrambi i ruoli

1. Vai al tuo ambiente di sviluppo.

2. Nella Cloud9-long-string directory, crea un file chiamato codecatalyst-eks-trust-policy.json con il seguente contenuto:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service":  [
                      "codecatalyst-runner.amazonaws.com",
                      "codecatalyst.amazonaws.com"
                    ]
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }

2. Per creare la politica di compilazione per il ruolo di compilazione

• Nella Cloud9-long-string directory, create un file chiamato codecatalyst-eks-build-policy.json con il seguente contenuto:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ecr:*",
                  "ec2:*"
              ],
              "Resource": "*"
          }
      ]
  }

  Nota

  La prima volta che il ruolo viene utilizzato per eseguire azioni del flusso di lavoro, utilizzate il carattere jolly nell'informativa sulla politica delle risorse, quindi definite la politica inserendo il nome della risorsa dopo che è disponibile.

  "Resource": "*"

3. Per creare la politica di distribuzione per il ruolo di distribuzione

• Nella Cloud9-long-string directory, create un file chiamato codecatalyst-eks-deploy-policy.json con il seguente contenuto:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "eks:DescribeCluster",
                  "eks:ListClusters"
              ],
              "Resource": "*"
          }
      ]
  }

  Nota

  La prima volta che il ruolo viene utilizzato per eseguire azioni del flusso di lavoro, utilizzate il carattere jolly nell'informativa sulla politica delle risorse, quindi definite la politica inserendo il nome della risorsa dopo che è disponibile.

  "Resource": "*"

4. Per aggiungere la politica di compilazione a AWS

1. Nel terminale Dev Environment, inserisci:

   cd /projects

2. Inserisci:

   aws iam create-policy \
       --policy-name codecatalyst-eks-build-policy \
       --policy-document file://codecatalyst-eks-build-policy.json

3. Premere Invio.

4. Nell'output del comando, annota il "arn": valore, ad esempioarn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy. Ne avrai bisogno ARN più tardi.

5. Per aggiungere la politica di distribuzione a AWS

1. Inserisci:

   aws iam create-policy \
       --policy-name codecatalyst-eks-deploy-policy \
       --policy-document file://codecatalyst-eks-deploy-policy.json

2. Premere Invio.

3. Nell'output del comando, annota il "arn": valore della policy di distribuzione, arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy ad esempio. Ne avrai bisogno ARN più tardi.

6. Per creare il ruolo di costruzione

1. Inserisci:

   aws iam create-role \
         --role-name codecatalyst-eks-build-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Premere Invio.

3. Inserisci:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-build-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy

   Dove arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy viene sostituito con quello ARN della politica di compilazione indicata in precedenza.

4. Premere Invio.

5. Alla riga di comando del terminale, digitate:

   aws iam get-role \
         --role-name codecatalyst-eks-build-role

6. Premere Invio.

7. Annotate il "Arn": valore del ruolo, arn:aws:iam::111122223333:role/codecatalyst-eks-build-role ad esempio. Ne avrai bisogno ARN più tardi.

7. Per creare il ruolo di distribuzione

1. Inserisci:

   aws iam create-role \
         --role-name codecatalyst-eks-deploy-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Premere Invio.

3. Inserisci:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-deploy-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy

   Dove arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy viene sostituito con quello ARN della politica di distribuzione indicata in precedenza.

4. Premere Invio.

5. Inserisci:

   aws iam get-role \
         --role-name codecatalyst-eks-deploy-role

6. Premere Invio.

7. Nota il "Arn": valore del ruolo, ad esempio,arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. Ne avrai bisogno ARN più tardi.

Per aggiungere ruoli di creazione e distribuzione al tuo Account AWS

1. Nella CodeCatalyst console, accedi al tuo spazio.

2. In alto, scegli Impostazioni.

3. Nel riquadro di navigazione, scegli AWS Account. Viene visualizzato un elenco di account.

4. Nella colonna Amazon CodeCatalyst display name, copia il nome visualizzato del Account AWS luogo in cui hai creato i ruoli di build e deploy. (Potrebbe essere un numero). Questo valore ti servirà in seguito, durante la creazione del tuo flusso di lavoro.

5. Scegli il nome visualizzato.

6. Scegli Gestisci ruoli dalla console AWS di gestione.

   Viene visualizzata la pagina Aggiungi IAM ruolo CodeCatalyst allo spazio Amazon. Potrebbe essere necessario effettuare il login per accedere alla pagina.

7. Seleziona Aggiungi un ruolo esistente in cui hai creato IAM.

   Viene visualizzato un elenco a discesa. L'elenco mostra i ruoli di compilazione e distribuzione e tutti gli altri IAM ruoli con una politica di attendibilità che include i principali del serviziocodecatalyst-runner.amazonaws.com. codecatalyst.amazonaws.com

8. Dall'elenco a discesa, aggiungi:

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   Nota

   Se vediThe security token included in the request is invalid, potrebbe essere perché non disponi delle autorizzazioni giuste. Per risolvere questo problema, esci e accedi nuovamente con l' AWS account che hai usato quando hai creato il tuo CodeCatalyst spazio. AWS

9. Torna alla CodeCatalyst console e aggiorna la pagina.

   I ruoli di compilazione e distribuzione dovrebbero ora apparire sotto IAM ruoli.

   Questi ruoli sono ora disponibili per l'uso nei flussi CodeCatalyst di lavoro.

Per configurare il file Kubernetes ConfigMap usando eksctl

• Nel terminale Dev Environment, inserisci:

  eksctl create iamidentitymapping --cluster codecatalyst-eks-cluster --arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role --group system:masters --username codecatalyst-eks-deploy-role --region us-west-2

  Dove:

  • codecatalyst-eks-cluster viene sostituito con il nome del EKS cluster Amazon.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role viene sostituito dal ruolo ARN di distribuzione in Fase 5: Creare AWS ruoli cui hai creato.

  • codecatalyst-eks-deploy-role (accanto a--username) viene sostituito dal nome del ruolo di distribuzione in cui è stato creato. Fase 5: Creare AWS ruoli

    Nota

    Se hai deciso di non creare un ruolo di distribuzione, sostituisci codecatalyst-eks-deploy-role con il nome del CodeCatalystWorkflowDevelopmentRole-spaceName ruolo. Per ulteriori informazioni su questo ruolo, consulta Fase 5: Creare AWS ruoli.

  • us-west-2 viene sostituito con la tua regione.

  Per i dettagli su questo comando, consulta Gestire IAM utenti e ruoli.

  Viene visualizzato un messaggio simile al seguente:

  2023-06-09 00:58:29 [ℹ]  checking arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role against entries in the auth ConfigMap
  2023-06-09 00:58:29 [ℹ]  adding identity "arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role" to auth ConfigMap

Per configurare il file Kubernetes ConfigMap usando kubectl

1. Nel terminale Dev Environment, inserisci:

   kubectl edit configmap -n kube-system aws-auth

   Il ConfigMap file viene visualizzato sullo schermo.

2. Aggiungi il testo in corsivo rosso:

   # Please edit the object below. Lines beginning with a '#' will be ignored,
   # and an empty file will abort the edit. If an error occurs while saving this file will be
   # reopened with the relevant failures.
   #
   apiVersion: v1
   data:
     mapRoles: |
       - groups:
         - system:bootstrappers
         - system:nodes
         rolearn: arn:aws:iam::111122223333:role/eksctl-codecatalyst-eks-cluster-n-NodeInstanceRole-16BC456ME6YR5
         username: system:node:{{EC2PrivateDNSName}}
       - groups:
         - system:masters
         rolearn: arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role
         username: codecatalyst-eks-deploy-role
     mapUsers: |
       []
   kind: ConfigMap
   metadata:
     creationTimestamp: "2023-06-08T19:04:39Z"
     managedFields:
     ...

   Dove:

   • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role viene sostituito dal ruolo ARN di distribuzione in cui è stato creato. Fase 5: Creare AWS ruoli

   • codecatalyst-eks-deploy-role (accanto ausername:) viene sostituito dal nome del ruolo di distribuzione in cui è stato creato. Fase 5: Creare AWS ruoli

     Nota

     Se hai deciso di non creare un ruolo di distribuzione, sostituisci codecatalyst-eks-deploy-role con il nome del CodeCatalystWorkflowDevelopmentRole-spaceName ruolo. Per ulteriori informazioni su questo ruolo, consulta Fase 5: Creare AWS ruoli.

   Per i dettagli, consulta la sezione Enabling IAM principal access to your cluster nella Amazon EKS User Guide.

Creazione di un flusso di lavoro

1. Vai alla console. CodeCatalyst

2. Vai al tuo progetto (codecatalyst-eks-project).

3. Nel riquadro di navigazione, scegli CI/CD, quindi scegli Flussi di lavoro.

4. Scegli Crea flusso di lavoro.

5. Per Source repository, sceglicodecatalyst-eks-source-repository.

6. Per Branch, sceglimain.

7. Scegli Create (Crea) .

8. Elimina il codice YAML di esempio.

9. Aggiungi il YAML codice seguente per creare un nuovo file di definizione del flusso di lavoro:

   Nota

   Per ulteriori informazioni sul file di definizione del flusso di lavoro, vedereYAMLDefinizione del workflow.

   Nota

   Nel YAML codice che segue, puoi omettere le Connections: sezioni, se lo desideri. Se si omettono queste sezioni, è necessario assicurarsi che il ruolo specificato nel campo Ruolo predefinito IAM nel proprio ambiente includa le autorizzazioni e le politiche di fiducia di entrambi i ruoli descritte in. Fase 6: Aggiungere AWS ruoli a CodeCatalyst Per ulteriori informazioni sulla configurazione di un ambiente con un IAM ruolo predefinito, vedere. Creazione di un ambiente

   Name: codecatalyst-eks-workflow
   SchemaVersion: 1.0
   
   Triggers:
     - Type: PUSH
       Branches:
         - main
   Actions:
     BuildBackend:
       Identifier: aws/build@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-build-role
       Inputs:
         Sources:
           - WorkflowSource
         Variables:
           - Name: REPOSITORY_URI
             Value: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo
           - Name: IMAGE_TAG
             Value: ${WorkflowSource.CommitId}
       Configuration:
         Steps:
           #pre_build:
           - Run: echo Logging in to Amazon ECR...
           - Run: aws --version
           - Run: aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com
           #build:
           - Run: echo Build started on `date`
           - Run: echo Building the Docker image...
           - Run: docker build -t $REPOSITORY_URI:latest .
           - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
           #post_build:
           - Run: echo Build completed on `date`
           - Run: echo Pushing the Docker images...
           - Run: docker push $REPOSITORY_URI:latest
           - Run: docker push $REPOSITORY_URI:$IMAGE_TAG
           # Replace the variables in deployment.yaml
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g"
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g"
           - Run: cat Kubernetes/*
           # The output artifact will be a zip file that contains Kubernetes manifest files.
       Outputs:
         Artifacts:
           - Name: Manifests
             Files: 
               - "Kubernetes/*"
     DeployToEKS:
       DependsOn: 
         - BuildBackend
       Identifier: aws/kubernetes-deploy@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-deploy-role
       Inputs:
         Artifacts:
           - Manifests
       Configuration:
         Namespace: default
         Region: us-west-2
         Cluster: codecatalyst-eks-cluster
         Manifests: Kubernetes/

   Nel codice precedente, sostituisci:

   • Entrambe le istanze di codecatalyst-eks-environment con il nome dell'ambiente in Prerequisiti cui hai creato.

   • Entrambe le istanze di codecatalyst-account-connection con il nome visualizzato della connessione all'account. Il nome visualizzato potrebbe essere un numero. Per ulteriori informazioni, consulta Fase 6: Aggiungere AWS ruoli a CodeCatalyst.

   • codecatalyst-eks-build-role con il nome del ruolo di costruzione in cui hai creatoFase 5: Creare AWS ruoli.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo (nella Value: proprietà) con il URI ECR repository Amazon in Fase 3: Creare un archivio di ECR immagini Amazon cui hai creato.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com (nel Run: aws ecr comando) con il URI ECR repository Amazon senza il suffisso dell'immagine ()/codecatalyst-eks-image-repo.

   • codecatalyst-eks-deploy-role con il nome del ruolo di distribuzione in cui hai creato. Fase 5: Creare AWS ruoli

   • Entrambe le istanze di us-west-2 con il tuo codice AWS regionale. Per un elenco dei codici regionali, consulta Endpoint regionali in. Riferimenti generali di AWS

   Nota

   Se hai deciso di non creare, creare e distribuire ruoli, sostituisci codecatalyst-eks-build-role e codecatalyst-eks-deploy-role con il nome del CodeCatalystWorkflowDevelopmentRole-spaceName ruolo. Per ulteriori informazioni su questo ruolo, consulta Fase 5: Creare AWS ruoli.

10. (Facoltativo) Scegliete Convalida per assicurarvi che il YAML codice sia valido prima di eseguire il commit.

11. Scegli Applica.

12. Nella finestra di dialogo Conferma flusso di lavoro, inserisci quanto segue:

    1. Per il messaggio di conferma, rimuovi il testo e inserisci:

       Add first workflow

    2. Per Repository, sceglicodecatalyst-eks-source-repository.

    3. Per il nome del ramo, scegli principale.

    4. Scegli Applica.

    Ora hai creato un flusso di lavoro. L'esecuzione di un flusso di lavoro viene avviata automaticamente a causa del trigger definito nella parte superiore del flusso di lavoro. In particolare, quando hai eseguito il commit (e inviato) del workflow.yaml file nell'archivio di origine, il trigger ha avviato l'esecuzione del flusso di lavoro.

Per visualizzare l'avanzamento del flusso di lavoro, esegui

1. Nel pannello di navigazione della CodeCatalyst console, scegli CI/CD, quindi scegli Flussi di lavoro.

2. Scegli il flusso di lavoro che hai appena creato,. codecatalyst-eks-workflow

3. Scegli BuildBackenddi vedere lo stato di avanzamento della costruzione.

4. Scegli DeployToEKSdi vedere lo stato di avanzamento della distribuzione.

   Per ulteriori informazioni sulla visualizzazione dei dettagli dell'esecuzione, consultaVisualizzazione dello stato e dei dettagli dell'esecuzione del flusso di lavoro.

Per verificare la distribuzione

1. Apri la EC2 console Amazon all'indirizzo https://console.aws.amazon.com/ec2/.

2. A sinistra, in basso, scegli Load Balancers.

3. Seleziona il load balancer che è stato creato come parte della tua implementazione Kubernetes. Se non sei sicuro di quale bilanciamento del carico scegliere, cerca i seguenti tag nella scheda Tag:

   • kubernetes.io/service-name

   • kubernetes.io/cluster/ekstutorialcluster

4. Con il bilanciamento del carico corretto selezionato, scegli la scheda Descrizione.

5. Copia e incolla il valore del DNSnome nella barra degli indirizzi del browser.

   Il programma «Hello, World!» nel browser viene visualizzata una pagina Web che indica che l'applicazione è stata distribuita correttamente.

Per modificare il file index.html

1. Vai al tuo ambiente di sviluppo.

2. Al prompt del terminale, passa al repository dei sorgenti:

   cd /projects/codecatalyst-eks-source-repository

3. Recupera le ultime modifiche al flusso di lavoro:

   git pull

4. Aprire codecatalyst-eks-source-repository/public-html/index.html.

5. Nella riga 14, modifica il Hello, World! testo inTutorial complete!.

6. Aggiungi, esegui il commit e spingi:

   git add .
   git commit -m "update index.html title"
   git push

   L'esecuzione di un flusso di lavoro viene avviata automaticamente.

7. (Facoltativo) Inserisci:

   git show HEAD

   Annota l'ID di commit per la index.html modifica. Questo ID di commit verrà taggato nell'immagine Docker che verrà distribuita dall'esecuzione del flusso di lavoro appena avviata.

8. Guarda lo stato di avanzamento della distribuzione:

   1. Nella CodeCatalyst console, nel riquadro di navigazione, scegli CI/CD, quindi scegli Flussi di lavoro.

   2. Scegli codecatalyst-eks-workflow di visualizzare l'ultima esecuzione.

   3. Scegli BuildBackende DeployToEKSper vedere l'avanzamento del flusso di lavoro esegui.

9. Verifica che l'applicazione sia stata aggiornata, come segue:

   1. Apri la EC2 console Amazon all'indirizzo https://console.aws.amazon.com/ec2/.

   2. A sinistra, in basso, scegli Load Balancers.

   3. Seleziona il load balancer che è stato creato come parte della tua implementazione Kubernetes.

   4. Copia e incolla il valore del DNSnome nella barra degli indirizzi del browser.

      Il «Tutorial completo!» Nel browser viene visualizzata una pagina Web che indica che è stata implementata correttamente una nuova revisione dell'applicazione.

10. (Facoltativo) In AWS, passa alla ECR console Amazon e verifica che la nuova immagine Docker sia stata etichettata con l'ID di commit del passaggio 7 di questa procedura.

Per eliminare

1. Elimina il tuo cluster:

   1. Nel terminale Dev Environment, inserisci:

      eksctl delete cluster --region=us-west-2 --name=codecatalyst-eks-cluster

      Dove:

      • us-west-2 viene sostituito con la tua regione.

      • codecatalyst-eks-cluster viene sostituito dal nome del cluster creato.

      Dopo 5-10 minuti, il cluster e le risorse associate vengono eliminati, inclusi, a titolo esemplificativo, AWS CloudFormation stack, gruppi di nodi (in AmazonEC2) e sistemi di bilanciamento del carico.

   Importante

   Se il eksctl delete cluster comando non funziona, potrebbe essere necessario aggiornare le credenziali o le credenziali. AWS kubectl Se non sei sicuro di quali credenziali aggiornare, aggiorna prima le credenziali. AWS Per aggiornare le credenziali, consulta. AWS Come posso correggere gli errori «Impossibile individuare le credenziali» e "ExpiredToken"? Per aggiornare le kubectl credenziali, consulta. Come posso correggere gli errori «Impossibile connettersi al server»?

2. Nella AWS console, pulisci come segue:

   1. In AmazonECR, eliminacodecatalyst-eks-image-repo.

   2. In IAM Identity Center, elimina:

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. InIAM, elimina:

      • codecatalyst-eks-build-role

      • codecatalyst-eks-deploy-role

      • codecatalyst-eks-build-policy

      • codecatalyst-eks-deploy-policy

3. Nella CodeCatalyst console, pulisci come segue:

   1. Eliminarecodecatalyst-eks-workflow.

   2. Eliminarecodecatalyst-eks-environment.

   3. Eliminarecodecatalyst-eks-source-repository.

   4. Elimina il tuo ambiente di sviluppo.

   5. Eliminacodecatalyst-eks-project.