Mover las propuestas asignadas en los tableros de proyecto

Introducción

En este tutorial se muestra cómo usar la acción alex-page/github-project-automation-plus para mover automáticamente una incidencia a una columna específica de un panel de proyecto cuando se asigna la incidencia. Por ejemplo, cuando se asigna una incidencia, puede moverla a la columna In Progress del panel de proyecto.

En el tutorial, primero creará un archivo de flujo de trabajo en el que se usa 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

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 tu repositorio, elige un tablero de proyecto. Puedes utilizar un proyecto existente o crear uno nuevo. Para más información sobre cómo crear un proyecto, vea "Creación de un panel de proyecto".

3. 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".

4. 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: 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 }}

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

   • Cambie el valor de project por el nombre del panel de proyecto. Si tiene varios paneles de proyecto con el mismo nombre, la acción alex-page/github-project-automation-plus actuará en todos los proyectos con el nombre especificado.
   • Cambie el valor de column por el nombre de la columna a la que quiera mover las incidencias cuando se asignen.
   • Cambie el valor de repo-token:
     1. Cree un token de acceso personal con el ámbito repo. Para más información, vea "Creación de un token de acceso personal".
     2. Almacena este token de acceso personal como secreto en tu repositorio. Para más información sobre el almacenamiento de secretos, vea "Secretos cifrados".
     3. En el archivo de flujo de trabajo, reemplace PERSONAL_ACCESS_TOKEN por el nombre del secreto.

6. 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 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 el repositorio es propiedad del usuario, la acción alex-page/github-project-automation-plus actuará en todos los proyectos del repositorio o la cuenta personal que tengan el nombre de proyecto y la columna especificados. 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.

1. Abre una propuesta en tu repositorio. Para más información, vea "Creación de una incidencia".
2. Asigna la propuesta. Para más información, vea "Asignación de incidencias y solicitudes de incorporación de cambios a otros usuarios de GitHub".
3. 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 más información, vea "Visualización del historial de ejecución de flujo de trabajo".
4. 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 más información sobre las tareas adicionales que puede realizar con la acción alex-page/github-project-automation-plus, como eliminar o archivar tarjetas de proyecto, visite la documentación de la acción alex-page/github-project-automation-plus.