View a markdown version of this page

Tutorial: filtrado de solicitudes de extracción por nombres de ramificación para iniciar una canalización (tipo V2) - AWS CodePipeline

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: filtrado de solicitudes de extracción por nombres de ramificación para iniciar una canalización (tipo V2)

En este tutorial, crearás una canalización que se conecte a tu GitHub.com repositorio, donde la acción de origen está configurada para iniciar tu canalización con una configuración de activación que filtra las solicitudes de extracción. Cuando se produce un evento de solicitud de extracción específico para una ramificación específica, se inicia la canalización. En este ejemplo, se muestra cómo crear una canalización que permita filtrar por nombres de ramificación. Para obtener más información acerca de cómo trabajar con desencadenadores, consulte Agregación de filtros para los tipos de eventos de solicitud de inserción y extracción (CLI). Para obtener más información acerca del filtrado con patrones regex en formato glob, consulte Trabajar con patrones glob en la sintaxis.

importante

Como parte de la creación de una canalización, para los artefactos se utilizará un depósito de artefactos de S3 proporcionado CodePipeline por el cliente. (Es diferente del bucket que se usa para una acción de origen de S3). Si el depósito de artefactos de S3 está en una cuenta diferente a la de tu canalización, asegúrate de que el depósito de artefactos de S3 pertenezca a una Cuentas de AWS persona segura y confiable.

Este tutorial se conecta a GitHub.com través del tipo de acción. CodeStarSourceConnection

Requisitos previos

Antes de empezar, debe hacer lo siguiente:

  • Crea un GitHub.com repositorio con tu GitHub.com cuenta.

  • Ten tus GitHub credenciales listas. Cuando utilice el Consola de administración de AWS para configurar una conexión, se le pedirá que inicie sesión con sus GitHub credenciales.

Paso 1: creación de una canalización que iniciar con una solicitud de extracción de ramificaciones específicas

En esta sección, debe crear una canalización con las siguientes acciones:

  • Una etapa de origen con una conexión a tu GitHub.com repositorio y a tu acción.

  • Una etapa de compilación con una acción de AWS CodeBuild compilación.

Para crear una canalización con el asistente
  1. Inicia sesión en la CodePipeline consola en https://console.aws.amazon.com/codepipeline/.

  2. En la página Bienvenido, Introducción o en la página Canalizaciones, elija Crear canalización.

  3. En la página Paso 1: elección de la opción de creación, en Opciones de creación, seleccione la opción Crear una canalización personalizada. Elija Siguiente.

  4. En Paso 2: elegir la configuración de la canalización, en Nombre de la canalización, escriba MyFilterBranchesPipeline.

  5. En Tipo de canalización, mantenga la selección predeterminada en V2. Los tipos de canalización difieren en características y precio. Para obtener más información, consulte Tipos de canalización.

  6. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

    nota

    Si, en cambio, optas por usar tu rol de CodePipeline servicio actual, asegúrate de haber agregado el permiso de codeconnections:UseConnection IAM a tu política de roles de servicio. Para obtener instrucciones sobre la función CodePipeline de servicio, consulta Añadir permisos a la función CodePipeline de servicio.

  7. Para Configuración avanzada deje los valores predeterminados. En Artifact store (Almacén de artefactos), elija Default location (Ubicación predeterminada) para utilizar el almacén de artefactos predeterminado, como el bucket de artefacto de Amazon S3 que se estableció como predeterminado, para la canalización en la región que seleccionó para esta.

    nota

    Este no es el bucket de origen para su código fuente. Este es el almacén de artefactos de la canalización. Cada canalización debe tener su propio almacén de artefactos independiente, como un bucket de S3.

    Elija Siguiente.

  8. En la página Paso 3: agregar la etapa de origen, agregue una etapa de origen:

    1. En Proveedor de origen, elija GitHub (a través de GitHub la aplicación).

    2. En Conexión, seleccione una conexión existente o cree una nueva. Para crear o gestionar una conexión para tu acción GitHub de origen, consultaGitHub conexiones.

    3. En Repository name (Nombre de repositorio), elija el nombre de su repositorio de GitHub.com.

    4. En Tipo de desencadenador, seleccione Especificar filtro.

      En Tipo de evento, seleccione Solicitud de extracción. Seleccione todos los eventos de la solicitud de extracción para que el evento se produzca para las solicitudes de extracción creadas, actualizadas o cerradas.

      En Ramificaciones, en el campo Incluir, introduzca main*.

      Imagen que muestra la opción “Incluir ramificaciones” seleccionada con un valor de main* para un desencadenador con un tipo de evento de solicitud de extracción
      importante

      Las canalizaciones que se inicien con este tipo de desencadenador se configurarán para los eventos de WebhookV2 y no utilizarán el evento de Webhook (detección de cambios en todos los eventos de inserción) para iniciar la canalización.

    Elija Siguiente.

  9. En Paso 4: agregación de la etapa de compilación, en Proveedor de compilación, elija AWS CodeBuild. En el campo Region (Región) conserve el valor predeterminado de la región de la canalización. Elija o cree el proyecto de compilación como se indica en Tutorial: Usar etiquetas de Git para iniciar la canalización. Esta acción solo se usará en este tutorial como la segunda etapa necesaria para crear la canalización.

  10. En Paso 5: agregación de la etapa de prueba, elija Omitir la etapa de prueba y, a continuación, acepte el mensaje de advertencia eligiendo Omitir una vez más.

    Elija Siguiente.

  11. En la página Paso 6: Agregar fase de despliegue, seleccione Omitir fase de despliegue y, a continuación, acepte el mensaje de advertencia seleccionando de nuevo Omitir. Elija Siguiente.

  12. En el paso 7: revisar, selecciona Crear canalización.

Paso 2: Crea y fusiona una pull request GitHub.com para iniciar la ejecución de tu canalización

En esta sección, va a crear y combinar una solicitud de extracción. Esto inicia la canalización, con una ejecución para la solicitud de extracción abierta y una ejecución para la solicitud de extracción cerrada.

Para crear una solicitud de extracción e iniciar la canalización
  1. En GitHub.com primer lugar, crea una solicitud de extracción realizando un cambio README.md en la rama de una función y enviando una solicitud de extracción a la main rama. Confirme el cambio con un mensaje como Update README.md for PR.

  2. La canalización comienza con la revisión de la fuente que muestra el mensaje de origen de la solicitud de extracción como actualización README.md para PR.

    Imagen que muestra el mensaje de código fuente de la solicitud de extracción con el siguiente texto: Update README.md for PR
  3. Elija Historial. En el historial de ejecución de canalizaciones, consulte los eventos de estado de las solicitudes de extracción CREATED y MERGED que iniciaron las ejecuciones de canalización.

    Imagen que muestra el historial de ejecución de canalizaciones con los eventos de estado de las solicitudes de extracción CREATED y MERGED que iniciaron las ejecuciones de canalización