https://github.com/phase2/docker-mariadb
MariaDB docker container with easy configuration via environment variables.
https://github.com/phase2/docker-mariadb
centos docker-image mariadb outrigger
Last synced: 26 days ago
JSON representation
MariaDB docker container with easy configuration via environment variables.
- Host: GitHub
- URL: https://github.com/phase2/docker-mariadb
- Owner: phase2
- Created: 2017-02-18T00:10:33.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-07-26T14:19:37.000Z (almost 9 years ago)
- Last Synced: 2025-01-12T17:36:40.191Z (over 1 year ago)
- Topics: centos, docker-image, mariadb, outrigger
- Language: Shell
- Size: 14.6 KB
- Stars: 0
- Watchers: 10
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Outrigger MariaDB
> MariaDB docker container with easy configuration via environment variables.
## Supported tags and respective `Dockerfile` links
- [`5.5` (*5.5/Dockerfile*)](https://github.com/phase2/docker-mariadb/blob/master/5.5/Dockerfile) [](https://microbadger.com/images/outrigger/mariadb:5.5 "Get your own version badge on microbadger.com")
- [`10.0` (*10.0/Dockerfile*)](https://github.com/phase2/docker-mariadb/blob/master/10.0/Dockerfile) [](https://microbadger.com/images/outrigger/mariadb:10.0 "Get your own version badge on microbadger.com")
- [`10.1` (*10.1/Dockerfile*)](https://github.com/phase2/docker-mariadb/blob/master/10.1/Dockerfile) [](https://microbadger.com/images/outrigger/mariadb:10.1 "Get your own version badge on microbadger.com")
- [`10.2` (*10.2/Dockerfile*)](https://github.com/phase2/docker-mariadb/blob/master/10.2/Dockerfile) [](https://microbadger.com/images/outrigger/mariadb:10.2 "Get your own version badge on microbadger.com")
This mariadb image is a MySQL compliant database image with configuration through
a collection of environment variables detailed below.
For more documentation on how Outrigger images are constructed and how to work
with them, please [see the documentation](http://docs.outrigger.sh/).
## How to use this image
Starting a MariaDB instance:
```bash
docker run --name some-mariadb -e MYSQL_PASS=my-secret-pw -d phase2/mariadb
```
... where some-mariadb is the name you want to assign to your container and
my-secret-pw is the password to be set for the MySQL root user
### Customizing Database Behavior
The MariaDB startup configuration is specified in the file `/etc/mysql/my.cnf`,
and that file in turn includes any files found in the `/etc/mysql/my.cnf.d`
directory that end with `.cnf`. Settings in files in this directory will augment
and/or override settings in /etc/mysql/my.cnf.
If you want to use a customized MySQL configuration, you can create your
alternative configuration file in a directory on the host machine and then mount
that directory location as `/etc/mysql/my.cnf.d` inside the mariadb container.
If `/my/custom/config-file.cnf` is the path and name of your custom
configuration file, you can start your mariadb container like this note that
only the directory path of the custom config file is used in this command):
```bash
docker run --name some-mariadb -v /my/custom:/etc/mysql/my.cnf.d -e MYSQL_PASS=my-secret-pw -d outrigger/mariadb
```
This will start a new container some-mariadb where the MariaDB instance uses the
combined startup settings from /etc/mysql/my.cnf and
/etc/mysql/conf.d/config-file.cnf, with settings from the latter taking
precedence.
> **If you add custom configuration in this way, you may invalidate the
environment variables as source of database configuration.**
## Environment Variables
Outrigger images use Environment Variables and [confd](https://github.com/kelseyhightower/confd)
to "templatize" a number of Docker environment configurations. These templates are
processed on startup with environment variables passed in via the docker run
command-line or via your docker-compose manifest file. Here are the "tunable"
configurations offered by this image.
* `MYSQL_PASS`: [`admin`] This will be the password that is set for the user
named **admin**. The root user does not have a password and allow local connections only.
* `MYSQL_DATABASE`: [e.g., `app_db`] If set, a database with this name will be
created when the database first starts up. *This is not set by default.*
* `MYSQL_EXPIRE_LOGS_DAYS`: [`10`]
* `MYSQL_MAX_ALLOWED_PACKET`: [`16M`]
* `MYSQL_MAX_CONNECTIONS`: [`10`]
* `MYSQL_QUERY_CACHE_LIMIT`: [`1M`]
* `MYSQL_QUERY_CACHE_SIZE`: [`16M`]
* `MYSQL_SLOW_QUERY_LOG`: [`0`] By default the slow query log is disabled.
* `MYSQL_LONG_QUERY_TIME`: [`10`] Long query threshold time in seconds.
* `MYSQL_LOG_QUERY_NO_INDEX`: [`0`] By default do not log queries that do not use an index.
## Security Reports
Please email outrigger@phase2technology with security concerns.
## Maintainers
[](https://www.phase2technology.com)