Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.
Introducción
En este tutorial se muestra cómo usar GitHub CLI en un flujo de trabajo para etiquetar los problemas recientemente abiertos o que se han vuelto 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
.
GitHub CLI permite usar fácilmente la API GitHub en un flujo de trabajo.
En el tutorial, primero creará un archivo de flujo de trabajo que usa la GitHub CLI. Después, personalizarás el flujo de trabajo de acuerdo con tus necesidades.
Crear un flujo de trabajo
-
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".
-
En el repositorio, cree un archivo denominado
.github/workflows/YOUR_WORKFLOW.yml
, y reemplaceYOUR_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, consulte "Crear nuevos archivos". -
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
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
-
Personaliza los valores
env
en tu archivo de flujo de trabajo:- Los valores
GH_TOKEN
,GH_REPO
yNUMBER
se establecen automáticamente mediante los contextosgithub
ysecrets
. Normalmente no es necesario cambiar estos valores. - 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".
- Los valores
-
Confirma tu archivo de flujo de trabajo en la rama predeterminada de tu repositorio. Para obtener más información, vea «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.
Prueba tu flujo de trabajo creando una propuesta en tu repositorio.
- Crea una propuesta en tu repositorio. Para obtener más información, vea «Crear una propuesta».
- 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, vea «Visualizar el historial de ejecución del flujo de trabajo».
- 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 sobre las cosas adicionales que puedes hacer con la GitHub CLI, consulta el Manual de la CLI de GitHub.
- Para obtener más información acerca de los distintos eventos que pueden desencadenar el flujo de trabajo, consulta "Eventos que desencadenan flujos de trabajo".
- Busca en GitHub ejemplos de flujos de trabajo mediante
gh issue edit
.