CI/CD with GitHub Actions & DevOps Pipelines · Lektion

Composite Actions und Veröffentlichung im Marketplace

Erstellen Sie Composite Actions, die mehrere Schritte bündeln, versionieren Sie sie korrekt und veröffentlichen Sie Ihre eigene Action zur Wiederverwendung im GitHub Marketplace.

Composite Actions und Veröffentlichung im Marketplace ist eine kostenlose CI/CD with GitHub Actions & DevOps Pipelines-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des CI/CD with GitHub Actions & DevOps Pipelines-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der CI/CD with GitHub Actions & DevOps Pipelines-Kurs umfasst insgesamt 4 Lektionen.

Drei Arten benutzerdefinierter Aktionen

GitHub unterstützt drei Möglichkeiten, eine benutzerdefinierte Aktion zu erstellen:

JavaScript-Aktionen — Node-Code ausführen
Docker-Aktionen — innerhalb eines Containers ausführen
Composite-Aktionen — mehrere Workflow-Schritte bündeln

Diese Lektion konzentriert sich auf Composite-Aktionen und das Veröffentlichen.

Was ist eine Composite-Aktion

Eine Composite-Aktion bündelt mehrere Run-Schritte und Aufrufe anderer Aktionen zu einer wiederverwendbaren Einheit, ohne JavaScript zu schreiben oder ein Docker-Image zu erstellen.

Sie eignet sich ideal, um eine wiederholte Folge von Shell-Befehlen abzubilden.

Die Datei action.yml

Jede Aktion wird durch eine Datei action.yml in ihrem Stammverzeichnis definiert. Setzen Sie bei einer Composite-Aktion runs.using auf composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

Shell ist erforderlich

Eine wichtige Feinheit: Bei Composite-Aktionen muss jeder run-Schritt eine shell deklarieren. Das Vergessen dieser Angabe ist der häufigste Fehler beim Erstellen von Composite-Aktionen.

    - run: echo 'hello'
      shell: bash

Inputs definieren

Machen Sie die Aktion mit inputs konfigurierbar. Aufrufer übergeben Werte über with, und Sie greifen mit inputs.<name> darauf zu.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Ausgaben definieren

Eine zusammengesetzte Action kann Ausgaben zurückgeben. Ein Schritt schreibt in GITHUB_OUTPUT, und die Action ordnet diesen Wert einer benannten Ausgabe zu.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Eine lokale Action verwenden

Sie können über den Pfad auf eine Action verweisen, die im selben Repository gespeichert ist. Das ist besonders praktisch während der Entwicklung, bevor Sie sie veröffentlichen.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Versionierung mit Tags

Veröffentlichte Actions werden über eine Git-Referenz eingebunden. Best Practice: Versehen Sie Releases mit Tags wie v1.0.0 und pflegen Sie zusätzlich ein veränderliches v1-Tag.

Aufrufer, die @v1 verwenden, erhalten automatisch abwärtskompatible Updates.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Vorbereitung für den Marketplace

Für die Veröffentlichung im GitHub Marketplace muss die Action in einem öffentlichen Repository liegen. Außerdem muss sie eine action.yml mit name, description und idealerweise branding (Symbol und Farbe) enthalten.

branding:
  icon: package
  color: blue

Das Release veröffentlichen

Erstellen Sie auf der Releases-Seite des Repositorys einen Entwurf für Ihr Tag. GitHub zeigt ein Kontrollkästchen Publish this Action to the Marketplace an.

Akzeptieren Sie die Vereinbarung, wählen Sie Kategorien aus und veröffentlichen Sie das Release. Danach kann jeder die Action suchen.

Verwendung dokumentieren

Eine gute Action wird mit einer verständlichen README ausgeliefert, die ein Anwendungsbeispiel sowie die Eingaben und Ausgaben zeigt.

Unternehmen, die Ihre Action evaluieren, stützen sich stark auf diese Dokumentation. Halten Sie sie daher korrekt und vollständig.

Kurze Wissensprüfung

Testen Sie Ihr Verständnis von zusammengesetzten Actions.

Zusammenfassung

Sie haben gelernt, zusammengesetzte Actions zu erstellen und zu veröffentlichen.

Zusammengesetzte Actions bündeln Schritte über runs.using: composite.
Jeder Ausführungsschritt benötigt explizit eine shell.
Stellen Sie Eingaben und Ausgaben für die Wiederverwendung bereit.
Versehen Sie die Action mit semantischen Versions-Tags und einem veränderlichen Major-Tag und veröffentlichen Sie sie anschließend im Marketplace.

Wiederverwendbare Actions ermöglichen es Teams, gemeinsame CI/CD-Logik zu skalieren.

Häufig gestellte Fragen

Ist die Lektion „Composite Actions und Veröffentlichung im Marketplace“ kostenlos?

Ja — der vollständige Text von „Composite Actions und Veröffentlichung im Marketplace“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des CI/CD with GitHub Actions & DevOps Pipelines-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der CI/CD with GitHub Actions & DevOps Pipelines-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Composite Actions und Veröffentlichung im Marketplace“?

Erstellen Sie Composite Actions, die mehrere Schritte bündeln, versionieren Sie sie korrekt und veröffentlichen Sie Ihre eigene Action zur Wiederverwendung im GitHub Marketplace. Du übst CI/CD with GitHub Actions & DevOps Pipelines mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um CI/CD with GitHub Actions & DevOps Pipelines zu starten?

Keine Vorkenntnisse erforderlich. CI/CD with GitHub Actions & DevOps Pipelines auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „Composite Actions und Veröffentlichung im Marketplace“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser CI/CD with GitHub Actions & DevOps Pipelines-Lektion Code schreiben und ausführen?

Ja. Jede CI/CD with GitHub Actions & DevOps Pipelines-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

Benutzerdefinierte GitHub Actions entwickeln
Self-Hosted Runner für On-Premises
Integration in Enterprise-Systeme
Composite Actions und Veröffentlichung im Marketplace

← Zurück zu CI/CD with GitHub Actions & DevOps Pipelines