Tutorial: Implementar una aplicación en Amazon EKS

Para lanzar un entorno de desarrollo

1. Abra la CodeCatalyst consola en https://codecatalyst.aws/.

2. Navegue hasta su proyecto,codecatalyst-eks-project.

3. En el panel de navegación, elija Código y, a continuación, elija Repositorios de origen.

4. Elige el nombre de tu repositorio fuente,codecatalyst-eks-source-repository.

5. En la parte superior, selecciona Crear entorno de desarrollo y, a continuación, selecciona AWS Cloud9 (en el navegador).

6. Asegúrese de que estén seleccionadas la opción Trabajar en la rama existente y la rama principal y, a continuación, elija Crear.

   Tu entorno de desarrollo se abre en una nueva pestaña del navegador y tu repositorio (codecatalyst-eks-source-repository) se clona en ella.

Para instalar y configurar kubectl

1. En la terminal Dev Environment, introduce:

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

2. Introduzca:

   chmod +x ./kubectl

3. Ingresa:

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

4. Ingresa:

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

5. Ingresa:

   kubectl version --short --client

6. Compruebe que aparezca una versión.

   Ya está instaladakubectl.

Para instalar y configurar eksctl

1. En la terminal Dev Environment, introduzca:

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

2. Introduzca:

   sudo cp /tmp/eksctl /usr/bin

3. Ingresa:

   eksctl version

4. Compruebe que aparezca una versión.

   Ya está instaladaeksctl.

Para comprobar que AWS CLI está instalado

1. En la terminal Dev Environment, introduzca:

   aws --version

2. Compruebe que aparezca una versión para comprobar que AWS CLI está instalada.

   Complete los procedimientos restantes para configurarlo AWS CLI con los permisos de acceso necesarios AWS.

1. Cree un usuario del Centro de IAM identidades, de la siguiente manera:

   1. Inicie sesión en AWS Management Console y abra la AWS IAM Identity Center consola en https://console.aws.amazon.com/singlesignon/.

      (Puede que tenga que seleccionar Activar si nunca ha iniciado sesión en IAM Identity Center).

      nota

      Asegúrese de iniciar sesión con el Cuenta de AWS que está conectado a su CodeCatalyst espacio. Para comprobar qué cuenta está conectada, ve a tu espacio y selecciona la pestaña de AWScuentas. Para obtener más información, consulte Crear un espacio.

   2. En el panel de navegación, elija Users y luego elija la opción Add user.

   3. En Nombre de usuario, ingresa:

      codecatalyst-eks-user

   4. En Contraseña, selecciona Generar una contraseña de un solo uso que puedas compartir con este usuario.

   5. En Dirección de correo electrónico y Confirmar dirección de correo electrónico, introduzca una dirección de correo electrónico que no exista aún en IAM Identity Center.

   6. En Nombre, introduzca:

      codecatalyst-eks-user

   7. En Apellido, introduzca:

      codecatalyst-eks-user

   8. En Nombre para mostrar, mantenga:

      codecatalyst-eks-user codecatalyst-eks-user

   9. Elija Next (Siguiente).

   10. En la página Añadir usuario a grupos, selecciona Siguiente.

   11. En la página Revisar y agregar usuario, revise la información y elija Agregar usuario.

       Aparece un cuadro de diálogo de contraseña de un solo uso.

   12. Seleccione Copiar y, a continuación, pegue la información de inicio de sesión en un archivo de texto. La información de inicio de sesión consta del portal de AWS accesoURL, un nombre de usuario y una contraseña de un solo uso.

   13. Elija Close.

2. Cree un conjunto de permisos, de la siguiente manera:

   1. En el panel de navegación, elija Conjuntos de permisos y, a continuación, elija Crear conjunto de permisos.

   2. Elija un conjunto de permisos predefinido y, a continuación, seleccione AdministratorAccess. Esta política proporciona permisos completos a todos Servicios de AWS.

   3. Elija Next (Siguiente).

   4. En Nombre del conjunto de permisos, elimine AdministratorAccess e introduzca:

      codecatalyst-eks-permission-set

   5. Elija Next (Siguiente).

   6. En la página Revisión, revise la información y, a continuación, elija Crear grupo.

