|
|
@@ -16,18 +16,18 @@ WARNING:
|
|
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`2.2.7`, `2.2` (*2.2/Dockerfile*)](https://github.com/docker-library/ruby/blob/ff427d10f40d1e19d2581346610ef47a83c4b8dc/2.2/Dockerfile)
|
|
|
-- [`2.2.7-slim`, `2.2-slim` (*2.2/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/ff427d10f40d1e19d2581346610ef47a83c4b8dc/2.2/slim/Dockerfile)
|
|
|
-- [`2.2.7-alpine`, `2.2-alpine` (*2.2/alpine/Dockerfile*)](https://github.com/docker-library/ruby/blob/ff427d10f40d1e19d2581346610ef47a83c4b8dc/2.2/alpine/Dockerfile)
|
|
|
-- [`2.2.7-onbuild`, `2.2-onbuild` (*2.2/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/5d04363db6f7ae316ef7056063f020557db828e1/2.2/onbuild/Dockerfile)
|
|
|
-- [`2.3.4`, `2.3` (*2.3/Dockerfile*)](https://github.com/docker-library/ruby/blob/00ade5b52c4d0a3400cba91e3972cf950b6854f7/2.3/Dockerfile)
|
|
|
-- [`2.3.4-slim`, `2.3-slim` (*2.3/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/00ade5b52c4d0a3400cba91e3972cf950b6854f7/2.3/slim/Dockerfile)
|
|
|
-- [`2.3.4-alpine`, `2.3-alpine` (*2.3/alpine/Dockerfile*)](https://github.com/docker-library/ruby/blob/00ade5b52c4d0a3400cba91e3972cf950b6854f7/2.3/alpine/Dockerfile)
|
|
|
-- [`2.3.4-onbuild`, `2.3-onbuild` (*2.3/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/1b08f346713a1293c2a9238e470e086126e2e28f/2.3/onbuild/Dockerfile)
|
|
|
-- [`2.4.1`, `2.4`, `2`, `latest` (*2.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/1824c6ec7555c92c61d335136da9a6fb6665de2a/2.4/Dockerfile)
|
|
|
-- [`2.4.1-slim`, `2.4-slim`, `2-slim`, `slim` (*2.4/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/1824c6ec7555c92c61d335136da9a6fb6665de2a/2.4/slim/Dockerfile)
|
|
|
-- [`2.4.1-alpine`, `2.4-alpine`, `2-alpine`, `alpine` (*2.4/alpine/Dockerfile*)](https://github.com/docker-library/ruby/blob/1824c6ec7555c92c61d335136da9a6fb6665de2a/2.4/alpine/Dockerfile)
|
|
|
-- [`2.4.1-onbuild`, `2.4-onbuild`, `2-onbuild`, `onbuild` (*2.4/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/752c5f7cf44870ceae77134b346d20093053c370/2.4/onbuild/Dockerfile)
|
|
|
+- [`2.4.1-jessie`, `2.4-jessie`, `2-jessie`, `jessie`, `2.4.1`, `2.4`, `2`, `latest` (*2.4/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.4/jessie/Dockerfile)
|
|
|
+- [`2.4.1-slim-jessie`, `2.4-slim-jessie`, `2-slim-jessie`, `slim-jessie`, `2.4.1-slim`, `2.4-slim`, `2-slim`, `slim` (*2.4/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.4/jessie/slim/Dockerfile)
|
|
|
+- [`2.4.1-onbuild`, `2.4-onbuild`, `2-onbuild`, `onbuild` (*2.4/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.4/jessie/onbuild/Dockerfile)
|
|
|
+- [`2.4.1-alpine3.4`, `2.4-alpine3.4`, `2-alpine3.4`, `alpine3.4`, `2.4.1-alpine`, `2.4-alpine`, `2-alpine`, `alpine` (*2.4/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.4/alpine3.4/Dockerfile)
|
|
|
+- [`2.3.4-jessie`, `2.3-jessie`, `2.3.4`, `2.3` (*2.3/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.3/jessie/Dockerfile)
|
|
|
+- [`2.3.4-slim-jessie`, `2.3-slim-jessie`, `2.3.4-slim`, `2.3-slim` (*2.3/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.3/jessie/slim/Dockerfile)
|
|
|
+- [`2.3.4-onbuild`, `2.3-onbuild` (*2.3/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.3/jessie/onbuild/Dockerfile)
|
|
|
+- [`2.3.4-alpine3.4`, `2.3-alpine3.4`, `2.3.4-alpine`, `2.3-alpine` (*2.3/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.3/alpine3.4/Dockerfile)
|
|
|
+- [`2.2.7-jessie`, `2.2-jessie`, `2.2.7`, `2.2` (*2.2/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.2/jessie/Dockerfile)
|
|
|
+- [`2.2.7-slim-jessie`, `2.2-slim-jessie`, `2.2.7-slim`, `2.2-slim` (*2.2/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.2/jessie/slim/Dockerfile)
|
|
|
+- [`2.2.7-onbuild`, `2.2-onbuild` (*2.2/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.2/jessie/onbuild/Dockerfile)
|
|
|
+- [`2.2.7-alpine3.4`, `2.2-alpine3.4`, `2.2.7-alpine`, `2.2-alpine` (*2.2/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.2/alpine3.4/Dockerfile)
|
|
|
|
|
|
# Quick reference
|
|
|
|
|
|
@@ -115,14 +115,6 @@ This is the defacto image. If you are unsure about what your needs are, you prob
|
|
|
|
|
|
This image does not contain the common packages contained in the default tag and only contains the minimal packages needed to run `ruby`. Unless you are working in an environment where *only* the `ruby` image will be deployed and you have space constraints, we highly recommend using the default image of this repository.
|
|
|
|
|
|
-## `ruby:alpine`
|
|
|
-
|
|
|
-This image is based on the popular [Alpine Linux project](http://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.
|
|
|
-
|
|
|
-This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc](http://www.musl-libc.org) instead of [glibc and friends](http://www.etalabs.net/compare_libcs.html), so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread](https://news.ycombinator.com/item?id=10782897) for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.
|
|
|
-
|
|
|
-To minimize image size, it's uncommon for additional related tools (such as `git` or `bash`) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the [`alpine` image description](https://hub.docker.com/_/alpine/) for examples of how to install packages if you are unfamiliar).
|
|
|
-
|
|
|
## `ruby:onbuild`
|
|
|
|
|
|
The `ONBUILD` image variants are deprecated, and their usage is discouraged. For more details, see [docker-library/official-images#2076](https://github.com/docker-library/official-images/issues/2076).
|
|
|
@@ -131,6 +123,14 @@ While the `onbuild` variant is really useful for "getting off the ground running
|
|
|
|
|
|
Once you've got a handle on how your project functions within Docker, you'll probably want to adjust your `Dockerfile` to inherit from a non-`onbuild` variant and copy the commands from the `onbuild` variant `Dockerfile` (moving the `ONBUILD` lines to the end and removing the `ONBUILD` keywords) into your own file so that you have tighter control over them and more transparency for yourself and others looking at your `Dockerfile` as to what it does. This also makes it easier to add additional requirements as time goes on (such as installing more packages before performing the previously-`ONBUILD` steps).
|
|
|
|
|
|
+## `ruby:alpine`
|
|
|
+
|
|
|
+This image is based on the popular [Alpine Linux project](http://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.
|
|
|
+
|
|
|
+This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc](http://www.musl-libc.org) instead of [glibc and friends](http://www.etalabs.net/compare_libcs.html), so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread](https://news.ycombinator.com/item?id=10782897) for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.
|
|
|
+
|
|
|
+To minimize image size, it's uncommon for additional related tools (such as `git` or `bash`) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the [`alpine` image description](https://hub.docker.com/_/alpine/) for examples of how to install packages if you are unfamiliar).
|
|
|
+
|
|
|
# License
|
|
|
|
|
|
View [license information](https://www.ruby-lang.org/en/about/license.txt) for the software contained in this image.
|