mariadb Docker container service for Gearbox
This is the repository for the mariadb Docker container implemented for Gearbox.
Service | GitHub Version | Docker Version | Docker Size | Docker Tags |
---|---|---|---|---|
mariadb | (10.0.38 , 10.0 ) |
|||
mariadb | (10.1.44 , 10.1 ) |
|||
mariadb | (10.2.31 , 10.2 ) |
|||
mariadb | (10.3.22 , 10.3 ) |
|||
mariadb | (10.4.12 , 10.4 ) |
|||
mariadb | (10.5.2 , 10.5 , latest ) |
|||
mariadb | (5.5.64 , 5.5 ) |
A driving force behind Gearbox is to improve the user experience using software, and especially for software developers.
Our vision is to empower developers and other software users to quickly and easily use almost any version of a software service, command line tool or API without without first getting bogged down with installation and configuration.
In other words, our vision for Gearbox users is that software "just works".
This container has been designed to work within the Gearbox framework. However, due to the flexability of Gearbox, it can be used outside of this framework.
There are three methods:
launch
is a tool specifically designed to interact with a Gearbox Docker container.
It provides three important functional areas, without any Docker container learning curve:
- Allows control over Gearbox Docker containers: stop, start, create, remove.
- Build, update, modify and release Docker images.
- Acts as a proxy for interactive commands within a Gearbox Docker container.
It also provides a functional SSH daemon for connecting remotely as well as a standard set of common tools and utilities.
Further launch
documentation can be found here.
launch
is currently in beta testing and is included along with all Gearbox Docker repos.
Once out of beta, it will be included within the Gearbox installation package.
For now, simply download the standalone launch
binary for your O/S.
There are many ways to call launch, either directly or indirectly. Additionally, all host environment variables will be imported into the container seamlessly. This allows a devloper to try multiple versions of software as though they were installed locally.
If a container is missing, it will be downloaded and created. Multiple versions can co-exist.
Install, create, and start the mariadb Gearbox container.
./launch install mariadb
Create, and start the mariadb Gearbox container. Run a shell.
./launch shell mariadb
Create, and start the mariadb Gearbox container with version 5.5.64 and run a shell.
./launch shell mariadb:5.5.64
./launch shell mariadb:5.5.64 ls -l
./launch shell mariadb:5.5.64 ps -eaf
If mariadb is symlinked to launch
, then the Gearbox container will be determined automatically and the default command will be run.
All available commands for a Gearbox container will be automatically symlinked upon installation.
./mariadb
Running mariadb Gearbox container default command. If a container has a default interactive command, arguments can be supplied without specifying that command.
./mariadb -flag1 -flag2 variable
./launch mariadb:5.5.64 -flag1 -flag2 variable
Gearbox containers may have multiple executables that can be run. The mariadb Gearbox container has the following available commands:
- The default command will execute
/usr/bin/mariadb
within the container. mariabackup
- will execute/usr/bin/mariabackup
within the container.mariadb
- will execute/usr/bin/mariadb
within the container.mariadb-access
- will execute/usr/bin/mariadb-access
within the container.mariadb-admin
- will execute/usr/bin/mariadb-admin
within the container.mariadb-analyze
- will execute/usr/bin/mariadb-analyze
within the container.mariadb-backup
- will execute/usr/bin/mariadb-backup
within the container.mariadb-binlog
- will execute/usr/bin/mariadb-binlog
within the container.mariadb-check
- will execute/usr/bin/mariadb-check
within the container.mariadb-conv
- will execute/usr/bin/mariadb-conv
within the container.mariadb-convert-table-format
- will execute/usr/bin/mariadb-convert-table-format
within the container.mariadb-dump
- will execute/usr/bin/mariadb-dump
within the container.mariadb-dumpslow
- will execute/usr/bin/mariadb-dumpslow
within the container.mariadb-find-rows
- will execute/usr/bin/mariadb-find-rows
within the container.mariadb-fix-extensions
- will execute/usr/bin/mariadb-fix-extensions
within the container.mariadb-hotcopy
- will execute/usr/bin/mariadb-hotcopy
within the container.mariadb-import
- will execute/usr/bin/mariadb-import
within the container.mariadb-install-db
- will execute/usr/bin/mariadb-install-db
within the container.mariadb-optimize
- will execute/usr/bin/mariadb-optimize
within the container.mariadb-plugin
- will execute/usr/bin/mariadb-plugin
within the container.mariadb-repair
- will execute/usr/bin/mariadb-repair
within the container.mariadb-secure-installation
- will execute/usr/bin/mariadb-secure-installation
within the container.mariadb-service-convert
- will execute/usr/bin/mariadb-service-convert
within the container.mariadb-setpermission
- will execute/usr/bin/mariadb-setpermission
within the container.mariadb-show
- will execute/usr/bin/mariadb-show
within the container.mariadb-slap
- will execute/usr/bin/mariadb-slap
within the container.mariadb-tzinfo-to-sql
- will execute/usr/bin/mariadb-tzinfo-to-sql
within the container.mariadb-upgrade
- will execute/usr/bin/mariadb-upgrade
within the container.mariadb-waitpid
- will execute/usr/bin/mariadb-waitpid
within the container.mariadbd-multi
- will execute/usr/bin/mariadbd-multi
within the container.mariadbd-safe
- will execute/usr/bin/mariadbd-safe
within the container.mariadbd-safe-helper
- will execute/usr/bin/mariadbd-safe-helper
within the container.
ssh - All Gearbox containers have a running SSH daemon. So you can connect remotely. To show what ports are exported to the host, use the following command.
./launch list mariadb
Simply clone this repository to your local machine
git clone https://github.com/gearboxworks/docker-mariadb.git
make build
- Build Docker images. Build all versions from the base directory or specific versions from each directory.
make list
- List already built Docker images. List all versions from the base directory or specific versions from each directory.
make clean
- Remove already built Docker images. Remove all versions from the base directory or specific versions from each directory.
make push
- Push already built Docker images to Docker Hub, (only for Gearbox admins). Push all versions from the base directory or specific versions from each directory.
You can either build your container as above, or use it from DockerHub with these commands:
make start
- Spin up a Docker container with the correct runtime configs.
make stop
- Stop a Docker container.
make run
- Run a Docker container in the foreground, (all STDOUT and STDERR will go to console). The Container be removed on termination.
make shell
- Run a shell, (/bin/bash), within a Docker container.
make rm
- Remove the Docker container.
make test
- Will issue a stop
, rm
, clean
, build
, create
and start
on a Docker container.
A simple docker pull gearbox/mariadb
will pull down the latest version.
start - Spin up a Docker container with the correct runtime configs.
docker run -d --name mariadb-latest --restart unless-stopped --network gearboxnet gearbox/mariadb:latest
stop - Stop a Docker container.
docker stop mariadb-latest
rm - Remove the Docker container.
docker container rm mariadb-latest
run - Run a Docker container in the foreground, (all STDOUT and STDERR will go to console). The Container be removed on termination.
docker run --rm --name mariadb-latest --network gearboxnet gearbox/mariadb:latest
shell - Run a shell, (/bin/bash), within a Docker container.
docker run --rm --name mariadb-latest -i -t --network gearboxnet gearbox/mariadb:latest /bin/bash
ssh - All Gearbox containers have a running SSH daemon. So you can connect remotely.
Either use launch
above or discover the port and SSH directly.
SSH_PORT="$(docker port mariadb-latest 22/tcp | sed 's/0.0.0.0://')"
ssh -p ${SSH_PORT} -o StrictHostKeyChecking=no gearbox@localhost