GitHub conexiones

1. Inicie 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, elija GitHub (versión 2).

   • 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 Action provider, elija GitHub (versión 2).

3. Realice una de las siguientes acciones siguientes:

   • En Conexión, si aún no ha creado una conexión con su proveedor, elija 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 la GitHub conexión, el nombre de la conexión aparece en Nombre de la conexión. Selecciona Conectar a GitHub. Aparece la página de solicitud de acceso.

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

   

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

   nota

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

4. En la GitHub página Instalar el AWS conector para, elige la cuenta en la que quieres 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 Instalar el AWS conector para, deja los valores predeterminados y selecciona Instalar.

6. En la GitHub página Conectar a, el ID 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 los activadores de Pipeline, puedes añadir activadores si tu acción es una CodeConnections acción. Para configurar la configuración de los activadores de canalización y, de forma opcional, filtrar con activadores, consulta más información enFiltra los activadores en las solicitudes 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 de salida de la GitHub acción mediante el método predeterminado, elija CodePipeline default. La acción accede a los archivos del GitHub repositorio y almacena los artefactos en un archivo ZIP en el almacén de artefactos de Pipeline.

   • 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 utilizar las acciones CodeBuild posteriores.

     Si elige esta opción, tendrá que actualizar los permisos de su función de servicio de CodeBuild proyectos, tal y como se muestra en Añade CodeBuild GitClone permisos para las conexiones a Bitbucket, Enterprise Server o .com GitHub GitHub GitLab la siguiente. Para ver un tutorial que muestra cómo utilizar la opción Clonación completa, consulte Tutorial: Utilice un clon completo con una fuente de GitHub canalización.

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

Para crear 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 la configuración de los activadores de canalización para filtrar con activadores, consulte más detalles enFiltra los activadores en las solicitudes de inserción o extracción de código. Por ejemplo, lo siguiente se suma 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"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]