GitHub conexiones

1. Inicia sesión en la CodePipeline consola.

2. Elija una de las siguientes opciones.

   • Elija Crear canalización. Siga los pasos de Crear una canalización para completar la primera pantalla y seleccione Siguiente. En la página de origen, en Proveedor de código fuente, selecciona GitHub (a través de GitHub la aplicación).

   • Elija editar una canalización existente. Elija Editar y, a continuación, elija Editar etapa. Elija añadir o editar su acción de origen. En la página Editar acción, en Nombre de la acción, introduzca el nombre de la acción. En el proveedor de acciones, elige GitHub (a través de GitHub la aplicación).

3. Realice una de las siguientes acciones:

   • En Conexión, si aún no has creado una conexión con tu proveedor, selecciona Conectar a GitHub. Continúe con el paso 2: crear una conexión a GitHub.

   • En Conexión, si ya ha creado una conexión con su proveedor, seleccione la conexión. Continúe con el Paso 3: Guardar la acción de origen para la conexión.

Para crear una conexión a GitHub

1. En la configuración de GitHub conexión, el nombre de la conexión aparece en Nombre de la conexión. Selecciona Conectarse a GitHub. Aparece la página de solicitud de acceso.

2. Seleccione Autorizar AWS conector para GitHub. Aparece la página de conexión y muestra el campo GitHub Aplicaciones.

   

3. En GitHub Aplicaciones, elige la instalación de una aplicación o elige Instalar una nueva aplicación para crear una.

   Se instala una aplicación para todas las conexiones a un proveedor en particular. Si ya ha instalado el AWS Connector for GitHub app, elíjalo y omita este paso.

   nota

   Si quieres crear un token de acceso de usuario, asegúrate de que ya has instalado el AWS Connector para la GitHub aplicación y deja vacío el campo de instalación de la aplicación. CodeConnections usará el token de acceso de usuario para la conexión.

4. En la GitHub página Install AWS Connector for, elija la cuenta en la que desea instalar la aplicación.

   nota

   Solo instalas la aplicación una vez para cada GitHub cuenta. Si instaló la aplicación previamente, puede elegir Configurar para dirigirse a una página de modificación para la instalación de la aplicación o puede utilizar el botón Atrás para volver a la consola.

5. En la GitHub página Install AWS Connector for, deje los valores predeterminados y seleccione Instalar.

6. En la GitHub página Conectarse a, el identificador de conexión de la nueva instalación aparece en GitHub Aplicaciones. Elija Conectar.

Para guardar la acción GitHub de origen

1. En Repository name (Nombre del repositorio), elija el nombre del repositorio de terceros.

2. En Pipeline triggers, puedes añadir activadores si tu acción es una CodeConnections acción. Para configurar los desencadenadores de canalización y, de forma opcional, filtrar con desencadenadores, consulte más información en Agregación de desencadenadores con tipos de eventos de solicitud de inserción o extracción de código.

3. En Output artifact format (Formato del artefacto de salida), debe elegir el formato de los artefactos.

   • Para almacenar los artefactos resultantes de la GitHub acción mediante el método predeterminado, elige CodePipeline predeterminado. La acción accede a los archivos desde el GitHub repositorio y almacena los artefactos en un archivo ZIP en el almacén de artefactos de la canalización.

   • Para almacenar un archivo JSON que contiene una referencia URL al repositorio de manera que las acciones posteriores puedan ejecutar comandos Git directamente, elija Clonación completa. Esta opción solo la pueden usar las acciones CodeBuild posteriores.

     Si eliges esta opción, tendrás que actualizar los permisos de tu función de servicio de CodeBuild proyectos, tal y como se muestra enAñade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o GitHub GitHub GitLab.com. Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Usa la clonación completa con una fuente de GitHub canalización.

4. Seleccione Siguiente en el asistente o Guardar en la página Editar acción.

Creación de una conexión

1. Abra un terminal (Linux, macOS o Unix) o un símbolo del sistema (Windows). Utilice el AWS CLI para ejecutar el create-connection comando, especificando el --provider-type y --connection-name para la conexión. En este ejemplo, el nombre del proveedor de terceros es GitHub y el nombre especificado para la conexión es MyConnection.

   aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

   Si se ejecuta correctamente, este comando devuelve la información del ARN de la conexión, que será similar a lo siguiente.

   {
       "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }

2. Utilice la consola para completar la conexión. Para obtener más información, consulte Actualización de una conexión pendiente.

3. De forma predeterminada, la canalización detecta los cambios al enviar el código al repositorio de origen de conexión. Para configurar la configuración del desencadenador de canalización para la publicación manual o para las etiquetas de Git, realiza una de las siguientes acciones:

   • Para configurar la configuración de los desencadenadores de canalización para que comience únicamente con una versión manual, añade la siguiente línea a la configuración:

     "DetectChanges": "false",

   • Para configurar los desencadenadores de canalización para filtrar con ellos, consulte más información en Agregación de desencadenadores con tipos de eventos de solicitud de inserción o extracción de código. Por ejemplo, lo siguiente se añade al nivel de canalización de la definición de JSON de canalización. En este ejemplo, release-v0 y release-v1 son las etiquetas de Git que se deben incluir y release-v2 es la etiqueta de Git que se debe excluir.

     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]