Verwenden von Workflowvorlagen

GitHub bietet Workflowvorlagen für verschiedene Sprachen und Tools.

In diesem Artikel

Info zu Workflowvorlagen

Bei Workflowvorlagen handelt es sich um Vorlagen, mit denen Sie eigene GitHub Actions-Workflows für ein Repository erstellen können. Sie stellen eine Alternative zum Starten aus einer leeren Workflowdatei dar und sind nützlich, da einige der Arbeiten bereits für Sie erledigt wurden.

GitHub umfasst Workflowvorlagen für verschiedene Sprachen und Tools. Wenn du Workflows im Repository einrichtest, analysiert GitHub den Code im Repository und empfiehlt Workflows anhand der Sprache und des Frameworks im Repository. Wenn Sie z. B. Node.js verwenden, schlägt GitHub eine Workflowvorlagendatei vor, die die Node.js-Pakete installiert und die Tests ausführt. Sie können nach relevanten Workflowvorlagen suchen und dabei Filter anwenden.

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

  • Continuous Integration (CI) Weitere Informationen findest du 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.

Sie können diese Workflows als Ausgangspunkt nutzen, um eigene benutzerdefinierte Workflows zu erstellen, oder sie unverändert übernehmen. Die vollständige Liste der Workflowvorlagen können Sie im Repository der Aktions-/Starter-Workflows durchsuchen. Weitere Informationen findest du unter Verwenden von Workflowvorlagen.

Außerdem können Sie eigene Workflowvorlagen erstellen und für Ihre Organisation freigeben. Diese Workflowvorlagen werden zusammen mit den von GitHub bereitgestellten Workflowvorlagen angezeigt. Alle Personen mit Schreibzugriff auf das github-Repository der Organisation können eine Workflowvorlage einrichten. Weitere Informationen finden Sie unter Erstellen von Workflowvorlagen für die Organisation.

Auswählen und Verwenden einer Workflowvorlage

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Wenn du bereits über einen Workflow im Repository verfügst, klicke auf Neuer Workflow.

  4. Auf der Seite „Workflow auswählen“ wird eine Auswahl empfohlener Workflowvorlagen angezeigt. Suchen Sie die Workflowvorlage, die Sie verwenden möchten, und klicken Sie dann auf Konfigurieren. Um die gewünschte Workflowvorlage zu finden, können Sie nach Schlüsselwörtern suchen oder nach Kategorie filtern.

  5. Wenn die Workflowvorlage Kommentare mit zusätzlichen Setupschritten enthält, führen Sie die entsprechenden Schritte aus.

    Es gibt begleitende Anleitungen für viele der Workflowvorlagen zum Erstellen und Testen von Projekten. Weitere Informationen finden Sie unter Erstellen und Testen.

  6. Einige Workflowvorlagen nutzen Geheimnisse. Beispiel: ${{ secrets.npm_token }}. Wenn die Workflowvorlage ein Geheimnis nutzt, müssen Sie den im Geheimnisnamen beschriebenen Wert als Geheimnis im Repository speichern. Weitere Informationen finden Sie unter Verwenden von Geheimnissen in GitHub-Aktionen.

  7. Optional kannst du zusätzliche Änderungen vornehmen. Beispielsweise kannst du den Wert on so bearbeiten, dass er sich bei Ausführung des Workflows ändert.

  8. Klicke auf Commit starten.

  9. Schreibe eine Commitnachricht, und entscheide, ob direkt ein Commit an den Standardbranch erfolgen oder ein Pull Request geöffnet werden soll.

Weiterführende Themen