Added release notes and upgrade guide for 0.38.1

This commit is contained in:
mmontes11
2025-04-15 13:33:58 +02:00
committed by Martin Montes
parent e30f9ea1a5
commit 8b46a2b2fb
2 changed files with 92 additions and 0 deletions

View File

@ -0,0 +1,13 @@
**`{{ .ProjectName }}` [0.38.1](https://github.com/mariadb-operator/mariadb-operator/releases/tag/0.38.1) is here!** 🦭
This is a patch release limited in scope and focusing on bug fixes and performance optimizations. Refer to the PRs below for more details.
If you're upgrading from previous versions, don't miss the [UPGRADE GUIDE](https://github.com/mariadb-operator/mariadb-operator/blob/main/docs/releases/UPGRADE_0.38.1.md) for a smooth transition.
Huge thanks to our contributors in this release! 🙏🏻
---
We value your feedback! If you encounter any issues or have suggestions, please [open an issue on GitHub](https://github.com/mariadb-operator/mariadb-operator/issues/new/choose). Your input is crucial to improve `{{ .ProjectName }}`🦭.
Join us on Slack: **[MariaDB Community Slack](https://r.mariadb.com/join-community-slack)**.

View File

@ -0,0 +1,79 @@
# Upgrade guide 0.38.1
This guide illustrates, step by step, how to migrate to `0.38.1` from previous versions.
> [!NOTE]
> Do not attempt to skip intermediate version upgrades. Upgrade progressively through each version.
- Uninstall you current `mariadb-operator` for preventing conflicts:
```bash
helm uninstall mariadb-operator
```
Alternatively, you may only downscale and delete the webhook configurations:
```bash
kubectl scale deployment mariadb-operator --replicas=0
kubectl scale deployment mariadb-operator-webhook --replicas=0
kubectl delete validatingwebhookconfiguration mariadb-operator-webhook
kubectl delete mutatingwebhookconfiguration mariadb-operator-webhook
```
- Upgrade `mariadb-operator-crds` to `0.38.1`:
```bash
helm repo update mariadb-operator
helm upgrade --install mariadb-operator-crds mariadb-operator/mariadb-operator-crds --version 0.38.1
```
- If you are using Galera, and you want the operator to automatically update the data-plane (i.e. init and agent containers) to `0.38.1`, you can set `updateStrategy.autoUpdateDataPlane=true` in your `MariaDB` resources:
```diff
apiVersion: k8s.mariadb.com/v1alpha1
kind: MariaDB
metadata:
name: mariadb-galera
spec:
updateStrategy:
+ autoUpdateDataPlane: true
```
Alternatively, you can also do this manually:
```diff
apiVersion: k8s.mariadb.com/v1alpha1
kind: MariaDB
metadata:
name: mariadb
spec:
galera:
agent:
- image: docker-registry3.mariadb.com/mariadb-operator/mariadb-operator:0.38.0
+ image: docker-registry3.mariadb.com/mariadb-operator/mariadb-operator:0.38.1
initContainer:
- image: docker-registry3.mariadb.com/mariadb-operator/mariadb-operator:0.38.0
+ image: docker-registry3.mariadb.com/mariadb-operator/mariadb-operator:0.38.1
```
- Upgrade `mariadb-operator` to `0.38.1`:
```bash
helm repo update mariadb-operator
helm upgrade --install mariadb-operator mariadb-operator/mariadb-operator --version 0.38.1
```
- If you previously decided to downscale the operator, make sure you upscale it back:
```bash
kubectl scale deployment mariadb-operator --replicas=1
kubectl scale deployment mariadb-operator-webhook --replicas=1
```
- If you previously set `updateStratety.autoUpdateDataPlane=true`, you may consider reverting the changes once the upgrades have finished:
```diff
apiVersion: k8s.mariadb.com/v1alpha1
kind: MariaDB
metadata:
name: mariadb-galera
spec:
updateStrategy:
+ autoUpdateDataPlane: false
- autoUpdateDataPlane: true
```