3. Asigne el conjunto de permisos acodecatalyst-eks-user, de la siguiente manera:

   1. En el panel de navegación, elija y Cuentas de AWS, a continuación, active la casilla de verificación situada junto a la casilla en la Cuenta de AWS que ha iniciado sesión actualmente.

   2. Seleccione Asignar usuarios o grupos.

   3. Elija la pestaña Users.

   4. Seleccione la casilla situada junto a codecatalyst-eks-user.

   5. Elija Next (Siguiente).

   6. Seleccione la casilla situada junto a codecatalyst-eks-permission-set.

   7. Elija Next (Siguiente).

   8. Revise la información y seleccione Enviar.

      Ahora tienes asignada codecatalyst-eks-user y codecatalyst-eks-permission-set a la tuya Cuenta de AWS, uniéndolas.

4. Obtenga las claves codecatalyst-eks-user de acceso y el token de sesión de la siguiente manera:

   1. Asegúrese de tener el portal de AWS acceso y el nombre de usuario URL y la contraseña de un solo uso del mismocodecatalyst-eks-user. Deberías haber copiado esta información en un editor de texto anteriormente.

      nota

      Si no dispone de esta información, vaya a la página de codecatalyst-eks-user detalles del IAM Identity Center, seleccione Restablecer contraseña, Generar una contraseña de un solo uso [...] y vuelva a restablecer la contraseña para mostrar la información en la pantalla.

   2. Cerrar sesión en AWS.

   3. Pegue el portal de AWS acceso URL en la barra de direcciones del navegador.

   4. Inicie sesión con:

      • Nombre de usuario:

        codecatalyst-eks-user

      • Contraseña:

        one-time-password

   5. En Establecer nueva contraseña, introduzca una nueva contraseña y elija Establecer nueva contraseña.

      Aparece un cuadro de Cuenta de AWS en la pantalla.

   6. Elija y Cuenta de AWS, a continuación, elija el nombre de la persona Cuenta de AWS a la que ha asignado el codecatalyst-eks-user usuario y el conjunto de permisos.

   7. Junto acodecatalyst-eks-permission-set, seleccione Línea de comandos o Acceso mediante programación.

   8. Copia los comandos en el centro de la página. Tienen un aspecto similar al siguiente:

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

      ... dónde session-token es una cadena larga y aleatoria.

5. Añada las claves de acceso y el token de sesión al AWS CLI, de la siguiente manera:

   1. Regrese a su CodeCatalyst entorno de desarrollo.

   2. En la línea de comandos del terminal, pegue los comandos que copió. Pulse Intro.

      Ahora lo ha configurado AWS CLI con claves de acceso y un token de sesión. Ahora puede utilizarla AWS CLI para completar las tareas requeridas en este tutorial.

      importante

      Si en algún momento de este tutorial ves mensajes similares a:

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

      O bien:

      ExpiredToken: The security token included in the request is expired

      ... es porque tu AWS CLI sesión ha caducado. En este caso, no ejecute el aws configure comando. En su lugar, siga las instrucciones del paso 4 de este procedimiento, que comienza con Obtain codecatalyst-eks-user's access key and session token la actualización de la sesión.

Pasos para crear un clúster

1. Ve a tu entorno de desarrollo.

2. Cree un clúster y nodos:

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

   Donde:

   • codecatalyst-eks-cluster se sustituye por el nombre que desee darle al clúster.

   • us-west-2 se sustituye por tu región.

   Después de 10 a 20 minutos, aparecerá un mensaje similar al siguiente:

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

   nota

   Verás varios waiting for CloudFormation stack mensajes mientras creas AWS el clúster. Esto es normal.

3. Comprueba que el clúster se haya creado correctamente:

   kubectl cluster-info

   Verás un mensaje similar al siguiente, que indica que la creación del clúster se ha realizado correctamente:

   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

Para crear un repositorio de imágenes en Amazon ECR

1. Ve a tu entorno de desarrollo.

