Skip to content

Commit 0acb069

Browse files
Move control-loop note from principle to glossary for now (#31)
* Add control-loop principle for consideration. Signed-off-by: Dan Garfield <[email protected]> * Add link Signed-off-by: Dan Garfield <[email protected]> * Remove extra dash Signed-off-by: Dan Garfield <[email protected]> * Improve inclusivity of language Co-authored-by: Scott Rigby <[email protected]> Signed-off-by: Dan Garfield <[email protected]> * Add feedback reference to reconcilliation Signed-off-by: Dan Garfield <[email protected]> * Move closed-loop to glossary to avoid confusion in the principles. Signed-off-by: Dan Garfield <[email protected]> Co-authored-by: Scott Rigby <[email protected]> * Remove closed loop from the principles and focus in the glossary Signed-off-by: Dan Garfield <[email protected]> * Update GLOSSARY.md Signed-off-by: Dan Garfield <[email protected]> Co-authored-by: Scott Rigby <[email protected]> * Update GLOSSARY.md Signed-off-by: Dan Garfield <[email protected]> Co-authored-by: Jesse Butler <[email protected]> Co-authored-by: Moshe Immerman <[email protected]> Co-authored-by: Lloyd Chang <[email protected]> Co-authored-by: Christian Hernandez <[email protected]> Co-authored-by: Michael Bridgen <[email protected]> Co-authored-by: Scott Rigby <[email protected]>
1 parent 7153c84 commit 0acb069

File tree

2 files changed

+8
-2
lines changed

2 files changed

+8
-2
lines changed

GLOSSARY.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,8 @@ This glossary accompanies the [GitOps Principles](./PRINCIPLES.md), and other su
2222
- ## Reconciliation
2323

2424
The process of ensuring the actual state of a system matches its [desired state](#desired-state).
25-
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.
25+
Contrary to traditional CI/CD where automation is generally driven by pre-set triggers, in GitOps reconciliation is triggered whenever there is a divergence with [feedback](#feedback) from previous attempts. 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.
26+
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.
2627

2728
- ## Software System
2829

@@ -38,3 +39,8 @@ This glossary accompanies the [GitOps Principles](./PRINCIPLES.md), and other su
3839
This state store should provide access control and auditing on the changes to the Desired State.
3940
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.
4041
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.
42+
43+
- ## Feedback
44+
45+
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.
46+

PRINCIPLES.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,4 +19,4 @@ The [desired state](./GLOSSARY.md#desired-state) of a GitOps managed system must
1919

2020
4. **Continuously Reconciled**
2121

22-
Software agents [continuously](./GLOSSARY.md#continuous) observe actual system state and [attempt to apply](./GLOSSARY.md#reconciliation) the desired state.
22+
Software agents [continuously](./GLOSSARY.md#continuous) observe actual system state and [attempt to apply](./GLOSSARY.md#reconciliation) the desired state.

0 commit comments

Comments
 (0)