diff --git a/i18n/GLOSSARY_pl.md b/i18n/GLOSSARY_pl.md new file mode 100644 index 0000000..5fb01b0 --- /dev/null +++ b/i18n/GLOSSARY_pl.md @@ -0,0 +1,52 @@ +# Glosariusz GitOps {{version}} + +Ten glosariusz powiązany jest z [Zasadami GitOps](./PRINCIPLES_pl.md) i innymi dokumentami pomocniczymi zawartymi w tym repozytorium. + +- ## Ciągły + + "Ciągły" (ang. Continuous) jest związany ze standardowym terminem: [Uzgadnianie](#Uzgadnianie) (ang. Reconciliation) co oznacza, że następuje to ciągle, ale nie oznacza to, że musi to nastąpić natychmiastowo. + +- ## Opis Deklaratywny + + Opis Deklaratywny (ang. Declarative Description) to konfiguracja, która opisuje pożądanany stan systemu, bez podawania specyficznych procedur określających w jaki sposób ten stan będzie osiagniety. To oddziela konfigurację [stanu pożądanego](#pożądany-stan) od implementacji (commands, API calls, skrypty itp.) używanej do osiągniecia tego stanu. + +- ## Pożądany Stan + + Pożądany Stan (ang. Desired State) to agregacja wszystkich danych dotyczących konfiguracji, które wystarczają żeby odtworzyć system w taki sposób, żeby instancje systemu były behawioralnie nie do odróżnienia. +Te dane konfiguracyjne generalnie nie zawierają trwałych danych aplikacji, jak na przykład zawartość bazy danych, chociaż często zawierają poświadczenia dostępu do tych danych lub konfigurację narzędzi do odzyskiwania danych działających w tym systemie. + +- ## Dryft + + Dryft (ang. Drift) oznacza kiedy rzeczywisty stan systemu przesunął się lub jest w trakcie oddalania się od [stanu pożądanego](#pożądany-stan). + +- ## Ściąganie + + Ściąganie (ang. Pull) - [3 Zasada GitOps](./PRINCIPLES_pl.md) (Ściągany automatycznie) określa, że ​​pożądany stan musi zostać ściągany (pulled), a nie wypchnięty (pushed), przede wszystkim dlatego, że agent musi mieć możliwość dostępu do [pożądanego stanu](#pożądany-stan) z [magazynu stanów](#magazyn-stanów) w dowolnym momencie, a nie tylko wtedy, gdy nastąpi celowa zmiana w magazynie stanów wyzwaląjca push event. + Jest to warunek konieczny, aby [uzgadnianie](#uzgadnianie) odbywało się [ciągle](#Ciągły), jak określono w [zasadzie 4](./PRINCIPLES_pl.md) (Ciągle uzgadniany). + Należy pamiętać, że w przeciwieństwie do tradycyjnego CI/CD, gdzie automatyzacja jest zazwyczaj wyzwalana przez wstępnie ustawione triggery – w GitOps [uzgadnianie](#uzgadnianie) jest wyzwalane zawsze kiedy występuje rozbieżność. + Rozbieżność może być spowodowana niezamierzonym [dryftem](#dryft) rzeczywistego stanu od deklaracji pożądanego stanu, a nie tylko celową zmianą wersji deklaracji pożądanego stanu. + +- ## Uzgadnianie + + Uzgadnianie (ang. Reconciliation) jest to proces mający na celu zapewnienie, że rzeczywisty stan systemu odpowiada [pożądanemu stanowi](#pożądany-stan). + W przeciwieństwie do tradycyjnego CI/CD, gdzie automatyzacja jest zazwyczaj wyzwalana przez wstępnie ustawione triggery, w GitOps uzgadnianie jest inicjowane zawsze kiedy występuje rozbieżność. Rozbieżność może być spowodowana niezamierzonym [dryftem](#dryft) rzeczywistego stanu od deklaracji pożądanego stanu lub celową zmianą wersji deklaracji pożądanego stanu. + Działania uzgadniania są podejmowane na podstawie zasad dotyczących [opinii](#opinie) systemu oraz wcześniejszych prób uzgadniania, w celu zmniejszenia dewjacji w czasie. + +- ## System oprogramowania + + System oprogramowania (ang. Software System) zarządzany przez GitOps zawiera: + + 1. Jeden lub więcej środowisk wykonawczych składających się z zasobów podlegających zarządzaniu + 1. Agentów zarządzających każdym środowiskiem wykonawczym + 1. Zasady kontrolowania dostępu i zarządzania repozytoriami, wdrożeniami i środowiskami wykonawczymi + +- ## Magazyn Stanów + + Maganzyn Stanów (ang. State Store) to system służący do przechowywania niezmiennych wersji deklaracji [stanu pożądanego](#pożądany-stan). + Magazyn stanów powinien umożliwiać kontrolę dostępu i audyt zmian stanu pożądanego. + Git, od którego GitOps wzięło swoją nazwę, jest kanonicznym przykładem używanym jako magazyn stanów, ale można użyć dowolnego innego systemu spełniającego te kryteria. + We wszystkich przypadkach magazyny stanów muszą być prawidłowo skonfigurowane i należy podjąć środki ostrożności, aby spełnić wymagania określone w [Zasadach GitOps](./PRINCIPLES_pl.md). + +- ## Opinie + + Opinie (ang. Feedback) - Open GitOps przestrzega [control-theory](https://en.wikipedia.org/wiki/Control_theory) i operuje w pętli zamkniętej. W teorii kontroli, opinie określają, w jaki sposób poprzednie próby zastosowania pożądanego stanu wpłynęły na stan rzeczywisty. Na przykład, jeśli pożądany stan wymaga więcej zasobów niż istnieje w systemie, agent może podjąć próby dodania zasobów, żeby automatycznie przywrócić poprzednią wersję lub wysłać ostrzeżenie do operatorów. diff --git a/i18n/PRINCIPLES_pl.md b/i18n/PRINCIPLES_pl.md new file mode 100644 index 0000000..997f091 --- /dev/null +++ b/i18n/PRINCIPLES_pl.md @@ -0,0 +1,22 @@ +# Zasady GitOps (ang. GitOps Principles) {{version}} + +GitOps to zbiór zasad obsługi i zarządzania systemami oprogramowania. +Zasady te wywodzą się z nowoczesnych operacji programistycznych, ale są również zakorzenione w istniejących i powszechnie stosowanych najlepszych praktykach. + +[Pożądany Stan](./GLOSSARY_pl.md#pożądany-stan) w systemie zarządzanym przez GitOps musi być: + +1. ## Deklaratywny (ang. Declarative) + + [System oprogramowania](./GLOSSARY_pl.md#system-oprogramowania) zarządzany przez GitOps musi mieć swój pożądany stan określony [deklaratywnie](./GLOSSARY_pl.md#opis-deklaratywny). + +2. ## Wersjonowany i Niezmienny (ang. Versioned and Immutable) + + Pożądany stan jest przechowywany w [magazynie stanów](./GLOSSARY_pl.md#magazyn-stanów) w sposób, który wymusza niezmienność, wersjonowanie i zachowuje pełną historię wersji. + +3. ## Ściągany automatycznie (ang. Pulled Automatically) + + Agenci automatycznie [ściągają](./GLOSSARY_pl.md#ściąganie) pożądany stan z deklaracji źródłowej. + +4. ## Stale uzgadniany (ang. Continuously Reconciled) + + Agenci [w sposób ciągły](./GLOSSARY_pl.md#ciągły) obserwują rzeczywisty stan systemu i [próbują zaaplikować](./GLOSSARY_pl.md#uzgadnianie) pożądany stan. diff --git a/i18n/README.md b/i18n/README.md index b397b6c..f19af6d 100644 --- a/i18n/README.md +++ b/i18n/README.md @@ -4,5 +4,6 @@ | -------- | -------------------------------- | --------------------------- | | German | [Prinzipien](./PRINCIPLES_de.md) | [Glossar](./GLOSSARY_de.md) | | Spanish | [Principios](./PRINCIPLES_es.md) | [Glosario](./GLOSSARY_es.md) | +| Polish | [Zasady](./PRINCIPLES_pl.md) | [Glosariusz](./GLOSSARY_pl.md) | | Portuguese | [Pincípios](./PRINCIPLES_pt.md) | [Glossário](./GLOSSARY_pt.md) | | French | [Principes](./PRINCIPLES_fr.md) | [Glossaire](./GLOSSARY_fr.md) |