CRD versioning and migration

[Danil-Grigorev]

Hi, is there a guide/example of CRD versioning and migration?

I was able to find https://github.com/stackabletech/operator-rs/tree/main/crates/stackable-versioned, but it doesn’t have any example usages, to follow best practices.

Is there a prior history of implementing conversion hooks for CRDs? Or maybe a controller which takes care of that?

Thanks in advance

[Techassi]

Hey, developer at @stackabletech here.

but it doesn’t have any example usages, to follow best practices.

You are right, there aren't many examples for this yet, as we are currently also figuring that stuff out. However, there is one simple example. This however only touches on how to version CRDs using Rust structs but not how to do the conversions. This is something we at Stackable will work on in the near future. See these docs for some very basic webhook code.

Is there a prior history of implementing conversion hooks for CRDs? Or maybe a controller which takes care of that?

As mentioned above, this will soon become something we at Stackable will invest time in. So feel free to follow our journey. The goal is to develop framework code to build these conversion webhooks and automate their deployment via controllers/operators.

We are additionally working on an ADR (Architectural Design Record) to define best practices around CRD versioning in general and how to do it in Rust via our macro. The work-in-progress PR is here: stackabletech/documentation#712