|
|
@@ -16,10 +16,11 @@ WARNING:
|
|
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`1.37.0-stretch`, `1-stretch`, `1.37-stretch`, `stretch`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/stretch/Dockerfile)
|
|
|
-- [`1.37.0-slim-stretch`, `1-slim-stretch`, `1.37-slim-stretch`, `slim-stretch`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/stretch/slim/Dockerfile)
|
|
|
-- [`1.37.0-buster`, `1-buster`, `1.37-buster`, `buster`, `1.37.0`, `1`, `1.37`, `latest`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/buster/Dockerfile)
|
|
|
-- [`1.37.0-slim-buster`, `1-slim-buster`, `1.37-slim-buster`, `slim-buster`, `1.37.0-slim`, `1-slim`, `1.37-slim`, `slim`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/buster/slim/Dockerfile)
|
|
|
+- [`1-stretch`, `1.37-stretch`, `1.37.0-stretch`, `stretch`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/stretch/Dockerfile)
|
|
|
+- [`1-slim-stretch`, `1.37-slim-stretch`, `1.37.0-slim-stretch`, `slim-stretch`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/stretch/slim/Dockerfile)
|
|
|
+- [`1-buster`, `1.37-buster`, `1.37.0-buster`, `buster`, `1`, `1.37`, `1.37.0`, `latest`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/buster/Dockerfile)
|
|
|
+- [`1-slim-buster`, `1.37-slim-buster`, `1.37.0-slim-buster`, `slim-buster`, `1-slim`, `1.37-slim`, `1.37.0-slim`, `slim`](https://github.com/rust-lang-nursery/docker-rust/blob/d55d56e152da6cffe980baee408cd18716df4b44/1.37.0/buster/slim/Dockerfile)
|
|
|
+- [`1-alpine3.10`, `1.37-alpine3.10`, `1.37.0-alpine3.10`, `alpine3.10`, `1-alpine`, `1.37-alpine`, `1.37.0-alpine`, `alpine`](https://github.com/rust-lang-nursery/docker-rust/blob/5586e216d828d2d8ab0a784eac32cacf38eae438/1.37.0/alpine3.10/Dockerfile)
|
|
|
|
|
|
# Quick reference
|
|
|
|
|
|
@@ -104,6 +105,14 @@ Some of these tags may have names like buster or stretch in them. These are the
|
|
|
|
|
|
This image does not contain the common packages contained in the default tag and only contains the minimal packages needed to run `rust`. Unless you are working in an environment where *only* the `rust` image will be deployed and you have space constraints, we highly recommend using the default image of this repository.
|
|
|
|
|
|
+## `rust:<version>-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.rust-lang.org/en-US/legal.html) for the software contained in this image.
|
Docker Library Bot