3.4 KiB
Overview
The mysql-innodb-cluster charm deploys a MySQL 8 InnoDB clustered database (i.e. MySQL InnoDB Cluster). It is used in conjunction with the mysql-router subordinate charm.
Important: The eoan series is the first series supported by the mysql-innodb-cluster and mysql-router charms. These charms replace the percona-cluster charm starting with the focal series.
Usage
Configuration
See file config.yaml
of the built charm (or see the charm in the Charm
Store) for the full list of configuration options,
along with their descriptions and default values. See the Juju
documentation for details on configuring applications.
Deployment
MySQL 8 is natively HA and requires at least three database units, which are often containerised. To deploy a three-node cluster to new containers on machines '0', '1', and '2':
juju deploy -n 3 --to lxd:0,lxd:1,lxd:2 mysql-innodb-cluster
A cloud application is joined to the database via an instance of mysql-router. For a pre-existing keystone application:
juju deploy mysql-router keystone-mysql-router
juju add-relation keystone-mysql-router:db-router mysql-innodb-cluster:db-router
juju add-relation keystone-mysql-router:shared-db keystone:shared-db
See Infrastructure high availability in the OpenStack Charms Deployment Guide for more deploy information.
TLS
TLS communication between MySQL InnoDB Cluster and its cloud clients is supported.
Due to the circular dependency between the vault and mysql-innodb-cluster applications, the enablement of this feature can only be done post-deployment (once vault has been initialised and has a root Certificate Authority).
Enable database TLS communication with this relation:
juju add-relation mysql-innodb-cluster:certificates vault:certificates
Actions
This section lists Juju actions supported by the charm.
Actions allow specific operations to be performed on a per-unit basis. To
display action descriptions run juju actions --schema mysql-innodb-cluster
.
If the charm is not deployed then see file actions.yaml
.
add-instance
cluster-rescan
cluster-status
mysqldump
reboot-cluster-from-complete-outage
rejoin-instance
remove-instance
restore-mysqldump
set-cluster-option
Documentation
The OpenStack Charms project maintains two documentation guides:
- OpenStack Charm Guide: for project information, including development and support notes
- OpenStack Charms Deployment Guide: for charm usage information
Bugs
Please report bugs on Launchpad.