# Referenz zur Metadatensyntax Du kannst Aktionen erstellen, um Aufgaben in deinem Repository auszuführen. Wenn Sie eine benutzerdefinierte Aktion erstellen, ist eine Metadatendatei erforderlich, die YAML-Syntax verwendet. > \[!NOTE] > Du kannst Docker-Container-, JavaScript- und zusammengesetzte Aktionen erstellen. Aktionen erfordern eine Metadatendatei, um die Eingaben, Ausgaben und Ausführungskonfigurationen für deine Aktion zu definieren. Metadatendateien für Aktionen verwenden YAML-Syntax, und der Name der Metadatendatei muss `action.yml` oder `action.yaml` lauten. Das bevorzugte Format ist `action.yml`. ## `name` ``` **Erforderlich** Der Name deiner Aktion. GitHub zeigt `name` auf der Registerkarte **Aktionen** an, um Aktionen in jedem Auftrag visuell erkennbar zu machen. ``` ## `author` ``` **Optional** Der Name des Autors der Aktion ``` ## `description` ``` **Erforderlich** Eine kurze Beschreibung der Aktion ``` ## `inputs` ``` **Optional** Mit Eingabeparametern kannst du die Daten angeben, die die Aktion während der Laufzeit erwartet. GitHub speichert Eingabeparameter als Umgebungsvariablen. Wir empfehlen, Eingabe-IDs in Kleinbuchstaben zu verwenden. ``` ### Beispiel: Angeben von Eingaben In diesem Beispiel werden zwei Eingaben konfiguriert: `num-octocats` und `octocat-eye-color`. Die Eingabe `num-octocats` ist nicht erforderlich und wird standardmäßig auf den Wert `1` festgelegt. `octocat-eye-color` ist erforderlich und weist keinen Standardwert auf. > \[!NOTE] > Aktionen, die `required: true` verwenden, geben nicht automatisch einen Fehler zurück, wenn keine Eingabe angegeben ist. Workflowdateien, die diese Aktion nutzen, müssen das Schlüsselwort `with` verwenden, um einen Eingabewert für `octocat-eye-color` festzulegen. Weitere Informationen zur `with`-Syntax findest du unter [Workflowsyntax für GitHub Actions](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepswith). ```yaml inputs: num-octocats: description: 'Number of Octocats' required: false default: '1' octocat-eye-color: description: 'Eye color of the Octocats' required: true ``` Wenn Sie eine Eingabe angeben, erstellt GitHub eine Umgebungsvariable für die Eingabe mit dem Namen `INPUT_`. Die erstellte Umgebungsvariable konvertiert Eingabenamen in Großbuchstaben und ersetzt Leerzeichen durch `_`-Zeichen. Wenn es sich um eine [zusammengesetzte](/de/actions/creating-actions/creating-a-composite-action) Aktion handelt, wird `INPUT_` nicht automatisch erstellt. Mit zusammengesetzten Aktionen können Sie `inputs`[Kontextreferenz](/de/actions/learn-github-actions/contexts) verwenden, um auf Aktionseingaben zuzugreifen. Um auf die Umgebungsvariable in einer Docker-Containeraktion zuzugreifen, musst du die Eingabe mithilfe des Schlüsselworts `args` in der Metadatendatei für die Aktion übergeben. Weitere Informationen zur Metadatendatei für Docker-Containeraktionen findest du unter [Creating a Docker container action (Erstellen einer Docker-Containeraktion)](/de/actions/creating-actions/creating-a-docker-container-action#creating-an-action-metadata-file). Wenn ein Workflow beispielsweise die Eingaben `num-octocats` und `octocat-eye-color` definiert hat, kann der Aktionscode die Werte der Eingaben mithilfe der Umgebungsvariablen `INPUT_NUM-OCTOCATS` und `INPUT_OCTOCAT-EYE-COLOR` lesen. ### `inputs.` ``` **Erforderlich** Ein `string`-Bezeichner, der der Eingabe zugeordnet werden soll. Der Wert von `` entspricht einer Zuordnung der Metadaten der Eingabe. `` muss ein eindeutiger Bezeichner innerhalb des `inputs`-Objekts sein. `` muss mit einem Buchstaben oder `_` beginnen und darf nur alphanumerische Zeichen, `-` oder `_` enthalten. ``` ### `inputs..description` ``` **Erforderlich** Eine `string`-Beschreibung des Eingabeparameters ``` ### `inputs..required` ``` **Optional** Ein `boolean`-Wert, der angibt, ob die Aktion den Eingabeparameter benötigt. Dieser ist auf `true` festgelegt, wenn der Parameter erforderlich ist. ``` ### `inputs..default` ``` **Optional** Ein `string`-Wert, der den Standardwert darstellt. Der Standardwert wird verwendet, wenn ein Eingabeparameter in einer Workflow-Datei nicht angegeben ist. ``` ### `inputs..deprecationMessage` ``` **Optional** Wenn der Eingabeparameter verwendet wird, wird dieser `string`-Wert als Warnmeldung protokolliert. Du kannst diese Warnung verwenden, um Benutzer*innen darüber zu informieren, dass die Eingabe schließen ist, und mögliche Alternativen erwähnen. ``` ## ``` `outputs` für Docker-Container und JavaScript-Aktionen **Optional** Ausgabeparameter ermöglichen es Ihnen, Daten zu deklarieren, die eine Aktion festlegt. Aktionen, die in einem Workflow später ausgeführt werden, können die Ausgabedaten der zuvor ausgeführten Aktionen verwenden. Wenn beispielsweise eine Aktion vorliegt, die zwei Eingaben addiert hat (x + y = z), kann die Aktion die Summe (z) für andere Aktionen ausgeben, damit sie dort als Eingabe verwendet wird. ``` Ausgaben dürfen maximal 1 MB pro Auftrag groß sein. Die Gesamtanzahl aller Ausgaben in einer Workflowausführung kann maximal 50 MB betragen. Eine Annäherung an die Größe erfolgt auf Basis der UTF-16-Codierung. Auch wenn du in der Metadaten-Datei deiner Aktion keine Ausgabe deklarierst, kannst du dennoch Ausgaben festlegen und in einem Workflow verwenden. Weitere Informationen zum Festlegen von Ausgaben in einer Aktion findest du unter [Workflow commands for GitHub Actions (Workflowbefehle für GitHub Actions)](/de/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter). ### Beispiel: Deklarieren von Ausgaben für Docker-Container und JavaScript-Aktionen ```yaml outputs: sum: # id of the output description: 'The sum of the inputs' ``` ### `outputs.` ``` **Erforderlich** Ein `string`-Bezeichner, der der Ausgabe zugeordnet werden soll. Der Wert von `` entspricht einer Zuordnung der Metadaten der Ausgabe. `` muss ein eindeutiger Bezeichner innerhalb des `outputs`-Objekts sein. `` muss mit einem Buchstaben oder `_` beginnen und darf nur alphanumerische Zeichen, `-` oder `_` enthalten. ``` ### `outputs..description` ``` **Erforderlich** Eine `string`-Beschreibung des Ausgabeparameters ``` ## ``` `outputs` für zusammengesetzte Aktionen **Optional**`outputs` verwendet die gleichen Parameter wie `outputs.` und `outputs..description` ([`outputs` für Docker-Containeraktionen und JavaScript-Aktionen](#outputs-for-docker-container-and-javascript-actions)), enthält jedoch das Token `value`. ``` Ausgaben dürfen maximal 1 MB pro Auftrag groß sein. Die Gesamtanzahl aller Ausgaben in einer Workflowausführung kann maximal 50 MB betragen. Eine Annäherung an die Größe erfolgt auf Basis der UTF-16-Codierung. ### Beispiel: Deklarieren von Ausgaben für zusammengesetzte Aktionen ```yaml outputs: random-number: description: "Random number" value: ${{ steps.random-number-generator.outputs.random-id }} runs: using: "composite" steps: - id: random-number-generator run: echo "random-id=$(echo $RANDOM)" >> $GITHUB_OUTPUT shell: bash ``` ### `outputs..value` ``` **Erforderlich** Der Wert, dem der Ausgabeparameter zugeordnet wird. Du kannst diesen auf `string` oder einen Ausdruck mit Kontext festlegen. Du kannst beispielsweise den `steps`-Kontext verwenden, um das `value`-Element einer Ausgabe auf den Ausgabewert eines Schritts festzulegen. ``` Weitere Informationen zur Verwendung der Kontextsyntax findest du unter [Kontextreferenz](/de/actions/learn-github-actions/contexts). ## `runs` ``` **Erforderlich** Gibt an, ob es sich um eine JavaScript-Aktion, eine zusammengesetzte Aktion oder eine Docker-Containeraktion handelt und wie die Aktion ausgeführt wird ``` ## ``` `runs` für JavaScript-Aktionen **Erforderlich** Konfiguriert den Pfad zum Code der Aktion und die Runtime, die zum Ausführen des Codes verwendet wird ``` ### Beispiel: Verwendung von Node.js 24 ```yaml runs: using: 'node24' main: 'main.js' ``` ### ``` `runs.using` für JavaScript-Aktionen **Erforderlich** Die Runtime, mit der der in [`main`](#runsmain) angegebene Code ausgeführt wird. ``` * Verwende `node20` für Node.js v20. * Verwende `node24` für Node.js 24. ### `runs.main` ``` **Erforderlich** Die Datei, die deinen Aktionscode enthält. Die in [`using`](#runsusing-for-javascript-actions) angegebene Runtime führt diese Datei aus. ``` ### `runs.pre` ``` **Optional** Ermöglicht es Ihnen, ein Skript am Anfang eines Auftrags auszuführen, bevor die Aktion `main:` beginnt. Du kannst beispielsweise mit `pre:` ein erforderliches Setupskript ausführen. Die mit der [`using`](#runsusing-for-javascript-actions)-Syntax angegebene Runtime führt diese Datei aus. Die Aktion `pre:` wird standardmäßig immer ausgeführt. Du kannst dies jedoch mit [`runs.pre-if`](#runspre-if) außer Kraft setzen. ``` > \[!NOTE] ``` `runs.pre` wird für lokale Aktionen nicht unterstützt. ``` In diesem Beispiel führt die Aktion `pre:` ein Skript mit dem Namen `setup.js` aus: ```yaml runs: using: 'node24' pre: 'setup.js' main: 'index.js' post: 'cleanup.js' ``` ### `runs.pre-if` ``` **Optional** Ermöglicht es Ihnen, Bedingungen für die Ausführung der Aktion `pre:` zu definieren. Die Aktion `pre:` wird nur ausgeführt, wenn die Bedingungen in `pre-if` erfüllt sind. Wenn keine festgelegt sind, wird `pre-if` standardmäßig auf `always()` festgelegt. In `pre-if` vergleichen die entsprechenden Funktionen den Status mit dem des Auftrags, nicht mit dem Status der Aktion. ``` Beachte, dass der `step`-Kontext nicht verfügbar ist, da noch keine Schritte ausgeführt wurden. In diesem Beispiel kann `cleanup.js` nur mit Linux-basierten Runnern ausgeführt werden. ```yaml pre: 'cleanup.js' pre-if: runner.os == 'linux' ``` ### `runs.post` ``` **Optional** Ermöglicht es Ihnen, ein Skript am Ende eines Auftrags auszuführen, sobald die Aktion `main:` abgeschlossen wurde. Du kannst beispielsweise `post:` verwenden, um bestimmte Prozesse zu beenden oder nicht benötigte Dateien zu entfernen. Die mit der [`using`](#runsusing-for-javascript-actions)-Syntax angegebene Runtime führt diese Datei aus. ``` In diesem Beispiel führt die Aktion `post:` ein Skript mit dem Namen `cleanup.js` aus: ```yaml runs: using: 'node24' main: 'index.js' post: 'cleanup.js' ``` Die Aktion `post:` wird standardmäßig immer ausgeführt. Du kannst dies jedoch mit `post-if` außer Kraft setzen. ### `runs.post-if` ``` **Optional** Ermöglicht es Ihnen, Bedingungen für die Ausführung der Aktion `post:` zu definieren. Die Aktion `post:` wird nur ausgeführt, wenn die Bedingungen in `post-if` erfüllt sind. Wenn keine festgelegt sind, wird `post-if` standardmäßig auf `always()` festgelegt. In `post-if` vergleichen die entsprechenden Funktionen den Status mit dem des Auftrags, nicht mit dem Status der Aktion. `cleanup.js` kann beispielsweise nur mit Linux-basierten Runnern ausgeführt werden: ``` ```yaml post: 'cleanup.js' post-if: runner.os == 'linux' ``` ## ``` `runs` für zusammengesetzte Aktionen **Erforderlich** Konfiguriert den Pfad zur zusammengesetzten Aktion ``` ### ``` `runs.using` für zusammengesetzte Aktionen **Erforderlich** Du musst diesen Wert auf `'composite'` festlegen. ``` ### `runs.steps` ``` **Erforderlich** Die Schritte, die in dieser Aktion ausgeführt werden sollen. Dabei kann es sich um `run`- oder `uses`-Schritte handeln. ``` #### `runs.steps[*].run` ``` **Optional** Der Befehl, den du ausführen möchtest. Dieser kann inline oder mit einem Skript in deinem Aktionsrepository angegeben werden: ``` ```yaml runs: using: "composite" steps: - run: ${{ github.action_path }}/test/script.sh shell: bash ``` Alternativ kannst du auch `$GITHUB_ACTION_PATH` verwenden: ```yaml runs: using: "composite" steps: - run: $GITHUB_ACTION_PATH/script.sh shell: bash ``` Weitere Informationen finden Sie unter [Kontextreferenz](/de/actions/learn-github-actions/contexts#github-context). #### `runs.steps[*].shell` ``` **Optional** Die Shell, in der der Befehl ausgeführt werden soll. Du kannst eine der in [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsshell) aufgeführten Shells verwenden. Erforderlich, wenn `run` festgelegt ist. ``` #### `runs.steps[*].if` ``` **Optional** Du kannst die `if`-Bedingung verwenden, um zu verhindern, dass ein Schritt ausgeführt wird – es sei denn, eine Bedingung ist erfüllt. Du kannst eine Bedingung mit jedem unterstützten Kontext und Ausdruck erstellen. ``` Wenn du Ausdrücke in einer `if`-Bedingung verwendest, kannst du optional die `${{ }}`-Ausdruckssyntax weglassen, da GitHub Actions die `if`-Bedingung automatisch als Ausdruck wertet. Diese Ausnahme gilt jedoch nicht überall. Du musst immer die Syntax des `${{ }}`-Ausdrucks verwenden oder mit `''`, `""` oder `()` abbrechen, wenn der Ausdruck mit `!` beginnt, da `!` die reservierte Schreibweise im YAML-Format ist. Zum Beispiel: ```yaml if: ${{ ! startsWith(github.ref, 'refs/tags/') }} ``` Weitere Informationen finden Sie unter [Auswerten von Ausdrücken in Workflows und Aktionen](/de/actions/learn-github-actions/expressions). ``` **Beispiel: Verwenden von Kontexten** ``` Dieser Schritt wird nur ausgeführt, wenn der Ereignistyp `pull_request` und die Ereignisaktion `unassigned` lautet. ```yaml steps: - run: echo This event is a pull request that had an assignee removed. if: ${{ github.event_name == 'pull_request' && github.event.action == 'unassigned' }} ``` ``` **Beispiel: Verwenden von Funktionen zur Statusüberprüfung** `my backup step` wird nur ausgeführt, wenn der vorherige Schritt einer zusammengesetzten Aktion nicht erfolgreich war. Weitere Informationen finden Sie unter [AUTOTITLE](/actions/learn-github-actions/expressions#status-check-functions). ``` ```yaml steps: - name: My first step uses: octo-org/action-name@main - name: My backup step if: ${{ failure() }} uses: actions/heroku@1.0.0 ``` #### `runs.steps[*].name` ``` **Optional** Der Name des zusammengesetzten Schritts ``` #### `runs.steps[*].id` ``` **Optional** Ein eindeutiger Bezeichner für den Schritt. Du kannst mit `id` auf den Schritt in Kontexten verweisen. Weitere Informationen finden Sie unter [AUTOTITLE](/actions/learn-github-actions/contexts). ``` #### `runs.steps[*].env` ``` **Optional** Legt eine `map` von Umgebungsvariablen fest, die nur in diesem Schritt verwendet werden. Wenn du die im Workflow gespeicherte Umgebungsvariable ändern möchtest, verwende `echo "{name}={value}" >> $GITHUB_ENV` in einem zusammengesetzten Schritt. ``` #### `runs.steps[*].working-directory` ``` **Optional** Gibt das Arbeitsverzeichnis an, in dem der Befehl ausgeführt wird ``` #### `runs.steps[*].uses` ``` **Optional** Wählt eine Aktion aus, die als Teil eines Schritts in deinem Auftrag ausgeführt werden soll. Eine Aktion ist eine wiederverwendbare Code-Einheit. Du kannst eine Aktion verwenden, die im selben Repository wie der Workflow, in einem öffentlichen Repository oder in einem [veröffentlichten Docker-Containerimage](https://hub.docker.com/) definiert ist. ``` Es wird dringend empfohlen, die verwendete Version der Aktion zu nennen (Git-Ref, SHA oder Docker-Tag-Nummer angeben). Wenn du keine Version angibst, könnten damit die Workflows gestört werden, oder es wird ein unerwartetes Verhalten hervorgerufen, wenn der bzw. die Besitzer\*in der Aktion eine Aktualisierung veröffentlicht. * Am besten in Hinblick auf Stabilität und Sicherheit ist es, die Commit-SHA einer freigegebenen Version einer Aktion zu verwenden. * Durch die Verwendung der spezifischen Hauptaktionsversion kannst du kritische Fehlerbehebungen und Sicherheitspatches erhalten und gleichzeitig die Kompatibilität wahren. Außerdem ist damit sichergestellt, dass der Workflow weiterhin problemlos arbeiteten sollte. * Die Verwendung des Standardbranches einer Aktion ist zwar auf den ersten Blick praktisch, doch wenn eine neue Hauptversion mit einem Breaking Change veröffentlicht wird, könnte der Workflow unterbrochen werden. Einige Aktionen erfordern Eingaben, die du mit dem Schlüsselwort [`with`](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepswith) festlegen musst. Die erforderlichen Eingaben findest du in der README-Datei der Aktion. ```yaml runs: using: "composite" steps: # Reference a specific commit - uses: actions/checkout@8f4b7f84864484a7bf31766abe9204da3cbe65b3 # Reference the major version of a release - uses: actions/checkout@v5 # Reference a specific version - uses: actions/checkout@v5.2.0 # Reference a branch - uses: actions/checkout@main # References a subdirectory in a public GitHub repository at a specific branch, ref, or SHA - uses: actions/aws/ec2@main # References a local action - uses: ./.github/actions/my-action # References a docker public registry action - uses: docker://gcr.io/cloud-builders/gradle # Reference a docker image published on docker hub - uses: docker://alpine:3.8 ``` #### `runs.steps[*].with` ``` **Optional** Eine `map` der Eingabeparameter, die durch die Aktion definiert werden. Jeder Eingabeparameter ist ein Schlüssel-Wert-Paar. Weitere Informationen findest du unter [Beispiel: Angeben von Eingaben](#example-specifying-inputs). ``` ```yaml runs: using: "composite" steps: - name: My first step uses: actions/hello_world@main with: first_name: Mona middle_name: The last_name: Octocat ``` #### `runs.steps[*].continue-on-error` ``` **Optional** Verhindert, dass bei der Aktion ein Fehler auftritt, wenn bei einem Schritt ein Fehler auftritt. Lege dies auf `true` fest, damit die Aktion erfolgreich abgeschlossen werden kann, wenn bei diesem Schritt ein Fehler auftritt. ``` ## ``` `runs` für Docker-Containeraktionen **Erforderlich** Konfiguriert das Image, das für die Docker-Containeraktion verwendet wird ``` ### Beispiel: Verwenden eines Dockerfiles in deinem Repository ```yaml runs: using: 'docker' image: 'Dockerfile' ``` ### Beispiel: Verwenden des öffentlichen Docker-Registrierungscontainers ```yaml runs: using: 'docker' image: 'docker://debian:stretch-slim' ``` ### ``` `runs.using` für Docker-Containeraktionen **Erforderlich** Du musst diesen Wert auf `'docker'` festlegen. ``` ### `runs.pre-entrypoint` ``` **Optional** Ermöglicht es Ihnen, ein Skript auszuführen, bevor die Aktion `entrypoint` beginnt. Du kannst beispielsweise mit `pre-entrypoint:` ein erforderliches Setupskript ausführen. GitHub Actions verwendet `docker run`, um diese Aktion zu starten, und führt das Skript in einem neuen Container aus, der das gleiche Basisimage verwendet. Das bedeutet, dass sich der Laufzeitstatus vom `entrypoint`-Hauptcontainer unterscheidet, und auf alle benötigten Status muss entweder im Arbeitsbereich `HOME` oder als `STATE_`-Variable zugegriffen werden. Die Aktion `pre-entrypoint:` wird standardmäßig immer ausgeführt. Du kannst dies jedoch mit [`runs.pre-if`](#runspre-if) außer Kraft setzen. ``` Die mit der [`using`](#runsusing-for-docker-container-actions)-Syntax angegebene Runtime führt diese Datei aus. In diesem Beispiel führt die Aktion `pre-entrypoint:` ein Skript mit dem Namen `setup.sh` aus: ```yaml runs: using: 'docker' image: 'Dockerfile' args: - 'bzz' pre-entrypoint: 'setup.sh' entrypoint: 'main.sh' ``` ### `runs.image` ``` **Erforderlich** Docker-Image, das beim Ausführen der Aktion als Container herangezogen wird. Der Wert kann der Name des Docker-Basisimages sein, ein lokales `Dockerfile` in deinem Repository oder ein öffentliches Image in Docker Hub oder einer anderen Registrierung. Damit du lokal auf ein `Dockerfile` in deinem Repository verweisen kannst, muss die Datei `Dockerfile` heißen, und du musst einen relativen Pfad zu deiner Metadatendatei für die Aktion verwenden. Die `docker`-Anwendung führt diese Datei aus. ``` ### `runs.env` ``` **Optional** Gibt eine Schlüssel-Wert-Zuordnung der Umgebungsvariablen an, die in der Containerumgebung festgelegt werden sollen. ``` ### `runs.entrypoint` ``` **Optional** Überschreibt `ENTRYPOINT` für Docker in `Dockerfile` oder legt einen Einstiegspunkt fest, falls noch keiner vorhanden ist. Verwende `entrypoint`, wenn `Dockerfile` in `ENTRYPOINT` nicht angegeben ist oder du die `ENTRYPOINT`-Anweisung außer Kraft setzen möchtest. Wenn du `entrypoint` auslässt, werden die Befehle ausgeführt, die du in der Docker-Anweisung `ENTRYPOINT` angibst. Für die Docker-Anweisung `ENTRYPOINT` gibt es ein _Shellformat_ und ein _Ausführungsformat_. In der Docker-Dokumentation zu `ENTRYPOINT` wird das _Ausführungsformat_ der `ENTRYPOINT`-Anweisung empfohlen. ``` Weitere Informationen zur Ausführung von `entrypoint` findest du unter [Dockerfile Unterstützung für GitHub Aktionen](/de/actions/creating-actions/dockerfile-support-for-github-actions#entrypoint). ### `runs.post-entrypoint` ``` **Optional** Ermöglicht es Ihnen, ein Bereinigungsskript auszuführen, sobald die Aktion `runs.entrypoint` abgeschlossen ist. GitHub Actions verwendet `docker run`, um diese Aktion zu starten. Da GitHub Actions das Skript in einem neuen Container mit dem gleichen Basisimage ausführt, unterscheidet sich der Laufzeitstatus vom `entrypoint`-Hauptcontainer. Du kannst auf jeden benötigten Status im Arbeitsbereich `HOME` oder als `STATE_`-Variable zugreifen. Die Aktion `post-entrypoint:` wird standardmäßig immer ausgeführt. Du kannst dies jedoch mit [`runs.post-if`](#runspost-if) außer Kraft setzen. ``` ```yaml runs: using: 'docker' image: 'Dockerfile' args: - 'bzz' entrypoint: 'main.sh' post-entrypoint: 'cleanup.sh' ``` ### `runs.args` ``` **Optional** Ein Array aus Zeichenfolgen, die die Eingaben für einen Docker-Container definieren. Eingaben können hartcodierte Strings enthalten. GitHub übergibt `args` beim Start des Containers an dessen `ENTRYPOINT`. ``` Die `args`-Elemente werden anstelle der `CMD`-Anweisung in `Dockerfile` verwendet. Wenn du `CMD` in `Dockerfile` verwendest, befolge diese Hinweise (nach Präferenz sortiert): 1. Dokumentieren die erforderlichen Argumente in der README-Datei der Aktion, und lasse sie in der `CMD`-Anweisung weg. 2. Verwende Standardwerte, die die Verwendung der Aktion ohne die Angabe von `args` ermöglichen. 3. Wenn die Aktion ein `--help`-Flag oder etwas ähnliches verfügbar macht, verwende dies, damit die Aktion selbstdokumentierend wird. Falls Sie Umgebungsvariablen in eine Aktion übergeben müssen, stellen Sie sicher, dass Ihre Aktion eine Kommandozeile ausführt, um eine Variablensubstitution vorzunehmen. Wenn dein `entrypoint`-Attribut beispielsweise auf `"sh -c"` festgelegt ist, wird `args` in einer Befehlsshell ausgeführt. Wenn `Dockerfile` jedoch `ENTRYPOINT` für die Ausführung dieses Befehls (`"sh -c"`) verwendet, wird `args` in einer Befehlsshell ausgeführt. Weitere Informationen zur Verwendung der `CMD`-Anweisung mit GitHub Actions findest du unter [Dockerfile Unterstützung für GitHub Aktionen](/de/actions/creating-actions/dockerfile-support-for-github-actions#cmd). #### Beispiel: Definieren von Argumenten für den Docker-Container ```yaml runs: using: 'docker' image: 'Dockerfile' args: - ${{ inputs.greeting }} - 'foo' - 'bar' ``` ## `branding` Optional: Du kannst ein farbiges Feather-Symbol verwenden, um ein Abzeichen zu erstellen, um deine Aktion zu personalisieren und zu unterscheiden. Badges werden neben dem Aktionsnamen in [GitHub Marketplace](https://github.com/marketplace?type=actions) angezeigt. ### Beispiel: Konfigurieren des Brandings für eine Aktion ```yaml branding: icon: 'award' color: 'green' ``` ### `branding.color` Die Hintergrundfarbe des Badges Dies kann eine der folgenden Möglichkeiten sein: `white`, `black`, `yellow`, `blue`, `green`, `orange`, `red`, `purple` oder `gray-dark`. ### `branding.icon` Der Name des zu verwendenden [Feather-Symbols](https://feathericons.com/) (Version 4.28.0). #### Ausgelassene Symbole Markensymbole und alle folgenden Symbole werden weggelassen:
  • Kaffee
  • Spalten
  • divide-circle
  • divide-square
  • divide
  • frown
  • Hexagon
  • Schlüssel
  • naja
  • Mauszeiger
  • Lächeln
  • Werkzeug
  • x-Oktagon
