Skip to content

Conversation

@kyrofa
Copy link

@kyrofa kyrofa commented Jan 6, 2026

Upgrading without this leads to a mimir deployment that can no longer be modified (e.g. #13928).


Note

Updates the 5.x→6.0 Helm chart migration guide to clarify rollout-operator handling.

  • Renames the rollout-operator section to "Account for the rollout-operator"
  • Adds explicit opt-out instructions with rollout_operator.enabled: false to avoid webhook interference during rollouts
  • Retains/clarifies CRD install commands when rollout-operator is used

Written by Cursor Bugbot for commit 0217cbb. This will update automatically on new commits. Configure here.

Upgrading without this leads to a mimir deployment that can no longer be
modified.

Signed-off-by: Kyle Fazzari <[email protected]>
@kyrofa kyrofa requested review from a team and tacole02 as code owners January 6, 2026 00:08
@CLAassistant
Copy link

CLAassistant commented Jan 6, 2026

CLA assistant check
All committers have signed the CLA.

Copy link
Contributor

@tacole02 tacole02 left a comment

Choose a reason for hiding this comment

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

Docs look good! I left a few minor suggestions for formatting and style. We'll also want a maintainer to approve before merge. Thank you!

Follow the [Migrate to unified proxy deployment](https://grafana.com/docs/helm-charts/mimir-distributed/v5.8.x/migration-guides/migrate-to-unified-proxy-deployment/) guide to complete this migration.

### Install rollout-operator CRDs (if using rollout-operator)
### Account for the rollout-operator
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Account for the rollout-operator
### Account for the rollout-operator
If your deployment uses the rollout-operator, you must ensure that the required CustomResourceDefinitions (CRDs) are installed. If you don’t use the rollout-operator, you must explicitly disable it in your values file to avoid unnecessary components.

Copy link
Author

Choose a reason for hiding this comment

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

Done.

### Install rollout-operator CRDs (if using rollout-operator)
### Account for the rollout-operator

#### If using, install CRDs
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
#### If using, install CRDs
#### Install CRDs when using the rollout-operator

Copy link
Author

Choose a reason for hiding this comment

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

Done, although I used "if" instead of "when" given that this upgrade only happens once instead of implying some sort of ongoing thing.

kubectl apply -f https://raw.githubusercontent.com/grafana/helm-charts/main/charts/rollout-operator/crds/zone-aware-pod-disruption-budget-custom-resource-definition.yaml
```

#### If not using, disable webhooks
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
#### If not using, disable webhooks
#### Disable the rollout-operator when not in use

Copy link
Author

Choose a reason for hiding this comment

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

Done, although I used "if" instead of "when" given that this upgrade only happens once instead of implying some sort of ongoing thing.


#### If not using, disable webhooks

If you've opted not to use the rollout-operator, disable it in your values file:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you've opted not to use the rollout-operator, disable it in your values file:
If you don’t use the rollout-operator, disable it in your values file to prevent the installation of related webhooks:

Copy link
Author

Choose a reason for hiding this comment

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

Done, although I also added the clarification that adding those webhooks without the CRDs will actually interfere with future rollouts. This really is a footgun to ship by default, by the way 😛 .

Signed-off-by: Kyle Fazzari <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants