From bb329658160c9e32b5ccea8d512b7e16da34238f Mon Sep 17 00:00:00 2001 From: Florian Heubeck Date: Tue, 8 Feb 2022 22:19:23 +0100 Subject: [PATCH] German translations of principles and glossary MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michael Rempel Co-authored-by: Bernd Stübinger Co-authored-by: Richard Steinbrück Co-authored-by: Tung Beier Co-authored-by: Jochen Bürkle Co-authored-by: Jan Knieling Co-authored-by: Kevin Fritz Signed-off-by: Florian Heubeck --- README.md | 2 ++ i18n/GLOSSARY_de.md | 52 +++++++++++++++++++++++++++++++++++++++++++ i18n/PRINCIPLES_de.md | 22 ++++++++++++++++++ i18n/README.md | 5 +++++ 4 files changed, 81 insertions(+) create mode 100644 i18n/GLOSSARY_de.md create mode 100644 i18n/PRINCIPLES_de.md create mode 100644 i18n/README.md diff --git a/README.md b/README.md index 9ac9c00..9405db0 100644 --- a/README.md +++ b/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). diff --git a/i18n/GLOSSARY_de.md b/i18n/GLOSSARY_de.md new file mode 100644 index 0000000..6767058 --- /dev/null +++ b/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. diff --git a/i18n/PRINCIPLES_de.md b/i18n/PRINCIPLES_de.md new file mode 100644 index 0000000..da0ad0a --- /dev/null +++ b/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). diff --git a/i18n/README.md b/i18n/README.md new file mode 100644 index 0000000..a4b4c72 --- /dev/null +++ b/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) |