mariadb

MariaDB Plugin

This is a resource plugin that provisions a temporary mariadb server for use within a sandbox.

Installing the Plugin

Before installing the plugin, create the required service account and RBAC permissions:

kubectl -n signadot create -f ./k8s/mariadb-init.yaml

Using the signadot CLI, register the plugin in Signadot Control Plane:

signadot resourceplugin apply -f ./plugin.yaml

Using the Plugin

When creating a Signadot Sandbox, you can request a temporary MariaDB instance with a specified database name from this plugin by specifying the plugin name mariadb and passing the following parameters.

Parameter	Description	Example
dbname	The name of the empty database to create	testdb

After the resource is provisioned, the following output keys will be available for use by forked workloads in the sandbox:

Output Key	Description	Example
provision.host	The hostname of the database	testdb-k5ncuujcjllj2.my-namespace.svc
provision.port	The port of the database	3306
provision.root-password	The password for mariadb root access	xxj87hd

example-sandbox.yaml is an example of a sandbox that uses this plugin. To run it, you will need to install the example-baseline application in your cluster, and use signadot CLI to create the sandbox (replacing <cluster-name> with your cluster name, and <example-baseline-namespace> with the namespace where example-baseline was deployed):

signadot sandbox apply -f ./example-sandbox.yaml --set cluster=<cluster-name> --set namespace=<example-baseline-namespace>

Now, in the Signadot Dashboard, you can follow the status of your sandbox, and once ready, you will be able to access the preview endpoint, where you will see the added env vars: DB_HOST, DB_PORT and DB_ROOT_PASSWORD.

Removing the Plugin

Make sure all sandboxes that used the chart are deleted, so that the plugin gets a chance to deprovision anything that was provisioned, and then use signadot CLI to uninstall the plugin:

signadot resourceplugin delete -f ./plugin.yaml

Finally delete the service account and RBAC permissions:

kubectl -n signadot delete -f ./k8s/mariadb-init.yaml