2. Crea un repositorio vacío en AmazonECR:

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

   Reemplazar codecatalyst-eks-image-repo con el nombre que quieras dar al ECR repositorio de Amazon.

   En este tutorial se asume que has asignado un nombre a tu repositoriocodecatalyst-eks-image-repo.

3. Muestra los detalles del ECR repositorio de Amazon:

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

4. Anote el “repositoryUri”: valor, por ejemplo,111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo.

   Lo necesitará más adelante cuando añada el repositorio a su flujo de trabajo.

Para añadir el archivo index.html

1. Ve a tu entorno de desarrollo.

2. Encodecatalyst-eks-source-repository, crea una carpeta llamadapublic-html.

3. En/public-html, cree un archivo llamado index.html con el siguiente contenido:

   <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. En la línea de comandos del terminal, escriba:

   cd /projects/codecatalyst-eks-source-repository

5. Agrega, confirma y presiona:

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

   index.htmlSe añade a tu repositorio en una public-html carpeta.

Para añadir el Dockerfile

1. Encodecatalyst-eks-source-repository, cree un archivo llamado Dockerfile con el siguiente contenido:

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

   No incluya una extensión de archivo.

   importante

   El Dockerfile debe residir en la carpeta raíz del repositorio. El Docker build comando del flujo de trabajo espera que esté ahí.

2. Agrega, confirma y presiona:

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

   El Dockerfile se añade a tu repositorio.

Para añadir un archivo deployment.yaml

1. Encodecatalyst-eks-source-repository, crea una carpeta llamada. Kubernetes

2. En/Kubernetes, cree un archivo llamado deployment.yaml con el siguiente contenido:

   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. Agrega, confirma y envía:

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

   El deployment.yaml archivo se añade a tu repositorio en una carpeta llamadaKubernetes.

1. Para crear una política de confianza para ambos roles

1. Ve a tu entorno de desarrollo.

2. En el Cloud9-long-string directorio, cree un archivo llamado codecatalyst-eks-trust-policy.json con el siguiente contenido:

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

2. Para crear la política de compilación para el rol de compilación

• En el Cloud9-long-string directorio, cree un archivo llamado codecatalyst-eks-build-policy.json con el siguiente contenido:

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

  nota

  La primera vez que se utilice el rol para ejecutar acciones de flujo de trabajo, utilice el comodín en la declaración de política de recursos y, a continuación, defina la política con el nombre del recurso cuando esté disponible.

  "Resource": "*"

3. Para crear la política de despliegue para el rol de despliegue

• En el Cloud9-long-string directorio, cree un archivo denominado codecatalyst-eks-deploy-policy.json con el siguiente contenido:

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

  nota

  La primera vez que se utilice el rol para ejecutar acciones de flujo de trabajo, utilice el comodín en la declaración de política de recursos y, a continuación, defina la política con el nombre del recurso cuando esté disponible.

  "Resource": "*"

4. Para añadir la política de compilación a AWS

1. En la terminal Dev Environment, ingresa:

   cd /projects

2. Introduzca:

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

3. Pulse Intro.

4. En el resultado del comando, anote el "arn": valor, por ejemplo,arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy. Lo necesitará ARN más adelante.

5. Para añadir la política de despliegue a AWS

1. Introduzca:

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

2. Pulse Intro.

3. En el resultado del comando, anote el "arn": valor de la política de despliegue, por ejemplo,arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy. Lo necesitará ARN más adelante.

6. Para crear el rol de compilación

1. Introduzca:

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

2. Pulse Intro.

3. Ingresa:

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

   Donde arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy se sustituye por la política ARN de construcción que ha indicado anteriormente.

4. Pulse Intro.

5. En la línea de comandos del terminal, escriba:

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

6. Pulse Intro.

7. Anote el "Arn": valor del rol, por ejemplo,arn:aws:iam::111122223333:role/codecatalyst-eks-build-role. Lo necesitarás ARN más tarde.

7. Para crear el rol de despliegue

1. Introduzca:

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

2. Pulse Intro.

3. Ingresa:

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

   Donde arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy se sustituye por la política ARN de despliegue que ha indicado anteriormente.

