Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Streamline #25

Merged
merged 1 commit into from
Dec 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
github: [cytopia]
patreon: devilbox
260 changes: 205 additions & 55 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,96 +1,137 @@
# MySQL Docker images


[![Tag](https://img.shields.io/github/tag/devilbox/docker-mysql.svg)](https://github.com/devilbox/docker-mysql/releases)
[![](https://img.shields.io/badge/github-devilbox%2Fdocker--mysql-red.svg)](https://github.com/devilbox/docker-mysql "github.com/devilbox/docker-mysql")
[![lint](https://github.com/devilbox/docker-mysql/workflows/lint/badge.svg)](https://github.com/devilbox/docker-mysql/actions?query=workflow%3Alint)
[![build](https://github.com/devilbox/docker-mysql/workflows/build/badge.svg)](https://github.com/devilbox/docker-mysql/actions?query=workflow%3Abuild)
[![nightly](https://github.com/devilbox/docker-mysql/workflows/nightly/badge.svg)](https://github.com/devilbox/docker-mysql/actions?query=workflow%3Anightly)
[![License](https://img.shields.io/badge/license-MIT-%233DA639.svg)](https://opensource.org/licenses/MIT)

[![Tag](https://img.shields.io/github/tag/devilbox/docker-mysql.svg)](https://github.com/devilbox/docker-mysql/releases)
[![Gitter](https://badges.gitter.im/devilbox/Lobby.svg)](https://gitter.im/devilbox/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Discourse](https://img.shields.io/discourse/https/devilbox.discourse.group/status.svg?colorB=%234CB697)](https://devilbox.discourse.group)
[![type](https://img.shields.io/badge/type-Docker-blue.svg)](https://hub.docker.com/r/devilbox/mysql)
[![License](https://img.shields.io/badge/license-MIT-%233DA639.svg)](https://opensource.org/licenses/MIT)

**Available Architectures:** `amd64`, `arm64`

The purpose of this project is to simply re-tag the official Docker images for
[![](https://img.shields.io/docker/pulls/devilbox/mysql.svg)](https://hub.docker.com/r/devilbox/mysql)

The purpose of this project is to streamline and re-tag the official Docker images for
[MySQL](https://hub.docker.com/_/mysql), [MariaDB](https://hub.docker.com/_/mariadb) and
[Percona](https://hub.docker.com/_/percona) in order to use them for the
**[Devilbox](https://github.com/cytopia/devilbox)** project.

| Docker Hub | Upstream Project |
|------------|------------------|
| <a href="https://hub.docker.com/r/devilbox/mysql"><img height="82px" src="http://dockeri.co/image/devilbox/mysql" /></a> | <a href="https://github.com/cytopia/devilbox" ><img height="82px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/01/png/banner_256_trans.png" /></a> |
> ##### 🐱 GitHub: [devilbox/docker-mysql](https://github.com/devilbox/docker-mysql)

| Current Project | Reference Implementation |
|:----------------:|:------------------------:|
| <a title="Docker MySQL" href="https://github.com/devilbox/docker-mysql" ><img height="82px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/04/png/banner_256_trans.png" /></a> | <a title="Devilbox" href="https://github.com/cytopia/devilbox" ><img height="82px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/01/png/banner_256_trans.png" /></a> |
| Streamlined [MySQL](https://github.com/devilbox/docker-mysql) images | The [Devilbox](https://github.com/cytopia/devilbox) |

## Documentation

In case you seek help, go and visit the community pages.

<table width="100%" style="width:100%; display:table;">
<thead>
<tr>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.readthedocs.io">Documentation</a></h3></th>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://gitter.im/devilbox/Lobby">Chat</a></h3></th>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.discourse.group">Forum</a></h3></th>
</tr>
</thead>
<tbody style="vertical-align: middle; text-align: center;">
<tr>
<td>
<a target="_blank" href="https://devilbox.readthedocs.io">
<img title="Documentation" name="Documentation" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/readthedocs.png" />
</a>
</td>
<td>
<a target="_blank" href="https://gitter.im/devilbox/Lobby">
<img title="Chat on Gitter" name="Chat on Gitter" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/gitter.png" />
</a>
</td>
<td>
<a target="_blank" href="https://devilbox.discourse.group">
<img title="Devilbox Forums" name="Forum" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/discourse.png" />
</a>
</td>
</tr>
<tr>
<td><a target="_blank" href="https://devilbox.readthedocs.io">devilbox.readthedocs.io</a></td>
<td><a target="_blank" href="https://gitter.im/devilbox/Lobby">gitter.im/devilbox</a></td>
<td><a target="_blank" href="https://devilbox.discourse.group">devilbox.discourse.group</a></td>
</tr>
</tbody>
</table>
## 🐋 Available Docker tags

[![](https://img.shields.io/docker/pulls/devilbox/mysql.svg)](https://hub.docker.com/r/devilbox/mysql)

[`mysql-5.5`][tag_mysql-5.5]
[`mysql-5.6`][tag_mysql-5.6]
[`mysql-5.7`][tag_mysql-5.7]
[`mysql-8.0`][tag_mysql-8.0]

## Additional features
[`mariadb-5.5`][tag_mariadb-5.5]
[`mariadb-10.0`][tag_mariadb-10.0]
[`mariadb-10.1`][tag_mariadb-10.1]
[`mariadb-10.2`][tag_mariadb-10.2]
[`mariadb-10.3`][tag_mariadb-10.3]
[`mariadb-10.4`][tag_mariadb-10.4]
[`mariadb-10.5`][tag_mariadb-10.5]
[`mariadb-10.6`][tag_mariadb-10.6]
[`mariadb-10.7`][tag_mariadb-10.7]
[`mariadb-10.8`][tag_mariadb-10.8]
[`mariadb-10.9`][tag_mariadb-10.9]
[`mariadb-10.10`][tag_mariadb-10.10]

[`percona-5.5`][tag_percona-5.5]
[`percona-5.6`][tag_percona-5.6]
[`percona-5.7`][tag_percona-5.7]
[`percona-8.0`][tag_percona-8.0]


[tag_mysql-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.5
[tag_mysql-5.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.6
[tag_mysql-5.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.7
[tag_mysql-8.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-8.0

[tag_percona-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.5
[tag_percona-5.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.6
[tag_percona-5.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.7
[tag_percona-8.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-8.0

[tag_mariadb-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-5.5
[tag_mariadb-10.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.0
[tag_mariadb-10.1]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.1
[tag_mariadb-10.2]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.2
[tag_mariadb-10.3]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.3
[tag_mariadb-10.4]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.4
[tag_mariadb-10.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.5
[tag_mariadb-10.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.6
[tag_mariadb-10.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.7
[tag_mariadb-10.8]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.8
[tag_mariadb-10.9]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.9
[tag_mariadb-10.10]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.10

```bash
docker pull devilbox/mysql:<docker-tag>
```


## ✰ Additional features

The provided images are purely based on their official counterparts, however they have also been
slightly customized/enhanced additions added:

* An additional \*.cnf config directory is provided: `/etc/mysql/docker-default.d/`. This is necessary as the default config directory already contains \*.cnf files and you might want to keep them and still be able to additionally provide custom files
* MySQL 8.0 and Percona 8.0 by default use a new authentication mechanism which is not (yet) understood by PHP's mysqli module. For those two images, the old authentication type has been re-enabled, so you can still use it with your current PHP code.
* MySQL 8.0 and Percona 8.0 by default use a new authentication mechanism which is not (yet) understood by PHP's `mysqli` extension. For those two images, the old authentication mechanism **[`mysql_native_password`](https://dev.mysql.com/doc/refman/8.0/en/native-pluggable-authentication.html)** has been re-enabled, so you can still use it with your current PHP code.


## ∑ Environment Variables

Same as official Docker images:

* [MySQL](https://hub.docker.com/_/mysql)
* [MariaDB](https://hub.docker.com/_/mariadb)
* [Percona](https://hub.docker.com/_/percona)


## Defaults
## 🖧 Exposed Ports

### Docker Image
MySQL listening port `3306`

| What | Value |
|------------|-----------------------------|
| ENTRYPOINT | `["/docker-entrypoint.sh"]` |
| CMD | `["mysqld"]` |

### Mountpoints
## 📂 Volumes

The mountpoints for configuration files have been streamlined for all images in this repository.

| Path | Description |
|--------------------------------|----------------------------------------|
| `/etc/mysql/conf.d` | Default primary config mountpoint |
| `/etc/mysql/docker-default.d/` | Additional secondary config mountpoint |


## Docker Tags
## ∢ Build

Build MySQL 5.5 Docker image locally
```bash
make build NAME=mysql VERSION=5.5
```
Build MariaDB 10.10 Docker image for `arm64` locally
```bash
make build NAME=mariadb VERSION=10.10 ARCH=linux/arm64
```


## 🛈 Retagging of official images

For retagged information see below.
The below listed tables show how the official images have been retagged.

#### MySQL

Expand Down Expand Up @@ -137,7 +178,116 @@ For retagged information see below.
| `percona:8.0` | `devilbox/mysql:percona-8.0` | `amd64` |


## License
## 🖤 Sister Projects

Show some love for the following sister projects.

<table>
<tr>
<th>🖤 Project</th>
<th>🐱 GitHub</th>
<th>🐋 DockerHub</th>
</tr>
<tr>
<td><a title="Devilbox" href="https://github.com/cytopia/devilbox" ><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/01/png/banner_256_trans.png" /></a></td>
<td><a href="https://github.com/cytopia/devilbox"><code>Devilbox</code></a></td>
<td></td>
</tr>
<tr>
<td><a title="Docker PHP-FMP" href="https://github.com/devilbox/docker-php-fpm" ><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/02/png/banner_256_trans.png" /></a></td>
<td><a href="https://github.com/devilbox/docker-php-fpm"><code>docker-php-fpm</code></a></td>
<td><a href="https://hub.docker.com/r/devilbox/php-fpm"><code>devilbox/php-fpm</code></a></td>
</tr>
<tr>
<td><a title="Docker PHP-FMP-Community" href="https://github.com/devilbox/docker-php-fpm-community" ><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/03/png/banner_256_trans.png" /></a></td>
<td><a href="https://github.com/devilbox/docker-php-fpm-community"><code>docker-php-fpm-community</code></a></td>
<td><a href="https://hub.docker.com/r/devilbox/php-fpm-community"><code>devilbox/php-fpm-community</code></a></td>
</tr>
<tr>
<td><a title="Docker MySQL" href="https://github.com/devilbox/docker-mysql" ><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/04/png/banner_256_trans.png" /></a></td>
<td><a href="https://github.com/devilbox/docker-mysql"><code>docker-mysql</code></a></td>
<td><a href="https://hub.docker.com/r/devilbox/mysql"><code>devilbox/mysql</code></a></td>
</tr>
<tr>
<td><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/05/png/banner_256_trans.png" /></td>
<td>
<a href="https://github.com/devilbox/docker-apache-2.2"><code>docker-apache-2.2</code></a><br/>
<a href="https://github.com/devilbox/docker-apache-2.4"><code>docker-apache-2.4</code></a><br/>
<a href="https://github.com/devilbox/docker-nginx-stable"><code>docker-nginx-stable</code></a><br/>
<a href="https://github.com/devilbox/docker-nginx-mainline"><code>docker-nginx-mainline</code></a>
</td>
<td>
<a href="https://hub.docker.com/r/devilbox/apache-2.2"><code>devilbox/apache-2.2</code></a><br/>
<a href="https://hub.docker.com/r/devilbox/apache-2.4"><code>devilbox/apache-2.4</code></a><br/>
<a href="https://hub.docker.com/r/devilbox/nginx-stable"><code>devilbox/nginx-stable</code></a><br/>
<a href="https://hub.docker.com/r/devilbox/nginx-mainline"><code>devilbox/nginx-mainline</code></a>
</td>
</tr>
</table>


## 👫 Community

In case you seek help, go and visit the community pages.

<table width="100%" style="width:100%; display:table;">
<thead>
<tr>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.readthedocs.io">📘 Documentation</a></h3></th>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://gitter.im/devilbox/Lobby">🗪 Chat</a></h3></th>
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.discourse.group">🗫 Forum</a></h3></th>
</tr>
</thead>
<tbody style="vertical-align: middle; text-align: center;">
<tr>
<td>
<a target="_blank" href="https://devilbox.readthedocs.io">
<img title="Documentation" name="Documentation" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/readthedocs.png" />
</a>
</td>
<td>
<a target="_blank" href="https://gitter.im/devilbox/Lobby">
<img title="Chat on Gitter" name="Chat on Gitter" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/gitter.png" />
</a>
</td>
<td>
<a target="_blank" href="https://devilbox.discourse.group">
<img title="Devilbox Forums" name="Forum" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/discourse.png" />
</a>
</td>
</tr>
<tr>
<td><a target="_blank" href="https://devilbox.readthedocs.io">devilbox.readthedocs.io</a></td>
<td><a target="_blank" href="https://gitter.im/devilbox/Lobby">gitter.im/devilbox</a></td>
<td><a target="_blank" href="https://devilbox.discourse.group">devilbox.discourse.group</a></td>
</tr>
</tbody>
</table>


## 🧘 Maintainer

**[@cytopia](https://github.com/cytopia)**

I try to keep with literally **over 100 projects** besides a full-time job.
If my work is making your life easier, consider contributing. 🖤

* [GitHub Sponsorship](https://github.com/sponsors/cytopia)
* [Patreon](https://www.patreon.com/devilbox)
* [Open Collective](https://opencollective.com/devilbox)

**Findme:**
**🐱** [cytopia](https://github.com/cytopia) / [devilbox](https://github.com/devilbox) |
**🐋** [cytopia](https://hub.docker.com/r/cytopia/) / [devilbox](https://hub.docker.com/r/devilbox/) |
**🐦** [everythingcli](https://twitter.com/everythingcli) / [devilbox](https://twitter.com/devilbox) |
**📖** [everythingcli.org](http://www.everythingcli.org/)

**Contrib:** PyPI: [cytopia](https://pypi.org/user/cytopia/) **·**
Terraform: [cytopia](https://registry.terraform.io/namespaces/cytopia) **·**
Ansible: [cytopia](https://galaxy.ansible.com/cytopia)


## 🗎 License

**[MIT License](LICENSE)**

Expand Down