German translations of principles and glossary

Contributors:
@mrempel23
@stuebingerb
@steinbrueckri
@beiertu-mms
@buerkle-mms
@Aldimann
@kharf
@heubeck

Co-authored-by: Michael Rempel <[email protected]>
Co-authored-by: Bernd Stübinger <[email protected]>
Co-authored-by: Richard Steinbrück <[email protected]>
Co-authored-by: Tung Beier <[email protected]>
Co-authored-by: Jochen Bürkle <[email protected]>
Co-authored-by: Jan Knieling <[email protected]>
Co-authored-by: Kevin Fritz <[email protected]>

Signed-off-by: Florian Heubeck <[email protected]>

Author: heubeck

README.md

@@ -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).

i18n/GLOSSARY_de.md

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

i18n/PRINCIPLES_de.md

@@ -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).

i18n/README.md

@@ -0,0 +1,5 @@
+# International versions of principles and glossary
+
+| Language | Principles                       | Glossary                    |
+| -------- | -------------------------------- | --------------------------- |
+| German   | [Prinzipien](./PRINCIPLES_de.md) | [Glossar](./GLOSSARY_de.md) |