Skip to main content

Aktionen auf dem GitHub-Marktplatz veröffentlichen

Du kannst Aktionen auf dem GitHub Marketplace veröffentlichen und der GitHub-Community zur Verfügung stellen.

You must accept the terms of service to publish actions in GitHub Marketplace.

Informationen zum Veröffentlichen von Aktionen

Bevor du eine Aktion veröffentlichen kannst, musst du eine Aktion in deinem Repository erstellen. Weitere Informationen findest du unter Freigeben von Automatisierungen.

Wenn du vorhast, deine Aktion auf dem GitHub Marketplace zu veröffentlichen, musst du sicherstellen, dass das Repository nur die Metadatendatei, den Code und andere Dateien enthält, die für die Aktion notwendig sind. Wenn du ein einzelnes Repository für die Aktion erstellst, kannst du den Code in einer einzelnen Einheit markieren, veröffentlichen und packen. GitHub verwendet auch die Metadaten der Aktion auf deiner GitHub Marketplace-Seite.

Aktionen werden ohne Überprüfung durch GitHub sofort auf dem GitHub Marketplace veröffentlicht, sofern sie folgende Anforderungen erfüllen:

  • Die Aktion muss sich in einem öffentlichen Repository befinden.
  • Jedes Repository muss eine einzelne Aktion enthalten.
  • Die Repositorys dürfen keine Workflowdateien enthalten.
  • Die Metadatendatei der Aktion (action.yml oder action.yaml) muss sich im Stammverzeichnis des Repositorys befinden.
  • Der name in der Metadatendatei der Aktion muss eindeutig sein.
    • Der name darf mit keinem vorhandenen Aktionsnamen übereinstimmen, der auf dem GitHub Marketplace veröffentlicht wurde.
    • Der name darf nicht mit einem Benutzer oder einer Organisation auf GitHub übereinstimmen, es sei denn, dieser Benutzer oder Organisationsinhaber veröffentlicht die Aktion. Beispielsweise kann nur die GitHub-Organisation eine Aktion namens github veröffentlichen.
    • Der name darf nicht mit einer vorhandenen GitHub Marketplace-Kategorie übereinstimmen.
    • GitHub behält sich die Namen von GitHub-Funktionen vor.

Publishing an action (Veröffentlichen einer Aktion)

Du kannst die von Dir erstellte Aktion auf den GitHub Marketplace stellen, indem du sie als neue Version markierst und publizierst.

Um ein neues Release zu entwerfen und die Aktion auf dem GitHub Marketplace zu veröffentlichen, folge diesen Anweisungen:

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Navigiere zu der Aktionsmetadatendatei in deinem Repository (action.yml oder action.yaml). Dir wird ein Banner zum Veröffentlichen der Aktion auf dem GitHub Marketplace angezeigt. Klicke auf Entwerfen eines Release.

  3. Wähle unter „Releaseaktion“ die Option Diese Aktion auf dem GitHub Marketplace veröffentlichen aus.

    Note

    Das Kontrollkästchen „Veröffentlichen“ ist deaktiviert, wenn das Konto, in dessen Besitz sich das Repository befindet, die Vereinbarung für GitHub Marketplace-Entwickler noch nicht akzeptiert hat. Wenn du das Repository besitzt oder Organisationsbesitzer/Organisationsbesitzerin bist, klicke auf den Link zum „Akzeptieren der GitHub Marketplace-Entwicklervereinbarung“ und akzeptiere die Vereinbarung. Wenn kein Link vorhanden ist, sende dem Organisationsbesitzer bzw. der Organisationsbesitzerin einen Link zur Seite „Freigabeaktion“ und bitte die Person, die Vereinbarung zu akzeptieren.

  4. Wenn die Bezeichnungen in deiner Metadaten-Datei irgendwelche Probleme verursachen, wird Dir eine Fehlermeldung angezeigt. Behebe diese, indem du deine Metadatendatei aktualisierst. Wenn du fertig bist, wird eine Nachricht mit dem Inhalt „Alles sieht gut aus“ angezeigt. Vorgang nicht gefunden werden konnte.

  5. Wähle das Dropdownmenü Primäre Kategorie und dann eine Kategorie aus, mit der andere deine Aktion im GitHub Marketplace finden können.

  6. Wähle optional das Dropdownmenü Weitere Kategorie und dann eine zweite Kategorie aus.

  7. Gib im Feld „Tag“ eine Version für deine Aktion ein. Dies zeigt den Leuten, welche Änderungen oder Funktionen das Release umfasst. Die Leute werden die Version auf der dedizierten GitHub Marketplace-Seite der Aktion sehen.

  8. Gib im Feld „Titel“ einen Releasetitel ein.

  9. Fülle alle anderen Felder aus, und klicke auf Release veröffentlichen. Zum Veröffentlichen brauchst du die Zwei-Faktor-Authentifizierung. Weitere Informationen findest du unter Zwei-Faktor-Authentifizierung konfigurieren.

Eine Aktion vom GitHub Marketplace entfernen

Um eine veröffentlichte Aktion vom GitHub Marketplace zu entfernen, musst du jedes veröffentlichte Release aktualisieren. Führe die folgenden Schritte für jedes auf dem GitHub Marketplace veröffentlichte Release der Aktion aus.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke rechts neben der Liste der Dateien auf Releases.

    Screenshot der Hauptseite eines Repositorys. Der Link mit der Bezeichnung „Releases“ ist orange umrandet.

  3. Wählen neben dem Release, das du bearbeiten möchtest, aus.

    Screenshot: Release in der Releaseliste. Das Stiftsymbol ist mit einem orangefarbenen Rahmen hervorgehoben.

  4. Wähle Diese Aktion auf dem GitHub Marketplace veröffentlichen aus, um das Häkchen zu entfernen.

  5. Klicke unten auf der Seite auf Release aktualisieren.

Übertragen eines Aktionsrepositorys

Sie können ein Aktionsrepository auf einen anderen Benutzer oder eine andere Organisation übertragen. Weitere Informationen findest du unter Repository übertragen.

Wenn ein Repositoryadministrator ein Aktionsrepository überträgt, erstellt GitHub automatisch eine Umleitung von der vorherigen URL zur neuen URL, was bedeutet, dass Workflows, die die betroffene Aktion verwenden, nicht aktualisiert werden müssen.

Aktionen, die auf GitHub Marketplace veröffentlicht werden, sind anhand ihres eindeutigen name-Bezeichners mit einem Repository verknüpft, was bedeutet, dass Sie neue Versionen einer Aktion aus dem übertragenen Repository unter demselben GitHub Marketplace-Listing veröffentlichen können. Wenn ein Aktionsrepository gelöscht wird, wird auch das GitHub Marketplace-Listing gelöscht, und der eindeutige name-Bezeichner wird verfügbar.

Note

Der Badge „Verifiziert“, der im GitHub-Profil einer Organisation angezeigt wird, unterscheidet sich vom Badge für überprüfte Ersteller auf GitHub Marketplace. Wenn Sie ein Aktionsrepository übertragen, verliert das GitHub Marketplace-Listing den Badge für verifizierte Ersteller, es sei denn, der neue Besitzer ist auch ein verifizierter Ersteller.

Informationen zu Badges im GitHub Marketplace

Bei Aktionen mit dem Badge oder mit dem Badge für verifizierte Erstellerinnen wurde der oder die Erstellerin der Aktion von GitHub als Partnerorganisation bestätigt. Partner können eine E-Mail an [email protected] senden, um den Badge für verifizierte Ersteller*innen zu beantragen.

Screenshot: GitHub Actions mit dem Badge für verifizierte Ersteller*innen