Agregar etiquetas a las propuestas

Introducción

Este tutorial ilustra cómo utilizar la acciónandymckay/labeler en un flujo de trabajo para etiquetar las propuestas recientemente abiertas o re-abiertas. Por ejemplo, puedes agregar la etiqueta triage cada que se abre o re-abre una propuesta. Después, puedes ver todas las propuestas que necesitan clasificarse si filtras las propuestas con la etiqueta triage.

En el tutorial, primero harás un archivo de flujo de trabajo que utilice la acción andymckay/labeler. Después, personalizarás el flujo de trabajo de acuerdo con tus necesidades.

Crear un flujo de trabajo

1. Elige un repoisitorio en donde quieras aplicar este fluljo de trabajo de administración de proyectos. Puedes utilizar un repositorio existente al cual tengas acceso de escritura o puedes crear un repositorio nuevo. Para obtener más información sobre la creación de repositorios, consulta "Crear un repositorio nuevo."

2. En tu repositorio, crea un archivo que se llame .github/workflows/YOUR_WORKFLOW.yml, reemplazando a YOUR_WORKFLOW con un nombre de tu elección. Este es un archivo de flujo de trabajo. Para obtener más información acerca de cómo crear archivos nuevos en GitHub, consulta la sección "Crear archivos nuevos".

3. Copia el siguiente contenido de YAML en tu archivo de flujo de trabajo.

   YAML

   # This workflow uses actions that are not certified by GitHub.
   # Estas las proporcionan entidades terceras y las gobiernan
   # condiciones de servicio, políticas de privacidad y documentación de soporte
   # documentación.
   
   name: Label issues
   on:
     issues:
       types:
         - reopened
         - opened
   jobs:
     label_issues:
       runs-on: ubuntu-latest
       steps:
         - name: Label issues
           uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414
           with:
             add-labels: "triage"
             repo-token: ${{ secrets.GITHUB_TOKEN }}

4. Personaliza los parámetros en tu archivo de flujo de trabajo:

   • Cambia el valor de add-labels a la lista de etiquetas que quieras agregar a la propuesta. Separa las etiquetas con comas. Por ejemplo, "help wanted, good first issue". Para obtener más información sobre las etiquetas, consulta la sección "Administrar etiquetas".

5. Confirma tu archivo de flujo de trabajo en la rama predeterminada de tu repositorio. Para obtener más información, consulta "Crear nuevos archivos."

Probar el flujo de trabajo

Cada que se abre o re-abre una propuesta en tu repositorio, este flujo de trabajo agregará a la propuesta las etiquetas que especificaste.

Prueba tu flujo de trabajo creando una propuesta en tu repositorio.

1. Crea una propuesta en tu repositorio. Para obtener más información, consulta la sección "Crear una propuesta".
2. Para ver la ejecución de flujo de trabajo que se activó al crear la propuesta, ve el historial de tus ejecuciones de flujo de trabajo. Para obtener más información, consulta la sección "Visualizar el historial de ejecuciones de un flujo de trabajo".
3. Cuando se complete el flujo de trabajo, la propuesta que creaste deberá tener agregadas las etiquetas que especificaste.

Pasos siguientes

• Para aprender más sobre las cosas adicionales que puedes hacer con la acción andymckay/labeler, como quitar etiquetas o saltarte esta acción si la propuesta se asigna o si tiene una etiqueta específica, consulta la documentación de la acción andymckay/labeler.
• Para aprender más sobre los diversos eventos que pueden activar tu flujo de trabajo, consulta la sección "Eventos que activan flujos de trabajo". La acción andymckay/labeler funciona en los eventos de issues, pull_request, o project_card.
• Busca en GitHub los ejemplos de los flujos de trabajo que utilizan esta acción.