Releases: canonical/mysql-operator
Revisions 366, 367
A new revision of Charmed MySQL has been published in the 8.0/stable channel on Charmhub.
See also: Releases overview page, How to perform an upgrade
What's Changed
This section outlines the most important features and bug fixes in this release.
Features
- Update MySQL to v8.0.41 in #606 by @shayancanonical
- [DPE-6651] Update snap revisions to new builds with updated percona packages in #622 by @shayancanonical
- [DPE-5656] New options for log rotation in #597 by @paulomach
- [DPE-4375] Add operator managed self-rejoin in #592 by @sinclert-canonical
- [DPE-5588] Check against invalid arch in #563 by @sinclert-canonical
Bug fixes
- [DPE-6137] Refactor for password safety by @paulomach in #579
- [DPE-4375] Add cluster manual re-join handler by @sinclert-canonical in #592
- [DPE-6666] Remove async-replication test workaround by @sinclert-canonical in #619
- fix: dpe-6695 fix race on legacy mysql by @paulomach in #624
- [DPE-6488] Address slow mysqld start upon unit reboot by @shayancanonical in #615
Full Changelog: rev312...rev366
Technical details
This section contains some technical details about the charm's contents and dependencies.
If you are jumping over several stable revisions, check previous release notes before upgrading.
Requirements and compatibility
This charm revision features the following changes in dependencies:
- (increased) MySQL version to
v8.0.41
- (increased) Snap revision 138/139
Important
This release of Charmed MySQL requires Juju v.3.4.3
or 3.5.2+
. See the guide How to upgrade Juju for a new database revision.
Revisions 312, 313
A new revision of Charmed MySQL VM has been published in the 8.0/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important features and bug fixes in this release.
Features
- Upgraded MySQL from
v8.0.36
->v8.0.39
(see Packaging) (DPE-4573) - Added support or ARM64 architecture (PR #472)
- Added support for Audit plugin (PR #488) (DPE-4366)
- Added Awesome Prometheus Alert Rules (criticality) (PR #493) (DPE-2477)
- Add integration with COS Tempo HA (DPE-5312)
- New Terraform module (PR #540) (DPE-5627)
- Changed binlog retention period (one week by default) (PR #503) (DPE-4247)
- Added support for re-scanning cluster for unit rejoin after node drain (PR #462) (DPE-4118)
- Enable and use admin address/port for operator users (PR #516) (DPE-5178)
Bug fixes
- Add warnings to destructive actions by (PR #555) (DPE-5711)
- Fixed MySQL Group replication start logic during the juju refresh (PR #546) (DPE-5941)
- Removed passwords from outputs and tracebacks (PR #499) (DPE-4266)
- Fixed cluster metadata and instance state checks (PR #482) (DPE-4850)
- Ensure username uniqueness (PR #464) (DPE-4643)
- Set instance offline mode on restore (PR #478) (DPE-4699)
- Added support for re-scanning cluster for unit rejoin after node drain (PR #462) (DPE-4118)
- Fixes for backup logging (PR #471) (DPE-4699)
- Fixed global-primary on endpoint (PR #467) (DPE-4658)
- Skip set unknown config keys (PR #532) (DPE-5628)
- Change key logs from debug->info (PR #527) (DPE-4910)
- Fixed timeout node count query (PR #528) (DPE-5582)
- Skip plugin install for not file found (PR #524) (DPE-5540)
- Skip tls reconfiguration on unit teardown (PR #522) (DPE-5493)
- Upgrade fix for admin-address enabled charm (PR #520) (DPE-5178)
- Bump cffi to version 1.16.0 (PR #549)
- Fixed use juju provided ip (PR #558) (DPE-6105)
- Fixed regression on MAAS deployment (PR #554) (DPE-6055)
- Add new VM reboot tests (PR #534) (DPE-5415)
- Fixed starting group replication while waiting for upgrade (PR #546) (DPE-5941)
Full Changelog: rev240...rev312
Technical details
This section contains some technical details about the charm's contents and dependencies.
If you are jumping over several stable revisions, check previous release notes before upgrading.
Requirements and compatibility
This charm revision features the following changes in dependencies:
- (increased) MySQL version
v8.0.39
Important
This release of Charmed MySQL requires Juju v.3.4.3
or 3.5.2+
. See the guide How to upgrade Juju for a new database revision.
See the system requirements page for more details about software and hardware prerequisites.
Packaging
This charm is based on the charmed-mysql
snap Revision 113/114. It packages:
- mysql-server-8.0: 8.0.39-0ubuntu0.22.04.1
- mysql-router
v8.0.39
: 8.0.39-0ubuntu0.22.04.1 - mysql-shell
v8.0.38
: 8.0.38+dfsg-0ubuntu0.22.04.1~ppa2 - prometheus-mysqld-exporter
v0.14.0
: 0.14.0-0ubuntu0.22.04.1~ppa2 - prometheus-mysqlrouter-exporter
v5.0.1
: 5.0.1-0ubuntu0.22.04.1~ppa1 - percona-xtrabackup
v8.0.35
: 8.0.35-31-0ubuntu0.22.04.1~ppa3
Contact us
Charmed MySQL is an open source project that warmly welcomes community contributions, suggestions, fixes, and constructive feedback.
Revision 240
A new revision of Charmed MySQL VM has been published in the 8.0/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important features and bug fixes in this release.
Important
The current charm revision requires Juju 3.4.3/3.5.2+!
If you are jumping over several stable revisions, make sure to check previous release notes before upgrading to this revision.
Features
- New workload version MySQL 8.0.36
- Async replication between clouds [PR#375][DPE-2957]
- Ubuntu PRO support (
ubuntu-advantage
&landscape-client
subordination) [PR#413] - Add COS Tempo tracing support [#456][DPE-4367]
- Add new config options:
- log rotation for general/error/slowquery text logs [PR#329][DPE-1796]
- TLS CA chain support [PR#396]
- Labels for internal Juju secrets in [PR#348][DPE-2886]
- Internal disable operator mode [DPE-2184]
- Updated
data-platform-libs
for external secrets [PR#333] - Snap aliases for MySQL server / Router [PR#417][DPE-3702]
- Allure Report [PR#391]
Bug fixes
- Fixed MAAS deployment [PR#444][DPE-3115]
- Fixed single unit upgrade [PR#340][DPE-2662]
- Fixed dateformat in logrotate config to avoid causing filename conflicts after 24hrs of uptime [PR#363][DPE-3063]
- Stops logging FLUSH LOG statements to the MySQL binlog which is causing GTID conflicts and prevents the member from self-healing [PR#336]
- Fixed rollback for unsupported MySQL datadir [DPE-3392]
- Updated TLS test lib and test charm [PR#392][DPE-3403]
- Fixed floor value for max_connections [PR#398]
- Fixed max_connections calculation [#429]DPE-3706
- Fixed KeyError when no ca-chain [PR#403][DPE-3688]
- Fixed broken state (after the restart) [PR#381][DPE-2618]
- Fixed error messaging when no bucket for backup [PR#350][DPE-2758]
- Avoid setting secret upon TLS relation broken if using juju secrets [PR#360][DPE-2677]
- Fixed logrotate file path [PR#374]
- Started using labels for internal secrets [PR#348][DPE-2886]
Canonical Data issues are now public on both Jira and GitHub platforms.
GitHub Releases provide a detailed list of bugfixes, PRs, and commits for each revision.
Full Changelog: rev196...rev240
Inside the charms
- Charmed MySQL ships the latest MySQL
8.0.36-0ubuntu0.22.04.1
mysql-shell
CLI tool updated to8.0.36+dfsg-0ubuntu0.22.04.1~ppa4
- Backup tools xtrabackup/xbcloud updated to
8.0.35-30
- The Prometheus mysqld-exporter is
0.14.0-0ubuntu0.22.04.1~ppa2
- VM charms based on Charmed MySQL snap (Ubuntu LTS
22.04.4
) revision103
- Principal charms supports Ubuntu LTS series 22.04 only
Technical notes
- Upgrade (
juju refresh
) is possible from revision 196+ - Use this operator together with a modern operator MySQL Router
- Please check restrictions from previous release notes
- Ensure the charm requirements met.
Contact us
Charmed MySQL is an open source project that warmly welcomes community contributions, suggestions, fixes, and constructive feedback.
Revision 196
A new revision of Charmed MySQL VM has been published in the 8.0/stable
channel.
See also: Releases overview page, How to perform an upgrade
What's changed
This section outlines the most important features and bug fixes in this release.
Features
- Add Juju 3 support (Juju 2 is still supported) [DPE-1790]
- Peer secrets are now stored in Juju secrets [DPE-1812]
- Charm minor upgrades and minor rollbacks [DPE-2206]
- Profiles configuration support [DPE-2154]
- Workload updated to MySQL 8.0.34 [DPE-2425]
- Support
juju expose
[DPE-1214] - Switch to MySQL ClusterSet by default [DPE-1231]
- Add the first Prometheus alert rule (COS Loki) [PR#230]
- UX: Autogenerate db/user in legacy mysql (if not specified as config) [DPE-1511]
- Switch Charmed MySQL SNAP to Canonical binaries
- New documentation:
Bug fixes
Canonical Data issues are now public on both Jira and GitHub platforms.
GitHub Releases provide a detailed list of bugfixes/PRs/Git commits for each revision.
Highlights for the current revision:
- #209 Use special user for backups + miscellaneous backups fixes
- #216 Fix/join units refactor by
- #223 Add auto-tuning for max_connections
- #224 Optimize mysqlsh calls on library by
- #254 Miscellaneous improvements to the mysql legacy relation
- #296 Fixed MySQL memory allocation, consider 'group_replication_message_cache_size'
- DPE-1626 Add timeout kwarg to run_mysqlcli_script
- DPE-2215 Fix wait timeout for shared-db
- DPE-2089 Improve charm to add snap alias charmed-mysql.mysql -> mysql
- DPE-2352 Restart mysql exporter upon monitoring password change
- DPE-1979 Fixed machine deployments where hosts are not resolvable
- DPE-1519 Stabilized integration with mysql-route
- DPE-2455 Fix bug that caused unnecessary truncation of the mysql hosts cache
- DPE-2214 Avoid resetting workload if recovery from unreachable state unsuccessful
- DPE-2478 Use actual observer pid in databag + reduce volume of secrets related logs
- DPE-2217 Preemptively switch primary on scale-down
- DPE-2401 Hold snap revision by default
- DPE-2485 Resolve race condition when restarting after configure_instance
- DPE-988 Fixed standby units (9+ cluster members are waiting to join the cluster)
- DPE-2177 Stop configuring mysql user
root@%
(removed as no longer necessary)
Full Changelog: rev151...rev196
What is inside the charms
- Charmed MySQL ships the latest MySQL “8.0.34-0ubuntu0.22.04.1”
- CLI mysql-shell updated to "8.0.34-0ubuntu0.22.04.1~ppa1"
- Backup tools xtrabackup/xbcloud updated to "8.0.34-29"
- The Prometheus mysqld-exporter is "0.14.0-0ubuntu0.22.04.1~ppa1"
- VM charms based on Charmed MySQL SNAP (Ubuntu LTS “22.04” - ubuntu:22.04-based)
- Principal charms supports the latest LTS series “22.04” only.
- Subordinate charms support LTS “22.04” and “20.04” only.
Technical notes
- Upgrade (
juju refresh
) from the old-stable revision 151 to the current-revision 196 is NOT supported!!! The upgrade functionality is new and supported for revision 196+ only! - Please check additionally the previously posted restrictions.
- Ensure the charm requirements met.
How to reach us
If you would like to chat with us about your use-cases or ideas, you can reach us at Canonical Mattermost public channel or Discourse. Check all other contact details here.
Consider opening a GitHub issue if you want to open a bug report.
Contribute to the project!
Note
Please check all the previous release notes if you are jumping over the several stable revisions!
Revision 151
A new revision of Charmed MySQL VM has been published in the 8.0/stable
channel.
See also: Releases overview page, How to perform an upgrade
Features
- Deploy on VM (tested with LXD, MAAS)
- juju constraints are supported to limit CPU/RAM/Storage size
- Scaling up/down in one simple juju command
- HA using Innodb Group replication
- Full backups and restores are supported when using any S3-compatible storage
- TLS support (using “tls-certificates” operator)
- DB access outside of Juju using “data-integrator”
- Data import using standard tools e.g. mysqldump, etc.
- Documentation:
Charm | Version | Charm channel | Documentation | License |
---|---|---|---|---|
MySQL | 8.0.32 | 8.0/stable (r151) | Tutorial, Readme, Contributing | Apache 2.0 |
Full Changelog: https://github.com/canonical/mysql-operator/commits/rev151
What is inside the charms
- Charmed MySQL charm ships the latest MySQL “8.0.32-0ubuntu0.22.04.2”
- VM charms based on our SNAP (Ubuntu LTS “22.04” - core22-based)
- Principal charms supports the latest LTS series “22.04” only.
- Subordinate charms support LTS “22.04” and “20.04” only.
Technical notes
Compatibility with legacy charms:
- New MySQL charm is a juju-interface compatible replacement for legacy charms such as “MariaDB”, “OSM MariaDB”, “Percona Cluster” and “Mysql Innodb Cluster” (using legacy interface “mysql”, via endpoints “mysql” and “mysql-root”). Other legacy interfaces such as “mysql-router” interface (“db-router” endpoint) and “mysql-shared” interface (“shared-db” endpoint) are also supported. However, it is highly recommended to migrate to the modern interface ‘mysql_client ’. It can be easily done using the charms library ‘data_interfaces’ from ‘data-platform-libs’.
Please contact us, see details below, if you are considering migrating from other “legacy” charms not mentioned above. Additionally:
- Tracks description:
- Charm MySQL charm follows the SNAP track “8.0”.
- No “latest” track in use (no surprises in tracking “latest/stable”)!
- Charmed MySQL charms provide legacy charm through “latest/stable”.
- Charm lifecycle flowchart diagrams: MySQL.
- Modern interfaces are well described in “Interfaces catalogue” and implemented by 'data-platform-libs'.
How to reach us
If you would like to chat with us about your use-cases or ideas, you can reach us at Canonical Mattermost public channel or Discourse. Check all other contact details here.
Consider opening a GitHub issue if you want to open a bug report. Contribute to the project!
The document was originally posted here.