4. Pulse Intro.

5. Introduzca:

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

6. Pulse Intro.

7. Anote el "Arn": valor del rol, por ejemplo,arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. Lo necesitarás ARN más tarde.

Para añadir funciones de creación e implementación a su Cuenta de AWS

1. En la CodeCatalyst consola, navega hasta tu espacio.

2. En la parte superior, selecciona Configuración.

3. En el panel de navegación, selecciona AWS cuentas. Aparece una lista de cuentas.

4. En la columna Nombre CodeCatalyst para mostrar de Amazon, copia el nombre para mostrar del Cuenta de AWS lugar en el que creaste las funciones de creación e implementación. (Puede ser un número). Necesitarás este valor más adelante, al crear tu flujo de trabajo.

5. Elige el nombre para mostrar.

6. Seleccione Administrar funciones en la consola de AWS administración.

   Aparece la página Añadir IAM rol al CodeCatalyst espacio de Amazon. Puede que tengas que iniciar sesión para acceder a la página.

7. Selecciona Añadir un rol existente en el que hayas creado IAM.

   Aparece una lista desplegable. La lista muestra las funciones de creación e implementación, así como cualquier otra IAM función con una política de confianza que incluya a los directores codecatalyst-runner.amazonaws.com y codecatalyst.amazonaws.com al servicio.

8. En la lista desplegable, agrega:

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   nota

   Si lo veThe security token included in the request is invalid, es posible que se deba a que no tiene los permisos adecuados. Para solucionar este problema, cierra sesión AWS como vuelve a iniciar sesión con la AWS cuenta que utilizaste al crear tu CodeCatalyst espacio.

9. Vuelve a la CodeCatalyst consola y actualiza la página.

   Las funciones de creación e implementación deberían aparecer ahora en IAMFunciones.

   Estos roles ahora están disponibles para su uso en los CodeCatalyst flujos de trabajo.

Para configurar el archivo de Kubernetes ConfigMap mediante eksctl

• En la terminal Dev Environment, introduzca:

  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

  Donde:

  • codecatalyst-eks-cluster se sustituye por el nombre del EKS clúster de Amazon.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role se sustituye por el rol ARN de despliegue en el que creastePaso 5: Crear AWS roles.

  • codecatalyst-eks-deploy-role (junto a--username) se sustituye por el nombre del rol de despliegue en el que creastePaso 5: Crear AWS roles.

    nota

    Si ha decidido no crear un rol de despliegue, sustitúyalo codecatalyst-eks-deploy-role por el nombre del CodeCatalystWorkflowDevelopmentRole-spaceName rol. Para obtener más información acerca de este rol, consulte Paso 5: Crear AWS roles.

  • us-west-2 se sustituye por tu región.

  Para obtener más información sobre este comando, consulte Administrar IAM usuarios y roles.

  Aparece un mensaje similar al siguiente:

  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

Para configurar el archivo de Kubernetes ConfigMap mediante kubectl

1. En la terminal Dev Environment, ingresa:

   kubectl edit configmap -n kube-system aws-auth

   El ConfigMap archivo aparece en la pantalla.

2. Añada el texto en cursiva roja:

   # 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:
     ...

   Donde:

   • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role se sustituye por el rol ARN de despliegue en Paso 5: Crear AWS roles el que creaste.

   • codecatalyst-eks-deploy-role (junto ausername:) se sustituye por el nombre del rol de despliegue en el que creastePaso 5: Crear AWS roles.

     nota

     Si ha decidido no crear un rol de despliegue, sustitúyalo codecatalyst-eks-deploy-role por el nombre del CodeCatalystWorkflowDevelopmentRole-spaceName rol. Para obtener más información acerca de este rol, consulte Paso 5: Crear AWS roles.

   Para obtener más información, consulta Cómo habilitar el acceso IAM principal a tu clúster en la Guía del EKS usuario de Amazon.

Para crear un flujo de trabajo

1. Ve a la consola. CodeCatalyst

2. Navega hasta tu proyecto (codecatalyst-eks-project).

3. En el panel de navegación, selecciona CI/CD y, a continuación, selecciona Flujos de trabajo.

