-
Notifications
You must be signed in to change notification settings - Fork 13
/
README.md.template
115 lines (72 loc) · 5.29 KB
/
README.md.template
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
---
[](https://github.com/Dockershelf/dockershelf/releases) [](https://github.com/Dockershelf/dockershelf/actions/workflows/schedule-master.yml) [](https://discord.gg/4Wc7xphH5e) [](https://cla-assistant.io/Dockershelf/dockershelf)
Current version: 3.3.1
*Dockershelf* is a repository that serves as a collector for docker recipes that are universal, efficient and slim. We keep adding "shelves", which are holders for the different versions of a popular language or application. Images are updated, tested and published *weekly* via a [Github Actions workflow](https://github.com/Dockershelf/dockershelf/actions). All images are available on [Docker Hub](https://hub.docker.com/u/dockershelf).
Excepting debian and latex images, all images have an stable/unstable version. Stable images are based on debian stable, which are ideal for production applications because packages are not updated to minor or major versions but still recieve security updates. Unstable images are based on debian sid, which are designed for development stages because packages are constantly beaing updated to its latest version. Latex images are only based on debian stable.
Images are built for `amd64` and `arm64` architectures, which cover most of the devices in the market. If you need an image for a different architecture, please [open an issue](https://github.com/Dockershelf/dockershelf/issues/new).
The list of available images is shown below.
|Image type |Tags |
|------------|------|
%%DEBIAN_TABLE_TAGS%%
%%PYTHON_TABLE_TAGS%%
%%NODE_TABLE_TAGS%%
%%GO_TABLE_TAGS%%
%%LATEX_TABLE_TAGS%%
## How to use
You can pull one of the images from Docker Hub and run it in your machine.
```
docker pull <image>
docker run -it <image> bash
```
<sup><code><image></code> is the desired image to download, for example <code>dockershelf/python:3.11</code>.</sup>
or you can use it as a base image in your Dockerfile.
```dockerfile
FROM dockershelf/debian:bookworm
RUN apt-get update \
&& apt-get install -y mysql-client
ENTRYPOINT ["mysql"]
```
## How to build locally
Clone this repository to your machine.
```
git clone https://github.com/Dockershelf/dockershelf
```
Run the build script in the root folder of your local copy. Remember to have docker installed and make sure your user has proper privileges to execute `docker build`.
```
bash build-image.sh <image>
```
<sup><code><image></code> is the desired image to build, for example <code>dockershelf/node:16-bookworm</code>.</sup>
## Shelves
### Debian
These images are similar to the official ones, but with some opinionated configurations. Check out [debian/README.md](https://github.com/Dockershelf/dockershelf/blob/master/debian/README.md) for more details.
|Image |Dockerfile |Pulls |Size |
|-------|------------|--------|------|
%%DEBIAN_TABLE%%
### Python
These are debian stable/unstable images with python versions installed from the [deadsnakes ppa](https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa). Check out [python/README.md](https://github.com/Dockershelf/dockershelf/blob/master/python/README.md) for more details.
|Image |Dockerfile |Pulls |Size |
|-------|------------|--------|------|
%%PYTHON_TABLE%%
### Node
These are debian stable/unstable images with node versions built using the [nodesource installation script](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions). Check out [node/README.md](https://github.com/Dockershelf/dockershelf/blob/master/node/README.md) for more details.
|Image |Dockerfile |Pulls |Size |
|-------|------------|--------|------|
%%NODE_TABLE%%
### Go
These are debian stable/unstable images with go version downloaded directly from the [official website](https://go.dev/dl/). Check out [node/README.md](https://github.com/Dockershelf/dockershelf/blob/master/go/README.md) for more details.
|Image |Dockerfile |Pulls |Size |
|-------|------------|--------|------|
%%GO_TABLE%%
### Latex
These are debian stable images that come with a set of latex (basic or full) packages installed. Check out [latex/README.md](https://github.com/Dockershelf/dockershelf/blob/master/latex/README.md) for more details.
|Image |Dockerfile |Pulls |Size |
|-------|------------|--------|------|
%%LATEX_TABLE%%
## Made with 💖 and 🍔
> Web [luisalejandro.org](http://luisalejandro.org/) · GitHub [@LuisAlejandro](https://github.com/LuisAlejandro) · Twitter [@LuisAlejandro](https://twitter.com/LuisAlejandro)