Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Diese Version von GitHub Enterprise wird eingestellt am 2023-03-15. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Planen der Erstellung von Issues

Du kannst GitHub Actions verwenden, um regelmäßig ein Issue zu erstellen, z. B. für tägliche Besprechungen oder vierteljährliche Überprüfungen.

Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

Einführung

Dieses Tutorial veranschaulicht, wie du die imjohnbo/issue-bot-Aktion verwendest, um Issues für regelmäßige Aufgaben zu erstellen. Du kannst beispielsweise für jede Woche ein Issue erstellen, das als Tagesordnung für eine Teambesprechung verwendet werden soll.

In diesem Tutorial erstellst du zunächst eine Workflowdatei, die die imjohnbo/issue-bot-Aktion verwendet. Im Anschluss passt du den Workflow an deine Anforderungen an.

Erstellen des Workflows

  1. Wähle ein Repository aus, in dem du diesen Projektverwaltungsworkflow anwenden möchtest. Du kannst ein vorhandenes Repository verwenden, auf das du Schreibzugriff hast, oder du kannst ein neues Repository erstellen. Weitere Informationen zum Erstellen eines Repositorys findest du unter Erstellen eines neuen Repositorys.

  2. Erstelle in deinem Repository eine Datei namens .github/workflows/YOUR_WORKFLOW.yml, und ersetze YOUR_WORKFLOW durch einen Namen deiner Wahl. Dies ist eine Workflowdatei. Weitere Informationen zum Erstellen neuer Dateien auf GitHub findest du unter Erstellen neuer Dateien.

  3. Kopiere den folgenden YAML-Inhalt in deine Workflowdatei.

    YAML
    # Dieser Workflow verwendet Aktionen, die nicht von GitHub zertifiziert sind.
    # Sie werden von einem Drittanbieter bereitgestellt und unterliegen
    # separaten Nutzungsbedingungen, Datenschutzbestimmungen und Support
    # Onlinedokumentation.
    
    # GitHub empfiehlt, Aktionen an einen Commit-SHA anzuheften.
    # Um eine neuere Version zu erhalten, musst du den SHA aktualisieren.
    # Du kannst auch auf ein Tag oder einen Branch verweisen, aber die Aktion kann sich ohne Vorwarnung ändern.
    
    name: Weekly Team Sync
    on:
      schedule:
        - cron: 20 07 * * 1
    
    jobs:
      create_issue:
        name: Create team sync issue
        runs-on: ubuntu-latest
        permissions:
          issues: write
        steps:
          - name: Create team sync issue
            uses: imjohnbo/issue-bot@3daae12aa54d38685d7ff8459fc8a2aee8cea98b
            with:
              assignees: "monalisa, doctocat, hubot"
              labels: "weekly sync, docs-team"
              title: "Team sync"
              body: |
                ### Agenda
    
                - [ ] Start the recording
                - [ ] Check-ins
                - [ ] Discussion points
                - [ ] Post the recording
                        
                ### Discussion Points
                Add things to discuss below
    
                - [Work this week](https://github.com/orgs/github/projects/3)
              pinned: false
              close-previous: false
            env:
              GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  4. Passe die Parameter in deiner Workflowdatei an:

    • Ändere den Wert für on.schedule, um festzulegen, wann dieser Workflow ausgeführt werden soll. Im obigen Beispiel wird der Workflow jeden Montag um 7:20 Uhr UTC ausgeführt. Weitere Informationen zu geplanten Workflows findest du unter Geplante Ereignisse.
    • Ändere den Wert für assignees in die Liste der GitHub-Benutzernamen, die du dem Issue zuweisen möchtest.
    • Ändere den Wert für labels in die Liste der Bezeichnungen, die du auf das Issue anwenden möchtest.
    • Ändere den Wert für title in den Titel, den das Issue haben soll.
    • Ändere den Wert für body in den Text, der im Issuetext angezeigt werden soll. Mit dem Zeichen | kannst du einen mehrzeiligen Wert für diesen Parameter verwenden.
    • Wenn du dieses Issue in deinem Repository anheften möchtest, lege pinned auf true fest. Weitere Informationen zu angehefteten Issues findest du unter Anheften eines Issues an dein Repository.
    • Wenn das von diesem Workflow generierte vorherige Issue immer geschlossen werden soll, wenn ein neues Issue erstellt wird, lege close-previous auf true fest. Der Workflow schließt das jüngste Issue, das die im Feld labels definierten Bezeichnungen enthält. Um zu vermeiden, dass das falsche Issue geschlossen wird, verwende eine eindeutige Bezeichnung oder eine eindeutige Kombination aus Bezeichnungen.
  5. Committe deine Workflowdatei in den Standardbranch deines Repositorys. Weitere Informationen findest du unter Erstellen neuer Dateien.

Erwartete Ergebnisse

Basierend auf dem Parameter schedule (z. B. jeden Montag um 7:20 Uhr UTC) erstellt dein Workflow ein neues Issue mit den zugewiesenen Personen, Bezeichnungen, dem Titel und dem Textkörper, die bzw. den du angegeben hast. Wenn du pinned auf true festgelegt hast, heftet der Workflow das Issue an dein Repository an. Wenn du close-previous auf TRUE festgelegt hast, schließt der Workflow das jüngste Issue mit den entsprechenden Bezeichnungen.

Hinweis: Das Ereignis schedule kann sich in Phasen mit einer hohen Auslastung durch GitHub Actions-Workflowausführungen verzögern. Eine hohe Last ist unter anderem zu Beginn jeder Stunde zu verzeichnen. Um die Wahrscheinlichkeit einer Verzögerung zu verringern, kannst du deinen Workflow so planen, dass er zu einer anderen Uhrzeit ausgeführt wird.

Du kannst den Verlauf der Workflowausführungen anzeigen, um zu ermitteln, ob dieser Workflow regelmäßig ausgeführt wird. Weitere Informationen findest du unter Aufrufen des Workflowausführungsverlaufs.

Nächste Schritte

  • Weitere Informationen zu weiteren Aufgaben, die du mit der imjohnbo/issue-bot-Aktion erledigen kannst, z. B. zum Rotieren von zugewiesenen Personen oder zum Verwenden einer Issuevorlage, findest du in der Dokumentation zu imjohnbo/issue-bot-Aktionen.
  • Durchsuche GitHub nach Beispielen für Workflows, die diese Aktion verwenden.