Skip to content

Commit

Permalink
German translations of principles and glossary
Browse files Browse the repository at this point in the history
Co-authored-by: Michael Rempel <mrempel23@gmail.com>
Co-authored-by: Bernd Stübinger <bernd.stuebinger@gmx.de>
Co-authored-by: Richard Steinbrück <richard.steinbrueck@googlemail.com>
Co-authored-by: Tung Beier <beiertu@mediamarktsaturn.com>
Co-authored-by: Jochen Bürkle <buerkle@mediamarktsaturn.com>
Co-authored-by: Jan Knieling <knieling_jan@hotmail.com>
Co-authored-by: Kevin Fritz <fritzk@mediamarktsaturn.com>
Signed-off-by: Florian Heubeck <heubeck@mediamarktsaturn.com>
  • Loading branch information
8 people committed Feb 20, 2022
1 parent 570b28f commit bb32965
Show file tree
Hide file tree
Showing 4 changed files with 81 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ See the [releases](https://github.com/open-gitops/documents/releases) page for p
Note the difference between pre-releases and full releases, defined by the [Semantic Versioning](https://semver.org/) scheme followed by this repo.
See [open milestones](https://github.com/open-gitops/documents/milestones) for planned future releases.

Please find translations of the principles as well as the glossary in the [i18n](./i18n/) folder.

## About OpenGitOps

OpenGitOps is a [CNCF Sandbox project](https://www.cncf.io/sandbox-projects/) for lasting programs, documents and code from the [GitOps Working Group](https://github.com/gitops-working-group/gitops-working-group).
Expand Down
52 changes: 52 additions & 0 deletions i18n/GLOSSARY_de.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
## GitOps-Glossar {{version}}

Dieses Glossar begleitet die [GitOps-Prinzipien](./PRINCIPLES_de.md) und andere Dokumente dieses Repositorys.

- ## Kontinuierlich

Mit "kontinuierlich" ist im Kontext der [Angleichung](#angleichung) gemeint, dass diese regelmäßig, aber nicht zwangsweise sofort erfolgt.

- ## Deklarative Beschreibung

Eine Konfiguration, die den gewünschten [Soll-Zustand](#soll-zustand) eines Systems beschreibt, ohne Vorgehensweisen zu definieren wie dieser erreicht wird.
Dies erzielt die Trennung der Konfiguration (Soll-Zustand) von der Implementierung (Befehle, API-Aufrufe, Skripte usw.), die verwendet wird, um den gewünschten Zustand zu erreichen.

- ## Soll-Zustand

Die Gesamtheit aller Konfigurationen, die es braucht, um ein sich gleichverhaltendes System wiederherzustellen.
Diese Konfigurationen enthalten im Allgemeinen keine gespeicherten Anwendungsdaten wie z.B. Datenbankinhalte, wohl aber die entsprechenden Zugangsdaten für den Zugriff darauf oder Einstellungen für Wiederherstellungs-Tools des Systems.

- ## Abweichung

Abweichung bezeichnet eine (beginnende) Entfernung des Ist-Zustandes eines Systems vom gewünschten [Soll-Zustand](#soll-zustand).

- ## Angleichung

Der Prozess, bei dem sichergestellt wird, dass der tatsächliche Zustand eines Systems mit seinem [Soll-Zustand](#soll-zustand) übereinstimmt.

Im Gegensatz zur traditionellen CI/CD, bei der die Automatisierung im Allgemeinen durch voreingestellte Auslöser gesteuert wird, wird bei GitOps die Angleichung immer dann ausgelöst, wenn eine Abweichung vorliegt.

Die [Abweichung](#abweichung) kann darauf zurückzuführen sein, dass sich der Ist-Zustand unbeabsichtigt geändert hat oder dass eine neue Version der Soll-Zustands-Beschreibung vorliegt.

Auf der Grundlage von Richtlinien und [Feedback](#feedback) des Systems sowie früherer Angleichungsversuche werden Maßnahmen ergriffen, um die Abweichung im Laufe der Zeit zu verringern.

- ## Softwaresystem

Ein mittels GitOps verwaltetes Softwaresystem beinhaltet:

1. Eine oder mehrere Laufzeitumgebungen, die aus verwalteten Ressourcen bestehen
1. Verwaltungs-Agenten innerhalb jeder einzelnen Laufzeitumgebung
1. Richtlinien zur Steuerung des Zugriffs sowie der Verwaltung der Repositorys, Deployments und Laufzeitumgebungen

- ## Zustandsspeicher

Ein System, um unveränderliche Versionen der Beschreibung des [Soll-Zustand](#soll-zustand) zu speichern.
Dieser Speicher sollte Zugriffssteuerung und Audits der Änderungen des Soll-Zustands unterstützen.
Git, von dem sich der Name GitOps ableitet, ist das kanonische Beispiel für diesen Speicher, aber jedes System das die genannten Bedingungen erfüllt, kann benutzt werden.
In jedem Fall muss der Speicher ordnungsgemäß konfiguriert sein und Maßnahmen getroffen werden, um den Anforderungen der GitOps-Prinzipien gerecht zu werden.

- ## Feedback

GitOps folgt der [Kontrolltheorie](https://de.wikipedia.org/wiki/Kontrolltheorie) und wird in einem geschlossenen Kreislauf betrieben.
In der Kontrolltheorie beschreibt die Rückmeldung, wie frühere Versuche, einen [Soll-Zustand](#soll-zustand) anzuwenden, den tatsächlichen Zustand beeinflusst haben.
Verlangt beispielsweise der Soll-Zustand mehr Ressourcen als in einem System vorhanden sind, könnte der Software-Agent versuchen, automatisch zu einer vorherigen Version zurückzurollen oder menschlichen Betreibern einen Alarm senden.
22 changes: 22 additions & 0 deletions i18n/PRINCIPLES_de.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
## GitOps-Prinzipien {{version}}

GitOps ist eine Sammlung von Prinzipien für den Betrieb und die Verwaltung von Softwaresystemen.
Diese Prinzipien sind aus dem modernen Softwarebetrieb abgeleitet, basieren aber auf existierenden und verbreiteten Best Practices.

Der [Soll-Zustand](./GLOSSARY_de.md#soll-zustand) eines mittels GitOps verwalteten Systems muss folgende Eigenschaften erfüllen:

1. **Deklarativ**

Der Soll-Zustand eines durch GitOps verwalteten [Systems](./GLOSSARY_de.md#softwaresystem) muss [deklarativ](./GLOSSARY_de.md#deklarative-beschreibung) beschrieben sein.

2. **Versioniert und unveränderlich**

Der Soll-Zustand wird in einer Weise [gespeichert](./GLOSSARY_de.md#zustandsspeicher), die Unveränderlichkeit sowie Versionierung erzwingt und die vollständige Historie erhält.

3. **Automatisch bezogen**

Software-Agenten beziehen den beschriebenen Soll-Zustand automatisch.

4. **Kontinuierlich angeglichen**

Software-Agenten beobachten den tatsächlichen Systemzustand und versuchen [kontinuierlich](./GLOSSARY_de.md#kontinuierlich), ihn dem Soll-Zustand [anzugleichen](./GLOSSARY_de.md#angleichung).
5 changes: 5 additions & 0 deletions i18n/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# International versions of principles and glossary

| Language | Principles | Glossary |
| -------- | -------------------------------- | --------------------------- |
| German | [Prinzipien](./PRINCIPLES_de.md) | [Glossar](./GLOSSARY_de.md) |

0 comments on commit bb32965

Please sign in to comment.