4. Seleccione Crear flujo de trabajo.

5. En Repositorio de origen, elijacodecatalyst-eks-source-repository.

6. Para Branch, elijamain.

7. Seleccione Crear.

8. Elimine el código de YAML muestra.

9. Añada el siguiente YAML código para crear un nuevo archivo de definición de flujo de trabajo:

   nota

   Para obtener más información sobre el archivo de definición del flujo de trabajo, consulteYAMLDefinición del flujo de trabajo.

   nota

   En el YAML código siguiente, puede omitir las Connections: secciones si lo desea. Si omite estas secciones, debe asegurarse de que la función especificada en el campo IAMFunción predeterminada de su entorno incluya los permisos y las políticas de confianza de ambas funciones descritas en. Paso 6: Añadir AWS roles a CodeCatalyst Para obtener más información sobre la configuración de un entorno con un IAM rol predeterminado, consulteCreación de un entorno.

   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/

   En el código anterior, sustituya:

   • Ambas instancias de codecatalyst-eks-environment con el nombre del entorno en el que creóRequisitos previos.

   • Ambas instancias de codecatalyst-account-connection con el nombre visible de la conexión de su cuenta. El nombre para mostrar puede ser un número. Para obtener más información, consulte Paso 6: Añadir AWS roles a CodeCatalyst.

   • codecatalyst-eks-build-role con el nombre del rol de compilación en el que creastePaso 5: Crear AWS roles.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo (en la Value: propiedad) con el ECR repositorio URI de Amazon en el que creastePaso 3: Crear un repositorio de ECR imágenes de Amazon.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com (en el Run: aws ecr comando) con el URI del ECR repositorio de Amazon sin el sufijo de imagen (/codecatalyst-eks-image-repo).

   • codecatalyst-eks-deploy-role con el nombre de la función de despliegue en Paso 5: Crear AWS roles la que creaste.

   • Ambas instancias de us-west-2 con el código de su AWS región. Para obtener una lista de los códigos de región, consulta los puntos finales regionales en. Referencia general de AWS

   nota

   Si ha decidido no crear funciones de creación e implementación, sustituya codecatalyst-eks-build-role y codecatalyst-eks-deploy-role por el nombre del CodeCatalystWorkflowDevelopmentRole-spaceName rol. Para obtener más información acerca de este rol, consulte Paso 5: Crear AWS roles.

10. (Opcional) Elija Validar para asegurarse de que el YAML código es válido antes de realizar la confirmación.

11. Elija Commit (Confirmar).

12. En el cuadro de diálogo Confirmar flujo de trabajo, introduzca lo siguiente:

    1. En el caso del mensaje de confirmación, elimine el texto e introduzca:

       Add first workflow

    2. En Repositorio, elijacodecatalyst-eks-source-repository.

    3. En Nombre de sucursal, elija principal.

    4. Elija Commit (Confirmar).

    Ahora ha creado un flujo de trabajo. La ejecución de un flujo de trabajo se inicia automáticamente debido al activador definido en la parte superior del flujo de trabajo. En concreto, cuando depositaste (e insertaste) el workflow.yaml archivo en tu repositorio de origen, el desencadenador inició la ejecución del flujo de trabajo.

Para ver el progreso de la ejecución del flujo de trabajo

1. En el panel de navegación de la CodeCatalyst consola, elija CI/CD y, a continuación, elija Flujos de trabajo.

2. Elija el flujo de trabajo que acaba de crear,. codecatalyst-eks-workflow

3. Elige BuildBackendver el progreso de la compilación.

4. Elija DeployToEKSver el progreso de la implementación.

   Para obtener más información sobre la visualización de los detalles de la ejecución, consulteVer el estado y los detalles de la ejecución del flujo de trabajo.

Para verificar el despliegue

1. Abre la EC2 consola de Amazon en https://console.aws.amazon.com/ec2/.

2. A la izquierda, cerca de la parte inferior, selecciona Load Balancers.

