Benutzerdefinierte Actions und Marketplace
Erkunden Sie den GitHub Actions Marketplace mit vorgefertigten Actions und lernen Sie, eigene benutzerdefinierte Actions zu erstellen.
Benutzerdefinierte Actions und Marketplace ist eine kostenlose Git & GitHub Professional Workflow-Lektion auf CoddyKit. Dies ist Lektion 3 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 Git & GitHub Professional Workflow-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Git & GitHub Professional Workflow-Kurs umfasst insgesamt 4 Lektionen.
Den GitHub Actions Marketplace entdecken
Willkommen im GitHub Actions Marketplace! Dies ist ein lebendiger Knotenpunkt, an dem Sie Tausende vorgefertigte Actions finden, die von GitHub, Open-Source-Mitwirkenden und kommerziellen Partnern erstellt wurden.
Diese Actions lassen sich problemlos in Ihre Workflows integrieren. Durch die Wiederverwendung vorhandener Lösungen für häufige Aufgaben sparen Sie Zeit und Aufwand.
Die richtige Action finden
Die Navigation im Marketplace ist unkompliziert. Sie können nach Actions anhand von Schlüsselwörtern suchen, nach Kategorien (z. B. „CI/CD“ oder „Deployment“) filtern und nach Beliebtheit sortieren.
- Achten Sie auf Actions mit vielen Sternen und aktiver Pflege.
- Prüfen Sie die Dokumentation der Action auf Anleitungen zur Verwendung sowie auf Eingaben und Ausgaben.
- Sehen Sie sich an, wie oft eine Action in öffentlichen Repositorys verwendet wurde, um zusätzliche Anhaltspunkte zu ihrer Verbreitung zu erhalten.
Eine vorgefertigte Action integrieren
Die Verwendung einer Marketplace-Action ist einfach. Sie verweisen in Ihrer Workflow-YAML-Datei mit dem Schlüsselwort uses darauf, gefolgt von owner/repo@version der Action.
Ein häufiges Beispiel ist actions/checkout. Damit wird der Code Ihres Repositorys ausgecheckt, sodass Ihr Workflow darauf zugreifen kann.
name: Marketplace Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Say hello
run: echo "Hello from workflow!"Eingaben und Ausgaben von Actions
Viele Actions akzeptieren Eingaben, mit denen Sie ihr Verhalten anpassen können. Diese werden mit dem Schlüsselwort with angegeben. Außerdem können sie Ausgaben erzeugen, die andere Schritte in Ihrem Workflow verwenden können.
Beispielsweise kann die Action actions/setup-node die Eingabe node-version entgegennehmen.
name: Node Setup Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js 18.x
uses: actions/setup-node@v3
with:
node-version: '18.x'
- name: Install dependencies
run: npm installWann Sie eine eigene Action erstellen sollten
Der Marketplace bietet zwar eine große Auswahl, aber manchmal benötigen Sie etwas Spezielles. Dann sind eigene Actions hilfreich!
Sie könnten eine eigene Action erstellen, um:
- Interne Unternehmenstools zu automatisieren.
- Eine einzigartige API zu integrieren, die von vorhandenen Actions nicht abgedeckt wird.
- Hochspezialisierte Aufgaben auszuführen, die für den Build-Prozess Ihres Projekts erforderlich sind.
Arten eigener Actions
Es gibt zwei Hauptarten eigener Actions, die Sie erstellen können:
- JavaScript Actions: Diese werden mit Node.js direkt auf dem Rechner des Runners ausgeführt. Sie lassen sich oft schneller entwickeln und einfacher teilen.
- Docker-Container-Actions: Diese werden in einem Docker-Container ausgeführt. Sie eignen sich hervorragend, um Umgebungen und Abhängigkeiten zu kapseln und so eine einheitliche Ausführung auf verschiedenen Runnern sicherzustellen.
Der Einfachheit halber konzentrieren wir uns auf JavaScript Actions.
Die Datei `action.yml`
Jede eigene Action benötigt eine action.yml-Datei. Diese Datei definiert die Metadaten der Action, darunter ihren Namen und ihre Beschreibung, die akzeptierten Eingaben, die erzeugten Ausgaben und ihre Ausführungsweise.
Sie ist wie das Manifest Ihrer Action und teilt GitHub Actions alles mit, was es wissen muss.
name: 'My Custom Greeting Action'
description: 'Greets a person with a custom message.'
inputs:
who-to-greet:
description: 'Who to greet'
required: true
default: 'World'
outputs:
time:
description: 'The time we greeted you'
runs:
using: 'node16'
main: 'index.js'Eine einfache JavaScript Action erstellen
Erstellen wir eine sehr einfache JavaScript Action. Sie benötigen eine index.js-Datei (in action.yml angegeben) und normalerweise eine package.json-Datei für Abhängigkeiten.
Das Paket @actions/core ist für die Interaktion mit dem Workflow unerlässlich, beispielsweise zum Abrufen von Eingaben und Festlegen von Ausgaben.
const core = require('@actions/core');
async function run() {
try {
const nameToGreet = core.getInput('who-to-greet');
console.log(`Hello ${nameToGreet}!`);
const time = (new Date()).toTimeString();
core.setOutput("time", time);
} catch (error) {
core.setFailed(error.message);
}
}
run();Ihre eigene Action integrieren
Um Ihre eigene Action zu verwenden, legen Sie ihre Dateien (action.yml, index.js usw.) in einem Unterverzeichnis Ihres Repositorys ab. Verweisen Sie anschließend in Ihrem Workflow mit einem relativen Pfad darauf: uses: ./path/to/your/action.
So können Sie Ihre Action lokal testen, bevor Sie sie möglicherweise im Marketplace veröffentlichen.
name: Use Custom Action Demo
on: [push]
jobs:
greet:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run my custom action
uses: ./my-custom-action # Path to action directory
with:
who-to-greet: 'CoddyKit User'
- name: Get the output time
run: echo "The greeting time was ${{ steps.run-my-custom-action.outputs.time }}"Komponenten eigener Actions
Sie haben die wichtigsten Elemente zum Erstellen und Verwenden eigener GitHub Actions kennengelernt. Testen wir Ihr Verständnis!
Zusammenfassung: Marketplace und eigene Actions
Sehr gut! Sie haben die Möglichkeiten sowohl des GitHub Actions Marketplace als auch eigener Actions erkundet.
- Der Marketplace bietet eine große Auswahl sofort einsetzbarer Actions, mit denen Sie Ihre Workflows optimieren können.
- Eigene Actions ermöglichen es Ihnen, GitHub Actions an die besonderen Anforderungen Ihres Projekts oder Ihrer Organisation anzupassen.
Durch die Kombination beider Möglichkeiten können Sie äußerst leistungsstarke und maßgeschneiderte Automatisierungspipelines erstellen!
Häufig gestellte Fragen
Ist die Lektion „Benutzerdefinierte Actions und Marketplace“ kostenlos?
Ja — der vollständige Text von „Benutzerdefinierte Actions und 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 Git & GitHub Professional Workflow-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Git & GitHub Professional Workflow-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Benutzerdefinierte Actions und Marketplace“?
Erkunden Sie den GitHub Actions Marketplace mit vorgefertigten Actions und lernen Sie, eigene benutzerdefinierte Actions zu erstellen. Du übst Git & GitHub Professional Workflow 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 Git & GitHub Professional Workflow zu starten?
Keine Vorkenntnisse erforderlich. Git & GitHub Professional Workflow 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 3 von 4.
Wie lange dauert die Lektion „Benutzerdefinierte Actions und 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 Git & GitHub Professional Workflow-Lektion Code schreiben und ausführen?
Ja. Jede Git & GitHub Professional Workflow-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
- Einführung in GitHub Actions
- CI/CD-Workflows erstellen
- Benutzerdefinierte Actions und Marketplace
- Secrets und Umgebungsvariablen in Actions