Agregar etiquetas a los problemas

Puede usar GitHub Actions para etiquetar automáticamente los problemas.

En este artículo

Nota:

Actualmente los ejecutores hospedados por GitHub Enterprise Server no se admiten en GitHub.

Introducción

En este tutorial se muestra cómo usar GitHub CLI en un flujo de trabajo para etiquetar las incidencias recién abiertas o reabiertas. 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.

GitHub CLI permite usar fácilmente la GitHub API en un flujo de trabajo.

En el tutorial, primero crearás un archivo de flujo de trabajo que usa GitHub CLI. 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, consulta Crear un repositorio nuevo.

  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 obtener más información sobre cómo crear nuevos archivos en GitHub, consulta Crear nuevos archivos.

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

    YAML
    name: Label issues
on:
  issues:
    types:
      - reopened
      - opened
jobs:
  label_issues:
    runs-on: ubuntu-latest
    permissions:
      issues: write
    steps:
      - run: gh issue edit "$NUMBER" --add-label "$LABELS"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GH_REPO: ${{ github.repository }}
          NUMBER: ${{ github.event.issue.number }}
          LABELS: triage

  4. Personaliza los valores env en tu archivo de flujo de trabajo:

    • Los valores GH_TOKEN, GH_REPO y NUMBER se establecen automáticamente mediante los contextos github y secrets. No necesitas cambiar estos.
    • Cambie el valor de LABELS a la lista de etiquetas que quiera agregar al problema. La(s) etiqueta(s) debe(n) existir para tu repositorio. Separa las etiquetas con comas. Por ejemplo, help wanted,good first issue. Para más información sobre las etiquetas, consulta Administrar las etiquetas.

  5. Confirma tu archivo de flujo de trabajo en la rama predeterminada de tu repositorio. Para más información, consulta Crear nuevos 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.

Pon a prueba tu flujo de trabajo creando una incidencia en tu repositorio.

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

Pasos siguientes