3. Selecciona el balanceador de carga que se creó como parte de tu implementación de Kubernetes. Si no estás seguro de qué balanceador de cargas elegir, busca las siguientes etiquetas en la pestaña Etiquetas:

   • kubernetes.io/service-name

   • kubernetes.io/cluster/ekstutorialcluster

4. Con el balanceador de carga correcto seleccionado, selecciona la pestaña Descripción.

5. Copia y pega el valor DNSdel nombre en la barra de direcciones del navegador.

   El «¡Hola, mundo!» La página web aparece en su navegador, lo que indica que la aplicación se ha implementado correctamente.

Para cambiar el archivo index.html

1. Ve a tu entorno de desarrollo.

2. En la línea de comandos del terminal, cambia a tu repositorio de código fuente:

   cd /projects/codecatalyst-eks-source-repository

3. Obtenga los cambios más recientes en el flujo de trabajo:

   git pull

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

5. En la línea 14, cambia el Hello, World! texto aTutorial complete!.

6. Agrega, confirma y presiona:

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

   La ejecución de un flujo de trabajo se inicia automáticamente.

7. (Opcional) Introduzca:

   git show HEAD

   Anote el ID de confirmación del index.html cambio. Este ID de confirmación se etiquetará en la imagen de Docker que se implementará en la ejecución del flujo de trabajo que acabas de iniciar.

8. Observe el progreso de la implementación:

   1. En la CodeCatalyst consola, en el panel de navegación, elija CI/CD y, a continuación, elija Flujos de trabajo.

   2. Elija codecatalyst-eks-workflow ver la última ejecución.

   3. Elija BuildBackendy DeployToEKSpara ver el progreso de la ejecución del flujo de trabajo.

9. Compruebe que la aplicación se haya actualizado de la siguiente manera:

   1. Abre la EC2 consola de Amazon en https://console.aws.amazon.com/ec2/.

   2. A la izquierda, cerca de la parte inferior, selecciona Load Balancers.

   3. Selecciona el balanceador de carga que se creó como parte de tu implementación de Kubernetes.

   4. Copia y pega el valor del DNSnombre en la barra de direcciones de tu navegador.

      ¡El «Tutorial completo!» La página web aparece en su navegador, lo que indica que ha implementado correctamente una nueva revisión de la aplicación.

10. (Opcional) En AWS, cambia a la ECR consola de Amazon y comprueba que la nueva imagen de Docker esté etiquetada con el ID de confirmación del paso 7 de este procedimiento.

Eliminación

1. Elimine el clúster:

   1. En la terminal Dev Environment, introduce:

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

      Donde:

      • us-west-2 se sustituye por tu región.

      • codecatalyst-eks-cluster se sustituye por el nombre del clúster que ha creado.

      Después de 5 a 10 minutos, se eliminan el clúster y los recursos asociados, incluidos, entre otros, las AWS CloudFormation pilas, los grupos de nodos (en AmazonEC2) y los balanceadores de carga.

   importante

   Si el eksctl delete cluster comando no funciona, es posible que tengas que actualizar tus AWS credenciales o tus kubectl credenciales. Si no está seguro de qué credenciales actualizar, actualice primero las AWS credenciales. Para actualizar sus AWS credenciales, consulte¿Cómo puedo corregir los errores «No se pueden localizar las credenciales» y ExpiredToken «»?. Para actualizar sus kubectl credenciales, consulte¿Cómo puedo corregir los errores «No se puede conectar al servidor»?.

2. En la AWS consola, limpie de la siguiente manera:

   1. En AmazonECR, elimínalocodecatalyst-eks-image-repo.

   2. En IAM Identity Center, elimina:

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. EnIAM, elimine:

      • codecatalyst-eks-build-role

      • codecatalyst-eks-deploy-role

      • codecatalyst-eks-build-policy

      • codecatalyst-eks-deploy-policy

3. En la CodeCatalyst consola, limpie de la siguiente manera:

   1. Eliminarcodecatalyst-eks-workflow.

   2. Eliminarcodecatalyst-eks-environment.

   3. Eliminarcodecatalyst-eks-source-repository.

   4. Elimine su entorno de desarrollo.

   5. Eliminarcodecatalyst-eks-project.