ravensys/mariadb repository overview

⁠MariaDB 10.2 SQL database server Docker image

This container image includes MariaDB database server version 10.2 based on CentOS.

The CentOS image is available on Docker Hub⁠ as ravensys/mariadb:10.2-centos7.

⁠Description

This container image provides a containerized packaging of the MariaDB mysqld daemon and client application. The mysqld server daemon accepts connections from clients and provides access to content from MariaDB databases on behalf of the clients. You can find more information on the MariaDB project from the project Web site (https://mariadb.org/⁠).

⁠Usage

If the database data directory is not initialized, the entrypoint script will first run mysql_install_db and setup necessary database users and password. After database is initialized, or if it was already present, mysqld is executed and will run as PID 1.

• Simple user with database

  This will create a container named mariadb_database running MariaDB with database named db and user with credentials user:pass. Port 3306 will be exposed and mapped to host.

  $ docker run -d --name mariadb_database -e MARIADB_USER=user -e MARIADB_PASSWORD=pass -e MARIADB_DATABASE=db -p 3306:3306 ravensys/mariadb:10.2-centos7
  

  Copy

• Simple user without database

  This will create a container named mariadb_database running MariaDB with user with credentials user:pass and admin with credentials root:rootpass. Port 3306 will be exposed and mapped to host.

  $ docker run -d --name mariadb_database -e MARIADB_USER=user -e MARIADB_PASSWORD=pass -e MARIADB_ADMIN_PASSWORD=rootpass -p 3306:3306 ravensys/mariadb:10.2-centos7
  

  Copy

• Only admin account

  This will create a container named mariadb_database running MariaDB with admin with credentials root:rootpass. Port 3306 will be exposed and mapped to host.

  $ docker run -d --name mariadb_database -e MARIADB_ADMIN_PASSWORD=rootpass -p 3306:3306 ravensys/mariadb:10.2-centos7
  

  Copy

  Alternatively the same configuration can be achieved by setting MARIADB_USER environment variable to root.

  $ docker run -d --name mariadb_database -e MARIADB_USER=root -e MARIADB_PASSWORD=rootpass -p 3306:3306 ravensys/mariadb:10.2-centos7
  

  Copy

To make database data persistent across container executions add -v /host/db/path:/var/lib/mysql/data argument to the Docker run command.

To stop detached container simply run docker stop mariadb_database.

⁠Environment variables

The image recognizes following environment variables which can be set during initialization by passing -e VAR=VALUE to the Docker run command.

Following environment variables influence MariaDB configuration file. They are all OPTIONAL.

⁠Secrets

The image recognizes following secrets which can be created by running echo <value> | docker secret create <name>.

Default secret name can be changed by setting respective environment variable during initialization, value represents a relative path to a file located in secrets volume.

Notice: Secrets takes precedence over environment variables, if both secret and environment variable are set, the value from secret is used.

⁠Volumes

The following mount points can be set by passing -v /host/path:/container/path to the Docker run command.

Notice: When mounting a directory from host into container, ensure that the mounted directory has appropriate permissions and that owner and group of directory matches UID of user running inside container.

⁠MariaDB auto-tuning

When MariaDB image is run with the --memory parameter set and if there are no values provided for these environment variables, their values will be automatically calculated based on available memory.

⁠MariaDB admin account

The admin account root has no password set by default, only allowing local connections. To allow root user login remotely the MARIADB_ADMIN_PASSWORD environment variable must be set when initializing container. Local connections will still not require password.

⁠MariaDB unprivileged account

The unprivileged user account with MARIADB_USER name is created, authenticated by password set in MARIADB_PASSWORD, with all privileges to database MARIADB_DATABASE.

⁠Changing passwords

Since passwords are part of the image configuration, the only supported method to change passwords for database user (MARIADB_USER) and admin root is by changing environment variables MARIADB_PASSWORD and MARIADB_ADMIN_PASSWORD, respectively.

Changing these database passwords through SQL statements or any way other than through environment variables aforementioned will cause a mismatch between values stored in variables and actual passwords. Whenever a database container stars it will reset passwords to values stored in environment variables.

⁠Post-initialization scripts

Image initialization process can by extended by placing sourcable shell scripts, these must have a .sh extension, into post-initialization drop-in /usr/share/container-entrypoint/mariadb/post-init.d directory.

• Mount volume with post-init scripts

  To propagate post-initialization scripts from host into container add volume mount -v /path/to/post-init/scripts:/usr/share/container-entrypoint/mariadb/post-init.d argument to the Docker run command.

  $ docker run -d --name mariadb_database -v /path/to/post-init/scripts:/usr/share/container-entrypoint/mariadb/post-init.d -e MARIADB_ADMIN_PASSWORD=rootpass -p 3306:3306 ravensys/mariadb:10.2-centos7
  

  Copy

• Extend image with post-init scripts

  This Dockerfile will create a Docker image based on ravensys/mariadb:10.2-centos7 with built-in post-initialization scripts from directory post-init-scripts.

  FROM ravensys/mariadb:10.2-centos7
  
  COPY post-init-scripts /usr/share/container-entrypoint/mariadb/post-init.d
  

  Copy

⁠Changing default locale

This Dockerfile will create a Docker image based on ravensys/mariadb:10.2-centos7 with default locale set to de_DE.UTF-8.

FROM ravensys/mariadb:10.2-centos7

RUN localedef -f UTF-8 -i de_DE de_DE.UTF-8
ENV LANG de_DE.UTF-8

⁠Troubleshooting

The container initialization scripts and mysqld daemon logs to the standard output, so these are available in container log. This log can be examined by running:

$ docker logs <container>

⁠See also

Dockerfile and other sources for this container image are available on https://github.com/ravensys/container-mariadb⁠.