Skip to content

Commit 0633e37

Browse files
authored
repo sync
2 parents 954dc04 + 2bee5b9 commit 0633e37

File tree

6,560 files changed

+80787
-28537
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

6,560 files changed

+80787
-28537
lines changed

translations/de-DE/content/actions/creating-actions/about-actions.md

+20-18
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
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.'
44
product: '{% data reusables.gated-features.actions %}'
55
redirect_from:
66
- /articles/about-actions
@@ -20,7 +20,8 @@ versions:
2020
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.
2121

2222
{% 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.
2425
{% endif %}
2526

2627
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
5354

5455
#### Zusammengesetzte Ausführungsschritte Aktionen
5556

56-
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)".
5758

5859
### Ort für eine Aktion auswählen
5960

6061
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.
6162

6263
{% 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.
6466
{% endif %}
6567

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`.
6769

68-
### Kompatibilität mit {% data variables.product.prodname_ghe_server %}
70+
### Compatibility with {% data variables.product.prodname_ghe_server %}
6971

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:
7173

7274
- Verwenden Sie für die REST-API die `GITHUB_API_URL` -Umgebungsvariable.
7375
- Verwenden Sie für GraphQL die Umgebungsvariable `GITHUB_GRAPHQL_URL` .
7476

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)."
7678

7779
### Verwenden der Releaseverwaltung für Aktionen
7880

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.
8082

8183
#### Bewährte Verfahren für das Release-Management
8284

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.
8486

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.
8688

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.
8890

8991
#### Verwenden von Tags für die Releaseverwaltung
9092

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:
9294

9395
- 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`).
9496
- Erstellen Sie eine Version mit semantischer Versionierung. Weitere Informationen finden Sie unter „[Veröffentlichungen erstellen](/articles/creating-releases)“.
9597
- 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)“.
9698
- 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.
9799
- 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.
98100

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:
100102

101103
```yaml
102104
Schritte:
103105
- verwendet: actions/javascript-action@v1
104106
```
105107
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:
107109
108110
```yaml
109111
Schritte:
@@ -112,7 +114,7 @@ Schritte:
112114
113115
#### Verwenden von Zweigen für die Releaseverwaltung
114116
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:
116118
117119
```yaml
118120
Schritte:
@@ -121,7 +123,7 @@ Schritte:
121123
122124
#### Verwenden des SHA eines Commits für die Releaseverwaltung
123125
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.
125127
126128
```yaml
127129
Schritte:
@@ -141,7 +143,7 @@ Wenn Du Deine Aktion öffentlich bereitstellen möchten, empfehlen wir, eine REA
141143

142144
### Unterschiede zwischen {% data variables.product.prodname_actions %} und {% data variables.product.prodname_github_apps %}
143145

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/)."
145147

146148
#### Stärken von GitHub Aktionen und GitHub Apps
147149

translations/de-DE/content/actions/creating-actions/creating-a-composite-run-steps-action.md

+18-5
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ Nachdem Sie dieses Projekt abgeschlossen haben, sollten Sie verstehen, wie Sie I
1818

1919
### Vorrausetzungen
2020

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.
2222

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)“.
2424

2525
1. Clone Dein Repository auf Deinen Computer. Weitere Informationen findest Du unter „[Ein Repository clonen](/articles/cloning-a-repository)“.
2626

@@ -36,7 +36,7 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %}
3636
echo "Auf Wiedersehen"
3737
```
3838

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.
4040

4141
```shell
4242
chmod +x goodbye.sh
@@ -85,13 +85,26 @@ Bevor Sie beginnen, erstellen Sie ein {% data variables.product.product_name %}
8585
8686
Weitere Informationen zur Verwendung von `github.action_path`finden Sie unter "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)".
8787
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+
```
89102
90103
### Deine Aktion in einem Workflow testen
91104
92105
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.
93106
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.
95108
96109
{% raw %}
97110
**.github/workflows/main.yml**

translations/de-DE/content/actions/creating-actions/creating-a-docker-container-action.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Eine Docker-Container-Aktion erstellen
3-
intro: In diesem Leitfaden werden die mindestens erforderlichen Schritte zum Erstellen einer Docker-Container-Aktion beschrieben.
3+
intro: 'In diesem Leitfaden werden die mindestens erforderlichen Schritte zum Erstellen einer Docker-Container-Aktion beschrieben.'
44
product: '{% data reusables.gated-features.actions %}'
55
redirect_from:
66
- /articles/creating-a-docker-container-action

0 commit comments

Comments
 (0)