

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.

# Integración CodeDeploy con GitHub
<a name="integrations-partners-github"></a>

CodeDeploy supports [GitHub](https://github.com/about), un servicio de alojamiento e intercambio de código basado en la web. CodeDeploy puede implementar en las instancias revisiones de aplicaciones almacenadas en GitHub repositorios o buckets de Amazon S3. CodeDeploy solo es compatible con GitHub implementaciones locales de EC2.

**Topics**
+ [Implementación de revisiones desde CodeDeploy GitHub](#github-deployment-steps)
+ [GitHub comportamientos con CodeDeploy](#github-behaviors)

## Implementación de revisiones desde CodeDeploy GitHub
<a name="github-deployment-steps"></a>

Para implementar una revisión de una aplicación desde un GitHub repositorio a las instancias:

1. Cree una revisión que sea compatible con CodeDeploy el tipo de instancia de Amazon EC2 en el que realizará la implementación.

   Para crear una revisión compatible, siga las instrucciones indicadas en [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). 

1. Utilice una GitHub cuenta para añadir la revisión a un GitHub repositorio.

   Para crear una GitHub cuenta, consulte [Unirse GitHub](https://github.com/join). Para crear un GitHub repositorio, consulta [Crear un repositorio](https://help.github.com/articles/create-a-repo/).

1. Utilice la página **Crear despliegue** de la CodeDeploy consola o el AWS CLI **create-deployment** comando para implementar la revisión desde el GitHub repositorio en las instancias de destino configuradas para su uso en CodeDeploy las implementaciones.

   Si desea **create-deployment** ejecutar el comando, primero debe usar la página **Crear despliegue** de la consola para dar CodeDeploy permiso para interactuar GitHub en nombre de la GitHub cuenta que prefiera para la aplicación especificada. Solamente es necesario hacerlo una vez para cada aplicación.

   Para obtener información sobre cómo utilizar la página **Crear despliegue** para realizar un despliegue desde un GitHub repositorio, consulte[Cree una implementación con CodeDeploy](deployments-create.md).

   Para obtener información sobre cómo **create-deployment** ejecutar el comando para implementar desde un GitHub repositorio, consulte[Creación de una implementación en una plataforma de informática EC2/en las instalaciones (CLI)](deployments-create-cli.md).

   Para obtener información sobre cómo preparar las instancias para su uso en CodeDeploy las implementaciones, consulte[Trabajar con instancias para CodeDeploy](instances.md).

Para obtener más información, consulte [Tutorial: Se utiliza CodeDeploy para implementar una aplicación desde GitHub](tutorials-github.md).

## GitHub comportamientos con CodeDeploy
<a name="github-behaviors"></a>

**Topics**
+ [GitHub autenticación con aplicaciones en CodeDeploy](#behaviors-authentication)
+ [CodeDeploy interacción con repositorios públicos GitHub y privados](#behaviors-interactions-private-and-public)
+ [CodeDeploy interacción con los repositorios gestionados por la organización GitHub](#behaviors-interactions-organization-managed)
+ [Implemente automáticamente desde CodePipeline con CodeDeploy](#behaviors-deploy-automatically)

### GitHub autenticación con aplicaciones en CodeDeploy
<a name="behaviors-authentication"></a>

Tras conceder el CodeDeploy permiso para interactuar con ella GitHub, la asociación entre esa GitHub cuenta y la aplicación se almacena en CodeDeploy. Puede vincular la aplicación a una GitHub cuenta diferente. También puedes revocar el permiso CodeDeploy para interactuar con GitHub ella.

**Para vincular una GitHub cuenta a una aplicación en CodeDeploy**

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. Elige la aplicación que quieres vincular a una cuenta diferente GitHub.

1. Si la aplicación no tiene un grupo de implementación, elija **Crear grupo de implementación** para crear uno. Para obtener más información, consulte [Cree un grupo de despliegue con CodeDeploy](deployment-groups-create.md). Se requiere un grupo de implementaciones para elegir **Create deployment (Crear implementación)** en el paso siguiente.

1.  En **Deployments (Implementaciones)**, elija **Create deployment (Crear implementación)**. 
**nota**  
No es necesario crear una nueva implementación. Actualmente, esta es la única forma de vincular una GitHub cuenta diferente a una aplicación.

1.  En **Configuración de despliegue**, en **Tipo de revisión**, seleccione **Mi aplicación está almacenada en GitHub**. 

1. Realice una de las siguientes acciones:
   + Para crear una conexión de AWS CodeDeploy aplicaciones a una GitHub cuenta, cierre sesión GitHub en una pestaña independiente del navegador web. En **nombre de GitHub token**, escriba un nombre para identificar esta conexión y, a continuación, elija **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 10.
   + Para usar una conexión que ya haya creado, en el **nombre del GitHub token**, seleccione su nombre y, a continuación, elija **Conectar a GitHub**. Continúe en el paso 8.
   + Para crear una conexión a otra GitHub cuenta, cierra sesión GitHub en otra pestaña del navegador web. En **nombre de GitHub token**, escriba un nombre para identificar la conexión y, a continuación, elija **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 10.

1. Si aún no ha iniciado sesión GitHub, siga las instrucciones de la página de inicio de **sesión** para iniciar sesión con la GitHub cuenta a la que desee vincular la aplicación.

1. Selecciona **Autorizar la aplicación**. GitHub da CodeDeploy permiso para interactuar GitHub en nombre de la GitHub cuenta en la que se ha iniciado sesión en la aplicación seleccionada. 

1. Si no desea crear una implementación, elija **Cancel**.

**Para revocar el permiso para interactuar con CodeDeploy GitHub**

1. Inicie sesión para [GitHub ](https://github.com/dashboard)usar las credenciales de la GitHub cuenta en la que desea revocar el permiso AWS CodeDeploy .

1. Abra la página de GitHub [solicitudes](https://github.com/settings/applications), busque **CodeDeploy**en la lista de aplicaciones autorizadas y, a continuación, siga el GitHub procedimiento para revocar la autorización de una solicitud.

### CodeDeploy interacción con repositorios públicos GitHub y privados
<a name="behaviors-interactions-private-and-public"></a>

CodeDeploy admite el despliegue de aplicaciones desde GitHub repositorios públicos y privados. Cuando des CodeDeploy permiso para acceder GitHub en tu nombre, CodeDeploy tendrás acceso de lectura y escritura a todos los GitHub repositorios privados a los que tenga acceso tu GitHub cuenta. Sin embargo, CodeDeploy solo lee de los repositorios. GitHub No escribirá en ninguno de tus GitHub repositorios privados.

### CodeDeploy interacción con los repositorios gestionados por la organización GitHub
<a name="behaviors-interactions-organization-managed"></a>

De forma predeterminada, GitHub los repositorios gestionados por una organización (a diferencia de los repositorios privados o públicos de tu cuenta) no permiten el acceso a aplicaciones de terceros, incluidas las siguientes: CodeDeploy La implementación fallará si las restricciones de aplicaciones de terceros de una organización están habilitadas GitHub e intentas implementar código desde su GitHub repositorio. Existen dos maneras de resolver este problema. 
+ Como miembro de la organización, puede solicitar al responsable que apruebe el acceso para CodeDeploy. Los pasos para solicitar este acceso dependen de si ya has autorizado CodeDeploy tu cuenta individual:
  + Si has autorizado el acceso a CodeDeploy tu cuenta, consulta Cómo [solicitar la aprobación de la organización para tus solicitudes autorizadas](https://help.github.com/articles/requesting-organization-approval-for-your-authorized-applications/).
  + Si aún no has autorizado el acceso a CodeDeploy tu cuenta, consulta Cómo [solicitar la aprobación de una organización para aplicaciones de terceros](https://help.github.com/articles/requesting-organization-approval-for-third-party-applications/).
+ El responsable de la organización puede deshabilitar todas las restricciones a las aplicaciones de terceros. Para obtener información al respecto, consulte [Desactivación de las restricciones a las aplicaciones de terceros en una organización](https://help.github.com/articles/disabling-third-party-application-restrictions-for-your-organization/).

Para obtener más información, consulte [Acerca de las restricciones a las aplicaciones de terceros](https://help.github.com/articles/about-third-party-application-restrictions/).

### Implemente automáticamente desde CodePipeline con CodeDeploy
<a name="behaviors-deploy-automatically"></a>

Puede activar un despliegue desde a CodePipeline cada vez que cambie el código fuente. Para obtener más información, consulte [CodePipeline](https://aws.amazon.com/codepipeline/).