Esta versión de GitHub Enterprise se discontinuará el 2022-02-16. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Crear plantillas de flujo de trabajo

Aprende cómo puedes crear plantillas de flujo de trabajo para ayudar a los integrantes de tu equipo a agregar flujos de trabajo nuevos más fácilmente.

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.

Resumen

Las plantillas de flujo de trabajo permiten a toda persona de tu organización que tenga permiso de crear flujos de trabajo hacerlo más rápida y fácilmente. Cuando creas un flujo de trabajo nuevo, puedes elegir una plantilla para que haga por ti algo o todo el trabajo de escribir el flujo. Puedes usar plantillas de flujo de trabajo como lugar de inicio para crear tu flujo de trabajo personalizado o usarlos tal como están. Esto no solo ahorra tiempo, sino que promueve la consistencia y las mejores prácticas a lo largo de tu organización.

Crear una plantilla de flujo de trabajo

Los usuarios con acceso de escritura en el repositorio .github de la organización pueden crear plantillas de flujo de trabajo. Los miembros de la organización que tengan permisos para crear flujos de trabajo podrán entonces utilizar estas plantillas.

Este procedimiento muestra cómo crear una plantilla de flujo de trabajo y un archivo de metadatos. El archivo de metadatos describe cómo se presenta la plantilla a los usuarios cuando están creando un flujo de trabajo nuevo.

  1. En caso de que no exista previamente, crea en tu organización un repositorio público nuevo que se llame .github.

  2. Crea un directorio que se llame workflow-templates.

  3. Crea tu nuevo archivo de flujo de trabajo dentro del directorio workflow-templates.

    Si necesitas referirte a la rama predeterminada de un repositorio, puedes utilizar el marcador de posición $default-branch. Cuando se crea un flujo de trabajo utilizando tu plantilla, el marcador de posición se reemplazará automáticamente con el nombre de la rama predeterminada del repositorio.

    Por ejemplo, este archivo de nombre octo-organization-ci.yml ilustra un flujo de trabajo básico.

    name: Octo Organization CI
    
    on:
      push:
        branches: [ $default-branch ]
      pull_request:
        branches: [ $default-branch ]
    
    jobs:
      build:
        runs-on: ubuntu-latest
    
        steps:
          - uses: actions/checkout@v2
    
          - name: Run a one-line script
            run: echo Hello from Octo Organization
    
  4. Crea un archivo de metadatos dentro del directorio workflow-templates. El archivo de metadatos debe tener el mismo nombre que el archivo de flujo de trabajo, pero en vez de tener la extensión .yml, este deberá encontrarse adjunto en .properties.json. Por ejemplo, este archivo que se llama octo-organization-ci.properties.json contiene los metadatos para un archivo de flujo de trabajo de nombre octo-organization-ci.yml:

    {
        "name": "Octo Organization Workflow",
        "description": "Octo Organization CI workflow template.",
        "iconName": "example-icon",
        "categories": [
            "Go"
        ],
        "filePatterns": [
            "package.json$",
            "^Dockerfile",
            ".*\\.md$"
        ]
    }
    
    • name - Requerido. El nombre de la plantilla de flujo de trabajo. Este se muestra en la lista de plantillas disponibles.
    • description - Requerido. La descripción de la plantilla de flujo de trabajo. Este se muestra en la lista de plantillas disponibles.
    • iconName - Requerido. Define un icono en la lista de plantillas para la entrada del flujo de trabajo. El iconName debe ser un icono en SVG del mismo nombre y se debe almacenar en el directorio workflow-templates. Por ejemplo, un archivo de tipo SVG que se nombre example-icon.svg se referenciará como example-icon.
    • categories - Opcional. Define la categoría de lenguaje del flujo de trabajo. Cuando un usuario visualiza las plantillas disponibles, aquellas que empaten con el mismo lenguaje se presentarán con mayor prominencia. Para obtener información sobre las categorías de lenguaje disponibles, consulta https://github.com/github/linguist/blob/master/lib/linguist/languages.yml.
    • filePatterns - Opcional. Permite que se utilice la plantilla si el repositorio del usuario contiene un archivo en su directorio raíz, el cual empate con una expresión regular definida.

Para agregar otra plantilla de flujo de trabajo, agrega tus archivos al mismo directorio de workflow-templates. Por ejemplo:

Archivos de plantilla de flujo de trabajo

Pasos siguientes

Para seguir aprendiendo sobre las GitHub Actions, consulta la sección "Utilizar plantillas de flujo de trabajo".

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.