Paso 4: Implementar la aplicación Hello World. - AWS CodeDeploy
Implementación de la revisión de la aplicación con CodeDeployMonitorización y solución de problemas de la implementaciónComprobación de la implementación

Paso 4: Implementar la aplicación Hello World.

Ahora implementa la revisión de la aplicación Hello, World! de ejemplo que ha cargado en Amazon S3. Utilice la AWS CLI o la consola de CodeDeploy para implementar la revisión y monitorizar el progreso de la implementación. Una vez implementada correctamente la revisión de la aplicación, comprobará los resultados.

Implementación de la revisión de la aplicación con CodeDeploy

Puede implementar su aplicación con la CLI o la consola.

Para implementar la revisión de la aplicación (CLI)

  1. En primer lugar, la implementación necesita un grupo de implementaciones. Sin embargo, para crear el grupo de implementaciones, primero necesita un ARN de rol de servicio. Un rol de servicio es un rol de IAM que concede a un servicio permiso para actuar en su nombre. En este caso, el rol de servicio concede a CodeDeploy permiso de acceso a las instancias de Amazon EC2 para ampliar (leer) las etiquetas de instancias de Amazon EC2.

    Ya debe haber seguido las instrucciones de Creación de un rol de servicio (CLI) para crear un rol de servicio. Para obtener el ARN del rol de servicio, consulte Obtención del ARN del rol de servicio (CLI) .

  2. Ahora que tiene el ARN, llame al comando create-deployment-group para crear un grupo de implementación denominado HelloWorld_DepGroup asociado a la aplicación HelloWorld_App, utilizando la etiqueta de instancia de Amazon EC2 denominada CodeDeployDemo y la configuración de implementación denominada CodeDeployDefault.OneAtATime con el ARN del rol de servicio:

    aws deploy create-deployment-group --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --deployment-config-name CodeDeployDefault.OneAtATime --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE --service-role-arn serviceRoleARN
    nota

    El comando create-deployment-group permite crear activadores que provoquen el envío de notificaciones de Amazon SNS a los suscriptores del tema sobre eventos específicos en implementaciones e instancias. El comando también admite opciones para revertir automáticamente las implementaciones y configurar alarmas para detener las implementaciones cuando se alcanzan los umbrales de monitorización de las alarmas de Amazon CloudWatch. Los comandos para estas acciones no se incluyen en este tutorial.

  3. Antes de crear una implementación, las instancias del grupo de implementación deben tener instalado el agente de CodeDeploy. Puede instalar el agente desde la línea de comandos con AWS Systems Manager mediante el comando siguiente:

    aws ssm create-association --name AWS-ConfigureAWSPackage --targets Key=tag:Name,Values=CodeDeployDemo --parameters action=Install,name=AWSCodeDeployAgent --schedule-expression "cron(0 2 ? * SUN *)"

    Este comando crea una asociación en Systems Manager State Manager que instalará el agente de CodeDeploy y, después, intentará actualizarlo todos los domingos por la mañana a las 2:00. Para obtener más información sobre el agente de CodeDeploy, consulte Trabajo con el agente de CodeDeploy. Para obtener más información acerca de Systems Manager, consulte ¿Qué es AWS Systems Manager?.

  4. Ejecute ahora el comando create-deployment para crear una implementación asociada a la aplicación HelloWorld_App, la configuración de implementación CodeDeployDefault.OneAtATime y el grupo de implementaciones HelloWorld_DepGroup utilizando la revisión de la aplicación HelloWorld_App.zip del bucket amzn-s3-demo-bucket:

    aws deploy create-deployment --application-name HelloWorld_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name HelloWorld_DepGroup --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=HelloWorld_App.zip

