Creating workflow templates for your organization

Overview

Mit Workflowvorlagen können alle Personen in deiner Organisation, die über die entsprechenden Berechtigungen verfügen, Workflows schneller und leichter erstellen. Bei der Erstellung eines neuen Workflows kann eine Workflowvorlage ausgewählt werden, die Ihnen das Schreiben des Workflows ganz oder teilweise abnimmt. Workflowvorlagen können als Ausgangspunkt verwendet werden, um eigene benutzerdefinierte Workflow zu erstellen, oder unverändert übernommen werden. So sparst du nicht nur Zeit, sondern sorgst auch für Konsistenz und den Einsatz bewährter Methoden in deiner Organisation.

GitHub bietet einsatzbereite Workflowvorlagen für die folgenden Kategorien auf hoher Ebene:

• Bereitstellung (CD) . Weitere Informationen finden Sie unter Info zu Continuous Deployment mit GitHub Actions.

• Sicherheit. Weitere Informationen findest du unter Konfigurieren des erweiterten Setups für das Codescanning.

• Continuous Integration (CI) Weitere Informationen finden Sie unter Info zu Continuous Integration mit GitHub Actions.
• Automatisierung. Automatisierungs-Workflowvorlagen bieten Lösungen für die Automatisierung von Workflows, wie z. B. die Triage von Pull Requests und das Anwenden einer Bezeichnung basierend auf den Pfaden, die im Pull Request geändert werden, oder das Begrüßen von Benutzern, die zum ersten Mal Mitwirkende des Repositorys sind.

Creating a workflow template

Workflow templates can be created by users with write access to the organization's public .github repository. These can then be used by organization members who have permission to create workflows.

This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the workflow templates will be presented to users when they are creating a new workflow.

1. If it doesn't already exist, create a new public repository named .github in your organization.

2. Create a directory named workflow-templates.

3. Create your new workflow file inside the workflow-templates directory.

   If you need to refer to a repository's default branch, you can use the $default-branch placeholder. When a workflow is created the placeholder will be automatically replaced with the name of the repository's default branch.

   For example, this file named octo-organization-ci.yml demonstrates a basic workflow.

   YAML

   name: Octo Organization CI
   
   on:
     push:
       branches: [ $default-branch ]
     pull_request:
       branches: [ $default-branch ]
   
   jobs:
     build:
       runs-on: ubuntu-latest
   
       steps:
         - uses: actions/checkout@v4
   
         - name: Run a one-line script
           run: echo Hello from Octo Organization
   

4. Create a metadata file inside the workflow-templates directory. The metadata file must have the same name as the workflow file, but instead of the .yml extension, it must be appended with .properties.json. For example, this file named octo-organization-ci.properties.json contains the metadata for a workflow file named octo-organization-ci.yml:

   JSON

   {
       "name": "Octo Organization Workflow",
       "description": "Octo Organization CI workflow template.",
       "iconName": "example-icon",
       "categories": [
           "Go"
       ],
       "filePatterns": [
           "package.json$",
           "^Dockerfile",
           ".*\\.md$"
       ]
   }
   

   • name - Required. The name of the workflow. This is displayed in the list of available workflows.

   • description - Required. The description of the workflow. This is displayed in the list of available workflows.

   • iconName - Optional. Specifies an icon for the workflow that is displayed in the list of workflows. iconName can one of the following types:

     • An SVG file that is stored in the workflow-templates directory. To reference a file, the value must be the file name without the file extension. For example, an SVG file named example-icon.svg is referenced as example-icon.
     • An icon from GitHub's set of Octicons. To reference an octicon, the value must be octicon <icon name>. For example, octicon smiley.

   • categories - Optional. Defines the categories that the workflow is shown under. You can use category names from the following lists:

     • General category names from the starter-workflows repository.
     • Linguist languages from the list in the linguist repository.
     • Supported tech stacks from the list in the starter-workflows repository.

   • filePatterns - Optional. Allows the workflow to be used if the user's repository has a file in its root directory that matches a defined regular expression.

To add another workflow template, add your files to the same workflow-templates directory.

Next steps

To continue learning about GitHub Actions, see Using workflow templates.