# Erstellen von Workflowvorlagen für die Organisation

Hier erfahren Sie, wie Sie Workflowvorlagen erstellen können, um den Mitglieder Ihres Teams das Hinzufügen neuer Workflows zu erleichtern.

> \[!NOTE]
> Auf GitHub Enterprise Server gehostete Runner werden aktuell nicht auf GitHub unterstützt.

## Erstellen von Workflowvorlagen

In diesem Verfahren wird das Erstellen einer Workflowvorlage und einer Metadatendatei veranschaulicht. Die Metadatendatei beschreibt, wie die Workflowvorlage Benutzer\*innen beim Erstellen eines neuen Workflows zur Verfügung gestellt wird.

1. Falls es noch nicht existiert, erstellen Sie ein neues öffentliches Repository `.github` in Ihrer Organisation.
2. Erstelle ein Verzeichnis namens `workflow-templates`.
3. Erstelle die neue Workflowdatei im Verzeichnis `workflow-templates`.

   Wenn du auf den Standardbranch eines Repositorys verweisen musst, kannst du den Platzhalter `$default-branch` verwenden. Beim Erstellen eines Workflows wird der Platzhalter automatisch durch den Namen des Standard-Branches des Repositorys ersetzt.

   > \[!NOTE]
   > Die folgenden Werte im `runs-on`-Schlüssel werden auch als Platzhalter behandelt:
   >
   > *

`ubuntu-latest` wird durch `[ self-hosted ]` ersetzt.

> \*
> `windows-latest` wird durch `[ self-hosted, windows ]` ersetzt.
> \*
> `macos-latest` wird durch `[ self-hosted, macOS ]`

Die Datei `octo-organization-ci.yml` veranschaulicht beispielsweise einen grundlegenden Workflow.

```yaml copy
name: Octo Organization CI

on:
  push:
    branches: [ $default-branch ]
  pull_request:
    branches: [ $default-branch ]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v6

      - name: Run a one-line script
        run: echo Hello from Octo Organization
```

1. Erstelle im Verzeichnis `workflow-templates` eine Metadatendatei. Die Metadatendatei muss denselben Namen wie die Workflowdatei tragen, aber statt der `.yml`-Erweiterung muss `.properties.json` angefügt sein. Beispielsweise enthält die Datei `octo-organization-ci.properties.json` die Metadatei für den Workflow `octo-organization-ci.yml`:

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

   * `name`

   - **Muss angegeben werden.** Der Name des Workflows. Dieser wird in der Liste der verfügbaren Workflows angezeigt.

   * `description`

   - **Muss angegeben werden.** Die Beschreibung des Workflows. Dieser wird in der Liste der verfügbaren Workflows angezeigt.

   * `iconName`

   - **Optional:** Legt ein Symbol für den Workflow fest, das in der Liste der Workflows angezeigt wird.
     `iconName` kann eine der folgenden Typen sein:
     * Eine SVG-Datei, die im Verzeichnis `workflow-templates` gespeichert ist. Um auf eine Datei zu verweisen, muss der Wert dem Dateinamen ohne Dateierweiterung entsprechen. Beispielsweise wird auf eine SVG-Datei mit dem Namen `example-icon.svg` als `example-icon` verwiesen.
     * Ein Symbol aus der [Octicon](https://primer.style/octicons/)-Gruppe von GitHub. Um auf ein Octicon zu verweisen, muss der Wert `octicon <icon name>` lauten. Beispiel: `octicon smiley`.

   * `categories`

   - **Optional:** Definiert die Kategorien, unter denen der Workflow angezeigt wird. Du kannst Kategorienamen aus den folgenden Listen verwenden:
     * Allgemeine Kategorienamen aus dem Repository [starter-workflows](https://github.com/actions/starter-workflows/blob/main/README.md#categories).

     * Linguist-Sprachen aus der Liste im Repository [linguist](https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml).

     * Unterstützte Technologiestapel aus der Liste im Repository [starter-workflows](https://github.com/github-starter-workflows/repo-analysis-partner/blob/main/tech_stacks.yml).

   * `filePatterns`

   - **Optional:** Dies ermöglicht die Verwendung des Workflows, wenn sich im Repository des Benutzers bzw. der Benutzerin eine Datei im Stammverzeichnis befindet, die einem definierten regulären Ausdruck entspricht.

2. Fügen Sie die Dateien demselben Verzeichnis `workflow-templates` hinzu, um eine weitere Workflowvorlage hinzuzufügen.

## Nächste Schritte

* Referenzinformationen zu Workflowvorlagen findest du unter [Wiederverwenden von Workflowkonfigurationen](/de/enterprise-server@3.22/actions/reference/workflows-and-actions/reusing-workflow-configurations#workflow-templates).