Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Polish Translation for Principles and Glossary #88

Open
wants to merge 45 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
45 commits
Select commit Hold shift + click to select a range
acaad7b
Update and rename GLOSSARY.md to GLOSSARY.pl
joanna-wyganowska Aug 26, 2024
65a86ef
setting up a Polish version
joanna-wyganowska Aug 26, 2024
e6dde88
Polish translation
joanna-wyganowska Aug 26, 2024
7a7ba03
Update GLOSSARY_pl.md
joanna-wyganowska Aug 26, 2024
de2f24c
Update GLOSSARY_pl.md
joanna-wyganowska Aug 26, 2024
a594fe5
Update README.md
joanna-wyganowska Aug 26, 2024
4f95be1
Update PRINCIPLES_pl.md
joanna-wyganowska Aug 27, 2024
8f0339b
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
9a68097
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
d0bec65
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
32c3ebe
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
1dc157f
Update PRINCIPLES_pl.md
joanna-wyganowska Aug 27, 2024
92c6dcd
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
54c8ecb
Update GLOSSARY_pl.md
joanna-wyganowska Aug 27, 2024
0429574
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
dfc6d0e
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
adac038
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
34ed230
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
8963e90
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
a081187
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
06d1397
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
657ddc6
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
70a23e1
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
5c420bc
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
04007c7
Update GLOSSARY_pl.md
joanna-wyganowska Aug 28, 2024
0a3da75
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
7071706
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
d016f94
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
b11c1d0
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
3a6a002
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
aaf0d76
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
68e401e
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
98890ee
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
70b620c
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
33757af
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
522c1ee
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
d6e146d
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
0e64482
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
3147876
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
aefc650
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
ac4ad0f
Update GLOSSARY_pl.md
joanna-wyganowska Aug 29, 2024
df897d8
Update PRINCIPLES_pl.md
joanna-wyganowska Aug 29, 2024
c7a8d31
Update PRINCIPLES_pl.md
joanna-wyganowska Aug 29, 2024
eb7b8ed
Restore glossary
todaywasawesome Aug 29, 2024
a84bb3d
Merge pull request #1 from open-gitops/patch-1
joanna-wyganowska Aug 29, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions i18n/GLOSSARY_pl.md
Original file line number Diff line number Diff line change
@@ -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.
22 changes: 22 additions & 0 deletions i18n/PRINCIPLES_pl.md
Original file line number Diff line number Diff line change
@@ -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.
1 change: 1 addition & 0 deletions i18n/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) |