Agregar etiquetas a las propuestas

Introducción

En este tutorial se muestra cómo usar la acción andymckay/labeler en un flujo de trabajo para etiquetar los problemas recientemente abiertos o vueltos a abrir. Por ejemplo, puede agregar la etiqueta triage cada vez que se abre o se vuelve a abrir un problema. Después, puede ver todas los problemas que necesitan clasificarse filtrando los problemas con la etiqueta triage.

En el tutorial, primero creará un archivo de flujo de trabajo en el que se usa 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 más información sobre cómo crear un repositorio, vea "Creación de un repositorio".

2. En el repositorio, cree un archivo denominado .github/workflows/YOUR_WORKFLOW.yml, y reemplace YOUR_WORKFLOW por el nombre que prefiera. Este es un archivo de flujo de trabajo. Para más información sobre cómo crear archivos en GitHub, vea "Creación de archivos".

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

   YAML

   # Este flujo de trabajo usa acciones que no GitHub no certifica.
   # Estas las proporcionan entidades terceras y las gobiernan
   # condiciones de servicio, políticas de privacidad y documentación de soporte
   # en línea.
   
   # GitHub recomienda anclar acciones a un SHA de confirmación.
   # Para obtener una versión más reciente, debes actualizar el SHA.
   # También puedes hacer referencia a una etiqueta o rama, pero la acción puede cambiar sin ninguna advertencia.
   
   name: Label issues
   on:
     issues:
       types:
         - reopened
         - opened
   jobs:
     label_issues:
       runs-on: ubuntu-latest
       permissions:
         issues: write
       steps:
         - name: Label issues
           uses: andymckay/labeler@e6c4322d0397f3240f0e7e30a33b5c5df2d39e90
           with:
             add-labels: "triage"
             repo-token: ${{ secrets.GITHUB_TOKEN }}

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

   • Cambie el valor de add-labels a la lista de etiquetas que quiera agregar al problema. Separa las etiquetas con comas. Por ejemplo, "help wanted, good first issue". Para obtener más información sobre las etiquetas, vea "Administrar etiquetas".

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

Prueba 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 más información, vea "Creación de una incidencia".
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 más información, vea "Visualización del historial de ejecución de flujos de trabajo".
3. Cuando se complete el flujo de trabajo, la propuesta que creaste deberá tener agregadas las etiquetas que especificaste.

Pasos siguientes

• Para obtener más información acerca de otras tareas que puede realizar con la acción andymckay/labeler, como eliminar etiquetas u omitir esta acción si se asigna al problema una etiqueta específica, o la tiene, vea la documentación de la acción andymckay/labeler.
• Para obtener más información acerca de los distintos eventos que pueden desencadenar el flujo de trabajo, vea "Eventos que desencadenan flujos de trabajo". La acción andymckay/labeler solo funciona en eventos issues, pull_request o project_card.
• Busque en GitHub ejemplos de flujos de trabajo mediante esta acción.