Skip to content

Conversation

pstibrany
Copy link
Contributor

@pstibrany pstibrany commented Jul 30, 2020

What this PR does: This PR adds document with some details for migrating existing chunks-based Cortex cluster running in Kubernetes to blocks.

It also shows Jsonnet-based configuration as an example.

Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
@pracucci pracucci changed the title Added migration document. Documented how to migrate a live cluster from chunks to blocks Aug 3, 2020
Signed-off-by: Marco Pracucci <marco@pracucci.com>
Copy link
Contributor

@pracucci pracucci left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good job @pstibrany !

I had a pretty invasive feedback about what should be documented and what not so instead of leaving many small comments I directly committed the changes. See this commit please. If you think the direction is wrong, we can rollback or re-iterate on it. Shortly, what I did:

  • This documentation should explain "how to do it" and not "the process we took to realise how to do it"
  • Notes about the script should be moved to the script itself (the final user just wanna a working solution and, if doesn't work, can look at the script where they find some notes as code comments)
  • For each reconfiguration required, let's give a TL;DR and then a sub-paragraph to explain the "why" of each change

The remaining comments I left apply on top of my changes.

Copy link
Contributor Author

@pstibrany pstibrany left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pracucci Your changes look good. I think discussion why approach outlined in the proposal didn't quite work is interesting and worth keeping somewhere, but it doesn't need to be here.

pstibrany and others added 4 commits August 11, 2020 12:28
Co-authored-by: Marco Pracucci <marco@pracucci.com>
Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
…igration.

Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
@pstibrany
Copy link
Contributor Author

I've addressed your feedback. Please take a look when you have some time. Thank you!

Copy link
Contributor

@pracucci pracucci left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very good job! I left few minor comments and suggestion (up to your judgment), but consider this PR already approved 🚀

Signed-off-by: Peter Štibraný <peter.stibrany@grafana.com>
@pstibrany pstibrany merged commit e36e2ae into cortexproject:master Aug 11, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants