/icinga-snmp-image

A container image based off of the official Icinga 2 Docker image which includes several SNMP plugins

Primary LanguageNixOtherNOASSERTION

Icinga SNMP Image

Build Status

A container image based off of the official Icinga 2 - Docker Image which includes various SNMP plugins. These include the Manubulon SNMP Plugins, the OpenBSD SNMPv3 Check, and the check_interfaces plugins.

Synopsis

Image

quay.io/jwillikers/icinga-snmp

Tags
  • latest

Supported architectures
  • amd64 (x86_64)

  • arm64 (aarch64)

Labels
io.containers.autoupdate=registry

Enables automatic updates when using Podman and the fully-qualified image name.

Contains a patched version of /usr/share/perl5/Net/SNMP/Security/USM.pm to support newer versions of the SHA algorithms for authentication.

Quick Start

Use this container image the same way as the Icinga 2 - Docker Image. It just contains several SNMP plugins in addition to everything else in the official upstream image. An example Kubernetes YAML configuration for running this container is available in my Home Lab Helm project.

Build

  1. Install an implementation of Nix, such as Lix used here.

    curl -sSf -L https://install.lix.systems/lix | sh -s -- install
  2. Clone this repository.

    git clone git@github.com:jwillikers/icinga-snmp-image.git
  3. Change into the project directory.

    cd icinga-snmp-image
  4. Build the image.

    nix build '.#icinga-snmp-image'

Develop

For local development, direnv is recommended. Follow these steps to install and enable it.

  1. Install direnv for your system according to the direnv installation instructions.

    sudo rpm-ostree install direnv
    sudo systemctl reboot
  2. Integrate direnv with your shell by following the instructions on the direnv Setup page.

  3. Permit the direnv configuration in the repository.

    direnv allow

Contributing

Contributions in the form of issues, feedback, and even pull requests are welcome. Make sure to adhere to the project’s Code of Conduct.

Open Source Software

This project is built on the hard work of countless open source contributors. Several of these projects are enumerated below.

Code of Conduct

Refer to the project’s Code of Conduct for details.

License

This repository is licensed under the GPLv3, a copy of which is provided in the license file.

© 2023-2024 Jordan Williams

Authors