{"meta":{"title":"Speichern von Informationen in Variablen","intro":"GitHub legt Standardvariablen für jede GitHub Actions-Workflowausführung fest. Sie können auch benutzerdefinierte Variablen für die Verwendung in einem einzelnen oder mehreren Workflows festlegen.","product":"GitHub Actions","breadcrumbs":[{"href":"/de/actions","title":"GitHub Actions"},{"href":"/de/actions/how-tos","title":"Anleitungen"},{"href":"/de/actions/how-tos/write-workflows","title":"Schreiben von Workflows"},{"href":"/de/actions/how-tos/write-workflows/choose-what-workflows-do","title":"Auswählen, was in Workflows passiert"},{"href":"/de/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables","title":"Verwenden von Variablen"}],"documentType":"article"},"body":"# Speichern von Informationen in Variablen\n\nGitHub legt Standardvariablen für jede GitHub Actions-Workflowausführung fest. Sie können auch benutzerdefinierte Variablen für die Verwendung in einem einzelnen oder mehreren Workflows festlegen.\n\n## Definieren von Umgebungsvariablen für einen einzelnen Workflow\n\nUm eine benutzerdefinierte Umgebungsvariable für die Verwendung in einem einzelnen Workflow anzulegen, können Sie den `env`-Schlüssel in der Workflowdatei definieren. Der Geltungsbereich einer mit dieser Methode festgelegten benutzerdefinierten Variable ist auf das Element beschränkt, in dem sie definiert wird. Sie können Variablen definieren, die auf Folgendes beschränkt sind:\n\n* Den gesamten Workflow, indem Sie [`env`](/de/actions/using-workflows/workflow-syntax-for-github-actions#env) in der Workflowdatei auf der obersten Ebene verwenden\n* Der Inhalt eines Auftrags innerhalb eines Workflows unter Verwendung von [`jobs..env`](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idenv).\n* Einen bestimmten Schritt innerhalb eines Auftrags, indem Sie [`jobs..steps[*].env`](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsenv) verwenden\n\n```yaml copy\nname: Greeting on variable day\n\non:\n workflow_dispatch\n\nenv:\n DAY_OF_WEEK: Monday\n\njobs:\n greeting_job:\n runs-on: ubuntu-latest\n env:\n Greeting: Hello\n steps:\n - name: \"Say Hello Mona it's Monday\"\n run: echo \"$Greeting $First_Name. Today is $DAY_OF_WEEK!\"\n env:\n First_Name: Mona\n```\n\nSie können auf `env`-Variablenwerte mithilfe von Runnerumgebungsvariablen oder mithilfe von Kontexten zugreifen. Das Beispiel oben zeigt drei benutzerdefinierte Variablen, die als Umgebungsvariablen für Läufer in einem `echo` Befehl verwendet werden: `$DAY_OF_WEEK`, `$Greeting` und `$First_Name`. Die Werte für diese Variablen werden auf Workflow-, Auftrags- und Schrittebene festgelegt, und ihr Geltungsbereich wird entsprechend beschränkt. Die Interpolation dieser Variablen erfolgt auf dem Runner.\n\nDie Befehle in den `run` Schritten eines Workflows oder einer referenzierten Aktion werden von der Shell verarbeitet, die Sie auf dem Runner verwenden. Die Anweisungen in den anderen Teilen eines Workflows werden von GitHub Actions verarbeitet und nicht an den Runner gesendet. Sie können entweder Umgebungsvariablen des Runners oder Kontexte in `run` Schritten verwenden, aber in den Teilen eines Workflows, die nicht an den Runner gesendet werden, müssen Sie Kontexte für den Zugriff auf Variablenwerte verwenden. Weitere Informationen findest du unter [Verwenden von Kontexten für das Zugreifen auf Variablenwerte](#using-contexts-to-access-variable-values).\n\nDa die Interpolation der Runnerumgebungsvariablen nach dem Senden eines Workflowauftrags an einen Runnercomputer durchgeführt wird, müssen Sie die richtige Syntax für die auf dem Runner verwendete Shell verwenden. In diesem Beispiel ist im Workflow `ubuntu-latest` angegeben. Auf Linux-Runnern wird standardmäßig die Bash-Shell verwendet. Daher müssen Sie in diesem Fall die Syntax `$NAME` verwenden. Standardmäßig verwenden Windows-Runner PowerShell, sodass Sie die Syntax `$env:NAME` verwenden würden. Weitere Informationen zu Shells findest du unter [Workflowsyntax für GitHub Actions](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsshell).\n\n## Definieren von Konfigurationsvariablen für mehrere Workflows\n\nSie können Konfigurationsvariablen für mehrere Workflows erstellen und diese entweder auf [Organisations-](#creating-configuration-variables-for-an-organization), [Repository-](#creating-configuration-variables-for-a-repository) oder [Umgebungsebene](#creating-configuration-variables-for-an-environment) definieren.\n\nSie können beispielsweise Konfigurationsvariablen verwenden, um Standardwerte für Parameter festzulegen, die an Buildtools auf Organisationsebene übergeben werden, und Repositorybesitzern dann erlauben, diese Parameter von Fall zu Fall zu überschreiben.\n\nWenn Sie Konfigurationsvariablen definieren, sind sie automatisch im `vars`-Kontext verfügbar. Weitere Informationen findest du unter [Verwenden des `vars`-Kontexts für das Zugreifen auf Werte von Konfigurationsvariablen](#using-the-vars-context-to-access-configuration-variable-values).\n\n### Erstellen von Konfigurationsvariablen für ein Repository\n\nUm Geheimnisse oder Variablen auf GitHub für ein Organisations-Repository zu erstellen, benötigen Sie `write` Zugriff. Für ein persönliches Konto-Repository müssen Sie Repository-Kollaborator sein.\n\n1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.\n2. Klicke unter dem Repositorynamen auf ** Settings**. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü **** die Option **Einstellungen** aus.\n\n ![Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.](/assets/images/help/repository/repo-actions-settings.png)\n3. Wähle im Abschnitt „Security“ der Randleiste ** Secrets and variables**, und klicke anschließend auf **Actions**.\n4. Klicke auf die Registerkarte **Variablen**.\n ![Screenshot der Seite „Aktionsgeheimnisse und -variablen“. Die Registerkarte „Variablen“ ist mit einer dunklen orangen Linie umrandet.](/assets/images/help/repository/actions-variables-tab.png)\n5. Klicke auf **Neue Repository-Variable**.\n6. Gib im Feld **Name** einen Namen für deine Variable ein.\n7. Gib im Feld **Wert** den Wert für deine Variable ein.\n8. Klicke auf **Variable hinzufügen**.\n\n### Erstellen von Konfigurationsvariablen für eine Umgebung\n\nUm Geheimnisse oder Variablen für eine Umgebung in einem Repository eines persönlichen Kontos zu erstellen, müssen Sie Besitzer des Repositorys sein. Für das Erstellen von Geheimnissen oder Variablen für eine Umgebung in einem Organisationsrepository benötigen Sie `admin`-Zugriff. Weitere Informationen zu Umgebungen findest du unter [Verwalten von Umgebungen für die Bereitstellung](/de/actions/deployment/targeting-different-environments/managing-environments-for-deployment).\n\n1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.\n2. Klicke unter dem Repositorynamen auf ** Settings**. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü **** die Option **Einstellungen** aus.\n\n ![Screenshot eines Repositoryheaders mit den Registerkarten. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.](/assets/images/help/repository/repo-actions-settings.png)\n3. Klicke auf der linken Randleiste auf **Umgebungen**.\n4. Klicken Sie auf die Umgebung, der Sie eine Variable hinzufügen möchten.\n5. Klicke unter **Umgebungsvariablen** auf **Variable hinzufügen**.\n6. Gib im Feld **Name** einen Namen für deine Variable ein.\n7. Gib im Feld **Wert** den Wert für deine Variable ein.\n8. Klicke auf **Variable hinzufügen**.\n\n### Erstellen von Konfigurationsvariablen für eine Organisation\n\n> \\[!NOTE]\n> Auf Geheimnisse und Variablen auf Organisationsebene können private Repositorys für GitHub Free nicht zugreifen. Weitere Informationen zum Upgrade des GitHub-Abonnements sind unter [Heraufstufen deines Kontoplans](/de/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription) zu finden.\n\nBeim Erstellen eines Geheimnisses oder einer Variable in einer Organisation kannst du mit einer Richtlinie den Zugriff jeweils nach Repository einschränken. Du kannst beispielsweise allen Repositorys Zugriff gewähren oder nur private Repositorys oder eine angegebene Liste von Repositorys zulassen.\n\nOrganisationsbesitzer\\*innen können Geheimnisse oder Variablen auf Organisationsebene erstellen.\n\n1. Navigieren Sie auf GitHub zur Hauptseite der Organisation.\n\n2. Klicke unter dem Organisationsnamen auf ** Settings**. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü **** die Option **Einstellungen** aus.\n\n ![Screenshot der Registerkarten im Profil einer Organisation. Die Registerkarte „Einstellungen“ ist dunkelorange umrandet.](/assets/images/help/discussions/org-settings-global-nav-update.png)\n\n3. Wähle im Abschnitt „Security“ der Randleiste ** Secrets and variables**, und klicke anschließend auf **Actions**.\n\n4. Klicke auf die Registerkarte **Variablen**.\n\n ![Screenshot: Seite „Geheimnisse und Variablen für Aktionen“. Die Registerkarte „Variablen“ ist dunkel-orange umrandet.](/assets/images/help/repository/actions-variables-tab.png)\n\n5. Klicke auf **Neue Organisationsvariable**.\n\n6. Gib im Feld **Name** einen Namen für deine Variable ein.\n\n7. Gib im Feld **Wert** den Wert für deine Variable ein.\n\n8. Wähle in der Dropdownliste **Repositoryzugriff** eine Zugriffsrichtlinie aus.\n\n9. Klicke auf **Variable hinzufügen**.\n\n## Verwenden von Kontexten für den Zugriff auf die Werte von Variablen\n\nKontexte sind eine Möglichkeit, auf Informationen zu Workflowausführungen, Variablen, Runnerumgebungen, Aufträge und Schritten zuzugreifen. Weitere Informationen finden Sie unter [Kontextreferenz](/de/actions/learn-github-actions/contexts). Es gibt noch viele weitere Kontexte, die Sie für verschiedene Zwecke in deinen Workflows verwenden können. Ausführliche Informationen zum Verwenden von bestimmten Kontexten innerhalb eines Workflows findest du unter [Kontextreferenz](/de/actions/learn-github-actions/contexts#context-availability).\n\nSie können die Werte der Umgebungsvariablen über den `env`-Kontext und die Werte der Konfigurationsvariablen über den `vars`-Kontext aufrufen.\n\n### Verwenden des `env`-Kontexts für den Zugriff auf die Werte von Umgebungsvariablen\n\nNeben Runner-Umgebungsvariablen können Sie mit GitHub Actions auch mithilfe von Kontexten `env`-Schlüsselwerte festlegen und lesen. Umgebungsvariablen und Kontexte sind für verschiedene Stellen im Workflow vorgesehen.\n\nDie `run` Schritte in einem Workflow oder in einer referenzierten Aktion werden von einem Runner verarbeitet. Daher können Sie hier Umgebungsvariablen für den Runner verwenden, wobei Sie die entsprechende Syntax für die auf dem Runner verwendete Shell verwenden - zum Beispiel `$NAME` für die Bash-Shell auf einem Linux-Runner oder `$env:NAME` für PowerShell auf einem Windows-Runner. In den meisten Fällen können Sie auch Kontexte mit der Syntax `${{ CONTEXT.PROPERTY }}` verwenden, um auf denselben Wert zuzugreifen. Der Unterschied besteht darin, dass der Kontext interpoliert und durch eine Zeichenfolge ersetzt wird, bevor der Auftrag an einen Runner gesendet wird.\n\nSie können jedoch keine Runner-Umgebungsvariablen in Teilen eines Workflows verwenden, die von GitHub Actions verarbeitet und nicht an den Runner gesendet werden. Stattdessen kann man Kontexte verwenden. Eine `if`-Bedingung, mit der entschieden wird, ob ein Auftrag oder Schritt an den Runner gesendet wird, wird beispielsweise immer von GitHub Actions verarbeitet. Sie müssen daher einen Kontext in einer `if` bedingten Anweisung verwenden, um auf den Wert einer Variablen zuzugreifen.\n\n```yaml copy\nname: Conditional env variable\n\non: workflow_dispatch\n\nenv:\n DAY_OF_WEEK: Monday\n\njobs:\n greeting_job:\n runs-on: ubuntu-latest\n env:\n Greeting: Hello\n steps:\n - name: \"Say Hello Mona it's Monday\"\n if: ${{ env.DAY_OF_WEEK == 'Monday' }}\n run: echo \"$Greeting $First_Name. Today is $DAY_OF_WEEK!\"\n env:\n First_Name: Mona\n```\n\nIn dieser abgewandelten Version des vorherigen Beispiels wurde eine `if`-Bedingung ergänzt. Der Workflowschritt wird jetzt nur ausgeführt, wenn `DAY_OF_WEEK` auf „Monday“ festgelegt ist. Auf diesen Wert wird über die bedingte Anweisung `if` unter Verwendung des [`env`-Kontexts](/de/actions/learn-github-actions/contexts#env-context) zugegriffen. Der `env`-Kontext ist für die Variablen, auf die innerhalb des `run`-Befehls verwiesen wird nicht erforderlich. Sie werden als Runner-Umgebungsvariablen referenziert und interpoliert, nachdem der Auftrag vom Runner empfangen wurde. Wir könnten diese Variablen jedoch interpolieren, bevor wir den Auftrag an den Runner senden, indem wir Kontexte verwenden. Das Ergebnis wäre das gleiche.\n\n```yaml\nrun: echo \"${{ env.Greeting }} ${{ env.First_Name }}. Today is ${{ env.DAY_OF_WEEK }}!\"\n```\n\n> \\[!NOTE]\n> Kontexte werden in der Regel mit einem Dollarzeichen und geschweiften Klammern gekennzeichnet, z. B. `${{ context.property }}`. In einer `if`-Bedingung sind `${{` und `}}` optional. Wenn Sie diese Zeichen verwenden, müssen sie jedoch die gesamte Vergleichsanweisung umschließen, wie oben zu sehen.\n\n> \\[!WARNING]\n> Bei der Erstellung von Workflows und Aktionen sollten Sie immer bedenken, ob Ihr Code nicht vertrauenswürdige Eingaben von möglichen Eindringlingen ausführen könnte. Bestimmte Kontexte sollten als nicht vertrauenswürdige Eingaben behandelt werden, da ein Angreifer seine eigenen schädlichen Inhalte einfügen könnte. Weitere Informationen finden Sie unter [Referenz zur sicheren Verwendung](/de/actions/security-guides/security-hardening-for-github-actions#understanding-the-risk-of-script-injections).\n\n### Verwenden des Kontexts `vars` für den Zugriff auf Konfigurationsvariablenwerte\n\nAuf Konfigurationsvariablen kann im gesamten Workflow mithilfe des Kontexts `vars` zugegriffen werden. Weitere Informationen finden Sie unter [Kontextreferenz](/de/actions/learn-github-actions/contexts#vars-context).\n\nWenn keine Konfigurationsvariable festgelegt wurde, ist der Rückgabewert eines Kontexts, der auf die Variable verweist, eine leere Zeichenfolge.\n\nDas folgende Beispiel zeigt die Verwendung von Konfigurationsvariablen mit dem Kontext `vars` in einem Workflow. Jede der folgenden Konfigurationsvariablen wurde auf Repository-, Organisations- oder Umgebungsebene definiert.\n\n```yaml copy\non:\n workflow_dispatch:\nenv:\n # Setting an environment variable with the value of a configuration variable\n env_var: ${{ vars.ENV_CONTEXT_VAR }}\n\njobs:\n display-variables:\n name: ${{ vars.JOB_NAME }}\n # You can use configuration variables with the `vars` context for dynamic jobs\n if: ${{ vars.USE_VARIABLES == 'true' }}\n runs-on: ${{ vars.RUNNER }}\n environment: ${{ vars.ENVIRONMENT_STAGE }}\n steps:\n - name: Use variables\n run: |\n echo \"repository variable : $REPOSITORY_VAR\"\n echo \"organization variable : $ORGANIZATION_VAR\"\n echo \"overridden variable : $OVERRIDE_VAR\"\n echo \"variable from shell environment : $env_var\"\n env:\n REPOSITORY_VAR: ${{ vars.REPOSITORY_VAR }}\n ORGANIZATION_VAR: ${{ vars.ORGANIZATION_VAR }}\n OVERRIDE_VAR: ${{ vars.OVERRIDE_VAR }}\n \n - name: ${{ vars.HELLO_WORLD_STEP }}\n if: ${{ vars.HELLO_WORLD_ENABLED == 'true' }}\n uses: actions/hello-world-javascript-action@main\n with:\n who-to-greet: ${{ vars.GREET_NAME }}\n```\n\n## Erkennen des Betriebssystems\n\nMithilfe der Standardumgebungsvariable `RUNNER_OS` und der entsprechenden Kontexteigenschaft `${{ runner.os }}` können Sie eine einzelne Workflowdatei erstellen, die für verschiedene Betriebssysteme verwendet werden kann. Beispielsweise könnte der folgende Workflow erfolgreich ausgeführt werden, wenn Sie das Betriebssystem von `macos-latest` in `windows-latest` ändern, ohne dass die Syntax der Umgebungsvariablen angepasst werden muss, die je nachdem, welche Shell auf dem Runner verwendet wird, unterschiedlich ist.\n\n```yaml copy\non: workflow_dispatch\n\njobs:\n if-Windows-else:\n runs-on: macos-latest\n steps:\n - name: condition 1\n if: runner.os == 'Windows'\n run: echo \"The operating system on the runner is $env:RUNNER_OS.\"\n - name: condition 2\n if: runner.os != 'Windows'\n run: echo \"The operating system on the runner is not Windows, it's $RUNNER_OS.\"\n```\n\nIn diesem Beispiel wird mit den beiden `if`-Anweisungen die Eigenschaft `os` des Kontexts `runner` überprüft, um das Betriebssystem des Runners zu ermitteln. Die `if`-Bedingungen werden von GitHub Actions verarbeitet, und nur Schritte, in denen das Ergebnis der Überprüfung `true` lautet, werden an den Runner gesendet. Hier ist immer das Ergebnis einer Überprüfung `true` und das der anderen `false`, sodass nur einer dieser Schritte an den Runner gesendet wird. Sobald der Auftrag an den Runner gesendet wird, wird der Schritt ausgeführt, und die Umgebungsvariable im `echo`-Befehl wird mit der richtigen Syntax interpoliert (`$env:NAME` für PowerShell unter Windows und `$NAME` für Bash und sh unter Linux bzw. macOS). In diesem Beispiel bedeutet die Anweisung `runs-on: macos-latest`, dass der zweite Schritt ausgeführt wird.\n\n## Übergeben von Werten zwischen Schritten und Aufträgen in einem Workflow\n\nWenn ein Wert in einem Schritt eines Auftrags generiert wird, können Sie diesen in darauffolgenden Schritten desselben Auftrags verwenden, indem Sie den Wert einer bereits vorhandenen oder neuen Umgebungsvariable zuweisen und diese dann in die `GITHUB_ENV`-Umgebungsdatei schreibsen. Die Umgebungsdatei kann direkt von einer Aktion oder über einen Shellbefehl in der Workflowdatei mit dem Schlüsselwort `run` verwendet werden. Weitere Informationen finden Sie unter [Workflow commands for GitHub Actions (Workflowbefehle für GitHub Actions)](/de/actions/using-workflows/workflow-commands-for-github-actions#setting-an-environment-variable).\n\nWenn Sie einen Wert von einem Schritt in einem Auftrag in einem bestimmten Workflow an einen Schritt in einem anderen Auftrag in diesem Workflow übergeben möchten, können sie den Wert als Auftragsausgabe definieren. Dann können Sie in einem Schritt in einem anderen Auftrag auf diese Auftragsausgabe verweisen. Weitere Informationen finden Sie unter [Workflowsyntax für GitHub Actions](/de/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idoutputs).\n\n## Nächste Schritte\n\nReferenzinformationen findest du unter [Referenz für Variablen](/de/actions/reference/variables-reference)."}