Aktionen auf dem GitHub-Marktplatz veröffentlichen

Voraussetzungen

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

Wenn Sie planen, Ihre Aktion unter GitHub Marketplace zu veröffentlichen, müssen Sie sicherstellen, dass das Repository ausschließlich die Metadatendatei, den Code und die Dateien enthält, die für die Aktion erforderlich 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 Ihrer GitHub Marketplace Seite.

Aktionen werden sofort auf GitHub Marketplace veröffentlicht und nicht von GitHub überprüft, solange sie diese Anforderungen erfüllen:

• Die Aktion muss sich in einem öffentlichen Repository befinden.
• Jedes Repository muss eine einzelne Aktionsmetadatendatei (action.yml oder action.yaml) im Stamm enthalten.
  • Repositorys können andere Aktionsmetadatendateien in Unterordnern enthalten, werden jedoch nicht automatisch im Marketplace gelistet.
• Der name in der Metadatendatei der Aktion muss eindeutig sein.
  • Der name darf nicht mit dem Namen einer vorhandenen Aktion übereinstimmen, die auf GitHub Marketplace veröffentlicht wurde.
  • name kann nicht mit einem Benutzer oder einer Organisation auf GitHub übereinstimmen, es sei denn, der Besitzer des Benutzers oder der Organisation veröffentlicht die Aktion. Beispielsweise kann nur die GitHub Organisation eine Aktion mit dem Namen githubveröffentlichen.
  • Dies name kann nicht mit einer vorhandenen GitHub Marketplace Kategorie übereinstimmen.
  • GitHub behält sich die Namen der GitHub Features vor.

Publishing an action (Veröffentlichen einer Aktion)

Sie können die Aktion, die Sie erstellt haben, für GitHub Marketplace bereitstellen, indem Sie sie als neue Version kennzeichnen und veröffentlichen.

Führen Sie die folgenden Anweisungen aus, um einen neuen Release-Entwurf zu erstellen und die Aktion in GitHub Marketplace zu veröffentlichen:

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

2. Navigieren Sie zur Metadatendatei der Aktion in Ihrem Repository (action.yml), und dort wird Ihnen ein Banner angezeigt, um die Aktion auf GitHub Marketplace zu veröffentlichen. Klicke auf Entwerfen eines Release.

3. Wählen Sie unter „Freigabeaktion“ die Option „Diese Aktion in die GitHub Marketplace veröffentlichen“ aus.

   Hinweis

   Das Kontrollkästchen "Veröffentlichen" ist deaktiviert, wenn das Konto, das das Repository besitzt, die GitHub Marketplace Entwicklervereinbarung 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/der Organisationsbesitzer(-in) einen Link zur Seite „Freigabeaktion“ und bitte diese Person, die Vereinbarung zu akzeptieren.

4. Wenn die Bezeichnungen in deiner Metadatendatei Probleme verursachen, wird dir eine Fehlermeldung oder eine Warnung angezeigt. Behebe diese, indem du deine Metadatendatei aktualisierst. Wenn du fertig bist, wird eine Nachricht mit dem Inhalt „Alles sieht gut aus“ angezeigt. Meldung.

5. Wählen Sie das Dropdownmenü "Primäre Kategorie " aus, und klicken Sie auf eine Kategorie, in der Personen Ihre Aktion GitHub Marketplacefinden können.

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

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

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 finden Sie unter Zwei-Faktor-Authentifizierung konfigurieren.

Entfernen einer Aktion aus GitHub Marketplace

Um eine veröffentlichte Aktion aus GitHub Marketplace zu entfernen, müssen Sie jede veröffentlichte Version aktualisieren. Führen Sie die folgenden Schritte für jede Version der Aktion aus, die Sie auf GitHub Marketplace veröffentlicht haben.

1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

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

   

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

   

4. Deaktivieren Sie „Diese Aktion im GitHub Marketplace veröffentlichen“, um das Häkchen aus dem Kontrollkästchen 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 finden Sie unter Repository übertragen.

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

Aktionen, die auf GitHub Marketplace veröffentlicht werden, sind über ihren eindeutigen name-Bezeichner mit einem Repository verknüpft. Das bedeutet, dass Sie neue Releases einer Aktion aus dem übertragenen Repository unter demselben GitHub Marketplace-Eintrag veröffentlichen können. Wenn ein Aktions-Repository gelöscht wird, wird die GitHub Marketplace Auflistung ebenfalls gelöscht, und der eindeutige name Bezeichner wird verfügbar.

Informationen zu Badges in GitHub Marketplace

Aktionen mit dem , oder dem Badge für verifizierte Ersteller, weisen darauf hin, dass GitHub den Ersteller der Aktion als Partnerorganisation verifiziert hat. Partner können eine E-Mail an partnerships@github.com senden, um den Badge für verifizierte Ersteller*innen zu beantragen.