Interfaces/endpoints

MySQL Router K8s supports modern ‘mysql_client’ interface. Applications can easily connect MySQL using ‘data_interfaces’ library from ‘data-platform-libs’.

Modern mysql_client interface (database endpoint):

Adding a relation is accomplished with juju relate (or juju integrate for Juju 3.x) via endpoint database. Read more about Juju relations (integrations). Example:

# Deploy Charmed MySQL K8s and MySQL Router K8s clusters with 3 nodes each
juju deploy mysql-k8s -n 3 --trust
juju deploy mysql-router-k8s -n 3 --trust --channel 8.0

# Deploy the relevant charms, e.g. mysql-test-app
juju deploy mysql-test-app

# Relate all applications
juju integrate mysql-k8s mysql-router-k8s
juju integrate mysql-router-k8s:database mysql-test-app

# Check established relation (using mysql_client interface):
juju status --relations

# Example of the properly established relation:
# > Integration provider                 Requirer                             Interface           Type     Message
# > mysql-k8s:database                   mysql-router-k8s:backend-database    mysql_client        regular
# > mysql-router-k8s:database            mysql-test-app:database              mysql_client        regular         
# > ...

Note: In order to relate with Charmed MySQL K8s, every table created by the client application must have a primary key. This is required by the group replication plugin enabled in this charm.

See all the charm interfaces here.