Kopf Versions Save

New features:

• Handler/resource filtering with arbitrary callbacks in when= option. #258 #288

Bugfixes:

• Reaction cycle stops in the middle with no messages (improper "now" comparison). #285

Internal improvements:

• aiohttp 4.x readiness (restriction to stay on 3.x). #277
• Better GitHub issue/PR templates. #278

Improvements:

• Process the changes happened during the freeze mode once unfrozen. #256 #257
• CRD's status field references fixed to match the examples. #262
• cooldown is renamed to backoff to match the usual terminology. #266

Bugfixes:

• "Line is too long" for objects longer than 128 KB in JSON (e.g. encrypted secrets). #276

Internal changes:

• CI/CD dependencies pinned to fight the unexpected changes. #265 #274
• Minikube's RBAC-only mode is relaxed to "Node,RBAC". #270

Improvements:

• Process the changes happened during the freeze mode once unfrozen. #256 #257
• CRD's status field references fixed to match the examples. #262
• cooldown is renamed to backoff to match the usual terminology. #266

Bugfixes:

• "Line is too long" for objects longer than 128 KB in JSON (e.g. encrypted secrets). #276

Internal changes:

• CI/CD dependencies pinned to fight the unexpected changes. #265 #274
• Minikube's RBAC-only mode is relaxed to "Node,RBAC". #270

Bugfixes:

• Fix an issue with crashing on startup due to 404 on peerings in the default auto-detection mode. #252

Bugfixes:

• Hot-fix the cluster-scoped resource discovery in the namespaced operators. #250

TL;DR: Massive refactoring, renames, code moves. Generally, should be backward-compatible.

RISKY CHANGES (can be BREAKING, should be not):

• Authentication and API talking are fully reworked: pykube-ng and kubernetes clients are now piggybacked by default to extract the endpoints and credentials, but are not used for the API communication. This can break API connectivity in some cases. #226 #227
• In-memory structures were introduced to carry the technical information/objects/flags for individual resources. This can lead to increased memory usage in huge clusters with thousands of monitored resources. #230
• @kopf.on.resume() handlers were fixed, and now execute when previously they were not executed by mistake, but this could be taken as an expected behaviour. This can lead to massive patches of all resumable objects on every operator startup (if there are 2+ handlers), which can be a problem in huge clusters. #230 #236
• Massive internal renames and code moves; not exposed publicly, unless hacks or monkey-patching were used. #209 #210 #211

New features:

• @kopf.on.startup() handlers for operator initialisation. #225
• @kopf.on.cleanup() handlers for operator shutdown. #225
• @kopf.on.login() custom authentication handlers. #226
• @kopf.on.probe() handlers for liveness metrics. #226
• Liveness probes with kopf run --liveness. #228
• memo kwargs to keep runtime-only operator-lifetime-limited arbitrary values. #234
• retries= limiter for handlers in addition to timeout=. #222
• errors=TEMPORARY, errors=PERMANENT, errors=IGNORED modes for handlers. #222
• Explicit owner is not needed in kopf.adopt() and hierarchy methods, current object is used by default. #203

Bugfixes:

• @kopf.on.resume() handlers fixed:
  • There can be more than one resuming handler. #230
  • Are executed if they go after the on-create/on-update handlers. #230
  • Are not repeated every few minutes for no reason, guaranteed to be called once. #229 #230
  • Can be retried in case of temporary or arbitrary errors. #230
  • Can have sub-handlers. #230
  • Are not invoked if the object is being deleted. #233
  • Can be explicitly marked as deletion-safe, and hence be invoked on resuming during deletion. #233
• spec, status, metadata fields are not added to the body when originally absent. #198
• OS signal handlers are ignored on Windows (not supported by asyncio). #220

Internal changes:

• Fully type-annotated in the code (not in the tests). #195 #196 #197 #200 #201
• Fully asynchronous internally (asyncio/aiohttp); synchronous pykube-ng client is removed. #217 #227
• Handler outcomes and persistent state management separated from each other. #221
• E2E tests are now isolated from each other, preventing false-positives. #205
• The latest k8s & minikube versions are used in e2e tests. #193
• No logging of empty meaningless diffs in on-resume and other handlers. #236
• No patching of the objects if there is no need to patch (and no logging). #236
• No purging of the handler progress if there is only one handler (and no logging). #236
• cause.event is renamed to cause.reason to avoid terminology conflicts. #201
• kex is added as an alias for KopfExample CRD for demos/docs. #235

Bugfixes:

• Raw data for CA, client certificates and private keys are accepted. #244
• Authorization: Bearer is not injected by default, breaking username+password auth. #243

Internal changes:

• Avoid logging of empty meaningless diffs in on-resume handlers. #236
• Avoid patching the objects if there is no need to patch (and skip logging). #236
• Avoid purging the handler progress if there is only one handler (and skip logging). #236
• Add kex as an alias for KopfExample CRD for demos/docs. #235

New features:

• memo kwargs to keep the runtime-only operator-lifetime-limited arbitrary values. #234

Improvements:

• @kopf.on.resume() handlers are not invoked if the object is being deleted. #233
• @kopf.on.resume() can be explicitly marked as a deletion-safe handler. #233