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.
# Tutorial: Se utiliza CodeDeploy para implementar una aplicación desde GitHub
En este tutorial, se utiliza CodeDeploy para implementar una revisión de aplicación de GitHub muestra en una sola instancia de Amazon EC2 que ejecute Amazon Linux, una sola instancia de Red Hat Enterprise Linux (RHEL) o una sola instancia de Windows Server. Para obtener información sobre la GitHub integración con CodeDeploy, consulte. [Integración CodeDeploy con GitHub](integrations-partners-github.md)
**nota**
También se puede utilizar CodeDeploy para implementar una revisión de una aplicación desde GitHub una instancia de Ubuntu Server. Puede utilizar el ejemplo de revisión descrito [Paso 2: Crear una revisión de aplicación de ejemplo](tutorials-on-premises-instance-2-create-sample-revision.md) en [Tutorial: Implemente una aplicación en una instancia local con CodeDeploy (Windows Server, Ubuntu Server o Red Hat Enterprise Linux)](tutorials-on-premises-instance.md) o puede crear una revisión compatible con una instancia de Ubuntu Server y CodeDeploy. Para crear su propia revisión, consulte [Planificación de una revisión de CodeDeploy](application-revisions-plan.md) y [Añadir un archivo de especificaciones de la aplicación a una revisión de CodeDeploy](application-revisions-appspec-file.md).
**Topics**
+ [Requisitos previos](tutorials-github-prerequisites.md)
+ [Paso 1: Configurar una GitHub cuenta](tutorials-github-create-github-account.md)
+ [Paso 2: Crea un GitHub repositorio](tutorials-github-create-github-repository.md)
+ [Paso 3: Sube una aplicación de muestra a tu GitHub repositorio](tutorials-github-upload-sample-revision.md)
+ [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md)
+ [Paso 5: Crear una aplicación y un grupo de implementación](tutorials-github-create-application.md)
+ [Paso 6: Implementar la aplicación en la instancia](tutorials-github-deploy-application.md)
+ [Paso 7: Monitorizar y comprobar la implementación](tutorials-github-verify.md)
+ [Paso 8: Eliminación](tutorials-github-clean-up.md)
# Requisitos previos
Antes de empezar este tutorial, haga lo siguiente:
+ Instale Git en su equipo local. Para instalar Git, consulte [Git Downloads](http://git-scm.com/downloads).
+ Complete los pasos indicados en [Empezar con CodeDeploy](getting-started-codedeploy.md), incluida la instalación y configuración de la AWS CLI. Esto es especialmente importante si quieres usarlo AWS CLI para implementar una revisión desde GitHub la instancia.
# Paso 1: Configurar una GitHub cuenta
Necesitará una GitHub cuenta para crear un GitHub repositorio en el que se almacenará la revisión. Si ya tiene una GitHub cuenta, pase a[Paso 2: Crea un GitHub repositorio](tutorials-github-create-github-repository.md).
1. Ve a [https://github.com/join](https://github.com).
1. Escriba un nombre de usuario, su dirección de correo electrónico y una contraseña.
1. Selecciona **Registrarse** y GitHub, a continuación, sigue las instrucciones.
# Paso 2: Crea un GitHub repositorio
Necesitará un GitHub repositorio para almacenar la revisión.
Si ya tiene un GitHub repositorio, asegúrese de sustituirlo por su nombre a **CodeDeployGitHubDemo** lo largo de este tutorial y, a continuación, vaya directamente a[Paso 3: Sube una aplicación de muestra a tu GitHub repositorio](tutorials-github-upload-sample-revision.md).
1. En la [página de GitHub inicio](https://github.com/dashboard), realice una de las siguientes acciones:
+ En **Your repositories**, elija **New repository**.
+ En la barra de navegación, seleccione **Create new** (**\$1**) y luego elija **New repository**.
1. En la página **Create a new repository**, haga lo siguiente:
+ En el cuadro **Repository name (Nombre del repositorio)**, indique **CodeDeployGitHubDemo**.
+ Seleccione **Public**.
**nota**
La opción predeterminada **Public** implica que cualquiera puede ver el repositorio. Puede seleccionar la opción **Private** (Privado) para limitar quién puede ver el repositorio y confirmarlo.
+ Desactive la casilla **Initialize this repository with a README**. En su lugar creará un archivo `README.md` manualmente en el siguiente paso.
+ Elija **Create repository**.
1. Siga las instrucciones correspondientes al tipo de su equipo local para crear el repositorio con la línea de comandos.
**nota**
Si ha activado la autenticación de dos factores GitHub, asegúrese de introducir su token de acceso personal en lugar de su contraseña de inicio de GitHub sesión si se le solicita una contraseña. Para obtener información, consulte [Proporcionar su código de autenticación 2FA](https://help.github.com/articles/providing-your-2fa-authentication-code/).
**En máquinas Linux, macOS o Unix locales:**
1. Desde el terminal, ejecuta los siguientes comandos, uno por uno, donde *user-name* aparece tu nombre de GitHub usuario:
```
mkdir /tmp/CodeDeployGitHubDemo
```
```
cd /tmp/CodeDeployGitHubDemo
```
```
touch README.md
```
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Deje el terminal abierto en la ubicación `/tmp/CodeDeployGitHubDemo`.
**En los equipos locales con Windows:**
1. Desde el símbolo del sistema abierto como administrador, ejecute sucesivamente los comandos siguientes:
```
mkdir c:\temp\CodeDeployGitHubDemo
```
```
cd c:\temp\CodeDeployGitHubDemo
```
```
notepad README.md
```
1. En el Bloc de notas, guarde el archivo `README.md`. Cierre el Bloc de notas. Ejecute los siguientes comandos, uno a la vez, donde *user-name* aparece su nombre GitHub de usuario:
```
git init
```
```
git add README.md
```
```
git commit -m "My first commit"
```
```
git remote add origin https://github.com/user-name/CodeDeployGitHubDemo.git
```
```
git push -u origin master
```
1. Deje el símbolo del sistema abierto en la ubicación `c:\temp\CodeDeployGitHubDemo`.
# Paso 3: Sube una aplicación de muestra a tu GitHub repositorio
En este paso, copiará un ejemplo de revisión de un bucket público de Amazon S3 a su GitHub repositorio. (Para simplificar, las revisiones de ejemplo incluidas para este tutorial son páginas web individuales).
**nota**
Si en lugar de nuestro ejemplo utiliza una revisión propia, esta deberá:
Seguir las directrices de [Planificación de una revisión de CodeDeploy](application-revisions-plan.md) y [Añadir un archivo de especificaciones de la aplicación a una revisión de CodeDeploy](application-revisions-appspec-file.md).
Funcionar con el tipo de instancia correspondiente.
Sea accesible desde su GitHub panel de control.
Si su revisión cumple estos requisitos, continúe en [Paso 5: Crear una aplicación y un grupo de implementación](tutorials-github-create-application.md).
Si vas a realizar el despliegue en una instancia de Ubuntu Server, tendrás que cargar en tu GitHub repositorio una revisión compatible con una instancia de Ubuntu Server y CodeDeploy. Para obtener más información, consulte [Planificación de una revisión de CodeDeploy](application-revisions-plan.md) y [Añadir un archivo de especificaciones de la aplicación a una revisión de CodeDeploy](application-revisions-appspec-file.md).
**Topics**
+ [Enviar una revisión de ejemplo desde una máquina local Linux, macOS o Unix](#tutorials-github-upload-sample-revision-unixes)
+ [Envío de una revisión de ejemplo desde un equipo local con Windows](#tutorials-github-upload-sample-revision-windows)
## Enviar una revisión de ejemplo desde una máquina local Linux, macOS o Unix
Con el terminal aún abierto, por ejemplo en la ubicación `/tmp/CodeDeployGitHubDemo`, ejecute sucesivamente los comandos siguientes:
**nota**
Si tiene previsto implementar en una instancia de Windows Server, sustituya `SampleApp_Windows.zip` por `SampleApp_Linux.zip` en los comandos.
```
(Amazon S3 copy command)
```
```
unzip SampleApp_Linux.zip
```
```
rm SampleApp_Linux.zip
```
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
¿Dónde *(Amazon S3 copy command)* está una de las siguientes opciones?
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Linux.zip . --region us-east-2` para la región Este de EE. UU. (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Linux.zip . --region us-east-1` para la región Este de EE. UU. (Norte de Virginia)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Linux.zip . --region us-west-1` para la región Oeste de EE. UU (Norte de California)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Linux.zip . --region us-west-2` para la región Oeste de EE. UU. (Oregón)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Linux.zip . --region ca-central-1` para la región Canadá (centro)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Linux.zip . --region eu-west-1` para la región Europa (Irlanda)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Linux.zip . --region eu-west-2` para la región Europa (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Linux.zip . --region eu-west-3` para la región Europa (París)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Linux.zip . --region eu-central-1` para la región Europa (Fráncfort)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Linux.zip . --region il-central-1` para la región Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Linux.zip . --region ap-east-1` para la región Asia Pacífico (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Linux.zip . --region ap-northeast-1` para la región Asia-Pacífico (Tokio)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Linux.zip . --region ap-northeast-2` para la región Asia-Pacífico (Seúl)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Linux.zip . --region ap-southeast-1` para la región Asia-Pacífico (Singapur)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Linux.zip . --region ap-southeast-2` para la región Asia-Pacífico (Sídney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Linux.zip . --region ap-southeast-4` para la región Asia-Pacífico (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Linux.zip . --region ap-south-1` para la región Asia-Pacífico (Bombay)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Linux.zip . --region sa-east-1` para la región América del Sur (São Paulo)
## Envío de una revisión de ejemplo desde un equipo local con Windows
Con el símbolo del sistema aún abierto, por ejemplo en la ubicación `c:\temp\CodeDeployGitHubDemo`, ejecute sucesivamente los comandos siguientes:
**nota**
Si tiene previsto realizar la implementación en una instancia de Amazon Linux o RHEL, sustituya `SampleApp_Linux.zip` por `SampleApp_Windows.zip` en los comandos.
```
(Amazon S3 copy command)
```
Descomprima el contenido `the` del archivo ZIP directamente en el directorio local (por ejemplo `c:\temp\CodeDeployGitHubDemo`), no en un nuevo subdirectorio.
```
git add .
```
```
git commit -m "Added sample app"
```
```
git push
```
Dónde *(Amazon S3 copy command)* está uno de los siguientes:
+ `aws s3 cp s3://aws-codedeploy-us-east-2/samples/latest/SampleApp_Windows.zip . --region us-east-2` para la región Este de EE. UU. (Ohio)
+ `aws s3 cp s3://aws-codedeploy-us-east-1/samples/latest/SampleApp_Windows.zip . --region us-east-1` para la región Este de EE. UU. (Norte de Virginia)
+ `aws s3 cp s3://aws-codedeploy-us-west-1/samples/latest/SampleApp_Windows.zip . --region us-west-1` para la región Oeste de EE. UU (Norte de California)
+ `aws s3 cp s3://aws-codedeploy-us-west-2/samples/latest/SampleApp_Windows.zip . --region us-west-2` para la región Oeste de EE. UU. (Oregón)
+ `aws s3 cp s3://aws-codedeploy-ca-central-1/samples/latest/SampleApp_Windows.zip . --region ca-central-1` para la región Canadá (centro)
+ `aws s3 cp s3://aws-codedeploy-eu-west-1/samples/latest/SampleApp_Windows.zip . --region eu-west-1` para la región Europa (Irlanda)
+ `aws s3 cp s3://aws-codedeploy-eu-west-2/samples/latest/SampleApp_Windows.zip . --region eu-west-2` para la región Europa (Londres)
+ `aws s3 cp s3://aws-codedeploy-eu-west-3/samples/latest/SampleApp_Windows.zip . --region eu-west-3` para la región Europa (París)
+ `aws s3 cp s3://aws-codedeploy-eu-central-1/samples/latest/SampleApp_Windows.zip . --region eu-central-1` para la región Europa (Fráncfort)
+ `aws s3 cp s3://aws-codedeploy-il-central-1/samples/latest/SampleApp_Windows.zip . --region il-central-1` para la región Israel (Tel Aviv)
+ `aws s3 cp s3://aws-codedeploy-ap-east-1/samples/latest/SampleApp_Windows.zip . --region ap-east-1` para la región Asia Pacífico (Hong Kong)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-1/samples/latest/SampleApp_Windows.zip . --region ap-northeast-1` para la región Asia-Pacífico (Tokio)
+ `aws s3 cp s3://aws-codedeploy-ap-northeast-2/samples/latest/SampleApp_Windows.zip . --region ap-northeast-2` para la región Asia-Pacífico (Seúl)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-1/samples/latest/SampleApp_Windows.zip . --region ap-southeast-1` para la región Asia-Pacífico (Singapur)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-2/samples/latest/SampleApp_Windows.zip . --region ap-southeast-2` para la región Asia-Pacífico (Sídney)
+ `aws s3 cp s3://aws-codedeploy-ap-southeast-4/samples/latest/SampleApp_Windows.zip . --region ap-southeast-4` para la región Asia-Pacífico (Melbourne)
+ `aws s3 cp s3://aws-codedeploy-ap-south-1/samples/latest/SampleApp_Windows.zip . --region ap-south-1` para la región Asia-Pacífico (Bombay)
+ `aws s3 cp s3://aws-codedeploy-sa-east-1/samples/latest/SampleApp_Windows.zip . --region sa-east-1` para la región América del Sur (São Paulo)
Para enviar su propia revisión a una instancia de Ubuntu Server, copie la revisión en el repositorio local y, a continuación, ejecute lo siguiente:
```
git add .
git commit -m "Added Ubuntu app"
git push
```
# Paso 4: Aprovisionar una instancia
En este paso creará o configurará la instancia en la que va a implementar la aplicación de ejemplo. Puede realizar la implementación en una instancia de Amazon EC2 o en una instancia local que ejecute uno de los sistemas operativos compatibles con. CodeDeploy Para obtener información, consulte [Sistemas operativos compatibles con el agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). (Si ya tiene una instancia configurada para su uso en CodeDeploy las implementaciones, vaya al paso siguiente).
**Para aprovisionar una instancia**
1. Siga las instrucciones de [Lanzamiento de una instancia de Amazon EC2 (consola)](instances-ec2-create.md#instances-ec2-create-console) para aprovisionar una instancia.
1. Al lanzar la instancia, no olvide especificar una etiqueta en la página **Añadir etiquetas**. Para obtener información detallada acerca de la forma de especificar la etiqueta, consulte [Lanzamiento de una instancia de Amazon EC2 (consola)](instances-ec2-create.md#instances-ec2-create-console).
**Para comprobar que el CodeDeploy agente se está ejecutando en la instancia**
+ Siga las instrucciones de [Compruebe que el CodeDeploy agente se esté ejecutando](codedeploy-agent-operations-verify.md) para comprobar que el agente se está ejecutando.
Una vez que hayas aprovisionado correctamente la instancia y hayas comprobado que el CodeDeploy agente se está ejecutando, continúa con el siguiente paso.
# Paso 5: Crear una aplicación y un grupo de implementación
En este paso, utilizará la CodeDeploy consola o la AWS CLI para crear un grupo de aplicaciones y despliegues que utilizará para implementar la revisión de muestra desde su GitHub repositorio.
## Creación de una aplicación y un grupo de implementación (consola)
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. En el panel de navegación, expanda **Implementar** y, después, elija **Aplicaciones**.
1. Seleccione **Create application (Crear aplicación)** y, a continuación, seleccione **Custom application (Aplicación personalizada)**.
1. En **Application name (Nombre de aplicación)**, escriba **CodeDeployGitHubDemo-App**.
1. En **Plataforma de informática**, elija **EC2/On-Premises**.
1. Elija **Creación de aplicación**.
1. En la pestaña **Deployment groups (Grupos de implementaciones)**, elija **Create deployment group (Crear grupo de implementaciones)**.
1. En **Nombre de grupo de implementación**, escriba **CodeDeployGitHubDemo-DepGrp**.
1. En **Función de servicio**, elige el nombre de la función de CodeDeploy servicio que creaste en [Crear una función de servicio](getting-started-create-service-role.md) para. CodeDeploy
1. En **Tipo de implementación**, elija **Local**.
1. En **Configuración de entorno**, en función del tipo de instancia que utiliza, seleccione **Instancias de Amazon EC2** o **Instancias en las instalaciones**. En **Key (Clave)** y **Value (Valor)**, escriba la clave y el valor de la etiqueta de instancia que se aplicó a la instancia como parte de [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md).
1. En **Configuración de despliegue**, elija **CodeDeployDefault. AllatOnce**.
1. En **Equilibrador de carga**, anule la selección de **Habilitar equilibración de carga**.
1. Expanda **Advanced (Avanzadas)**.
1. En **Alarms (Alarmas)**, seleccione **Ignore alarm configuration (Ignorar las alarmas)**.
1. Elija **Create deployment group (Crear grupo de implementaciones)** y vaya al paso siguiente.
## Creación de una aplicación y un grupo de implementaciones (CLI)
1. Ejecute el comando **create-application** para crear una aplicación de CodeDeploy denominada `CodeDeployGitHubDemo-App`:
```
aws deploy create-application --application-name CodeDeployGitHubDemo-App
```
1. Llame al comando **create-deployment-group** para crear un grupo de implementación denominado `CodeDeployGitHubDemo-DepGrp`:
+ Si va a realizar una implementación en una instancia de Amazon EC2, *ec2-tag-key* es la clave de etiqueta de la instancia de Amazon EC2 que se aplicó a su instancia de Amazon EC2 como parte de. [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md)
+ Si va a realizar una implementación en una instancia de Amazon EC2, *ec2-tag-value* es el valor de etiqueta de la instancia de Amazon EC2 que se aplicó a su instancia de Amazon EC2 como parte de. [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md)
+ Si va a realizar la implementación en una instancia local, *on-premises-tag-key* es la clave de etiqueta de la instancia local que se aplicó a la instancia local como parte de ella. [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md)
+ Si vas a realizar la implementación en una instancia local, *on-premises-tag-value* es el valor de etiqueta de la instancia local que se aplicó a la instancia local como parte de ella. [Paso 4: Aprovisionar una instancia](tutorials-github-provision-instance.md)
+ *service-role-arn*es el ARN del rol de servicio para el que creó en [Crear un rol de servicio](getting-started-create-service-role.md). CodeDeploy (Siga las instrucciones de [Obtención del ARN del rol de servicio (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli) para determinar el ARN del rol de servicio).
```
aws deploy create-deployment-group --application-name CodeDeployGitHubDemo-App --ec2-tag-filters Key=ec2-tag-key,Type=KEY_AND_VALUE,Value=ec2-tag-value --on-premises-tag-filters Key=on-premises-tag-key,Type=KEY_AND_VALUE,Value=on-premises-tag-value --deployment-group-name CodeDeployGitHubDemo-DepGrp --service-role-arn service-role-arn
```
**nota**
El [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)comando 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 cumplen los umbrales de monitoreo de CloudWatch las alarmas de Amazon. Los comandos para estas acciones no se incluyen en este tutorial.
# Paso 6: Implementar la aplicación en la instancia
En este paso, utiliza la CodeDeploy consola o la AWS CLI para implementar la revisión de muestra del GitHub repositorio en la instancia.
## Para implementar la revisión (consola)
1. En la página **Deployment group details (Detalles del grupo de implementaciones)**, elija **Create deployment (Crear implementación)**.
1. En **Deployment group (Grupo de implementación)**, elija **`CodeDeployGitHubDemo-DepGrp`**.
1. En **Tipo de revisión**, elija **GitHub**.
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 GitHub en una pestaña independiente del navegador web. 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 la aplicación nombrada`CodeDeployGitHubDemo-App`. Continúe en el paso 5.
+ 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 7.
+ Para crear una conexión a otra GitHub cuenta, cierra sesión GitHub en otra pestaña del navegador web. Selecciona **Conectar a otra GitHub cuenta** y, a continuación, selecciona **Conectar a GitHub**. Continúe en el paso 5.
1. **Sigue las instrucciones de la página de inicio de sesión para iniciar sesión con tu GitHub cuenta.**
1. En la página **Authorize application**, elija **Authorize application**.
1. En la página CodeDeploy **Crear despliegue**, en **Nombre del repositorio**, introduzca el nombre de GitHub usuario que utilizó para iniciar sesión, seguido de una barra inclinada (`/`), seguido del nombre del repositorio en el que insertó la revisión de la aplicación (por ejemplo,***my-github-user-name*/CodeDeployGitHubDemo**).
Si no está seguro del valor que debe introducir o si desea especificar un repositorio diferente:
1. En una pestaña independiente del navegador web, dirígete al [GitHub panel](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 este valor en **Repository name (Nombre del repositorio)**.
**nota**
Si el nombre del repositorio de destino no aparece en **Tus repositorios**, usa el GitHub cuadro de **búsqueda para buscar** el repositorio de destino y el nombre del GitHub usuario u organización.
1. En el cuadro **ID de confirmación**, introduce el ID de la confirmación asociada a la transferencia de la revisión de tu aplicación a GitHub.
Si no está seguro del valor que debe introducir:
1. En otra pestaña del navegador web, ve a tu [GitHub panel de control](https://github.com/dashboard).
1. En **Your repositories (Sus repositorios)**, elija **CodeDeployGitHubDemo**.
1. En la lista de confirmaciones, busca y copia el ID de confirmación asociado al envío de la revisión de tu aplicación a GitHub. 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**.
1. Elija **Deploy** y continúe con el paso siguiente.
## Para implementar la revisión (CLI)
Antes de poder llamar a cualquier AWS CLI comando con el que interactúes GitHub (por ejemplo, el **create-deployment** comando al que llamarás a continuación), debes dar CodeDeploy permiso para usar tu cuenta de GitHub usuario con GitHub la que interactuar en la `CodeDeployGitHubDemo-App` aplicación. Actualmente esto debe hacerse en la consola de CodeDeploy .
1. Inicie sesión en [https://console.aws.amazon.com/codedeploy Consola de administración de AWS](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 el panel de navegación, expanda **Implementar** y, después, elija **Aplicaciones**.
1. Elija **CodeDeployGitHubDemo-App**.
1. En la pestaña **Implementaciones**, elija **Crear implementación**.
**nota**
No va a crear una nueva implementación. Actualmente, esta es la única forma de dar CodeDeploy permiso para interactuar GitHub en nombre de su cuenta de GitHub usuario.
1. En **el grupo de implementación**, seleccione **CodeDeployGitHubDemo- DepGrp**.
1. En **Tipo de revisión**, elija **GitHub**.
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 GitHub en una pestaña independiente del navegador web. En **GitHub cuenta**, escriba un nombre para identificar esta conexión y, a continuación, seleccione **Conectar a GitHub**. La página web le pide que autorice CodeDeploy la interacción con GitHub la aplicación nombrada`CodeDeployGitHubDemo-App`. Continúe en el paso 8.
+ 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 10.
+ Para crear una conexión a otra GitHub cuenta, cierra sesión GitHub en otra pestaña del navegador web. Selecciona **Conectar a otra GitHub cuenta** y, a continuación, selecciona **Conectar a GitHub**. Continúe en el paso 8.
1. **Sigue las instrucciones de la página de inicio de sesión para iniciar sesión con tu nombre GitHub de usuario o correo electrónico y contraseña.**
1. En la página **Authorize application**, elija **Authorize application**.
1. En la página CodeDeploy **Crear despliegue**, selecciona **Cancelar**.
1. Ejecuta el **create-deployment** comando para implementar la revisión desde tu GitHub repositorio a la instancia, donde:
+ *repository*es el nombre de tu GitHub cuenta, seguido de una barra diagonal (`/`), seguido del nombre de tu repositorio (`CodeDeployGitHubDemo`), por ejemplo,. `MyGitHubUserName/CodeDeployGitHubDemo`
Si no está seguro del valor que debe indicar o si desea especificar un repositorio diferente:
1. [En otra pestaña del navegador web, ve a tu panel de control. GitHub ](https://github.com/dashboard)
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. Este es el valor que debe usar.
**nota**
Si el nombre del repositorio de destino no aparece en **Tus repositorios**, usa el GitHub cuadro de **búsqueda para buscar** el repositorio de destino y el nombre de GitHub usuario u organización correspondiente.
+ *commit-id*es la confirmación asociada a la versión de la revisión de la aplicación que subiste a tu repositorio (por ejemplo,`f835159a...528eb76f`).
Si no está seguro del valor que debe usar:
1. En otra pestaña del navegador web, ve a tu [GitHub panel de control](https://github.com/dashboard).
1. En **Your repositories (Sus repositorios)**, elija **CodeDeployGitHubDemo**.
1. En la lista de confirmaciones, busca el ID de confirmación asociado al envío de la revisión de tu aplicación a GitHub. 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). Utilice este valor.
Si está trabajando en una máquina Linux, macOS o Unix local:
```
aws deploy create-deployment \
--application-name CodeDeployGitHubDemo-App \
--deployment-config-name CodeDeployDefault.OneAtATime \
--deployment-group-name CodeDeployGitHubDemo-DepGrp \
--description "My GitHub deployment demo" \
--github-location repository=repository,commitId=commit-id
```
Si se encuentra en un equipo local con Windows:
```
aws deploy create-deployment --application-name CodeDeployGitHubDemo-App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name CodeDeployGitHubDemo-DepGrp --description "My GitHub deployment demo" --github-location repository=repository,commitId=commit-id
```
# Paso 7: Monitorizar y comprobar la implementación
En este paso, utilizará la CodeDeploy consola o la AWS CLI para comprobar el éxito de la implementación. Utilizará el navegador web para ver la página implementada en la instancia que ha creado o configurado.
**nota**
Si se trata de una implementación en una instancia de Ubuntu Server, utilice su propia estrategia de pruebas para determinar si la revisión implementada funciona según lo previsto en la instancia y, a continuación, continúe en el paso siguiente.
**Para monitorizar y comprobar la implementación (consola)**
1. En el panel de navegación, expanda **Implementar** y después elija **Implementaciones**.
1. **En la lista de despliegues, busque la fila con un valor de **aplicación** de **CodeDeployGitHubDemo-App** y un valor de **grupo de despliegues** de CodeDeployGitHubDemo -. DepGrp** Si no aparece **Succeeded** o **Failed** en la columna **Status**, pulse el botón **Refresh** periódicamente.
1. Si aparece **Failed** en la columna **Status**, siga las instrucciones de [Visualización de los detalles de la instancia (consola)](instances-view-details.md#instances-view-details-console) para resolver los problemas de la implementación.
1. Si aparece **Succeeded** en la columna **Status**, ya puede comprobar la implementación en el navegador web. Nuestra revisión de ejemplo implementa una única página web en la instancia. Si la implementación es en una instancia de Amazon EC2, en el navegador web, vaya a `http://public-dns` para la instancia (por ejemplo, `http://ec2-01-234-567-890.compute-1.amazonaws.com`).
1. Si puede ver la página web, ¡enhorabuena\$1 Ahora que ha utilizado correctamente AWS CodeDeploy implementar una revisión desde GitHub, puede pasar a. [Paso 8: Eliminación](tutorials-github-clean-up.md)
**Para monitorizar y comprobar la implementación (CLI)**
1. Para obtener el ID de implementación, ejecute el comando **list-deployments** con la aplicación `CodeDeployGitHubDemo-App` y el grupo de implementaciones `CodeDeployGitHubDemo-DepGrp`:
```
aws deploy list-deployments --application-name CodeDeployGitHubDemo-App --deployment-group-name CodeDeployGitHubDemo-DepGrp --query "deployments" --output text
```
1. Ejecute el comando **get-deployment** indicando el ID de la implementación obtenido en la salida del comando **list-deployments**:
```
aws deploy get-deployment --deployment-id deployment-id --query "deploymentInfo.[status, creator]" --output text
```
1. Si el resultado es **Failed**, siga las instrucciones de [Visualización de los detalles de la instancia (consola)](instances-view-details.md#instances-view-details-console) para resolver los problemas de la implementación.
1. Si el resultado es **Succeeded**, ya puede comprobar la implementación en el navegador web. Nuestra revisión de ejemplo implementa una única página web en la instancia. Si la implementación es en una instancia de Amazon EC2, puede ver la página en el navegador web en la dirección `http://public-dns` para la instancia de Amazon EC2 (por ejemplo, `http://ec2-01-234-567-890.compute-1.amazonaws.com`).
1. Si puede ver la página web, ¡enhorabuena\$1 La has utilizado correctamente AWS CodeDeploy para realizar la implementación desde tu GitHub repositorio.
# Paso 8: Eliminación
Para evitar cargos adicionales por los recursos que ha utilizado en este tutorial, debe terminar la instancia de Amazon EC2 y sus recursos asociados. De forma opcional, puede eliminar los registros en CodeDeploy de los componentes de la implementación asociados a este tutorial. Si estabas usando un GitHub repositorio solo para este tutorial, también puedes eliminarlo ahora.
## Para eliminar una CloudFormation pila (si utilizó la CloudFormation plantilla para crear una instancia de Amazon EC2)
1. Inicie sesión en Consola de administración de AWS [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/) y abra la CloudFormation consola.
1. En la columna **Stacks** (Pilas) elija la pila que comience por `CodeDeploySampleStack`.
1. Elija **Eliminar**.
1. Cuando se le solicite, seleccione **Delete stack** (Eliminar pila). Se eliminará la instancia de Amazon EC2 y el perfil de instancia de IAM y el rol de servicio asociados.
## Para anular el registro y limpiar manualmente una instancia on-premises (si ha aprovisionado una instancia on-premises)
1. Usa el AWS CLI comando [deregister](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html) en la instancia local representada aquí por *your-instance-name* y en la región asociada por: *your-region*
```
aws deploy deregister --instance-name your-instance-name --no-delete-iam-user --region your-region
```
1. Desde la instancia en las instalaciones, llame al comando [uninstall](https://docs.aws.amazon.com/cli/latest/reference/deploy/uninstall.html):
```
aws deploy uninstall
```
## Para terminar manualmente una instancia de Amazon EC2 (si ha iniciado manualmente una instancia de Amazon EC2)
1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. En el panel de navegación, bajo **Instances**, elija **Instances**.
1. Seleccione la casilla junto a la instancia de Amazon EC2 que desea terminar. En el menú **Actions**, seleccione **Instance State** y elija **Terminate**.
1. Cuando se le pregunte, elija **Yes, Terminate**.
## Para eliminar los registros de los componentes CodeDeploy de despliegue
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. En el panel de navegación, expanda **Implementar** y, después, elija **Aplicaciones**.
1. Elija **CodeDeployGitHubDemo-App**.
1. Elija **Eliminar aplicación**.
1. Cuando se le pregunte, escriba **Delete** y, a continuación, elija **Delete (Eliminar)**.
## Para eliminar tu repositorio GitHub
Consulte [Eliminar un repositorio](https://help.github.com/articles/deleting-a-repository/) en la [GitHub ayuda](https://help.github.com).