Para implementar la revisión de la aplicación (consola)

  1. Para utilizar la consola de CodeDeploy para implementar la revisión de la aplicación, primero necesita un ARN de rol de servicio ARN. Un rol de servicio es un rol de IAM que concede a un servicio permiso para actuar en su nombre. En este caso, el rol de servicio concede a CodeDeploy permiso de acceso a las instancias de Amazon EC2 para ampliar (leer) las etiquetas de instancias de Amazon EC2.

    Ya debe haber seguido las instrucciones de Creación de un rol de servicio (consola) para crear un rol de servicio. Para obtener el ARN del rol de servicio, consulte Obtención del ARN del rol de servicio (consola) .

  2. Ahora que tiene el ARN, puede utilizar la consola de CodeDeploy para implementar la revisión de la aplicación.

    Inicie sesión en la Consola de administración de AWS y abra la consola de CodeDeploy en https://console.aws.amazon.com/codedeploy.

    nota

    Inicie sesión con el mismo usuario que configuró en Introducción a CodeDeploy.

  3. En el panel de navegación, expanda Implementar y, después, elija Aplicaciones.

  4. Elija HelloWorld_App.

  5. En la pestaña Deployment groups (Grupos de implementaciones), elija Create deployment group (Crear grupo de implementaciones).

  6. En Nombre de grupo de implementación, escriba HelloWorld_DepGroup.

  7. En Service Role (Rol de servicio), elija el nombre del rol de servicio.

  8. En Tipo de implementación, elija Local.

  9. En Configuración de entorno, elija la pestaña Instancias de Amazon EC2.

  10. En Configuración del agente con AWS Systems Manager, mantenga los valores predeterminados.

  11. En Clave, introduzca Name.

  12. En Valor, escriba CodeDeployDemo.

  13. En Configuración de implementación, elija CodeDeployDefault.OneAtATime.

  14. En Equilibrador de carga, anule la selección de Habilitar equilibración de carga.

  15. Elija Crear grupo de implementación.

  16. Elija Crear implementación.

  17. En Grupo de implementación, elija HelloWorld_DepGroup

  18. En Tipo de revisión, elija Mi aplicación está almacenada en Amazon S3 y, a continuación, en Ubicación de la revisión, escriba la ubicación de la revisión de la aplicación de ejemplo Hello, World! que cargó previamente en Amazon S3. Para obtener la ubicación:

    1. Abra la consola de Amazon S3 en https://console.aws.amazon.com/s3.

    2. En la lista de buckets, elija amzn-s3-demo-bucket (o el nombre del bucket en el que cargó la revisión de la aplicación).

    3. En la lista de objetos, elija HelloWorld_App.zip.

    4. En la pestaña Overview (Información general), elija Copy path (Ruta de copia).

    5. Vuelva a la consola de CodeDeploy y, en Ubicación de la revisión, pegue el valor del campo Enlace.

  19. En Revision file type (Tipo de archivo de revisión), elija .zip.

  20. (Opcional) Escriba un comentario en Deployment description (Descripción de implementación).

  21. Elija Crear implementación. En la página Deployments se mostrará información sobre la implementación que acaba de crear.

Monitorización y solución de problemas de la implementación

Utilice la AWS CLI o la consola para monitorizar y resolver problemas de la implementación.

Para monitorizar y solucionar problemas en la implementación (CLI)

  1. Obtenga el ID de la implementación; para ello, ejecute el comando list-deployments para la aplicación HelloWorld_App y el grupo de implementaciones HelloWorld_DepGroup:

    aws deploy list-deployments --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --query "deployments" --output text

  2. Llame al comando get-deployment con el ID de la implementación:

    aws deploy get-deployment --deployment-id deploymentID --query "deploymentInfo.status" --output text

  3. El comando devuelve el estado general de la implementación. Si todo sale bien, el valor es Succeeded.

    Si el estado general es Failed, puede llamar a comandos como list-deployment-instances y get-deployment-instance para solucionar los problemas. Si desea conocer más opciones de solución de problemas, consulte Análisis de archivos de registro para investigar los errores de implementación en instancias.

Para monitorizar y resolver problemas de la implementación (consola)

En la página Implementaciones de la consola de CodeDeploy puede monitorizar el estado de la implementación en la columna Estado.

Para obtener más información acerca de la implementación, sobre todo si el valor de la columna Status tiene un valor distinto de Succeeded:

  1. En la tabla Deployments (Implementaciones), elija el ID de implementación. Cuando se produce un error en una implementación, aparece un mensaje que describe el motivo del error en la página de detalles de la implementación.

  2. Aparece más información sobre las instancias de la implementación. Cuando se una implementación falla, es posible que pueda determinar las instancias de Amazon EC2 afectadas y el paso del proceso en el que se ha producido el error.

  3. Si desea realizar más resolución de problemas, puede utilizar una técnica como View Instance Details. También puede analizar los archivos de registro de la implementación en una instancia de Amazon EC2. Para obtener más información, consulte Análisis de archivos de registro para investigar los errores de implementación en instancias.

Comprobación de la implementación

Después que la implementación se realiza correctamente, verifique que funciona la instalación. Utilice la dirección de DNS público de la instancia de Amazon EC2 para ver la página web en un navegador web. (Para obtener el valor de DNS público, en la consola de Amazon EC2, seleccione la instancia de Amazon EC2 y, en la pestaña Descripción, busque el valor Public DNS).

Por ejemplo, si la dirección DNS pública de la instancia de Amazon EC2 es ec2-01-234-567-890.compute-1.amazonaws.com, se usará la siguiente dirección URL:

http://ec2-01-234-567-890.compute-1.amazonaws.com

Si la operación se realiza correctamente, debería ver una página web Hello, World!.