Skip to content

Commit ec323fc

Browse files
authoredDec 10, 2022
Merge pull request #25 from devilbox/release-0.20
Streamline
2 parents 8927088 + 6670ec2 commit ec323fc

File tree

2 files changed

+208
-55
lines changed

2 files changed

+208
-55
lines changed
 

‎.github/FUNDING.yml

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
github: [cytopia]
3+
patreon: devilbox

‎README.md

+205-55
Original file line numberDiff line numberDiff line change
@@ -1,96 +1,137 @@
11
# MySQL Docker images
22

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

8-
[![Tag](https://img.shields.io/github/tag/devilbox/docker-mysql.svg)](https://github.com/devilbox/docker-mysql/releases)
910
[![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)
1011
[![Discourse](https://img.shields.io/discourse/https/devilbox.discourse.group/status.svg?colorB=%234CB697)](https://devilbox.discourse.group)
11-
[![type](https://img.shields.io/badge/type-Docker-blue.svg)](https://hub.docker.com/r/devilbox/mysql)
12-
[![License](https://img.shields.io/badge/license-MIT-%233DA639.svg)](https://opensource.org/licenses/MIT)
1312

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

16-
The purpose of this project is to simply re-tag the official Docker images for
15+
[![](https://img.shields.io/docker/pulls/devilbox/mysql.svg)](https://hub.docker.com/r/devilbox/mysql)
16+
17+
The purpose of this project is to streamline and re-tag the official Docker images for
1718
[MySQL](https://hub.docker.com/_/mysql), [MariaDB](https://hub.docker.com/_/mariadb) and
1819
[Percona](https://hub.docker.com/_/percona) in order to use them for the
1920
**[Devilbox](https://github.com/cytopia/devilbox)** project.
2021

21-
| Docker Hub | Upstream Project |
22-
|------------|------------------|
23-
| <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> |
22+
> ##### 🐱 GitHub: [devilbox/docker-mysql](https://github.com/devilbox/docker-mysql)
2423
24+
| Current Project | Reference Implementation |
25+
|:----------------:|:------------------------:|
26+
| <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> |
27+
| Streamlined [MySQL](https://github.com/devilbox/docker-mysql) images | The [Devilbox](https://github.com/cytopia/devilbox) |
2528

26-
## Documentation
2729

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

30-
<table width="100%" style="width:100%; display:table;">
31-
<thead>
32-
<tr>
33-
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.readthedocs.io">Documentation</a></h3></th>
34-
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://gitter.im/devilbox/Lobby">Chat</a></h3></th>
35-
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.discourse.group">Forum</a></h3></th>
36-
</tr>
37-
</thead>
38-
<tbody style="vertical-align: middle; text-align: center;">
39-
<tr>
40-
<td>
41-
<a target="_blank" href="https://devilbox.readthedocs.io">
42-
<img title="Documentation" name="Documentation" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/readthedocs.png" />
43-
</a>
44-
</td>
45-
<td>
46-
<a target="_blank" href="https://gitter.im/devilbox/Lobby">
47-
<img title="Chat on Gitter" name="Chat on Gitter" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/gitter.png" />
48-
</a>
49-
</td>
50-
<td>
51-
<a target="_blank" href="https://devilbox.discourse.group">
52-
<img title="Devilbox Forums" name="Forum" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/discourse.png" />
53-
</a>
54-
</td>
55-
</tr>
56-
<tr>
57-
<td><a target="_blank" href="https://devilbox.readthedocs.io">devilbox.readthedocs.io</a></td>
58-
<td><a target="_blank" href="https://gitter.im/devilbox/Lobby">gitter.im/devilbox</a></td>
59-
<td><a target="_blank" href="https://devilbox.discourse.group">devilbox.discourse.group</a></td>
60-
</tr>
61-
</tbody>
62-
</table>
31+
## 🐋 Available Docker tags
32+
33+
[![](https://img.shields.io/docker/pulls/devilbox/mysql.svg)](https://hub.docker.com/r/devilbox/mysql)
6334

35+
[`mysql-5.5`][tag_mysql-5.5]
36+
[`mysql-5.6`][tag_mysql-5.6]
37+
[`mysql-5.7`][tag_mysql-5.7]
38+
[`mysql-8.0`][tag_mysql-8.0]
6439

65-
## Additional features
40+
[`mariadb-5.5`][tag_mariadb-5.5]
41+
[`mariadb-10.0`][tag_mariadb-10.0]
42+
[`mariadb-10.1`][tag_mariadb-10.1]
43+
[`mariadb-10.2`][tag_mariadb-10.2]
44+
[`mariadb-10.3`][tag_mariadb-10.3]
45+
[`mariadb-10.4`][tag_mariadb-10.4]
46+
[`mariadb-10.5`][tag_mariadb-10.5]
47+
[`mariadb-10.6`][tag_mariadb-10.6]
48+
[`mariadb-10.7`][tag_mariadb-10.7]
49+
[`mariadb-10.8`][tag_mariadb-10.8]
50+
[`mariadb-10.9`][tag_mariadb-10.9]
51+
[`mariadb-10.10`][tag_mariadb-10.10]
52+
53+
[`percona-5.5`][tag_percona-5.5]
54+
[`percona-5.6`][tag_percona-5.6]
55+
[`percona-5.7`][tag_percona-5.7]
56+
[`percona-8.0`][tag_percona-8.0]
57+
58+
59+
[tag_mysql-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.5
60+
[tag_mysql-5.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.6
61+
[tag_mysql-5.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-5.7
62+
[tag_mysql-8.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mysql-8.0
63+
64+
[tag_percona-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.5
65+
[tag_percona-5.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.6
66+
[tag_percona-5.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-5.7
67+
[tag_percona-8.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/percona-8.0
68+
69+
[tag_mariadb-5.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-5.5
70+
[tag_mariadb-10.0]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.0
71+
[tag_mariadb-10.1]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.1
72+
[tag_mariadb-10.2]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.2
73+
[tag_mariadb-10.3]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.3
74+
[tag_mariadb-10.4]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.4
75+
[tag_mariadb-10.5]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.5
76+
[tag_mariadb-10.6]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.6
77+
[tag_mariadb-10.7]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.7
78+
[tag_mariadb-10.8]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.8
79+
[tag_mariadb-10.9]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.9
80+
[tag_mariadb-10.10]: https://github.com/devilbox/docker-mysql/blob/master/Dockerfiles/mariadb-10.10
81+
82+
```bash
83+
docker pull devilbox/mysql:<docker-tag>
84+
```
85+
86+
87+
## ✰ Additional features
6688

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

7092
* 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
71-
* 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.
93+
* 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.
94+
95+
96+
## ∑ Environment Variables
97+
98+
Same as official Docker images:
99+
100+
* [MySQL](https://hub.docker.com/_/mysql)
101+
* [MariaDB](https://hub.docker.com/_/mariadb)
102+
* [Percona](https://hub.docker.com/_/percona)
72103

73104

74-
## Defaults
105+
## 🖧 Exposed Ports
75106

76-
### Docker Image
107+
MySQL listening port `3306`
77108

78-
| What | Value |
79-
|------------|-----------------------------|
80-
| ENTRYPOINT | `["/docker-entrypoint.sh"]` |
81-
| CMD | `["mysqld"]` |
82109

83-
### Mountpoints
110+
## 📂 Volumes
111+
112+
The mountpoints for configuration files have been streamlined for all images in this repository.
84113

85114
| Path | Description |
86115
|--------------------------------|----------------------------------------|
87116
| `/etc/mysql/conf.d` | Default primary config mountpoint |
88117
| `/etc/mysql/docker-default.d/` | Additional secondary config mountpoint |
89118

90119

91-
## Docker Tags
120+
## ∢ Build
121+
122+
Build MySQL 5.5 Docker image locally
123+
```bash
124+
make build NAME=mysql VERSION=5.5
125+
```
126+
Build MariaDB 10.10 Docker image for `arm64` locally
127+
```bash
128+
make build NAME=mariadb VERSION=10.10 ARCH=linux/arm64
129+
```
130+
131+
132+
## 🛈 Retagging of official images
92133

93-
For retagged information see below.
134+
The below listed tables show how the official images have been retagged.
94135

95136
#### MySQL
96137

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

139180

140-
## License
181+
## 🖤 Sister Projects
182+
183+
Show some love for the following sister projects.
184+
185+
<table>
186+
<tr>
187+
<th>🖤 Project</th>
188+
<th>🐱 GitHub</th>
189+
<th>🐋 DockerHub</th>
190+
</tr>
191+
<tr>
192+
<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>
193+
<td><a href="https://github.com/cytopia/devilbox"><code>Devilbox</code></a></td>
194+
<td></td>
195+
</tr>
196+
<tr>
197+
<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>
198+
<td><a href="https://github.com/devilbox/docker-php-fpm"><code>docker-php-fpm</code></a></td>
199+
<td><a href="https://hub.docker.com/r/devilbox/php-fpm"><code>devilbox/php-fpm</code></a></td>
200+
</tr>
201+
<tr>
202+
<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>
203+
<td><a href="https://github.com/devilbox/docker-php-fpm-community"><code>docker-php-fpm-community</code></a></td>
204+
<td><a href="https://hub.docker.com/r/devilbox/php-fpm-community"><code>devilbox/php-fpm-community</code></a></td>
205+
</tr>
206+
<tr>
207+
<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>
208+
<td><a href="https://github.com/devilbox/docker-mysql"><code>docker-mysql</code></a></td>
209+
<td><a href="https://hub.docker.com/r/devilbox/mysql"><code>devilbox/mysql</code></a></td>
210+
</tr>
211+
<tr>
212+
<td><img width="256px" src="https://raw.githubusercontent.com/devilbox/artwork/master/submissions_banner/cytopia/05/png/banner_256_trans.png" /></td>
213+
<td>
214+
<a href="https://github.com/devilbox/docker-apache-2.2"><code>docker-apache-2.2</code></a><br/>
215+
<a href="https://github.com/devilbox/docker-apache-2.4"><code>docker-apache-2.4</code></a><br/>
216+
<a href="https://github.com/devilbox/docker-nginx-stable"><code>docker-nginx-stable</code></a><br/>
217+
<a href="https://github.com/devilbox/docker-nginx-mainline"><code>docker-nginx-mainline</code></a>
218+
</td>
219+
<td>
220+
<a href="https://hub.docker.com/r/devilbox/apache-2.2"><code>devilbox/apache-2.2</code></a><br/>
221+
<a href="https://hub.docker.com/r/devilbox/apache-2.4"><code>devilbox/apache-2.4</code></a><br/>
222+
<a href="https://hub.docker.com/r/devilbox/nginx-stable"><code>devilbox/nginx-stable</code></a><br/>
223+
<a href="https://hub.docker.com/r/devilbox/nginx-mainline"><code>devilbox/nginx-mainline</code></a>
224+
</td>
225+
</tr>
226+
</table>
227+
228+
229+
## 👫 Community
230+
231+
In case you seek help, go and visit the community pages.
232+
233+
<table width="100%" style="width:100%; display:table;">
234+
<thead>
235+
<tr>
236+
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.readthedocs.io">📘 Documentation</a></h3></th>
237+
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://gitter.im/devilbox/Lobby">🗪 Chat</a></h3></th>
238+
<th width="33%" style="width:33%;"><h3><a target="_blank" href="https://devilbox.discourse.group">🗫 Forum</a></h3></th>
239+
</tr>
240+
</thead>
241+
<tbody style="vertical-align: middle; text-align: center;">
242+
<tr>
243+
<td>
244+
<a target="_blank" href="https://devilbox.readthedocs.io">
245+
<img title="Documentation" name="Documentation" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/readthedocs.png" />
246+
</a>
247+
</td>
248+
<td>
249+
<a target="_blank" href="https://gitter.im/devilbox/Lobby">
250+
<img title="Chat on Gitter" name="Chat on Gitter" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/gitter.png" />
251+
</a>
252+
</td>
253+
<td>
254+
<a target="_blank" href="https://devilbox.discourse.group">
255+
<img title="Devilbox Forums" name="Forum" src="https://raw.githubusercontent.com/cytopia/icons/master/400x400/discourse.png" />
256+
</a>
257+
</td>
258+
</tr>
259+
<tr>
260+
<td><a target="_blank" href="https://devilbox.readthedocs.io">devilbox.readthedocs.io</a></td>
261+
<td><a target="_blank" href="https://gitter.im/devilbox/Lobby">gitter.im/devilbox</a></td>
262+
<td><a target="_blank" href="https://devilbox.discourse.group">devilbox.discourse.group</a></td>
263+
</tr>
264+
</tbody>
265+
</table>
266+
267+
268+
## 🧘 Maintainer
269+
270+
**[@cytopia](https://github.com/cytopia)**
271+
272+
I try to keep with literally **over 100 projects** besides a full-time job.
273+
If my work is making your life easier, consider contributing. 🖤
274+
275+
* [GitHub Sponsorship](https://github.com/sponsors/cytopia)
276+
* [Patreon](https://www.patreon.com/devilbox)
277+
* [Open Collective](https://opencollective.com/devilbox)
278+
279+
**Findme:**
280+
**🐱** [cytopia](https://github.com/cytopia) / [devilbox](https://github.com/devilbox) |
281+
**🐋** [cytopia](https://hub.docker.com/r/cytopia/) / [devilbox](https://hub.docker.com/r/devilbox/) |
282+
**🐦** [everythingcli](https://twitter.com/everythingcli) / [devilbox](https://twitter.com/devilbox) |
283+
**📖** [everythingcli.org](http://www.everythingcli.org/)
284+
285+
**Contrib:** PyPI: [cytopia](https://pypi.org/user/cytopia/) **·**
286+
Terraform: [cytopia](https://registry.terraform.io/namespaces/cytopia) **·**
287+
Ansible: [cytopia](https://galaxy.ansible.com/cytopia)
288+
289+
290+
## 🗎 License
141291

142292
**[MIT License](LICENSE)**
143293

0 commit comments

Comments
 (0)
Please sign in to comment.