You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: translations/de-DE/content/actions/creating-actions/about-actions.md
+20-18
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Informationen zu Aktionen
3
-
intro: 'Aktionen sind einzelne Aufgaben, die Du kombinieren kannst, um Aufträge zu erstellen und Deinen Workflow anzupassen. Sie können eigene Aktionen erstellen oder Aktionen verwenden und anpassen, die von der {% data variables.product.prodname_dotcom %} -Community gemeinsam genutzt werden.'
3
+
intro: 'Aktionen sind einzelne Aufgaben, die Du kombinieren kannst, um Aufträge zu erstellen und Deinen Workflow anzupassen. You can create your own actions, or use and customize actions shared by the {% data variables.product.prodname_dotcom %} community.'
4
4
product: '{% data reusables.gated-features.actions %}'
5
5
redirect_from:
6
6
- /articles/about-actions
@@ -20,7 +20,8 @@ versions:
20
20
Zum Erstellen von Aktionen können Sie benutzerdefinierten Code schreiben, der mit Ihrem Repository auf die gewünschte Weise interagiert und sich dabei beispielsweise in die APIs von {% data variables.product.prodname_dotcom %} und in öffentlich zugängliche Drittanbieter-APIs integriert. Mit einer Aktion können Sie beispielsweise npm-Module veröffentlichen, SMS-Nachrichten bei dringenden Problemen senden oder produktionsreifen Code bereitstellen.
21
21
22
22
{% if currentVersion == "free-pro-team@latest" %}
23
-
Sie können eigene Aktionen schreiben und ausschließlich in Ihrem Workflow verwenden oder auch Ihre erstellten Aktionen mit der {% data variables.product.prodname_dotcom %}-Community schreiben. Die erstellten Aktionen können nur dann freigegeben werden, wenn das Repository öffentlich ist.
23
+
You can write your own actions to use in your workflow or share the actions you build with the
24
+
{% data variables.product.prodname_dotcom %} community. Die erstellten Aktionen können nur dann freigegeben werden, wenn das Repository öffentlich ist.
24
25
{% endif %}
25
26
26
27
Aktionen können direkt auf einem Computer oder in einem Docker-Container laufen. Sie können die Eingabe, die Ausgabe und die Umgebungsvariablen für eine Aktion definieren.
@@ -53,57 +54,58 @@ Wenn Sie ein Node.js Projekt entwickeln, bietet das {% data variables.product.pr
Ein _zusammengesetzten Ausführungsschritte_ Aktion ermöglicht es Ihnen, mehrere Workflowausführungsschritte innerhalb einer Aktion zu kombinieren. Sie können diese Funktion beispielsweise verwenden, um mehrere Ausführungsbefehle in einer Aktion zu bündeln, und dann einen Workflow haben, der die gebündelten Befehle in einem einzigen Schritt mit dieser Aktion ausführt. Um ein Beispiel anzuzeigen, sehen Sie sich "[Erstellen einer zusammengesetzten Ausführungsschritteaktion](/actions/creating-actions/creating-a-composite-run-steps-action)" an.
57
+
A _composite run steps_ action allows you to combine multiple workflow run steps within one action. For example, you can use this feature to bundle together multiple run commands into an action, and then have a workflow that executes the bundled commands a single step using that action. To see an example, check out "[Creating a composite run steps action](/actions/creating-actions/creating-a-composite-run-steps-action)".
57
58
58
59
### Ort für eine Aktion auswählen
59
60
60
61
Wenn Du eine Aktion entwickelst, die von anderen Personen genutzt werden soll, empfehlen wir, die Aktion in ihrem eigenen Repository zu belassen, also nicht mit anderem Anwendungscode zu einem Bundle zusammenzufassen. Damit kannst Du die Aktion wie jede andere Software versionieren, nachverfolgen und veröffentlichen.
61
62
62
63
{% if currentVersion == "free-pro-team@latest" %}
63
-
Wenn Du eine Aktion in einem eigenen Repository speicherst, kann die {% data variables.product.prodname_dotcom %}-Community die Aktion eher entdecken. Außerdem wird damit die Codebasis begrenzt, auf die die Entwickler bei der Fehlerbehebung und bei der Erweiterung der Aktion angewiesen sind, und die Versionierung der Aktion wird von der Versionierung des anderen Anwendungscodes getrennt.
64
+
Storing an action in its own repository makes it easier for the
65
+
{% data variables.product.prodname_dotcom %} community to discover the action, narrows the scope of the code base for developers fixing issues and extending the action, and decouples the action's versioning from the versioning of other application code.
64
66
{% endif %}
65
67
66
-
Wenn Du eine Aktion erstellst, die nicht öffentlich zugänglich sein soll, kannst Du die Dateien für die Aktion an einem beliebigen Speicherort in Deinem Repository ablegen. Wenn der Aktions-, der Workflow- und der Anwendungscode in einem einzigen Repository abgelegt werden sollen, empfehlen wir, die Aktionen im Verzeichnis `.github` zu speichern. Beispiel: `.github/actions/action-a` und `.github/actions/action-b`.
68
+
{% if currentVersion == "free-pro-team@latest" %}If you're building an action that you don't plan to make available to the public, you {% else %} You{% endif %} can store the action's files in any location in your repository. Wenn der Aktions-, der Workflow- und der Anwendungscode in einem einzigen Repository abgelegt werden sollen, empfehlen wir, die Aktionen im Verzeichnis `.github` zu speichern. Beispiel: `.github/actions/action-a` und `.github/actions/action-b`.
67
69
68
-
### Kompatibilität mit {% data variables.product.prodname_ghe_server %}
70
+
### Compatibility with {% data variables.product.prodname_ghe_server %}
69
71
70
-
Um sicherzustellen, dass Ihre Aktion mit {% data variables.product.prodname_ghe_server %}kompatibel ist, sollten Sie sicherstellen, dass Sie keine hartcodierten Verweise auf {% data variables.product.prodname_dotcom %} API-URLs verwenden. Sie sollten stattdessen Umgebungsvariablen verwenden, um auf die {% data variables.product.prodname_dotcom %} -API zu verweisen:
72
+
To ensure that your action is compatible with {% data variables.product.prodname_ghe_server %}, you should make sure that you do not use any hard-coded references to {% data variables.product.prodname_dotcom %} API URLs. You should instead use environment variables to refer to the {% data variables.product.prodname_dotcom %} API:
71
73
72
74
- Verwenden Sie für die REST-API die `GITHUB_API_URL` -Umgebungsvariable.
73
75
- Verwenden Sie für GraphQL die Umgebungsvariable `GITHUB_GRAPHQL_URL` .
74
76
75
-
Weitere Informationen finden Sie unter "[Standardumgebungsvariablen](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)".
77
+
For more information, see "[Default environment variables](/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables)."
76
78
77
79
### Verwenden der Releaseverwaltung für Aktionen
78
80
79
-
In diesem Abschnitt wird erläutert, wie Sie die Releaseverwaltung verwenden können, um Aktualisierungen auf vorhersehbare Weise an Ihre Aktionen zu verteilen.
81
+
This section explains how you can use release management to distribute updates to your actions in a predictable way.
80
82
81
83
#### Bewährte Verfahren für das Release-Management
82
84
83
-
Wenn Sie eine Aktion für andere Benutzer entwickeln, empfehlen wir die Verwendung der Releaseverwaltung, um zu steuern, wie Sie Updates verteilen. Benutzer können erwarten, dass die Hauptversion einer Aktion die erforderlichen kritischen Korrekturen und Sicherheitspatches enthält, während sie weiterhin mit ihren vorhandenen Workflows kompatibel bleiben. Sie sollten die Veröffentlichung einer neuen Hauptversion in Betracht ziehen, wenn sich Ihre Änderungen auf die Kompatibilität auswirken.
85
+
If you're developing an action for other people to use, we recommend using release management to control how you distribute updates. Users can expect an action's major version to include necessary critical fixes and security patches, while still remaining compatible with their existing workflows. You should consider releasing a new major version whenever your changes affect compatibility.
84
86
85
-
Bei diesem Releaseverwaltungsansatz sollten Benutzer nicht auf den `Master` Zweig einer Aktion verweisen, da dieser wahrscheinlich den neuesten Code enthält und daher möglicherweise instabil ist. Stattdessen können Sie den Benutzern empfehlen, bei der Verwendung Ihrer Aktion eine Hauptversion anzugeben und sie nur dann an eine bestimmte Version weiterzuleiten, wenn Probleme auftreten.
87
+
Bei diesem Releaseverwaltungsansatz sollten Benutzer nicht auf den `Master` Zweig einer Aktion verweisen, da dieser wahrscheinlich den neuesten Code enthält und daher möglicherweise instabil ist. Instead, you can recommend that your users specify a major version when using your action, and only direct them to a more specific version if they encounter issues.
86
88
87
-
Um eine bestimmte Aktionsversion zu verwenden, können Benutzer ihre {% data variables.product.prodname_actions %} Workflow so konfigurieren, dass sie auf ein Tag, die SHA eines Commits oder einen Zweig abzielen, der nach einer Version benannt ist.
89
+
To use a specific action version, users can configure their {% data variables.product.prodname_actions %} workflow to target a tag, a commit's SHA, or a branch named for a release.
88
90
89
91
#### Verwenden von Tags für die Releaseverwaltung
90
92
91
-
Es wird empfohlen, Tags für die Releaseverwaltung von Aktionen zu verwenden. Mit diesem Ansatz können Ihre Benutzer leicht zwischen Haupt- und Nebenversionen unterscheiden:
93
+
We recommend using tags for actions release management. Using this approach, your users can easily distinguish between major and minor versions:
92
94
93
95
- Erstellen und überprüfen Sie eine Version auf einem Release-Zweig (z. B. `release/v1`), bevor Sie das Release-Tag erstellen (z. B. `v1.0.2`).
94
96
- Erstellen Sie eine Version mit semantischer Versionierung. Weitere Informationen finden Sie unter „[Veröffentlichungen erstellen](/articles/creating-releases)“.
95
97
- Verschieben Sie das Hauptversions-Tag (z. B. `v1`, `v2`), um auf die Git-Ref der aktuellen Version zu verweisen. Weitere Informationen findest Du unter „[Git-Grundlagen - Tagging](https://git-scm.com/book/en/v2/Git-Basics-Tagging)“.
96
98
- Führen Sie ein neues Hauptversions-Tag (`v2`) für Änderungen ein, die vorhandene Workflows unterbrechen. Eine störende Änderung liegt beispielsweise vor, wenn die Eingabe einer Aktion geändert wird.
97
99
- Hauptversionen können zunächst mit einem `Beta-` -Tag veröffentlicht werden, um ihren Status anzugeben, z. B. `v2-beta`. Das `-beta-` -Tag kann dann entfernt werden, wenn es fertig ist.
98
100
99
-
In diesem Beispiel wird veranschaulicht, wie ein Benutzer auf ein Hauptversions-Tag verweisen kann:
101
+
This example demonstrates how a user can reference a major release tag:
100
102
101
103
```yaml
102
104
Schritte:
103
105
- verwendet: actions/javascript-action@v1
104
106
```
105
107
106
-
In diesem Beispiel wird veranschaulicht, wie ein Benutzer auf ein bestimmtes Patch-Release-Tag verweisen kann:
108
+
This example demonstrates how a user can reference a specific patch release tag:
107
109
108
110
```yaml
109
111
Schritte:
@@ -112,7 +114,7 @@ Schritte:
112
114
113
115
#### Verwenden von Zweigen für die Releaseverwaltung
114
116
115
-
Wenn Sie Zweigstellennamen für die Releaseverwaltung verwenden möchten, wird in diesem Beispiel veranschaulicht, wie Sie auf eine benannte Zweigstelle verweisen:
117
+
If you prefer to use branch names for release management, this example demonstrates how to reference a named branch:
116
118
117
119
```yaml
118
120
Schritte:
@@ -121,7 +123,7 @@ Schritte:
121
123
122
124
#### Verwenden des SHA eines Commits für die Releaseverwaltung
123
125
124
-
Jeder Git-Commit erhält einen berechneten SHA-Wert, der eindeutig und unveränderlich ist. Die Benutzer Ihrer Aktion möchten sich möglicherweise auf den SHA-Wert eines Commits verlassen, da dieser Ansatz zuverlässiger sein kann als die Angabe eines Tags, das gelöscht oder verschoben werden könnte. Dies bedeutet jedoch, dass die Benutzer keine weiteren Aktualisierungen der Aktion erhalten. Die Verwendung des vollständigen SHA-Werts eines Commits anstelle des abgekürzten Werts kann dazu beitragen, dass Personen einen böswilligen Commit verwenden, der dieselbe Abkürzung verwendet.
126
+
Each Git commit receives a calculated SHA value, which is unique and immutable. Your action's users might prefer to rely on a commit's SHA value, as this approach can be more reliable than specifying a tag, which could be deleted or moved. However, this means that users will not receive further updates made to the action. Using a commit's full SHA value instead of the abbreviated value can help prevent people from using a malicious commit that uses the same abbreviation.
125
127
126
128
```yaml
127
129
Schritte:
@@ -141,7 +143,7 @@ Wenn Du Deine Aktion öffentlich bereitstellen möchten, empfehlen wir, eine REA
141
143
142
144
### Unterschiede zwischen {% data variables.product.prodname_actions %} und {% data variables.product.prodname_github_apps %}
143
145
144
-
{% data variables.product.prodname_marketplace %} bietet Tools, um Deinen Workflow zu verbessern. Wenn Du die Unterschiede und die Vorteile der einzelnen Tools verstehst, kannst Du das beste Tool für Deinen Auftrag auswählen. Weitere Informationen zum Erstellen von Aktionen und Apps finden Sie unter "[über GitHub-Aktionen](/actions/getting-started-with-github-actions/about-github-actions)" und "[über Apps](/apps/about-apps/)".
146
+
{% data variables.product.prodname_marketplace %} bietet Tools, um Deinen Workflow zu verbessern. Wenn Du die Unterschiede und die Vorteile der einzelnen Tools verstehst, kannst Du das beste Tool für Deinen Auftrag auswählen. For more information about building apps, see "[About apps](/apps/about-apps/)."
Copy file name to clipboardExpand all lines: translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md
+18-5
Original file line number
Diff line number
Diff line change
@@ -18,9 +18,9 @@ Nachdem Sie dieses Projekt abgeschlossen haben, sollten Sie verstehen, wie Sie I
18
18
19
19
### Vorrausetzungen
20
20
21
-
Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %} Repository.
21
+
Before you begin, you'll create a {% data variables.product.product_name %} repository.
22
22
23
-
1.Erstellen Sie ein neues öffentliches Repository auf {% data variables.product.product_location %}. Sie können einen beliebigen Repository-Namen auswählen oder die folgenden `hello-world-composite-run-steps-action` Beispiel verwenden. Sie können diese Dateien hinzufügen, nachdem Ihr Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“.
23
+
1.Create a new public repository on {% data variables.product.product_location %}. Sie können einen beliebigen Repository-Namen auswählen oder die folgenden `hello-world-composite-run-steps-action` Beispiel verwenden. Du kannst diese Dateien hinzufügen, nachdem Dein Projekt per Push an {% data variables.product.product_name %} übergeben wurde. Weitere Informationen finden Sie unter „[Neues Repository erstellen](/articles/creating-a-new-repository)“.
24
24
25
25
1. Clone Dein Repository auf Deinen Computer. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“.
26
26
@@ -36,7 +36,7 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %}
36
36
echo"Auf Wiedersehen"
37
37
```
38
38
39
-
1. Machen Sie von Ihrem Terminal aus `goodbye.sh`ausführbare Datei und checken Sie sie in Ihr Repository ein.
39
+
3. From your terminal, make `goodbye.sh`executable.
40
40
41
41
```shell
42
42
chmod +x goodbye.sh
@@ -85,13 +85,26 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %}
85
85
86
86
Weitere Informationen zur Verwendung von `github.action_path`finden Sie unter "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
87
87
88
-
1. Erstellen Sie eine neue Bezeichnung. In diesem Beispiel wird eine Bezeichnung mit dem Namen `v1` für den Hauptzweig verwendet. Weitere Informationen finden Sie unter "[Erstellen einer Bezeichnung ](/github/managing-your-work-on-github/creating-a-label)."
88
+
1. From your terminal, check in your `action.yml` file.
89
+
90
+
```shell
91
+
git add action.yml
92
+
git commit -m "Add action"
93
+
git push
94
+
```
95
+
96
+
1. From your terminal, add a tag. This example uses a tag called `v1`. Weitere Informationen finden Sie unter „[Informationen zu Aktionen](/actions/creating-actions/about-actions#using-release-management-for-actions)“.
97
+
98
+
```shell
99
+
git tag -a -m "Description of this release" v1
100
+
git push --follow-tags
101
+
```
89
102
90
103
### Deine Aktion in einem Workflow testen
91
104
92
105
Der folgende Workflowcode verwendet die abgeschlossene Hello-World-Aktion, die Sie in "[Erstellen einer Aktionsmetadatendatei](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)" ausgeführt haben.
93
106
94
-
Kopieren Sie den Workflowcode in eine `.github/workflows/main.yml` Datei in einem anderen Repository, ersetzen Sie jedoch `actions/hello-world-composite-run-steps-action@v1` durch das Repository und die Von Ihnen erstellte Bezeichnung. Darüber hinaus können Sie die Eingabe `who-to-greet` durch Ihren Namen ersetzen.
107
+
Copy the workflow code into a `.github/workflows/main.yml` file in another repository, but replace `actions/hello-world-composite-run-steps-action@v1` with the repository and tag you created. Darüber hinaus können Sie die Eingabe `who-to-greet` durch Ihren Namen ersetzen.
0 commit comments