From 6f6c20053e4bf99b290bdc80c0f29da9c7d56ffb Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Wed, 4 Sep 2024 23:43:24 +0200 Subject: [PATCH 1/6] Add Macedonian version of PRINCIPLES Signed-off-by: Goce Mitevski Signed-off-by: Goce Mitevski --- i18n/PRINCIPLES_mk.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 i18n/PRINCIPLES_mk.md diff --git a/i18n/PRINCIPLES_mk.md b/i18n/PRINCIPLES_mk.md new file mode 100644 index 0000000..d0f1098 --- /dev/null +++ b/i18n/PRINCIPLES_mk.md @@ -0,0 +1,22 @@ +# Принципи на „GitOps“ {{version}} + +„GitOps“ претставува збирка на принципи за одржување и управување на софтверски системи. +Овие принципи се изведени од современите софтверски оперативни практики, но исто така се вкоренети во претходно постоечките и широко усвоени најдобри практики. + +[Посакуваната состојба](./GLOSSARY_mk.md#desired-state) на системот управуван со „GitOps“ мора да биде: + +1. ## Декларативна + + [Системот](./GLOSSARY_mk.md#software-system) управуван од „GitOps“ мора да ја има посакуваната состојба изразена [декларативно](./GLOSSARY.md#declarative-description). + +2. ## Верзионирана и непроменлива + + Посакуваната состојба [се зачувува](./GLOSSARY_mk.md#state-store) на начин што наметнува непроменливост, верзионирање и задржува целосна историја на верзии. + +3. ## Повлечена автоматски + + Софтверските агенти автоматски [ги повлекуваат](./GLOSSARY_mk.md#pull) посакуваните декларации за состојбата од изворот. + +4. ## Постојано хармонична + + Софтверските агенти [постојано](./GLOSSARY_mk.md#continuous) ја набљудуваат вистинската состојба на системот и [се обидуваат да ја применат](./GLOSSARY_mk.md#reconciliation) посакуваната состојба. From 8fc1d56b48134fea137374c1ebc417615c716e3f Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Wed, 4 Sep 2024 23:43:40 +0200 Subject: [PATCH 2/6] Add Macedonian version of GLOSSARY Signed-off-by: Goce Mitevski Signed-off-by: Goce Mitevski --- i18n/GLOSSARY_mk.md | 53 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 i18n/GLOSSARY_mk.md diff --git a/i18n/GLOSSARY_mk.md b/i18n/GLOSSARY_mk.md new file mode 100644 index 0000000..632acb9 --- /dev/null +++ b/i18n/GLOSSARY_mk.md @@ -0,0 +1,53 @@ +# Речник на „GitOps“ {{version}} + +Овој речник ги придружува [Принципите на „GitOps“](./PRINCIPLES_mk.md), како и другите придружни документи во ова складиште. + +- ## Непрекинато + + „Непрекинато“ е наменето да одговара на стандардниот термин во индустријата: [хармонијата](#reconciliation) продолжува да се воспоставува, но не мора да се случи веднаш. + +- ## Декларативен опис + + Конфигурација која ја опишува посакуваната оперативна состојба на системот без да специфицира процедури за тоа како ќе се постигне таа состојба. Ова ја одделува конфигурацијата (саканата состојба) од имплементацијата (наредби, повици до „API“, скрипти итн.) што се користат за постигнување на таа состојба. + +- ## Посакувана состојба + + Агрегат од сите конфигурациски податоци што е доволен за повторно создавање на системот, така што инстанците на системот не се разликуваат по однесување. + Овие податоци за конфигурација генерално не вклучуваат постојани податоци за апликацијата, како на пример содржината на базата на податоци, иако често вклучуваат ингеренции за пристап до тие податоци или конфигурација за алатки за обновување на податоци што работат на тој систем. + +- ## Лизгање + + Кога вистинската состојба на системот е поместена или е во процес на оддалечување од [посакуваната состојба](#desired-state), ова често се нарекува лизгање. + +- ## Повлекување + + [Принципот бр. 3](./PRINCIPLES_mk.md) (Повлечена автоматски) одредува дека [посакуваната состојба](#desired-state) мора да се „влече“ наместо да се „турка“, главно затоа што софтверските агенти мора да бидат во можност да пристапат до посакуваната состојба во т.н. [записник на состојби](#state-store) во било кое време, а не само кога има намерна промена во записникот што предизвикува некој настан на „туркање“. + Ова е предуслов за [хармонијата](#reconciliation) да се воспоставува [непрекинато](#continuous), како што е предвидено во [принципот бр. 4](./PRINCIPLES_mk.md) (Постојано хармонична). + Забележете дека - за разлика од традиционалните „CI/CD“, каде што автоматизацијата генерално е управувана од предефинирани активатори - во „GitOps“, [хармонијата](#reconciliation) се воспоставува _секогаш_ кога има дивергенција. + Дивергенцијата може да се должи на ненамерното [лизгање](#drift) од посакуваната состојба - не само поради намерна промена на верзијата. + +- ## Reconciliation + + The process of ensuring the actual state of a system matches its [desired state](#desired-state). + Contrary to traditional CI/CD where automation is generally driven by pre-set triggers, in GitOps reconciliation is triggered whenever there is a divergence. Divergence could be due to the actual state unintentionally [drifting](#drift) from the desired state declarations, or a new desired state declaration version having been changed intentionally. + Actions are taken based on policies around [feedback](./GLOSSARY.md#feedback) from the system and previous reconciliation attempts, in order to reduce deviation over time. + +- ## Software System + + A software system managed by GitOps includes: + + 1. One or more runtime environments consisting of resources under management + 2. The management agents within each runtime + 3. Policies for controlling access and management of repositories, deployments, runtimes + +- ## State Store + + A system for storing immutable versions of [desired state](#desired-state) declarations. + This state store should provide access control and auditing on the changes to the Desired State. + Git, from which GitOps derives its name, is the canonical example used as this state store but any other system that meets these criteria may be used. + In all cases, these state stores must be properly configured and precautions must be taken to comply with requirements set out in the GitOps Principles. + +- ## Feedback + + Open GitOps follows [control-theory](https://en.wikipedia.org/wiki/Control_theory) and operates in a closed-loop. In control theory, feedback represents how previous attempts to apply a desired state have affected the actual state. For example if the desired state requires more resources than exist in a system, the software agent may make attempts to add resources, to automatically rollback to a previous version, or to send alerts to human operators. + From 61ee3c67e89890406ff74a44c91b3a57cb29a222 Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Thu, 5 Sep 2024 17:55:34 +0200 Subject: [PATCH 3/6] Update PRICIPLES links Signed-off-by: Goce Mitevski Signed-off-by: Goce Mitevski --- i18n/PRINCIPLES_mk.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/i18n/PRINCIPLES_mk.md b/i18n/PRINCIPLES_mk.md index d0f1098..d4832a8 100644 --- a/i18n/PRINCIPLES_mk.md +++ b/i18n/PRINCIPLES_mk.md @@ -3,20 +3,20 @@ „GitOps“ претставува збирка на принципи за одржување и управување на софтверски системи. Овие принципи се изведени од современите софтверски оперативни практики, но исто така се вкоренети во претходно постоечките и широко усвоени најдобри практики. -[Посакуваната состојба](./GLOSSARY_mk.md#desired-state) на системот управуван со „GitOps“ мора да биде: +[Посакуваната состојба](./GLOSSARY_mk.md#посакувана-состојба) на системот управуван со „GitOps“ мора да биде: 1. ## Декларативна - [Системот](./GLOSSARY_mk.md#software-system) управуван од „GitOps“ мора да ја има посакуваната состојба изразена [декларативно](./GLOSSARY.md#declarative-description). + [Системот](./GLOSSARY_mk.md#софтверски-систем) управуван од „GitOps“ мора да ја има посакуваната состојба изразена [декларативно](./GLOSSARY.md#деклараривен-опис). 2. ## Верзионирана и непроменлива - Посакуваната состојба [се зачувува](./GLOSSARY_mk.md#state-store) на начин што наметнува непроменливост, верзионирање и задржува целосна историја на верзии. + Посакуваната состојба [се зачувува](./GLOSSARY_mk.md#записник-на-состојби) на начин што наметнува непроменливост, верзионирање и задржува целосна историја на верзии. 3. ## Повлечена автоматски - Софтверските агенти автоматски [ги повлекуваат](./GLOSSARY_mk.md#pull) посакуваните декларации за состојбата од изворот. + Софтверските агенти автоматски [ги повлекуваат](./GLOSSARY_mk.md#повлекување) посакуваните декларации за состојбата од изворот. 4. ## Постојано хармонична - Софтверските агенти [постојано](./GLOSSARY_mk.md#continuous) ја набљудуваат вистинската состојба на системот и [се обидуваат да ја применат](./GLOSSARY_mk.md#reconciliation) посакуваната состојба. + Софтверските агенти [постојано](./GLOSSARY_mk.md#непрекинато) ја набљудуваат вистинската состојба на системот и [се обидуваат да ја применат](./GLOSSARY_mk.md#хармонија) посакуваната состојба. From 546fb987e53db731098e3b52cfe7310ff1ff016c Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Thu, 5 Sep 2024 17:56:04 +0200 Subject: [PATCH 4/6] Complete GLOSSARY Macedonian translation and fix broken links Signed-off-by: Goce Mitevski Signed-off-by: Goce Mitevski --- i18n/GLOSSARY_mk.md | 44 ++++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/i18n/GLOSSARY_mk.md b/i18n/GLOSSARY_mk.md index 632acb9..a1e942e 100644 --- a/i18n/GLOSSARY_mk.md +++ b/i18n/GLOSSARY_mk.md @@ -4,7 +4,7 @@ - ## Непрекинато - „Непрекинато“ е наменето да одговара на стандардниот термин во индустријата: [хармонијата](#reconciliation) продолжува да се воспоставува, но не мора да се случи веднаш. + „Непрекинато“ е наменето да одговара на стандардниот термин во индустријата: [хармонијата](#хармонија) продолжува да се воспоставува, но не мора да се случи веднаш. - ## Декларативен опис @@ -17,37 +17,37 @@ - ## Лизгање - Кога вистинската состојба на системот е поместена или е во процес на оддалечување од [посакуваната состојба](#desired-state), ова често се нарекува лизгање. + Кога вистинската состојба на системот е поместена или е во процес на оддалечување од [посакуваната состојба](#посакувана-состојба), ова често се нарекува лизгање. - ## Повлекување - [Принципот бр. 3](./PRINCIPLES_mk.md) (Повлечена автоматски) одредува дека [посакуваната состојба](#desired-state) мора да се „влече“ наместо да се „турка“, главно затоа што софтверските агенти мора да бидат во можност да пристапат до посакуваната состојба во т.н. [записник на состојби](#state-store) во било кое време, а не само кога има намерна промена во записникот што предизвикува некој настан на „туркање“. - Ова е предуслов за [хармонијата](#reconciliation) да се воспоставува [непрекинато](#continuous), како што е предвидено во [принципот бр. 4](./PRINCIPLES_mk.md) (Постојано хармонична). - Забележете дека - за разлика од традиционалните „CI/CD“, каде што автоматизацијата генерално е управувана од предефинирани активатори - во „GitOps“, [хармонијата](#reconciliation) се воспоставува _секогаш_ кога има дивергенција. - Дивергенцијата може да се должи на ненамерното [лизгање](#drift) од посакуваната состојба - не само поради намерна промена на верзијата. + [Принципот бр. 3](./PRINCIPLES_mk.md) (Повлечена автоматски) одредува дека [посакуваната состојба](#посакувана-состојба) мора да се „влече“ наместо да се „турка“, главно затоа што софтверските агенти мора да бидат во можност да пристапат до посакуваната состојба во т.н. [записник на состојби](#записник-на-состојби) во било кое време, а не само кога има намерна промена во записникот што предизвикува некој настан на „туркање“. + Ова е предуслов за [хармонијата](#хармонија) да се воспоставува [непрекинато](#непрекинато), како што е предвидено во [принципот бр. 4](./PRINCIPLES_mk.md) (Постојано хармонична). + Забележете дека - за разлика од традиционалните „CI/CD“, каде што автоматизацијата генерално е управувана од предефинирани активатори - во „GitOps“, [хармонијата](#хармонија) се воспоставува _секогаш_ кога има дивергенција. + Дивергенцијата може да се должи на ненамерното [лизгање](#лизгање) од посакуваната состојба - не само поради намерна промена на верзијата. -- ## Reconciliation +- ## Хармонија - The process of ensuring the actual state of a system matches its [desired state](#desired-state). - Contrary to traditional CI/CD where automation is generally driven by pre-set triggers, in GitOps reconciliation is triggered whenever there is a divergence. Divergence could be due to the actual state unintentionally [drifting](#drift) from the desired state declarations, or a new desired state declaration version having been changed intentionally. - Actions are taken based on policies around [feedback](./GLOSSARY.md#feedback) from the system and previous reconciliation attempts, in order to reduce deviation over time. + Процесот преку којшто се осигуруваме дека тековната состојба на системот се совпаѓа со неговата [посакувана состојба](#посакувана-состојба). + Спротивно на традиционалните „CI/CD“ каде што автоматизацијата генерално е управувана од предефинирани активатори, во „GitOps“ усогласувањето се активира секогаш кога има дивергенција. Дивергенцијата може да се должи на ненамерно [лизгање](#лизгање) од посакуваната состојба или пак со намерна промена на нејзината верзија. + Акциите се преземаат врз основа на политиките околу [повратните информации](./GLOSSARY_mk.md#feedback) од системот и претходните обиди за хармонија, со цел да се намалат отстапувањата со текот на времето. -- ## Software System +- ## Софтверски систем - A software system managed by GitOps includes: + Еден софтверски систем управуван од „GitOps“ содржи: - 1. One or more runtime environments consisting of resources under management - 2. The management agents within each runtime - 3. Policies for controlling access and management of repositories, deployments, runtimes + 1. Една или повеќе работни околини составени од управувани ресурси + 2. Агентите за управување во секој циклус на извршување + 3. Политики за контролирање на пристапот и управување со складишта, редоследи, времетраења на извршување -- ## State Store +- ## Записник на состојби - A system for storing immutable versions of [desired state](#desired-state) declarations. - This state store should provide access control and auditing on the changes to the Desired State. - Git, from which GitOps derives its name, is the canonical example used as this state store but any other system that meets these criteria may be used. - In all cases, these state stores must be properly configured and precautions must be taken to comply with requirements set out in the GitOps Principles. + Систем за складирање на непроменливи верзии на декларации за [посакуваната состојба](#посакувана-состојба). + Записникот на состојби треба да обезбеди контрола на пристап и ревизија на промените на Посакуваната состојба. + „Git“, од кој „GitOps“ го добива своето име, е канонскиот пример за ваков записник, но може да се користи кој било друг систем што ги исполнува овие критериуми. + Во сите случаи, овие записници на состојби мора да бидат правилно конфигурирани и мора да се преземат мерки на претпазливост за да се усогласат со барањата утврдени во Принципите на „GitOps“. -- ## Feedback +- ## Повратни информации - Open GitOps follows [control-theory](https://en.wikipedia.org/wiki/Control_theory) and operates in a closed-loop. In control theory, feedback represents how previous attempts to apply a desired state have affected the actual state. For example if the desired state requires more resources than exist in a system, the software agent may make attempts to add resources, to automatically rollback to a previous version, or to send alerts to human operators. + „Open GitOps“ ја следи [теоријата на контрола](https://en.wikipedia.org/wiki/Control_theory) и работи во затворена јамка. Во теоријата на контрола, повратната информација прикажува како претходните обиди да се стигне до посакуваната состојба влијаеле на тековната состојба. На пример, ако посакуваната состојба бара повеќе ресурси отколку што постојат во системот, софтверскиот агент може да се обиде да додаде ресурси, автоматски да се врати на претходната верзија или да испрати предупредувања до човечките оператори. From cd2a8f8ccc4837af1870a91affff3e4700bc5aef Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Sat, 21 Sep 2024 10:47:03 +0200 Subject: [PATCH 5/6] =?UTF-8?q?Replace=20'=D0=BF=D1=80=D0=B8=D0=BD=D1=86?= =?UTF-8?q?=D0=B8=D0=BF'=20with=20'=D0=BD=D0=B0=D1=87=D0=B5=D0=BB=D0=BE'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Goce Mitevski --- i18n/GLOSSARY_mk.md | 8 ++++---- i18n/PRINCIPLES_mk.md | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/i18n/GLOSSARY_mk.md b/i18n/GLOSSARY_mk.md index a1e942e..086b45c 100644 --- a/i18n/GLOSSARY_mk.md +++ b/i18n/GLOSSARY_mk.md @@ -1,6 +1,6 @@ # Речник на „GitOps“ {{version}} -Овој речник ги придружува [Принципите на „GitOps“](./PRINCIPLES_mk.md), како и другите придружни документи во ова складиште. +Овој речник ги придружува [Начелата на „GitOps“](./PRINCIPLES_mk.md), како и другите придружни документи во ова складиште. - ## Непрекинато @@ -21,8 +21,8 @@ - ## Повлекување - [Принципот бр. 3](./PRINCIPLES_mk.md) (Повлечена автоматски) одредува дека [посакуваната состојба](#посакувана-состојба) мора да се „влече“ наместо да се „турка“, главно затоа што софтверските агенти мора да бидат во можност да пристапат до посакуваната состојба во т.н. [записник на состојби](#записник-на-состојби) во било кое време, а не само кога има намерна промена во записникот што предизвикува некој настан на „туркање“. - Ова е предуслов за [хармонијата](#хармонија) да се воспоставува [непрекинато](#непрекинато), како што е предвидено во [принципот бр. 4](./PRINCIPLES_mk.md) (Постојано хармонична). + [Начелото бр. 3](./PRINCIPLES_mk.md) (Повлечена автоматски) одредува дека [посакуваната состојба](#посакувана-состојба) мора да се „влече“ наместо да се „турка“, главно затоа што софтверските агенти мора да бидат во можност да пристапат до посакуваната состојба во т.н. [записник на состојби](#записник-на-состојби) во било кое време, а не само кога има намерна промена во записникот што предизвикува некој настан на „туркање“. + Ова е предуслов за [хармонијата](#хармонија) да се воспоставува [непрекинато](#непрекинато), како што е предвидено во [начелото бр. 4](./PRINCIPLES_mk.md) (Постојано хармонична). Забележете дека - за разлика од традиционалните „CI/CD“, каде што автоматизацијата генерално е управувана од предефинирани активатори - во „GitOps“, [хармонијата](#хармонија) се воспоставува _секогаш_ кога има дивергенција. Дивергенцијата може да се должи на ненамерното [лизгање](#лизгање) од посакуваната состојба - не само поради намерна промена на верзијата. @@ -45,7 +45,7 @@ Систем за складирање на непроменливи верзии на декларации за [посакуваната состојба](#посакувана-состојба). Записникот на состојби треба да обезбеди контрола на пристап и ревизија на промените на Посакуваната состојба. „Git“, од кој „GitOps“ го добива своето име, е канонскиот пример за ваков записник, но може да се користи кој било друг систем што ги исполнува овие критериуми. - Во сите случаи, овие записници на состојби мора да бидат правилно конфигурирани и мора да се преземат мерки на претпазливост за да се усогласат со барањата утврдени во Принципите на „GitOps“. + Во сите случаи, овие записници на состојби мора да бидат правилно конфигурирани и мора да се преземат мерки на претпазливост за да се усогласат со барањата утврдени во Начела на „GitOps“. - ## Повратни информации diff --git a/i18n/PRINCIPLES_mk.md b/i18n/PRINCIPLES_mk.md index d4832a8..fd28f97 100644 --- a/i18n/PRINCIPLES_mk.md +++ b/i18n/PRINCIPLES_mk.md @@ -1,7 +1,7 @@ -# Принципи на „GitOps“ {{version}} +# Начела на „GitOps“ {{version}} -„GitOps“ претставува збирка на принципи за одржување и управување на софтверски системи. -Овие принципи се изведени од современите софтверски оперативни практики, но исто така се вкоренети во претходно постоечките и широко усвоени најдобри практики. +„GitOps“ претставува збирка на начела за одржување и управување на софтверски системи. +Овие начела се изведени од современите софтверски оперативни практики, но исто така се вкоренети во претходно постоечките и широко усвоени најдобри практики. [Посакуваната состојба](./GLOSSARY_mk.md#посакувана-состојба) на системот управуван со „GitOps“ мора да биде: From 26ba0073cef60b41e9bfc1b0fa12eb420679d0a7 Mon Sep 17 00:00:00 2001 From: Goce Mitevski Date: Thu, 3 Oct 2024 08:44:25 +0200 Subject: [PATCH 6/6] Resolve merge conflict Signed-off-by: Goce Mitevski --- i18n/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/i18n/README.md b/i18n/README.md index 44a60db..110cc4d 100644 --- a/i18n/README.md +++ b/i18n/README.md @@ -6,3 +6,4 @@ | Español (Spanish) | [Principios](./PRINCIPLES_es.md) | [Glosario](./GLOSSARY_es.md) | | Português (Portuguese) | [Pincípios](./PRINCIPLES_pt.md) | [Glossário](./GLOSSARY_pt.md) | | Français (French) | [Principes](./PRINCIPLES_fr.md) | [Glossaire](./GLOSSARY_fr.md) | +| Македонски (Macedonian) | [Начела](./PRINCIPLES_mk.md) | [Речник](./GLOSSARY_mk.md) |