Add a docker-compose local setup to fully test Mimir

[pracucci]

What this PR does:
In this PR I propose to introduce a docker-compose local setup (based on single binary and memberlist) to allow the community to have a quick way to try the latest stable release of Mimir in a HA setup. It also runs Prometheus (used both to scrape Mimir metrics and run recording rules) as well as Grafana with our dashboard provisioned.

The PR includes a tutorial-style README.md guiding the user step-by-step. I've try to follow the Grafana tutorial style, but I haven't used tutorial markdown syntax given for the moment won't be published as a Grafana tutorial.

Which issue(s) this PR fixes:
Fixes #991
Fixes #1024

Checklist

• Tests updated
• Documentation added
• CHANGELOG.md updated - the order of entries should be [CHANGE], [FEATURE], [ENHANCEMENT], [BUGFIX]

[osg-grafana]

Removed Docs: from title because this is not user documentation and belongs in a product demo location. Will pull in Julie Dam who leads up content strategy as a whole.

[pracucci]

Removed Docs: from title because this is not user documentation and belongs in a product demo location. Will pull in Julie Dam who leads up content strategy as a whole.

Well, the plan was to write a documentation page too but it hasn't been written yet (reason why PR is still a draft).

[osg-grafana]

Removed Docs: from title because this is not user documentation and belongs in a product demo location. Will pull in Julie Dam who leads up content strategy as a whole.

Well, the plan was to write a documentation page too but it hasn't been written yet (reason why PR is still a draft).

@KMiller-Grafana, this looks like it is in your court because it relates to configuration. I agree with you that this should not be in the user documentation.

[pstibrany]

I like how simple the config is.

[replay]

This looks good to me.

I spun it up on Ubuntu 20.04 and I can successfully access Grafana and query some of the metrics

[pstibrany]

Shall we add a script that starts all of this (start.sh)? Not everyone may know how to start docker-compose setup from CLI.

[pracucci]

Shall we add a script that starts all of this (start.sh)? Not everyone may know how to start docker-compose setup from CLI.

I think you've approved too quickly. This will come along with a tutorial I'm going to write. It also miss some config, like Alertmanager sharding.

[pstibrany]

I think you've approved too quickly. This will come along with a tutorial I'm going to write. It also miss some config, like Alertmanager sharding.

I approved because I'm perfectly fine merging this in the current state and iterating on it over next several PRs.

[osg-grafana]

Please move this to a demo subdirectory and out of docs/sources/.

[GrafanaWriter]

This should publish out of grafana/tutorials after the Mimir launch as the tutorials repo is public.

For now, we should move the file out of the /docs directory to avoid issues with the docs publication pipeline.

I'm happy to work with you on this, @pracucci to make it sparkle. The template for tutorials was created some time ago, but it can be a guide and something I'm open to refining along the way (as long as it doesn't slow us down too much).

[osg-grafana]

Unblocking with the assumption that it is moved out of the docs/ directory.

[pracucci]

@GrafanaWriter @osg-grafana I've moved it outside of docs/ and I've written a tutorial. As noted in the PR description, I've try to follow the Grafana tutorial style, but I haven't used tutorial markdown syntax yet given for the moment it won't be published as a Grafana tutorial.

Could I get your review, please?

[pracucci]

@pstibrany @replay This PR is now ready to review. The tutorial and docker-compose setup includes everything I had in mind when I started working on it. Could you take another look, please?

[GrafanaWriter]

Thanks for writing this, @pracucci, and for adopting/adapting the template. Please let me know of any questions or comments.

[pracucci]

Thanks @GrafanaWriter for your review. I've accepted most suggestions and replied to a couple of them. Could you take another look, please?

[pracucci]

To avoid that other users experience the same confusion, would it make sense to change the example recording rule to from count:up to sum:up? I can imagine that this is something which could confuse other people too.

Very good point. Changed to sum:up.

I've also accepted all suggestions.

[pracucci]

I did follow the tutorial one last time and looks good to me. I'm going to merge this PR.

Edit: I will add the integration test of the config in a follow up PR and the diagram to the tutorial once ready.