Skip to content

Commit

Permalink
Sync docs from Discourse
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] committed Jan 7, 2025
1 parent cec46a0 commit 156b7c4
Show file tree
Hide file tree
Showing 3 changed files with 128 additions and 3 deletions.
1 change: 1 addition & 0 deletions docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@ Charmed MySQL K8s is an official distribution of MySQL. It’s an open-source pr
| 2 | h-contribute | [Contribute](/t/14655) |
| 1 | reference | [Reference]() |
| 2 | r-releases | [Release Notes](/t/11878) |
| 3 | r-revision-210-211 | [Revision 210/211](/t/16133) |
| 3 | r-revision-180-181 | [Revision 180/181](/t/15276) |
| 3 | r-revision-153 | [Revision 153](/t/14072) |
| 3 | r-revision-127 | [Revision 127](/t/13522) |
Expand Down
18 changes: 15 additions & 3 deletions docs/reference/r-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ To see all releases and commits, check the [Charmed MySQL K8s Releases page on G

| Release | MySQL version | Juju version | [TLS encryption](/t/9655)* | [COS monitoring](/t/9981) | [Minor version upgrades](/t/11752) | [Cross-regional async replication](/t/13458) |
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| [210], [211] | 8.0.39 | `3.5.4+` | ![check] | ![check] | ![check] | ![check] |
| [180], [181] | 8.0.37 | `3.4.3+` | ![check] | ![check] | ![check] | ![check] |
| [153] | 8.0.36 | `3.4.3+` | ![check] | ![check] | ![check] | ![check] |
| [127] | 8.0.35 | `3.1.6+` | | ![check] | ![check] | |
Expand All @@ -23,16 +24,25 @@ For more details about each feature/interface, refer to the documentation linked
## Architecture and base
Several [revisions](https://juju.is/docs/sdk/revision) are released simultaneously for different [bases/series](https://juju.is/docs/juju/base) using the same charm code. In other words, one release contains multiple revisions.

> If you do not specify a revision on deploy time, Juju will automatically choose the revision that matches your base and architecture.
> If you do not specify a revision on deploy time, Juju will automatically choose the revision that matches your base and architecture.
>
> See: [`juju set-constraints`](https://juju.is/docs/juju/juju-set-constraints), [`juju info`](https://juju.is/docs/juju/juju-info)
> If you deploy a specific revision, **you must make sure it matches your base and architecture** via the tables below or with [`juju info`](https://juju.is/docs/juju/juju-info)
### Release 210-211

### Release 180-181 (`8.0/stable`)
| Revision | amd64 | arm64 | Ubuntu 22.04 LTS
|:--------:|:-----:|:-----:|:-----:|
|[210] |![check] | | ![check] |
|[211] | | ![check]| ![check] |

[details=Release 180-181]
### Release 180-181

| Revision | amd64 | arm64 | Ubuntu 22.04 LTS
|:--------:|:-----:|:-----:|:-----:|
|[180] |![check] | | ![check] |
|[181] | | ![check]| ![check] |
[/details]

[details=Release 153]

Expand Down Expand Up @@ -70,6 +80,8 @@ Several [revisions](https://juju.is/docs/sdk/revision) are released simultaneous
[/details]

<!-- LINKS -->
[210]: /t/16133
[211]: /t/16133
[180]: /t/15276
[181]: /t/15276
[153]: /t/14072
Expand Down
112 changes: 112 additions & 0 deletions docs/reference/r-revision-210-211.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
>Reference > Release Notes > [All revisions] > Revision 211/210
# Revision 211/210
<sub>January 6, 2025</sub>

Dear community,

Canonical's newest Charmed MySQL K8s operator has been published in the [8.0/stable channel]:
* Revision 210 is built for `amd64` on Ubuntu 22.04 LTS
* Revision 211 is built for `arm64` on Ubuntu 22.04 LTS

If you are jumping over several stable revisions, check [previous release notes][All revisions] before upgrading.

---

## Highlights
* Updated MySQL to `v8.0.39` ([PR #488](https://github.com/canonical/mysql-k8s-operator/pull/488)) ([DPE-4573](https://warthogs.atlassian.net/browse/DPE-4573))
* Added fully-featured terraform module ([PR #522](https://github.com/canonical/mysql-k8s-operator/pull/522)) ([DPE-5627](https://warthogs.atlassian.net/browse/DPE-5627))
* See also: [How to deploy on Terraform](/t/14926)
* Updated COS alert rule descriptions ([PR #519](https://github.com/canonical/mysql-k8s-operator/pull/519)) ([DPE-5659](https://warthogs.atlassian.net/browse/DPE-5659))
* See also: [How to enable alert rules](/t/15488),
* Bumped juju versions ([PR #517](https://github.com/canonical/mysql-k8s-operator/pull/517))
* `v2.9.50` -> `v2.9.51`
* `v3.4.5` -> `v3.5.4`

## Features and improvements
* Integrated with Tempo HA and tested relay support of tracing traffic through `grafana-agent-k8s` ([PR #518](https://github.com/canonical/mysql-k8s-operator/pull/518)) ([DPE-5312](https://warthogs.atlassian.net/browse/DPE-5312))
* Adopted admin address throughout charm ([PR #502](https://github.com/canonical/mysql-k8s-operator/pull/502)) ([DPE-5178](https://warthogs.atlassian.net/browse/DPE-5178))
* Avoid ambiguous service selector when multiple `mysql` apps in a model have the same cluster-name ([PR #501](https://github.com/canonical/mysql-k8s-operator/pull/501)) ([DPE-4861](https://warthogs.atlassian.net/browse/DPE-4861))
* Ensure that uninitialized variable not referenced in `_is_cluster_blocked` helper ([PR #507](https://github.com/canonical/mysql-k8s-operator/pull/507)) ([DPE-5481](https://warthogs.atlassian.net/browse/DPE-5481))
* Recover from pod restarts during cluster creation during setup ([PR #499](https://github.com/canonical/mysql-k8s-operator/pull/499))
* Added timeout on node count query ([PR #514](https://github.com/canonical/mysql-k8s-operator/pull/514)) ([DPE-5582](https://warthogs.atlassian.net/browse/DPE-5582))

## Bugfixes and maintenance

* Fixed unit-initialized test may break when run too early ([PR #491](https://github.com/canonical/mysql-k8s-operator/pull/491)) ([DPE-5209](https://warthogs.atlassian.net/browse/DPE-5209))
* Common credentials fixture and `exec` timeout workaround ([PR #493](https://github.com/canonical/mysql-k8s-operator/pull/493)) ([DPE-5210](https://warthogs.atlassian.net/browse/DPE-5210))
* Fixed /database requested wait container ([PR #500](https://github.com/canonical/mysql-k8s-operator/pull/500)) ([DPE-5385](https://warthogs.atlassian.net/browse/DPE-5385))
* Attempted to stabilize failing integration tests ([PR #496](https://github.com/canonical/mysql-k8s-operator/pull/496))
* Add test to ensure correct k8s endpoints created for clusters with the same name ([PR #508](https://github.com/canonical/mysql-k8s-operator/pull/508))
* Add check to ensure peer databag populated before reconciling mysqld exporter pebble layers ([PR #505](https://github.com/canonical/mysql-k8s-operator/pull/505)) ([DPE-5417](https://warthogs.atlassian.net/browse/DPE-5417))
* Add base in test_multi_relations to workaround libjuju bug ([PR #506](https://github.com/canonical/mysql-k8s-operator/pull/506)) ([DPE-5480](https://warthogs.atlassian.net/browse/DPE-5480))

[details=Libraries, testing, and CI]

* increased key logs verbosity (s/debug/info/) ([PR #513](https://github.com/canonical/mysql-k8s-operator/pull/513))
* Run juju 3.6 nightly tests against 3.6/stable ([PR #533](https://github.com/canonical/mysql-k8s-operator/pull/533))
* Test for multi-relation scale in/out ([PR #489](https://github.com/canonical/mysql-k8s-operator/pull/489)) ([DPE-4613](https://warthogs.atlassian.net/browse/DPE-4613))
* Test against juju 3.6/candidate + upgrade dpw to v23.0.5 ([PR #527](https://github.com/canonical/mysql-k8s-operator/pull/527))
* Added workflow for nightly scheduled tests with juju 3.6 ([PR #490](https://github.com/canonical/mysql-k8s-operator/pull/490)) ([DPE-4976](https://warthogs.atlassian.net/browse/DPE-4976))
* Switch from tox build wrapper to charmcraft.yaml overrides ([PR #509](https://github.com/canonical/mysql-k8s-operator/pull/509))
* Update canonical/charming-actions action to v2.6.3 ([PR #497](https://github.com/canonical/mysql-k8s-operator/pull/497))
* Update codecov/codecov-action action to v5 ([PR #526](https://github.com/canonical/mysql-k8s-operator/pull/526))
* Update data-platform-workflows to v23.1.0 ([PR #532](https://github.com/canonical/mysql-k8s-operator/pull/532))
* Update dependency canonical/microk8s to v1.31 ([PR #495](https://github.com/canonical/mysql-k8s-operator/pull/495))
* Update dependency cryptography to v43 [SECURITY] ([PR #498](https://github.com/canonical/mysql-k8s-operator/pull/498))

[/details]

## Requirements and compatibility
* (increased) MySQL version: `v8.0.37` -> `v8.0.39`
* (increased) Minimum Juju 2 version:`v2.9.50` -> `v2.9.51`
* (increased) Minimum Juju 3 version:`v3.4.5` -> `v3.5.4`

See the [system requirements] for more details about Juju versions and other software and hardware prerequisites.

### Packaging

This charm is based on the Charmed MySQL K8s [rock image]. It packages:
* [mysql-server-8.0] `v8.0.39`
* [mysql-router] `v8.0.39`
* [mysql-shell] `v8.0.38`
* [prometheus-mysqld-exporter] `v0.14.0`
* [prometheus-mysqlrouter-exporter] `v5.0.1`
* [percona-xtrabackup] `v8.0.35`

See the [`/lib/charms` directory on GitHub] for more details about all supported libraries.

See the [`metadata.yaml` file on GitHub] for a full list of supported interfaces.


<!-- Topics -->
[All revisions]: /t/11878
[system requirements]: /t/11421

<!-- GitHub -->
[`/lib/charms` directory on GitHub]: https://github.com/canonical/mysql-k8s-operator/tree/main/lib/charms
[`metadata.yaml` file on GitHub]: https://github.com/canonical/mysql-k8s-operator/blob/main/metadata.yaml

<!-- Charmhub -->
[8.0/stable channel]: https://charmhub.io/mysql?channel=8.0/stable

<!-- Snap/Rock -->
[`charmed-mysql` packaging]: https://github.com/canonical/charmed-mysql-rock

[MySQL Libraries tab]: https://charmhub.io/mysql/libraries

[113/114]: https://github.com/canonical/charmed-mysql-snap/releases/tag/rev114
[rock image]: https://github.com/canonical/charmed-mysql-rock/pkgs/container/charmed-mysql

[mysql-server-8.0]: https://launchpad.net/ubuntu/+source/mysql-8.0/
[mysql-router]: https://launchpad.net/ubuntu/+source/mysql-8.0/
[mysql-shell]: https://launchpad.net/~data-platform/+archive/ubuntu/mysql-shell
[prometheus-mysqld-exporter]: https://launchpad.net/~data-platform/+archive/ubuntu/mysqld-exporter
[prometheus-mysqlrouter-exporter]: https://launchpad.net/~data-platform/+archive/ubuntu/mysqlrouter-exporter
[percona-xtrabackup]: https://launchpad.net/~data-platform/+archive/ubuntu/xtrabackup


<!-- Badges -->
[juju-2_amd64]: https://img.shields.io/badge/Juju_2.9.51-amd64-darkgreen?labelColor=ea7d56
[juju-3_amd64]: https://img.shields.io/badge/Juju_3.4.6-amd64-darkgreen?labelColor=E95420
[juju-3_arm64]: https://img.shields.io/badge/Juju_3.4.6-arm64-blue?labelColor=E95420

0 comments on commit 156b7c4

Please sign in to comment.