appuio/dbaas-mariadb-apb repository overview

⁠MariaDB as a Service APB

This Ansible playbook bundle provisions users and databases on a existing MariaDB instance.

⁠Installation

Set up the Ansible service broker to import APBs from the Docker Hub appuio repository:

registry:
  - name: appuio
    type: dockerhub
    org: appuio
    tag: latest
    white_list: [.*-apb$]

To provide the admin user credentials to connect to the MariaDB, a secret with the name dbaas-db-credentials needs to exist in the Ansible service broker namespace:

apiVersion: v1
kind: Secret
metadata:
  name: dbaas-db-credentials
type: Opaque
stringData:
  mariadb_hostname: db.maria.com
  mariadb_password: myPassword
  mariadb_port: '3306'
  mariadb_user: root

The Ansible service broker needs to be configured to mount the secret in provisioner pods. Add the following section to the Ansible service broker configuration (ConfigMap):

secrets:
- title: DBaaS database credentials
  secret: dbaas-db-credentials
  apb_name: appuio-dbaas-mariadb-apb

⁠Development environment

You can use minishift⁠ with the Ansible Service Broker Addon⁠ to run a local OpenShift installation with the Ansible service broker to test APBs:

MINISHIFT_ENABLE_EXPERIMENTAL=y minishift start --extra-clusterup-flags "--service-catalog" --openshift-version v3.9.0

minishift addons install <path_to_addon>
minishift addons apply ansible-service-broker

Install the APB CLI⁠ on your machine. The easiest way is to run it in a Docker container via the provided helper script⁠.

⁠Release

An automatic Docker build is set up for this repository. If you change stuff in apb.yml don't forget to run apb prepare before committing.