public_git
/
kubernetes-operator
mirror of https://github.com/jenkinsci/kubernetes-operator.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Update how-it-works.md

This commit is contained in:
antoniaklja 2019-01-05 20:35:52 +01:00
parent 2ce69f9394
commit 5164fbc3e4
1 changed files with 15 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/how-it-works.md
View File

@ -24,7 +24,19 @@ User reconciliation loop takes care of reconciling user provided configuration,
![reconcile](../phases.png) ![reconcile](../phases.png)
## Operator Status ## Operator State
Operator status is used for storing any configuration events or job statuses managed by the operator. Operator state is kept in custom resource status section, which is used for storing any configuration events or job statuses managed by the operator.
It helps to maintain or recover desired state even after operator or Jenkins restarts. It helps to maintain or recover desired state even after operator or Jenkins restarts.
## System Jenkins Jobs
The operator or Jenkins instance can be restarted at any time and any operation should not block the reconciliation loop so we implemented
custom jobs API for executing and verifying status of them according to operator lifecycle.
Main assumptions are:
- do not block reconciliation loop
- fire job, requeue reconciliation loop and verify status next time
- handle retries if case of failure
- handle build expiration (deadline)
- keep state in the custom resource status