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 la acción alex-page/github-project-automation-plus
para mover automáticamente una incidencia a una columna específica de un proyecto (clásico) cuando se asigna la incidencia. Por ejemplo, cuando se asigna una incidencia, puedes moverla a la columna In Progress
del proyecto (clásico).
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
-
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, selecciona un proyecto (clásico). Puedes utilizar un proyecto existente o crear uno nuevo. Para más información sobre cómo crear un proyecto, consulta "Creación de una instancia de project (classic)".
-
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 # 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@7ffb872c64bd809d23563a130a0a97d01dfa8f43 with: project: Docs Work column: In Progress repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
# 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@7ffb872c64bd809d23563a130a0a97d01dfa8f43 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
por el nombre del proyecto (clásico). Si tiene varios proyecto (clásico) con el mismo nombre, la acciónalex-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
:- Crea una personal access token con el ámbito
repo
. Para obtener más información, vea «Administración de tokens de acceso personal». - Almacena esta personal access token como secreto en el repositorio. Para obtener más información sobre cómo almacenar secretos, consulta "Uso de secretos en Acciones de GitHub".
- En el archivo de flujo de trabajo, reemplace
PERSONAL_ACCESS_TOKEN
por el nombre del secreto.
- Crea una personal access token con el ámbito
- Cambia el valor de
-
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 vez que se asigne una propuesta en tu repositorio, dicha propuesta se moverá al proyecto (clásico) especificado. Si el problema aún no está en el proyecto (clásico), se agregará al proyecto (clásico).
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.
- Abre una propuesta en tu repositorio. Para obtener más información, vea «Crear una propuesta».
- Asigna la propuesta. Para obtener más información, vea «Asignar propuestas y solicitudes de extracción 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, vea «Visualizar el historial de ejecución del flujo de trabajo».
- Cuando se complete el flujo de trabajo, la propuesta que asignaste se debe agregar a la columna del proyecto (clásico) 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ónalex-page/github-project-automation-plus
.