|
|
@@ -16,21 +16,24 @@ WARNING:
|
|
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`2.4.2-stretch`, `2.4-stretch`, `2-stretch`, `stretch` (*2.4/stretch/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/stretch/Dockerfile)
|
|
|
-- [`2.4.2-slim-stretch`, `2.4-slim-stretch`, `2-slim-stretch`, `slim-stretch` (*2.4/stretch/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/stretch/slim/Dockerfile)
|
|
|
-- [`2.4.2-jessie`, `2.4-jessie`, `2-jessie`, `jessie`, `2.4.2`, `2.4`, `2`, `latest` (*2.4/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/jessie/Dockerfile)
|
|
|
-- [`2.4.2-slim-jessie`, `2.4-slim-jessie`, `2-slim-jessie`, `slim-jessie`, `2.4.2-slim`, `2.4-slim`, `2-slim`, `slim` (*2.4/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/jessie/slim/Dockerfile)
|
|
|
+- [`2.5.0-preview1-stretch`, `2.5-rc-stretch`, `rc-stretch`, `2.5.0-preview1`, `2.5-rc`, `rc` (*2.5-rc/stretch/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.5-rc/stretch/Dockerfile)
|
|
|
+- [`2.5.0-preview1-slim-stretch`, `2.5-rc-slim-stretch`, `rc-slim-stretch`, `2.5.0-preview1-slim`, `2.5-rc-slim`, `rc-slim` (*2.5-rc/stretch/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.5-rc/stretch/slim/Dockerfile)
|
|
|
+- [`2.5.0-preview1-alpine3.6`, `2.5-rc-alpine3.6`, `rc-alpine3.6`, `2.5.0-preview1-alpine`, `2.5-rc-alpine`, `rc-alpine` (*2.5-rc/alpine3.6/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.5-rc/alpine3.6/Dockerfile)
|
|
|
+- [`2.4.2-stretch`, `2.4-stretch`, `2-stretch`, `stretch` (*2.4/stretch/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/stretch/Dockerfile)
|
|
|
+- [`2.4.2-slim-stretch`, `2.4-slim-stretch`, `2-slim-stretch`, `slim-stretch` (*2.4/stretch/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/stretch/slim/Dockerfile)
|
|
|
+- [`2.4.2-jessie`, `2.4-jessie`, `2-jessie`, `jessie`, `2.4.2`, `2.4`, `2`, `latest` (*2.4/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/jessie/Dockerfile)
|
|
|
+- [`2.4.2-slim-jessie`, `2.4-slim-jessie`, `2-slim-jessie`, `slim-jessie`, `2.4.2-slim`, `2.4-slim`, `2-slim`, `slim` (*2.4/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/jessie/slim/Dockerfile)
|
|
|
- [`2.4.2-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.2-alpine3.6`, `2.4-alpine3.6`, `2-alpine3.6`, `alpine3.6` (*2.4/alpine3.6/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/alpine3.6/Dockerfile)
|
|
|
-- [`2.4.2-alpine3.4`, `2.4-alpine3.4`, `2-alpine3.4`, `alpine3.4`, `2.4.2-alpine`, `2.4-alpine`, `2-alpine`, `alpine` (*2.4/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/9390129c08cc19668fc482edfd7d7c5a890a80eb/2.4/alpine3.4/Dockerfile)
|
|
|
-- [`2.3.5-jessie`, `2.3-jessie`, `2.3.5`, `2.3` (*2.3/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/104e3aeadd3c2ea1597be3cd407551faab802ecb/2.3/jessie/Dockerfile)
|
|
|
-- [`2.3.5-slim-jessie`, `2.3-slim-jessie`, `2.3.5-slim`, `2.3-slim` (*2.3/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/104e3aeadd3c2ea1597be3cd407551faab802ecb/2.3/jessie/slim/Dockerfile)
|
|
|
+- [`2.4.2-alpine3.6`, `2.4-alpine3.6`, `2-alpine3.6`, `alpine3.6` (*2.4/alpine3.6/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/alpine3.6/Dockerfile)
|
|
|
+- [`2.4.2-alpine3.4`, `2.4-alpine3.4`, `2-alpine3.4`, `alpine3.4`, `2.4.2-alpine`, `2.4-alpine`, `2-alpine`, `alpine` (*2.4/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.4/alpine3.4/Dockerfile)
|
|
|
+- [`2.3.5-jessie`, `2.3-jessie`, `2.3.5`, `2.3` (*2.3/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.3/jessie/Dockerfile)
|
|
|
+- [`2.3.5-slim-jessie`, `2.3-slim-jessie`, `2.3.5-slim`, `2.3-slim` (*2.3/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.3/jessie/slim/Dockerfile)
|
|
|
- [`2.3.5-onbuild`, `2.3-onbuild` (*2.3/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.3/jessie/onbuild/Dockerfile)
|
|
|
-- [`2.3.5-alpine3.4`, `2.3-alpine3.4`, `2.3.5-alpine`, `2.3-alpine` (*2.3/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/104e3aeadd3c2ea1597be3cd407551faab802ecb/2.3/alpine3.4/Dockerfile)
|
|
|
-- [`2.2.8-jessie`, `2.2-jessie`, `2.2.8`, `2.2` (*2.2/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/59abfdf2c6aaeab159aeb46c762c178e76900c0f/2.2/jessie/Dockerfile)
|
|
|
-- [`2.2.8-slim-jessie`, `2.2-slim-jessie`, `2.2.8-slim`, `2.2-slim` (*2.2/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/59abfdf2c6aaeab159aeb46c762c178e76900c0f/2.2/jessie/slim/Dockerfile)
|
|
|
+- [`2.3.5-alpine3.4`, `2.3-alpine3.4`, `2.3.5-alpine`, `2.3-alpine` (*2.3/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.3/alpine3.4/Dockerfile)
|
|
|
+- [`2.2.8-jessie`, `2.2-jessie`, `2.2.8`, `2.2` (*2.2/jessie/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.2/jessie/Dockerfile)
|
|
|
+- [`2.2.8-slim-jessie`, `2.2-slim-jessie`, `2.2.8-slim`, `2.2-slim` (*2.2/jessie/slim/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.2/jessie/slim/Dockerfile)
|
|
|
- [`2.2.8-onbuild`, `2.2-onbuild` (*2.2/jessie/onbuild/Dockerfile*)](https://github.com/docker-library/ruby/blob/a6918175fd506b46bf2d8f899f4faa40e72296fb/2.2/jessie/onbuild/Dockerfile)
|
|
|
-- [`2.2.8-alpine3.4`, `2.2-alpine3.4`, `2.2.8-alpine`, `2.2-alpine` (*2.2/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/59abfdf2c6aaeab159aeb46c762c178e76900c0f/2.2/alpine3.4/Dockerfile)
|
|
|
+- [`2.2.8-alpine3.4`, `2.2-alpine3.4`, `2.2.8-alpine`, `2.2-alpine` (*2.2/alpine3.4/Dockerfile*)](https://github.com/docker-library/ruby/blob/6959194971f4f84e9bef2976ae6b8a469fa58dae/2.2/alpine3.4/Dockerfile)
|
|
|
|
|
|
# Quick reference
|
|
|
|
|
|
@@ -121,14 +124,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: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).
|
|
|
-
|
|
|
-While the `onbuild` variant is really useful for "getting off the ground running" (zero to Dockerized in a short period of time), it's not recommended for long-term usage within a project due to the lack of control over *when* the `ONBUILD` triggers fire (see also [`docker/docker#5714`](https://github.com/docker/docker/issues/5714), [`docker/docker#8240`](https://github.com/docker/docker/issues/8240), [`docker/docker#11917`](https://github.com/docker/docker/issues/11917)).
|
|
|
-
|
|
|
-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.
|
|
|
@@ -137,6 +132,14 @@ This variant is highly recommended when final image size being as small as possi
|
|
|
|
|
|
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).
|
|
|
+
|
|
|
+While the `onbuild` variant is really useful for "getting off the ground running" (zero to Dockerized in a short period of time), it's not recommended for long-term usage within a project due to the lack of control over *when* the `ONBUILD` triggers fire (see also [`docker/docker#5714`](https://github.com/docker/docker/issues/5714), [`docker/docker#8240`](https://github.com/docker/docker/issues/8240), [`docker/docker#11917`](https://github.com/docker/docker/issues/11917)).
|
|
|
+
|
|
|
+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).
|
|
|
+
|
|
|
# License
|
|
|
|
|
|
View [license information](https://www.ruby-lang.org/en/about/license.txt) for the software contained in this image.
|
Docker Library Bot