From b04d073fd62f8a8ded7e7f6f10c005456a8edfbf Mon Sep 17 00:00:00 2001 From: root Date: Thu, 10 May 2018 13:38:17 -0700 Subject: [PATCH] Updated Zabbix snmptraps image description --- snmptraps/alpine/.dockerignore | 2 +- snmptraps/alpine/README.md | 34 ++++++++++++++++++++++++++++------ snmptraps/centos/README.md | 34 ++++++++++++++++++++++++++++------ snmptraps/ubuntu/README.md | 34 ++++++++++++++++++++++++++++------ 4 files changed, 85 insertions(+), 19 deletions(-) diff --git a/snmptraps/alpine/.dockerignore b/snmptraps/alpine/.dockerignore index c07a74de4..88a84e55a 100644 --- a/snmptraps/alpine/.dockerignore +++ b/snmptraps/alpine/.dockerignore @@ -1 +1 @@ -build.sh \ No newline at end of file +build.sh diff --git a/snmptraps/alpine/README.md b/snmptraps/alpine/README.md index af6f825d1..51fa5bee2 100644 --- a/snmptraps/alpine/README.md +++ b/snmptraps/alpine/README.md @@ -14,13 +14,15 @@ The image is used to receive SNMP traps, store them to a log file and provide ac # Zabbix snmptraps images -These are the only official Zabbix snmptraps Docker images. They are based on trusty Ubuntu. The available versions of Zabbix snmptraps are: +These are the only official Zabbix snmptraps Docker images. They are based on Alpine Linux v3.4, Ubuntu 14.04 (trusty) and CentOS 7 images. The available versions of Zabbix snmptraps are: - Zabbix snmptraps 3.0 (tags: ubuntu-3.0-latest) - Zabbix snmptraps 3.0.* (tags: ubuntu-3.0.*) - Zabbix snmptraps 3.2 (tags: ubuntu-3.2-latest, ubuntu-latest, latest) - Zabbix snmptraps 3.2.* (tags: ubuntu-3.2.*) - Zabbix snmptraps 3.4 (tags: ubuntu-trunk) + Zabbix snmptraps 3.0 (tags: alpine-3.0-latest, ubuntu-3.0-latest, centos-3.0-latest) + Zabbix snmptraps 3.0.* (tags: alpine-3.0.*, ubuntu-3.0.*, centos-3.0.*) + Zabbix snmptraps 3.2 (tags: alpine-3.2-latest, ubuntu-3.2-latest, centos-3.2-latest) + Zabbix snmptraps 3.2.* (tags: alpine-3.2.*, ubuntu-3.2.*, centos-3.2.*) + Zabbix snmptraps 3.4 (tags: alpine-3.4-latest, ubuntu-3.4-latest, centos-3.4-latest, alpine-latest, ubuntu-latest, centos-latest, latest) + Zabbix snmptraps 3.4.* (tags: alpine-3.4.*, ubuntu-3.4.*, centos-3.4.*) + Zabbix snmptraps 4.0 (tags: alpine-trunk, ubuntu-trunk, centos-trunk) Images are updated when new releases are published. @@ -62,6 +64,26 @@ The volume contains log file ``snmptraps.log`` named with received SNMP traps. The volume allows to add new MIB files. It does not support subdirectories, all MIBs must be placed to ``/var/lib/zabbix/mibs``. +# The image variants + +The `zabbix-snmptraps` images come in many flavors, each designed for a specific use case. + +## `zabbix-snmptraps:ubuntu-` + +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. + +## `zabbix-snmptraps:centos-` + +This is the defacto image also. 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. + +## `zabbix-snmptraps: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). + # Supported Docker versions This image is officially supported on Docker version 1.12.0. diff --git a/snmptraps/centos/README.md b/snmptraps/centos/README.md index af6f825d1..51fa5bee2 100644 --- a/snmptraps/centos/README.md +++ b/snmptraps/centos/README.md @@ -14,13 +14,15 @@ The image is used to receive SNMP traps, store them to a log file and provide ac # Zabbix snmptraps images -These are the only official Zabbix snmptraps Docker images. They are based on trusty Ubuntu. The available versions of Zabbix snmptraps are: +These are the only official Zabbix snmptraps Docker images. They are based on Alpine Linux v3.4, Ubuntu 14.04 (trusty) and CentOS 7 images. The available versions of Zabbix snmptraps are: - Zabbix snmptraps 3.0 (tags: ubuntu-3.0-latest) - Zabbix snmptraps 3.0.* (tags: ubuntu-3.0.*) - Zabbix snmptraps 3.2 (tags: ubuntu-3.2-latest, ubuntu-latest, latest) - Zabbix snmptraps 3.2.* (tags: ubuntu-3.2.*) - Zabbix snmptraps 3.4 (tags: ubuntu-trunk) + Zabbix snmptraps 3.0 (tags: alpine-3.0-latest, ubuntu-3.0-latest, centos-3.0-latest) + Zabbix snmptraps 3.0.* (tags: alpine-3.0.*, ubuntu-3.0.*, centos-3.0.*) + Zabbix snmptraps 3.2 (tags: alpine-3.2-latest, ubuntu-3.2-latest, centos-3.2-latest) + Zabbix snmptraps 3.2.* (tags: alpine-3.2.*, ubuntu-3.2.*, centos-3.2.*) + Zabbix snmptraps 3.4 (tags: alpine-3.4-latest, ubuntu-3.4-latest, centos-3.4-latest, alpine-latest, ubuntu-latest, centos-latest, latest) + Zabbix snmptraps 3.4.* (tags: alpine-3.4.*, ubuntu-3.4.*, centos-3.4.*) + Zabbix snmptraps 4.0 (tags: alpine-trunk, ubuntu-trunk, centos-trunk) Images are updated when new releases are published. @@ -62,6 +64,26 @@ The volume contains log file ``snmptraps.log`` named with received SNMP traps. The volume allows to add new MIB files. It does not support subdirectories, all MIBs must be placed to ``/var/lib/zabbix/mibs``. +# The image variants + +The `zabbix-snmptraps` images come in many flavors, each designed for a specific use case. + +## `zabbix-snmptraps:ubuntu-` + +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. + +## `zabbix-snmptraps:centos-` + +This is the defacto image also. 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. + +## `zabbix-snmptraps: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). + # Supported Docker versions This image is officially supported on Docker version 1.12.0. diff --git a/snmptraps/ubuntu/README.md b/snmptraps/ubuntu/README.md index af6f825d1..51fa5bee2 100644 --- a/snmptraps/ubuntu/README.md +++ b/snmptraps/ubuntu/README.md @@ -14,13 +14,15 @@ The image is used to receive SNMP traps, store them to a log file and provide ac # Zabbix snmptraps images -These are the only official Zabbix snmptraps Docker images. They are based on trusty Ubuntu. The available versions of Zabbix snmptraps are: +These are the only official Zabbix snmptraps Docker images. They are based on Alpine Linux v3.4, Ubuntu 14.04 (trusty) and CentOS 7 images. The available versions of Zabbix snmptraps are: - Zabbix snmptraps 3.0 (tags: ubuntu-3.0-latest) - Zabbix snmptraps 3.0.* (tags: ubuntu-3.0.*) - Zabbix snmptraps 3.2 (tags: ubuntu-3.2-latest, ubuntu-latest, latest) - Zabbix snmptraps 3.2.* (tags: ubuntu-3.2.*) - Zabbix snmptraps 3.4 (tags: ubuntu-trunk) + Zabbix snmptraps 3.0 (tags: alpine-3.0-latest, ubuntu-3.0-latest, centos-3.0-latest) + Zabbix snmptraps 3.0.* (tags: alpine-3.0.*, ubuntu-3.0.*, centos-3.0.*) + Zabbix snmptraps 3.2 (tags: alpine-3.2-latest, ubuntu-3.2-latest, centos-3.2-latest) + Zabbix snmptraps 3.2.* (tags: alpine-3.2.*, ubuntu-3.2.*, centos-3.2.*) + Zabbix snmptraps 3.4 (tags: alpine-3.4-latest, ubuntu-3.4-latest, centos-3.4-latest, alpine-latest, ubuntu-latest, centos-latest, latest) + Zabbix snmptraps 3.4.* (tags: alpine-3.4.*, ubuntu-3.4.*, centos-3.4.*) + Zabbix snmptraps 4.0 (tags: alpine-trunk, ubuntu-trunk, centos-trunk) Images are updated when new releases are published. @@ -62,6 +64,26 @@ The volume contains log file ``snmptraps.log`` named with received SNMP traps. The volume allows to add new MIB files. It does not support subdirectories, all MIBs must be placed to ``/var/lib/zabbix/mibs``. +# The image variants + +The `zabbix-snmptraps` images come in many flavors, each designed for a specific use case. + +## `zabbix-snmptraps:ubuntu-` + +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. + +## `zabbix-snmptraps:centos-` + +This is the defacto image also. 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. + +## `zabbix-snmptraps: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). + # Supported Docker versions This image is officially supported on Docker version 1.12.0.