|
|
@@ -20,26 +20,27 @@ WARNING:
|
|
|
|
|
|
## Simple Tags
|
|
|
|
|
|
-- [`2.1.0-scratch`, `2.1-scratch`, `2-scratch`, `scratch`, `2.1.0-linux`, `2.1-linux`, `2-linux`, `linux`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/scratch/amd64/Dockerfile)
|
|
|
-- [`2.1.0-windowsservercore-1809`, `2.1-windowsservercore-1809`, `2-windowsservercore-1809`, `windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercore1809/Dockerfile)
|
|
|
-- [`2.1.0-nanoserver-1809`, `2.1-nanoserver-1809`, `2-nanoserver-1809`, `nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1809/Dockerfile)
|
|
|
-- [`2.1.0-windowsservercore-1803`, `2.1-windowsservercore-1803`, `2-windowsservercore-1803`, `windowsservercore-1803`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercore1803/Dockerfile)
|
|
|
-- [`2.1.0-nanoserver-1803`, `2.1-nanoserver-1803`, `2-nanoserver-1803`, `nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1803/Dockerfile)
|
|
|
-- [`2.1.0-windowsservercore-ltsc2016`, `2.1-windowsservercore-ltsc2016`, `2-windowsservercore-ltsc2016`, `windowsservercore-ltsc2016`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercoreltsc2016/Dockerfile)
|
|
|
+- [`2.1.0-alpine3.10`, `2.1-alpine3.10`, `2-alpine3.10`, `alpine3.10`, `2.1.0-alpine`, `2.1-alpine`, `2-alpine`, `alpine`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/alpine3.10/Dockerfile)
|
|
|
+- [`2.1.0-scratch`, `2.1-scratch`, `2-scratch`, `scratch`, `2.1.0-linux`, `2.1-linux`, `2-linux`, `linux`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/scratch/Dockerfile)
|
|
|
+- [`2.1.0-windowsservercore-1809`, `2.1-windowsservercore-1809`, `2-windowsservercore-1809`, `windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-1809/Dockerfile)
|
|
|
+- [`2.1.0-nanoserver-1809`, `2.1-nanoserver-1809`, `2-nanoserver-1809`, `nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1809/Dockerfile)
|
|
|
+- [`2.1.0-windowsservercore-1803`, `2.1-windowsservercore-1803`, `2-windowsservercore-1803`, `windowsservercore-1803`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-1803/Dockerfile)
|
|
|
+- [`2.1.0-nanoserver-1803`, `2.1-nanoserver-1803`, `2-nanoserver-1803`, `nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1803/Dockerfile)
|
|
|
+- [`2.1.0-windowsservercore-ltsc2016`, `2.1-windowsservercore-ltsc2016`, `2-windowsservercore-ltsc2016`, `windowsservercore-ltsc2016`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-ltsc2016/Dockerfile)
|
|
|
|
|
|
## Shared Tags
|
|
|
|
|
|
- `2.1.0`, `2.1`, `2`, `latest`:
|
|
|
- - [`2.1.0-scratch`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/scratch/amd64/Dockerfile)
|
|
|
- - [`2.1.0-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1809/Dockerfile)
|
|
|
- - [`2.1.0-nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1803/Dockerfile)
|
|
|
+ - [`2.1.0-scratch`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/scratch/Dockerfile)
|
|
|
+ - [`2.1.0-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1809/Dockerfile)
|
|
|
+ - [`2.1.0-nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1803/Dockerfile)
|
|
|
- `2.1.0-windowsservercore`, `2.1-windowsservercore`, `2-windowsservercore`, `windowsservercore`:
|
|
|
- - [`2.1.0-windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercore1809/Dockerfile)
|
|
|
- - [`2.1.0-windowsservercore-1803`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercore1803/Dockerfile)
|
|
|
- - [`2.1.0-windowsservercore-ltsc2016`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/windowsservercoreltsc2016/Dockerfile)
|
|
|
+ - [`2.1.0-windowsservercore-1809`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-1809/Dockerfile)
|
|
|
+ - [`2.1.0-windowsservercore-1803`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-1803/Dockerfile)
|
|
|
+ - [`2.1.0-windowsservercore-ltsc2016`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/windowsservercore-ltsc2016/Dockerfile)
|
|
|
- `2.1.0-nanoserver`, `2.1-nanoserver`, `2-nanoserver`, `nanoserver`:
|
|
|
- - [`2.1.0-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1809/Dockerfile)
|
|
|
- - [`2.1.0-nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/f71b553207305f7d725e3eed1329dcd8b00ca22f/2.1.0/nanoserver1803/Dockerfile)
|
|
|
+ - [`2.1.0-nanoserver-1809`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1809/Dockerfile)
|
|
|
+ - [`2.1.0-nanoserver-1803`](https://github.com/nats-io/nats-docker/blob/4854982e40f364582d2459be021425b4f7d7ba69/2.1.0/nanoserver-1803/Dockerfile)
|
|
|
|
|
|
# Quick reference
|
|
|
|
|
|
@@ -227,6 +228,14 @@ The `nats` images come in many flavors, each designed for a specific use case.
|
|
|
|
|
|
This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of.
|
|
|
|
|
|
+## `nats:<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).
|
|
|
+
|
|
|
## `nats:<version>-windowsservercore`
|
|
|
|
|
|
This image is based on [Windows Server Core (`microsoft/windowsservercore`)](https://hub.docker.com/r/microsoft/windowsservercore/). As such, it only works in places which that image does, such as Windows 10 Professional/Enterprise (Anniversary Edition) or Windows Server 2016.
|