Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.
Introducción
Este tutorial ilustra cómo utilizar la acción alex-page/github-project-automation-plus
para mover una propuesta automáticamente a una columna específica en un tablero de proyecto cuando esta se asigna. Por ejemplo, cuando se asigna una propuesta, puedes moverla hacia la columna In Progress
de tu tablero de proyecto.
En el tutorial, primero crearás un archivo de flujo de trabajo que utilice la acción alex-page/github-project-automation-plus
. 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 obtener más información sobre la creación de repositorios, consulta "Crear un repositorio nuevo."
-
En tu repositorio, elige un tablero de proyecto. Puedes utilizar un proyecto existente o crear uno nuevo. Para obtener más información sobre cómo crear un proyecto, consulta la sección "Crear un tablero de proyecto".
-
En tu repositorio, crea un archivo que se llame
.github/workflows/YOUR_WORKFLOW.yml
, reemplazando aYOUR_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". -
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: Move assigned card on: issues: types: - assigned jobs: move-assigned-card: runs-on: ubuntu-latest steps: - uses: alex-page/github-project-automation-plus@5bcba1c1c091a222584d10913e5c060d32c44044 with: project: Docs Work column: In Progress repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
-
Personaliza los parámetros en tu archivo de flujo de trabajo:
- Cambia el valor de
project
al nombre de tu tablero de proyecto. Si tienes varios tableros de proyecto con el mismo nombre, la acciónalex-page/github-project-automation-plus
actuará sobre todos aquellos que tengan el nombre previamente especificado. - Cambia el valor de
column
al nombre de la columna en donde quieres mover las propuestas cuando se asignen. - Cambia el valor de
repo-token
:- Crea un token de acceso personal con el alcance de
repo
. Para obtener más información, consulta la sección "Crear un token de acceso personal". - Almacena este token de acceso personal como secreto en tu repositorio. Para obtener más información sobre cómo almacenar secretos, consulta la sección "Secretos cifrados".
- En tu archivo de flujo de trabajo, reemplaza a
PERSONAL_ACCESS_TOKEN
con el nombre de tu secreto.
- Crea un token de acceso personal con el alcance de
- Cambia el valor de
-
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 vez que se asigne una propuesta en tu repositorio, dicha propuesta se moverá al tablero de proyecto especificado. Si la propuesta no estaba ya en el tablero de proyecto, se agregará a este.
Si tu repositorio le pertenece a un usuario, la acción alex-page/github-project-automation-plus
actuará en todos los proyectos de tu repositorio o cuenta personal que tengan el nombre de proyecto y columna específicos. De la misma forma, si tu repositorio pertenece a una organización, la acción actuará en todos los poryectos de tu repositorio u organización que tengan el nombre y columna especificadas.
Prueba tu flujo de trabajo asignando una propuesta en tu repositorio.
- Abre una propuesta en tu repositorio. Para obtener más información, consulta la sección "Crear una propuesta".
- Asigna la propuesta. Para obtener más informaciónm, consulta la sección "Asignar propuestas y solicitudes de cambios a otros usuarios de GitHub".
- Para ver la ejecución de flujo de trabajo que se activó al asignar la propuesta, visualiza 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".
- Cuando se complete el flujo de trabajo, la propuesta que asignaste se debe agregar a la columna del tablero de proyecto que se especificó.
Pasos siguientes
- Para aprender más sobre las cosas adicionales que puedes hacer con la acción
alex-page/github-project-automation-plus
, como borrar o archivar tarjetas de proyecto, visita la documentación de la acciónalex-page/github-project-automation-plus
.