#### Vollständige Liste aller derzeit unterstützten Symbole:
  • Aktivität
  • airplay
  • alert-circle
  • alert-octagon
  • Warnsymbol-Dreieck
  • align-center
  • align-justify
  • align-left
  • align-right
  • Anker
  • Blende
  • Archiv
  • Abwärtspfeil-Kreis
  • arrow-down-left
  • arrow-down-right
  • arrow-down
  • Pfeil-links-Kreis
  • arrow-left
  • arrow-right-circle
  • arrow-right
  • Pfeil-nach-oben-Kreis
  • arrow-up-left
  • arrow-up-right
  • Pfeil-hoch
  • at-sign
  • Auszeichnung
  • Balkendiagramm-2
  • Balkendiagramm
  • Batterieladung
  • Batterie
  • Alarm aus
  • Glocke
  • Bluetooth
  • Fett
  • Buch öffnen
  • Buch
  • Lesezeichen (bookmark)
  • box
  • Aktentasche
  • Kalender
  • Kamera aus
  • Kamera
  • cast
  • Kontrollkreis
  • check-square
  • überprüfen
  • Pfeil nach unten
  • chevron-left
  • Pfeil nach rechts
  • chevron-up
  • chevrons-down
  • chevrons-left
  • chevrons-right
  • chevrons-up
  • Kreis
  • Zwischenablage
  • Uhr
  • cloud-drizzle
  • Wolke-Blitz
  • Cloud deaktivieren
  • Wolkenregen
  • Wolken-Schnee
  • cloud
  • Programmcode
  • Befehl
  • Kompass
  • kopieren
  • corner-down-left
  • corner-down-right
  • corner-left-down
  • corner-left-up
  • corner-right-down
  • corner-right-up
  • corner-up-left
  • corner-up-right
  • Zentrale Verarbeitungseinheit (CPU)
  • Kreditkarte
  • crop
  • Fadenkreuz
  • Datenbank
  • löschen
  • disc
  • Dollarzeichen
  • Download-Cloud
  • Download
  • droplet
  • edit-2
  • edit-3
  • Bearbeiten
  • Externer Link
  • eye-off
  • Auge
  • Fast-Forward
  • Feder
  • file-minus
  • file-plus
  • Dateitext
  • Datei
  • film
  • filter
  • Flagge
  • folder-minus
  • folder-plus
  • Ordner
  • Geschenk
  • git-branch
  • git-commit
  • git-merge
  • git-pull-request
  • Globus
  • grid
  • Festplatte
  • hash
  • Kopfhörer
  • Herz
  • help-circle
  • Startseite
  • Bild
  • Posteingang
  • Informationen
  • kursiv
  • Ebenen
  • Layout
  • life-buoy
  • link-2
  • link
  • Liste
  • loader
  • Sperre
  • Anmeldung
  • Abmelden
  • E-Mail
  • map-pin
  • Karte
  • maximize-2
  • maximieren
  • Menü
  • Nachrichtenkreis
  • Nachrichten-Quadrat
  • Mikrofon aus
  • Mikrofon
  • minimieren-2
  • minimieren
  • Minus-Kreis-Symbol
  • minus-square
  • minus
  • Überwachen
  • Mond
  • mehr horizontal
  • mehr vertikal
  • Verschieben
  • Musik
  • navigation-2
  • navigation
  • Achteck
  • Paket
  • Büroklammer
  • Pause-Kreis
  • Pause
  • Prozent
  • Telefonanruf
  • phone-forwarded
  • eingehender Anruf
  • Anruf verpasst
  • Telefon aus
  • phone-outgoing
  • Telefon
  • Kreisdiagramm
  • play-circle
  • play
  • Plus-Kreis
  • plus-square
  • plus
  • Tasche
  • Leistung
  • Drucker
  • radio
  • refresh-ccw
  • refresh-cw
  • wiederholen
  • rewind
  • rotate-ccw
  • rotate-cw
  • rss
  • Speichern
  • Schere
  • Suche
  • senden
  • server
  • Einstellungen
  • share-2
  • Freigeben
  • shield-off
  • Schutzschild
  • Einkaufstasche
  • Einkaufswagen
  • Shuffle
  • Seitenleiste
  • skip-back
  • Weiter springen
  • slash
  • Schieberegler
  • smartphone
  • Lautsprecher
  • square
  • Stern
  • Stopp-Kreis
  • Sonne
  • Sonnenaufgang
  • Sonnenuntergang
  • Tabelle
  • Tablet
  • das Tag
  • Ziel
  • terminal
  • thermometer
  • Daumen nach unten
  • Daumen hoch
  • toggle-left
  • toggle-right
  • trash-2
  • trash
  • Abwärtstrend
  • im Aufwärtstrend
  • Dreieck
  • LKW
  • Fernseher
  • Typ
  • Regenschirm
  • Unterstreichen
  • Entsperren
  • Hochladen-Cloud
  • hochladen
  • Nutzerüberprüfung
  • user-minus
  • user-plus
  • user-x
  • Benutzer
  • Benutzer
  • video-off
  • video
  • Sprachnachricht
  • Band 1
  • volume-2
  • volume-x
  • Lautstärke
  • watch
  • WLAN aus
  • wifi
  • wind
  • x-circle
  • x-quadrat
  • x
  • zap-off
  • zap
  • vergrößern
  • herauszoomen
## Ändern des Namens der Metadatendatei Während die Aktionsmetadatendatei beide YAML-Formate unterstützt, wirkt sich das Ändern des Namens der Metadatendatei (von `action.yml` zu `action.yaml` oder umgekehrt) zwischen Versionen auf frühere Releaseversionen aus, die im GitHub Marketplace veröffentlicht wurden. Durch das Ändern des Dateinamens werden alle Releaseversionen im GitHub Marketplace ausgeblendet, die dem vorherigen Dateinamen zugeordnet sind. Auf frühere Releaseversionen kann weiterhin über das Quellrepository zugegriffen werden. Bei der Veröffentlichung neuer Versionen von Aktionen besitzen nur Versionen nach der Änderung des Metadatendateinamens das GitHub Marketplace-Tag und werden auf GitHub Marketplace angezeigt.