Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Cree una implementación con CodeDeploy Puede utilizar la CodeDeploy consola, las API o las CodeDeploy API para crear una implementación que instale las revisiones de aplicaciones que ya haya enviado a Amazon S3 o, si la implementación se realiza en una plataforma informática local de EC2 GitHub, en las instancias de un grupo de implementaciones. AWS CLI El proceso para crear una implementación depende de la plataforma de informática usada en la implementación. **Topics** + [Requisitos previos para una implementación](deployments-create-prerequisites.md) + [Creación de una implementación en una plataforma de informática de Amazon ECS (consola)](deployments-create-console-ecs.md) + [Crear una implementación de AWS Lambda Compute Platform (consola)](deployments-create-console-lambda.md) + [Creación de una implementación en una plataforma de informática de EC2/en las instalaciones (consola)](deployments-create-console.md) + [Creación de una implementación en una plataforma de informática de Amazon ECS (CLI)](deployments-create-ecs-cli.md) + [Crear una implementación de AWS Lambda Compute Platform (CLI)](deployments-create-lambda-cli.md) + [Creación de una implementación en una plataforma de informática EC2/en las instalaciones (CLI)](deployments-create-cli.md) + [Cree una blue/green implementación de Amazon ECS mediante CloudFormation](deployments-create-ecs-cfn.md) # Requisitos previos para una implementación Asegúrese de seguir estos pasos antes de iniciar una implementación. ## Requisitos previos de implementación en una plataforma informática AWS Lambda + Cree una aplicación que incluya al menos un grupo de implementación. Para obtener más información, consulte [Cree una aplicación con CodeDeploy](applications-create.md) y [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). + Prepare la revisión de la aplicación, también conocida como AppSpec archivo, que especifica la versión de la función Lambda que desea implementar. El AppSpec archivo también puede especificar las funciones de Lambda para validar la implementación. Para obtener más información, consulte [Trabajar con revisiones de aplicaciones para CodeDeploy](application-revisions.md). + Si desea utilizar una configuración de implementación personalizada para su implementación, créela antes de iniciar el proceso de implementación. Para obtener información, consulte [Cree una configuración de despliegue con CodeDeploy](deployment-configurations-create.md). ## Requisitos previos para una implementación en una plataforma de informática EC2/en las instalaciones + Si se trata de una implementación "in-place", cree o configure las instancias en las que desea realizar la implementación. Para obtener información, consulte [Trabajar con instancias para CodeDeploy](instances.md). Para una blue/green implementación, tiene un grupo de Amazon EC2 Auto Scaling existente para usarlo como plantilla para su entorno de reemplazo, o bien tiene una o más instancias o grupos de Amazon EC2 Auto Scaling que especifique como su entorno original. Para obtener más información, consulte [Tutorial: Se usa CodeDeploy para implementar una aplicación en un grupo de Auto Scaling](tutorials-auto-scaling-group.md) y [Integración CodeDeploy con Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md). + Cree una aplicación que incluya al menos un grupo de implementación. Para obtener más información, consulte [Cree una aplicación con CodeDeploy](applications-create.md) y [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). + Prepare la revisión de la aplicación que desea implementar en las instancias del grupo de implementaciones. Para obtener información, consulte [Trabajar con revisiones de aplicaciones para CodeDeploy](application-revisions.md). + Si desea utilizar una configuración de implementación personalizada para su implementación, créela antes de iniciar el proceso de implementación. Para obtener información, consulte [Cree una configuración de despliegue con CodeDeploy](deployment-configurations-create.md). + Si está implementando la revisión de la aplicación desde un bucket de Amazon S3, el bucket se encuentra en la misma AWS región que las instancias de su grupo de implementación. + Si está implementando la revisión de la aplicación desde un bucket de Amazon S3, debe haberse aplicado al bucket una política de bucket Amazon S3. Esta política concede a las instancias los permisos necesarios para descargar la revisión de la aplicación. Por ejemplo, la siguiente política de bucket de Amazon S3 permite a cualquier instancia de Amazon EC2 asociada a un perfil de instancia de IAM que contenga el ARN `arn:aws:iam::444455556666:role/CodeDeployDemo` descargar desde cualquier lugar al bucket de Amazon S3 llamado `amzn-s3-demo-bucket`: ``` { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:role/CodeDeployDemo" ] } } ] } ``` La siguiente política de bucket de Amazon S3 permite a cualquier instancia en las instalaciones con un usuario de IAM asociado que contenga el ARN `arn:aws:iam::444455556666:user/CodeDeployUser` descargar desde cualquier lugar al bucket de Amazon S3 denominado `amzn-s3-demo-bucket`: ``` { "Statement": [ { "Action": [ "s3:Get*", "s3:List*" ], "Effect": "Allow", "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Principal": { "AWS": [ "arn:aws:iam::444455556666:user/CodeDeployUser" ] } } ] } ``` Para obtener información acerca de cómo generar y adjuntar una política de bucket de Amazon S3, consulte [Ejemplos de política de bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html). + Si va a crear una blue/green implementación o ha especificado un Classic Load Balancer, Application Load Balancer o Network Load Balancer opcionales en el grupo de implementaciones para una implementación local, ha creado una VPC mediante Amazon VPC que contiene al menos dos subredes. (CodeDeploy usa Elastic Load Balancing, que requiere que todas las instancias de un grupo de balanceadores de carga estén en una sola VPC). Si aún no ha creado una VPC, consulte la [Guía de introducción a Amazon VPC](https://docs.aws.amazon.com/AmazonVPC/latest/GettingStartedGuide/ExerciseOverview.html). + Si va a crear una blue/green implementación, ha configurado al menos un Classic Load Balancer, Application Load Balancer o Network Load Balancer en Elastic Load Balancing y lo ha utilizado para registrar las instancias que componen el entorno original. **nota** Las instancias del entorno de sustitución se registrarán con el equilibrador de carga en otro momento. Para obtener más información sobre la configuración de un equilibrador de carga, consulte [Configurar un balanceador de carga en Elastic Load Balancing para las implementaciones de CodeDeploy Amazon EC2](deployment-groups-create-load-balancer.md) y [Configure un balanceador de carga, grupos objetivo y agentes de escucha para las implementaciones de CodeDeploy Amazon ECS](deployment-groups-create-load-balancer-for-ecs.md). ## Requisitos previos de despliegue para un despliegue a través de blue/green CloudFormation + La plantilla no necesita modelar los recursos para una CodeDeploy aplicación o un grupo de implementación. + La plantilla debe incluir recursos para una VPC usando Amazon VPC que contenga al menos dos subredes. + La plantilla debe incluir recursos para uno o más equilibradores de carga clásicos, equilibradores de carga de aplicación o equilibradores de carga de red en Elastic Load Balancing que se utilizan para dirigir el tráfico a sus grupos objetivo. # Creación de una implementación en una plataforma de informática de Amazon ECS (consola) En este tema se muestra cómo implementar un servicio de Amazon ECS mediante la consola. Para obtener más información, consulte [Tutorial: Implementación de una aplicación en Amazon ECS](tutorial-ecs-deployment.md) y [Tutorial: Implementación de un servicio de Amazon ECS con una prueba de validación](tutorial-ecs-deployment-with-hooks.md). 1. Inicie sesión en Consola de administración de AWS y abra la CodeDeploy consola en [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy) **nota** Inicie sesión con el mismo usuario que configuró en [Empezar con CodeDeploy](getting-started-codedeploy.md). 1. Realice una de las siguientes acciones: + Si desea implementar una aplicación, en el panel de navegación, expanda **Deploy (Implementar)** y, a continuación, elija **Applications (Aplicaciones)**. Elija el nombre de la aplicación que desea implementar. Asegúrese de que la columna **Plataforma de informática** de la aplicación sea **Amazon ECS**. + Si desea volver a implementar una implementación, en el panel de navegación, expanda **Implementar** y, a continuación, elija **Implementaciones**. Seleccione la implementación que desea volver a implementar y, en la columna **Application (Aplicación)**, elija el nombre de su aplicación. Asegúrese de que la columna **Plataforma de informática** de la implementación sea **Amazon ECS**. 1. En la pestaña **Implementaciones**, elija **Crear implementación**. **nota** La aplicación debe tener un grupo de implementación antes de poder implementarse. Si la aplicación no tiene un grupo de implementación, en la pestaña **Grupos de implementación**, elija **Crear grupo de implementación**. Para obtener más información, consulte [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). 1. En **Grupo de implementación**, elija el grupo de implementación que va a utilizar para esta implementación. 1. Junto a **Ubicación de la revisión**, elija el lugar donde se encuentra la revisión: + **Mi aplicación está almacenada en Amazon S3**: para obtener información, consulte [Especificar información acerca de una revisión almacenada en un bucket de Amazon S3](deployments-create-console-s3.md) y vuelva al paso 6. + **Utilizar el AppSpec editor**: selecciona JSON o YAML y, a continuación, introduce el AppSpec archivo en el editor. Para guardar el AppSpec archivo, selecciona **Guardar como archivo de texto**. Cuando elija **Implementar** al final de estos pasos, recibirá un error si el código JSON o YAML no es válido. Para obtener más información sobre la creación de un AppSpec archivo, consulte[Añadir un archivo de especificaciones de la aplicación a una revisión de CodeDeploy](application-revisions-appspec-file.md). 1. (Opcional) En el cuadro **Descripción de la implementación**, introduzca una descripción para la implementación. 1. (Opcional) En **Rollback configuration overrides**, puede especificar opciones de restauración automática de esta implementación distintas de las que se hayan especificado para el grupo de implementaciones, si las hay. Para obtener información sobre las reversiones CodeDeploy, consulte [Reimplementaciones y restauración de implementaciones](deployment-steps-lambda.md#deployment-rollback-lambda) y[Vuelva a implementar y revertir una implementación con CodeDeploy](deployments-rollback-and-redeploy.md). Elija una de las siguientes opciones: + Se **revierte cuando se produce un error en una implementación CodeDeploy: se vuelve a implementar** la última revisión válida conocida como una implementación nueva. + ** CodeDeploy Retirar cuando se alcanzan los umbrales de alarma: si se** agregaron alarmas al grupo de implementación, vuelve a implementar la última revisión válida conocida cuando se activan una o más de las alarmas especificadas. + **Deshabilitar restauraciones**: no se realizan restauraciones de esta implementación. 1. Elija **Crear implementación**. Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). # Crear una implementación de AWS Lambda Compute Platform (consola) En este tema se muestra cómo implementar una función de Lambda mediante la consola. 1. Inicie sesión Consola de administración de AWS y abra la CodeDeploy consola en [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy) **nota** Inicie sesión con el mismo usuario que configuró en [Empezar con CodeDeploy](getting-started-codedeploy.md). 1. Realice una de las siguientes acciones: + Si desea implementar una aplicación, en el panel de navegación, expanda **Deploy (Implementar)** y, a continuación, elija **Applications (Aplicaciones)**. Elija el nombre de la aplicación que desea implementar. Asegúrese de que la columna **Plataforma de informática** de la aplicación sea **AWS Lambda**. + Si desea volver a implementar una implementación, en el panel de navegación, expanda **Implementar** y, a continuación, elija **Implementaciones**. Seleccione la implementación que desea volver a implementar y, en la columna **Application (Aplicación)**, elija el nombre de su aplicación. Asegúrese de que la columna **Plataforma de informática** de la implementación sea **AWS Lambda**. 1. En la pestaña **Implementaciones**, elija **Crear implementación**. **nota** La aplicación debe tener un grupo de implementación antes de poder implementarse. Si la aplicación no tiene un grupo de implementación, en la pestaña **Grupos de implementación**, elija **Crear grupo de implementación**. Para obtener más información, consulte [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). 1. En **Grupo de implementación**, elija el grupo de implementación que va a utilizar para esta implementación. 1. Junto a **Ubicación de la revisión**, elija el lugar donde se encuentra la revisión: + **Mi aplicación está almacenada en Amazon S3**: para obtener información, consulte [Especificar información acerca de una revisión almacenada en un bucket de Amazon S3](deployments-create-console-s3.md) y vuelva al paso 6. + **Utilizar el AppSpec editor**: selecciona JSON o YAML y, a continuación, introduce el AppSpec archivo en el editor. Para guardar el AppSpec archivo, selecciona **Guardar como archivo de texto**. Cuando elija **Implementar** al final de estos pasos, recibirá un error si el código JSON o YAML no es válido. Para obtener más información sobre la creación de un AppSpec archivo, consulte[Añadir un archivo de especificaciones de la aplicación a una revisión de CodeDeploy](application-revisions-appspec-file.md). 1. (Opcional) En el cuadro **Descripción de la implementación**, introduzca una descripción para la implementación. 1. (Opcional) Expanda **Anulaciones del grupo de implementación** para elegir una configuración de implementación que controle cómo se desvía el tráfico a una versión de la función de Lambda distinta de la que se especifica en el grupo de implementación. Para obtener más información, consulte [Configuraciones de implementación en una plataforma AWS Lambda informática](deployment-configurations.md#deployment-configuration-lambda). 1. (Opcional) En **Rollback configuration overrides**, puede especificar opciones de restauración automática de esta implementación distintas de las que se hayan especificado para el grupo de implementaciones, si las hay. Para obtener información sobre las reversiones CodeDeploy, consulte [Reimplementaciones y restauración de implementaciones](deployment-steps-lambda.md#deployment-rollback-lambda) y[Vuelva a implementar y revertir una implementación con CodeDeploy](deployments-rollback-and-redeploy.md). Elija una de las siguientes opciones: + Se **revierte cuando se produce un error en una implementación CodeDeploy: se vuelve a implementar** la última revisión válida conocida como una implementación nueva. + ** CodeDeploy Retirar cuando se alcanzan los umbrales de alarma: si se** agregaron alarmas al grupo de implementación, vuelve a implementar la última revisión válida conocida cuando se activan una o más de las alarmas especificadas. + **Deshabilitar restauraciones**: no se realizan restauraciones de esta implementación. 1. Elija **Crear implementación**. Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). # Creación de una implementación en una plataforma de informática de EC2/en las instalaciones (consola) En este tema se muestra cómo implementar una aplicación un servidor Amazon EC2 o en las instalaciones mediante la consola. 1. [Inicie sesión en la CodeDeploy consola Consola de administración de AWS y ábrala en /codedeploy. https://console.aws.amazon.com](https://console.aws.amazon.com/codedeploy) **nota** Inicie sesión con el mismo usuario que configuró en [Empezar con CodeDeploy](getting-started-codedeploy.md). 1. Realice una de las siguientes acciones: + Si desea implementar una aplicación, en el panel de navegación, expanda **Deploy (Implementar)** y, a continuación, elija **Applications (Aplicaciones)**. Elija el nombre de la aplicación que desea implementar. Asegúrese de que la columna **Plataforma de informática** de la aplicación sea **EC2/en las instalaciones**. + Si desea volver a implementar una implementación, en el panel de navegación, expanda **Implementar** y, a continuación, elija **Implementaciones**. Localice la implementación que desea volver a implementar y, a continuación, elija el nombre de su aplicación en la columna **Application (Aplicación)**. Asegúrese de que la columna **Plataforma de informática** de la implementación sea **EC2/en las instalaciones**. 1. En la pestaña **Implementaciones**, elija **Crear implementación**. **nota** La aplicación debe tener un grupo de implementación antes de poder implementarse. Si la aplicación no tiene un grupo de implementación, en la pestaña **Grupos de implementación**, elija **Crear grupo de implementación**. Para obtener más información, consulte [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). 1. En **Grupo de implementación**, elija el grupo de implementación que va a utilizar para esta implementación. 1. Junto a **Repository type (Tipo de repositorio)**, seleccione el tipo de repositorio en el que está almacenada la revisión: + **Mi aplicación está almacenada en Amazon S3**: para obtener información, consulte [Especificar información acerca de una revisión almacenada en un bucket de Amazon S3](deployments-create-console-s3.md) y vuelva al paso 6. + **Mi aplicación está guardada en GitHub**: para obtener más información, consulte y[Especifique la información sobre una revisión almacenada en un GitHub repositorio](deployments-create-console-github.md), a continuación, vuelva al paso 6. 1. (Opcional) En el cuadro **Descripción de la implementación**, introduzca una descripción para la implementación. 1. (Opcional) Expanda **Anular la configuración de la implementación** para elegir una configuración de implementación que controle cómo se desvía el tráfico al servidor de Amazon EC2, o a uno en las instalaciones, distinto del que se especifica en el grupo de implementación. Para obtener más información, consulte [Trabajar con configuraciones de implementación en CodeDeploy](deployment-configurations.md). 1. 1. Seleccione **No fallar la implementación si el evento del ApplicationStop ciclo de vida falla** si desea que la implementación en una instancia se realice correctamente si el evento del `ApplicationStop` ciclo de vida falla. 1. Amplíe la **configuración adicional del comportamiento de despliegue** para especificar CodeDeploy cómo se gestionan los archivos en una ubicación de destino de despliegue que no formaban parte de la anterior implementación exitosa. Elija una de las siguientes opciones: + **Dar como errónea la implementación**: se notifica un error y el estado de la implementación cambia a `Failed`. + **Sobrescribir el contenido**: si hay un archivo del mismo nombre en la ubicación de destino, la versión de la revisión de la aplicación lo sustituye. + **Retener el contenido**: si hay un archivo del mismo nombre en la ubicación de destino, este se conserva y la versión de la revisión de la aplicación no se copia en la instancia. Para obtener más información, consulte [Comportamiento de la restauración con contenido existente](deployments-rollback-and-redeploy.md#deployments-rollback-and-redeploy-content-options). 1. (Opcional) En **Rollback configuration overrides**, puede especificar opciones de restauración automática de esta implementación distintas de las que se hayan especificado para el grupo de implementaciones, si las hay. Para obtener información sobre las reversiones CodeDeploy, consulte [Reimplementaciones y restauración de implementaciones](deployment-steps-server.md#deployment-rollback) y[Vuelva a implementar y revertir una implementación con CodeDeploy](deployments-rollback-and-redeploy.md). Elija una de las siguientes opciones: + Se **revierte cuando se produce un error en una implementación CodeDeploy: se vuelve a implementar** la última revisión válida conocida como una implementación nueva. + **Retirar cuando se alcanzan los umbrales de alarma**: si se agregaron alarmas al grupo de implementación, CodeDeploy implementa la última revisión válida conocida cuando se activan una o más de las alarmas especificadas. + **Deshabilitar restauraciones**: no se realizan restauraciones de esta implementación. 1. Elija **Iniciar la implementación**. Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). **Topics** + [Especificar información acerca de una revisión almacenada en un bucket de Amazon S3](deployments-create-console-s3.md) + [Especifique la información sobre una revisión almacenada en un GitHub repositorio](deployments-create-console-github.md) # Especificar información acerca de una revisión almacenada en un bucket de Amazon S3 Si está siguiendo los pasos descritos en [Creación de una implementación en una plataforma de informática de EC2/en las instalaciones (consola)](deployments-create-console.md), siga estos también para añadir detalles acerca de una revisión de la aplicación almacenada en un bucket de Amazon S3. 1. Copie el enlace de Amazon S3 de la revisión en el cuadro **Ubicación de la revisión**. Para encontrar el valor del enlace: 1. En una pestaña diferente del navegador: Inicie sesión en la consola de Amazon S3 Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). Busque y seleccione la revisión. 1. Si el panel **Properties** no está visible, elija el botón **Properties**. 1. En el panel de **propiedades**, copie el valor del campo **Enlace** en el cuadro **Ubicación de la revisión** de la CodeDeploy consola. Para especificar una ETag (suma de comprobación de archivos) como parte de la ubicación de la revisión: + Si el valor del campo de **enlace** termina en**?versionId=*versionId***, añada **&etag=** y ETag al final del valor del campo de **enlace**. + Si el valor del campo de **enlace** no especifica un identificador de versión, añada **?etag=** y el ETag valor al final del campo de **enlace**. **nota** Aunque no es tan fácil como copiar el valor del campo **Link**, también puede escribir la ubicación de la revisión en uno de los siguientes formatos: **s3://*bucket-name*/*folders*/*objectName*** **s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*** **s3://*bucket-name*/*folders*/*objectName*?etag=*etag*** **s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*&etag=*etag*** ***bucket-name*.s3.amazonaws.com/*folders*/*objectName*** 1. Si aparece un mensaje en la lista **File type** que indique que no se ha podido detectar el tipo de archivo, seleccione el tipo de archivo de la revisión. En caso contrario, acepte el tipo de archivo detectado. # Especifique la información sobre una revisión almacenada en un GitHub repositorio Si sigue los pasos descritos[Creación de una implementación en una plataforma de informática de EC2/en las instalaciones (consola)](deployments-create-console.md), siga estos pasos para añadir detalles sobre una revisión de la aplicación almacenada en un GitHub repositorio. 1. En **Conectarse a GitHub**, realice una de las siguientes acciones: + Para crear una conexión de CodeDeploy aplicaciones a una GitHub cuenta, cierre sesión en otra pestaña del navegador web GitHub. En la **GitHub cuenta**, introduce un nombre para identificar esta conexión y, a continuación, selecciona **Conectar a GitHub**. La página web le pide que autorice CodeDeploy la interacción con GitHub su aplicación. Continúe en el paso 2. + Para usar una conexión que ya haya creado, en la **GitHubcuenta**, seleccione su nombre y, a continuación, elija **Conectar a GitHub**. Continúe en el paso 4. + Para crear una conexión a otra GitHub cuenta, cierra sesión en otra pestaña del navegador web GitHub. Selecciona **Conectarse a una GitHub cuenta diferente** y, a continuación, selecciona **Conectar a GitHub**. Continúe en el paso 2. 1. Si se te pide que inicies sesión GitHub, sigue las instrucciones de la página de inicio de **sesión**. Inicie sesión con su nombre GitHub de usuario o correo electrónico y contraseña. 1. Si aparece la página **Authorize application**, elija **Authorize application**. 1. En la página **Crear despliegue**, en el cuadro **Nombre del repositorio**, introduzca el nombre del GitHub usuario o la organización que contiene la revisión, seguido de una barra diagonal (`/`) seguida del nombre del repositorio que contiene la revisión. Si no está seguro del valor que debe especificar: 1. En otra pestaña del navegador web, ve a tu [GitHubpanel](https://github.com/dashboard) de control. 1. En **Your repositories**, pase el cursor sobre el nombre del repositorio de destino. Aparece una descripción emergente en la que se muestra el nombre del GitHub usuario o la organización, seguido de una barra diagonal (`/`) seguida del nombre del repositorio. Escriba el valor mostrado en el cuadro **Repository name** (Nombre de repositorio). **nota** Si el nombre del repositorio de destino no está visible en **Tus repositorios**, usa el GitHub cuadro de **búsqueda para buscar** el nombre del repositorio de destino y el nombre del GitHub usuario u organización. 1. En el campo **Commit ID** (ID de confirmación), escriba el ID de la confirmación que hace referencia a la revisión en el repositorio. Si no está seguro del valor que debe especificar: 1. En otra pestaña del navegador web, ve a tu [GitHubpanel](https://github.com/dashboard) de control. 1. En **Your repositories**, seleccione el nombre del repositorio que contiene la confirmación de destino. 1. En la lista de confirmaciones, busque y copie el ID de confirmación que hace referencia a la revisión en el repositorio. Este ID suele tener 40 caracteres y se compone de letras y números. No utilice la versión corta del ID de confirmación, que suele ser los primeros 10 caracteres de la versión larga. 1. Pegue el ID de confirmación en el cuadro **Commit ID**. # Creación de una implementación en una plataforma de informática de Amazon ECS (CLI) Una vez creada la aplicación y la revisión (en las implementaciones de Amazon ECS, este es el AppSpec archivo): Llame al comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) especificando lo siguiente: + Un nombre de aplicación. Para ver una lista de nombres de aplicaciones, llame al comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + El nombre del grupo de implementaciones. Para ver una lista de los nombres de los grupos de implementaciones, llame al comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + Información acerca de la revisión a implementar: Para revisiones almacenadas en Amazon S3: + Nombre del bucket de Amazon S3 que contiene la revisión. + El nombre de la revisión cargada. + (Opcional) El identificador de versión de Amazon S3 de la revisión. (Si no se especifica el identificador de la versión, CodeDeploy utiliza la versión más reciente). + (Opcional) El ETag de la revisión. (Si no ETag se especifica, CodeDeploy omite la validación del objeto). Para las revisiones almacenadas en un archivo que no está en Amazon S3, necesita el nombre de archivo y su ruta. El archivo de revisión está escrito en JSON o YAML, por lo que probablemente tenga una extensión .json o .yaml. + Una descripción para la implementación (opcional). El archivo de revisión se puede especificar como un archivo cargado en un bucket de Amazon S3 o como una cadena. La sintaxis de cada uno cuando se usa como parte del comando **create-deployment** es: + Bucket de Amazon S3: Los parámetros `version` y `eTag` son opcionales. ``` --s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string ``` + Cadena: ``` --revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}' ``` **nota** El comando **create-deployment** puede cargar una revisión desde un archivo. Para obtener más información, consulte [Carga de parámetros desde un archivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file). Para ver las plantillas de revisión de AWS Lambda despliegue, consulte[Agregar un AppSpec archivo para una implementación de AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Para ver una revisión de ejemplo, consulte [AppSpec Ejemplo de archivo para una implementación de AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda). Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). # Crear una implementación de AWS Lambda Compute Platform (CLI) Una vez que haya creado la aplicación y la revisión (en las implementaciones de AWS Lambda, este es el AppSpec archivo): Llame al comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) especificando lo siguiente: + Un nombre de aplicación. Para ver una lista de nombres de aplicaciones, llame al comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + El nombre del grupo de implementaciones. Para ver una lista de los nombres de los grupos de implementaciones, llame al comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + Información acerca de la revisión a implementar: Para revisiones almacenadas en Amazon S3: + Nombre del bucket de Amazon S3 que contiene la revisión. + El nombre de la revisión cargada. + (Opcional) El identificador de versión de Amazon S3 de la revisión. (Si no se especifica el identificador de la versión, CodeDeploy utiliza la versión más reciente). + (Opcional) El ETag de la revisión. (Si no ETag se especifica, CodeDeploy omite la validación del objeto). Para las revisiones almacenadas en un archivo que no está en Amazon S3, necesita el nombre de archivo y su ruta. El archivo de revisión está escrito en JSON o YAML, por lo que probablemente tenga una extensión .json o .yaml. + El nombre de la configuración de implementación a utilizar (opcional). Para ver una lista de las configuraciones de implementación, realice una llamada al comando [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Si no se especifica, CodeDeploy utiliza una configuración de despliegue predeterminada específica). + Una descripción para la implementación (opcional). El archivo de revisión se puede especificar como un archivo cargado en un bucket de Amazon S3 o como una cadena. La sintaxis de cada uno cuando se usa como parte del comando **create-deployment** es: + Bucket de Amazon S3: Los parámetros `version` y `eTag` son opcionales. ``` --s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string ``` + Cadena: ``` --revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}' ``` **nota** El comando **create-deployment** puede cargar una revisión desde un archivo. Para obtener más información, consulte [Carga de parámetros desde un archivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file). Para ver las plantillas de revisión de AWS Lambda despliegue, consulte[Agregar un AppSpec archivo para una implementación de AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Para ver una revisión de ejemplo, consulte [AppSpec Ejemplo de archivo para una implementación de AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda). Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). # Creación de una implementación en una plataforma de informática EC2/en las instalaciones (CLI) Para usar el AWS CLI para implementar una revisión en la plataforma informática local de EC2: 1. Una vez preparadas las instancias, creada la aplicación y enviada la revisión, realice alguna de las siguientes acciones: + Si desea implementar una revisión de un bucket de Amazon S3, continúe con el paso 2. + Si desea implementar una revisión desde un GitHub repositorio, primero complete los pasos del paso 2 y, a continuación[Conectar una CodeDeploy aplicación a un GitHub repositorio](deployments-create-cli-github.md), continúe con el paso 2. 1. Llame al comando [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) especificando lo siguiente: + `--application-name`: un nombre de aplicación. Para ver una lista de nombres de aplicaciones, llame al comando [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html). + `--deployment-group-name`: un nombre de grupo de implementación de Amazon EC2. Para ver una lista de los nombres de los grupos de implementaciones, llame al comando [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html). + `--revision`: información acerca de la revisión a implementar: Para revisiones almacenadas en Amazon S3: + `s3Location`: nombre del bucket de Amazon S3 que contiene la revisión. + `s3Location --> key`: nombre de la revisión cargada. + `s3Location --> bundleType`: nombre y tipo de archivo de la revisión cargada. **nota** Los formatos de archivo tar y tar comprimido (.tar y .tar.gz) no son compatibles con las instancias de Windows Server. + `s3Location --> version`: (Opcional) El identificador de versión de Amazon S3 de la revisión. (Si no se especifica el identificador de versión, CodeDeploy utiliza la versión más reciente). + `s3Location --> eTag`: (Opcional) El ETag para la revisión. (Si no ETag se especifica, CodeDeploy omite la validación del objeto). Para las revisiones almacenadas en GitHub: + `gitHubLocation --> repository`: el nombre de GitHub usuario o grupo asignado al repositorio que contiene la revisión, seguido de una barra diagonal (`/`) seguida del nombre del repositorio. + `gitHubLocation --> commitId`: ID de confirmación de la revisión. + `--deployment-config-name`: (Opcional) El nombre de la configuración de implementación a utilizar. Para ver una lista de las configuraciones de implementación, realice una llamada al comando [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Si no se especifica, CodeDeploy utiliza una configuración de despliegue predeterminada específica). + `--ignore-application-stop-failures | --no-ignore-application-stop-failures`: si desea que la implementación en una instancia continúe y pase al evento del ciclo de vida `BeforeInstall` en caso de que se produzca un error en el evento del ciclo de vida de la implementación `ApplicationStop` (opcional). + `--description`: una descripción para la implementación (opcional). + `--file-exists-behavior`: (Opcional) Como parte del proceso de implementación, el CodeDeploy agente elimina de cada instancia todos los archivos instalados en la implementación más reciente. Elija qué ocurre cuando los archivos que no formaban parte de una implementación anterior aparecen en las ubicaciones de implementación de destino. + `--target-instances`: Para blue/green las implementaciones, información sobre las instancias que pertenecen al entorno de reemplazo de una blue/green implementación, incluidos los nombres de uno o más grupos de Amazon EC2 Auto Scaling o la clave, el tipo y el valor del filtro de etiquetas utilizados para identificar las instancias de Amazon EC2. **nota** Utilice esta sintaxis como parte de la llamada a **create-deployment** para especificar información sobre una revisión en Amazon S3 directamente en la línea de comandos. Los parámetros `version` y `eTag` son opcionales. ``` --s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string ``` Utilice esta sintaxis como parte de la **create-deployment** llamada para especificar la información sobre una revisión GitHub directamente en la línea de comandos: ``` --github-location repository=string,commitId=string ``` Para obtener información acerca de las revisiones que se han transferido, realice una llamada al comando [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html). Para realizar un seguimiento del estado de la implementación, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). ## referencia del comando create-deployment A continuación se muestran la estructura y las opciones del comando `create-deployment`. Para obtener más información, consulte la referencia de [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) en la *Referencia del comando AWS CLI *. ``` create-deployment --application-name [--deployment-group-name ] [--revision ] [--deployment-config-name ] [--description ] [--ignore-application-stop-failures | --no-ignore-application-stop-failures] [--target-instances ] [--auto-rollback-configuration ] [--update-outdated-instances-only | --no-update-outdated-instances-only] [--file-exists-behavior ] [--s3-location ] [--github-location ] [--cli-input-json ] [--generate-cli-skeleton ] ``` # Conectar una CodeDeploy aplicación a un GitHub repositorio Antes de poder implementar una aplicación desde un GitHub repositorio por primera vez utilizando el AWS CLI, primero debes dar CodeDeploy permiso para interactuar con ella GitHub en nombre de tu GitHub cuenta. Este paso debe completarse una vez para cada aplicación que utilice la CodeDeploy consola. 1. Inicie sesión en la CodeDeploy consola Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy) **nota** Inicie sesión con el mismo usuario que configuró en [Empezar con CodeDeploy](getting-started-codedeploy.md). 1. Elija **Aplicaciones**. 1. En **Aplicaciones**, elija la aplicación que desee vincular a su cuenta de GitHub usuario y elija **Implementar** aplicación. **nota** No está creando una implementación. Actualmente, esta es la única forma de conceder CodeDeploy permiso para interactuar con ella GitHub en nombre de su cuenta de GitHub usuario. 1. Junto a **Tipo de repositorio**, selecciona **En qué se guarda la revisión de mi aplicación GitHub**. 1. Selecciona **Conectar a GitHub**. **nota** Si ves un enlace de **Conectarse a una GitHub cuenta diferente**: Es posible que ya tengas autorización CodeDeploy para interactuar GitHub en nombre de otra GitHub cuenta de la aplicación. Es posible que hayas revocado la autorización CodeDeploy para interactuar GitHub en nombre de la GitHub cuenta en la que has iniciado sesión en todas las aplicaciones vinculadas a ella. CodeDeploy Para obtener más información, consulte [GitHub autenticación con aplicaciones en CodeDeploy](integrations-partners-github.md#behaviors-authentication). 1. **Si aún no ha iniciado sesión GitHub, siga las instrucciones de la página de inicio de sesión.** 1. En la página **Authorize application**, elija **Authorize application**. 1. Ahora CodeDeploy que tienes permiso, selecciona **Cancelar** y continúa con los pasos indicados[Creación de una implementación en una plataforma de informática EC2/en las instalaciones (CLI)](deployments-create-cli.md). # Cree una blue/green implementación de Amazon ECS mediante CloudFormation Puede utilizarlo AWS CloudFormation para gestionar las blue/green implementaciones de Amazon ECS a través CodeDeploy de. Para generar la implementación, defina los recursos verdes y azules y especifique la configuración de enrutamiento y estabilización del tráfico que se va a utilizar en CloudFormation. En este tema se describen las diferencias entre las blue/green implementaciones de Amazon ECS gestionadas por CodeDeploy y las gestionadas por. CloudFormation *Para step-by-step obtener instrucciones sobre cómo administrar las implementaciones azul/verde de Amazon ECS, consulte [Automatizar las implementaciones azul/verde de ECS mediante CodeDeploy el uso CloudFormation en la Guía del usuario](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html). AWS CloudFormationAWS CloudFormation * **nota** La administración de blue/green las implementaciones de Amazon ECS con no CloudFormation está disponible en la región de Asia Pacífico (Osaka). ## Diferencias entre las blue/green implementaciones de Amazon ECS hasta CodeDeploy y CloudFormation La plantilla de CloudFormation pila modela los recursos y la infraestructura relacionados con las tareas de Amazon ECS, así como las opciones de configuración para las implementaciones. Por lo tanto, existen diferencias entre las implementaciones estándar de Amazon ECS y blue/green las blue/green implementaciones que se crean mediante ellas. CloudFormation A diferencia de blue/green las implementaciones estándar de Amazon ECS, no se modela ni se crea manualmente lo siguiente: + No se crea una AWS CodeDeploy aplicación especificando un nombre que represente de forma exclusiva lo que se quiere implementar. + No se crea un grupo AWS CodeDeploy de implementación. + No se especifica un archivo de *especificaciones de la aplicación (AppSpec archivo*). La información que normalmente se gestiona con el AppSpec archivo, como las opciones de configuración ponderadas o los eventos del ciclo de vida, se gestiona mediante un `AWS::CodeDeploy::BlueGreen` enlace. En esta tabla se resumen las diferencias en el flujo de trabajo de alto nivel entre los tipos de implementación. **** | Función | blue/green Implementaciones estándar | Implementaciones azul/verdes hasta CloudFormation | | --- | --- | --- | | Especifique el clúster de Amazon ECS, el servicio Amazon ECS, el Equilibrador de carga de aplicación o el Equilibrador de carga de red, el Oyente de producción, el oyente de prueba y los dos grupos de destino. | Cree un grupo de CodeDeploy despliegue que especifique estos recursos. | Cree una CloudFormation plantilla para modelar estos recursos. | | Especifique el cambio que se va a implementar. | Cree una CodeDeploy aplicación. | Cree una CloudFormation plantilla que especifique la imagen del contenedor. | | Especifique la definición de tarea de Amazon ECS, el nombre del contenedor y el puerto del contenedor. | Cree un AppSpec archivo que especifique estos recursos. | Cree una CloudFormation plantilla para modelar estos recursos. | | Especifique las opciones de cambio de tráfico de implementación y los enlaces de eventos de ciclo de vida. | Cree un AppSpec archivo que especifique estas opciones. | Cree una CloudFormation plantilla que utilice los parámetros de AWS::CodeDeploy::BlueGreen gancho para especificar estas opciones. | | CloudWatch alarmas. | Cree una CloudWatch alarma que desencadene una reversión. | Configure una CloudWatch alarma a nivel de CloudFormation pila que active una reversión. | | Restauración/reimplementación. | Especifique las opciones de restauración y reimplementación. | Cancela la actualización de la pila en CloudFormation. | ## Supervisión de las blue/green implementaciones de Amazon ECS mediante CloudFormation Puede monitorear las blue/green implementaciones a través de y. CloudFormation CodeDeploy Para obtener información sobre la supervisión continua CloudFormation, consulte la [sección Supervisión de blue/green eventos CloudFormation en](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html#blue-green-events) la *Guía del AWS CloudFormation usuario*. **Para ver el estado de despliegue de los blue/green despliegues en CodeDeploy** 1. Inicie sesión en Consola de administración de AWS [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) y abra la CodeDeploy consola. **nota** Inicie sesión con el mismo usuario que configuró en [Empezar con CodeDeploy](getting-started-codedeploy.md). 1. En **Implementaciones, aparece** la implementación que se activó por la actualización de la CloudFormation pila. Elija la implementación para ver el **Deployment history (Historial de implementaciones)**. ![\[Captura de pantalla de la consola que muestra la sección Deployments (Implementaciones) y el Deployment history (Historial de implementaciones).\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/images/cfn-cd-bg-deplhist.png) 1. Elija la implementación para ver el estado de cambio de tráfico. Tenga en cuenta que el grupo de aplicación e implantación no se han creado. ![\[Captura de pantalla de la consola que muestra los detalles de implementación con el estado de implementación completado.\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/images/cfn-cd-bg-deplstatus.png) 1. Lo siguiente se aplica para restaurar o detener la implementación: + La implementación correcta aparece en CodeDeploy y muestra que la implementación fue iniciada por CloudFormation. + Si quiere detener y revertir la implementación, debe cancelar la actualización de la pila en CloudFormation.