zabbixci 0.3.14

Source control for Zabbix templates in Git

[!WARNING] This project is under active development, the code in the main branch should be relatively stable but things might break every now and then. The releases that can be installed with pip are currently stable enough for testing. If you run into unexpected bugs, please create an issue. For questions about usage, please start a discussion.

ZabbixCI

ZabbixCI is a tool that adds continuous integration to Zabbix, allowing you to synchronize Zabbix assets with a Git repository. By using the Zabbix API, ZabbixCI can create, update, and delete assets across multiple Zabbix servers.

[!NOTE] ZabbixCI has no affiliation with Zabbix SIA.

Features

ZabbixCI provides the following features:

• Easily installable through pip or run it as a container image
• Fully configurable through cli arguments, config file and/or environment variables
• Supports HTTP(S) and SSH auth for Git
• Export assets from Zabbix and push them to Git
• Pull assets from Git and import them in Zabbix
• Only changed or new assets will be processed during Git push or Zabbix import actions
• Removes deleted assets automatically (unless black- or whitelisting is used)
• Use dry-run to verify behavior without changes to Zabbix or Git
• Build with parallelization in mind to speed up the process (can be scaled for your needs)
• (Optional) Support for private CA servers to verify certificates
• (Optional) Allow black-/whitelisting of assets (supports regexp)
• (Optional) Use separate branches for push and pull transactions

Additional template features

• Sync your templates with Git
• Built-in Zabbix version compatibility checking
• (Optional) Automatically populate empty vendor field with your own string
• (Optional) Allow automatic versioning of exported templates based on timestamps

Additional image (icons and backgrounds) features

• Sync your map images with Git
• Sync your icon-maps with Git
• Dynamically generate icons and backgrounds in predefined sizes
• Use .png or .svg files as sources for image generation

Installation

ZabbixCI is available on PyPI and can be installed using pip:

pip install zabbixci

Alternatively, you can use a container image to run ZabbixCI, see the available container images. See the Containerized Deployment documentation for more information.

Configuration

ZabbixCI requires parameters to be set as command line arguments, a yaml configuration or as environment variables. See the example configuration file.

We recommend passing environment variables when using the container image. Feel free to use the method that best suits your workflow.

Usage

We have a quickstart tutorial for first time users. Please see the Docs for extended details if needed.

License

This project is licensed under AGPL-3.0, see LICENSE for more information.

Contributing

Contributions are welcome! Please take a look at the following guidelines:

• It is best to create a issue before submitting a PR, this way we can determine the correct base for a PR, allowing for easier merges and consistency in versions releases.
• New features will always be added to the next minor update, instead of a patch update. For this, new features should always be based of the develop branch instead of the main branch.
• Commit messages should follow the Gitmoji convention or prefix with types (feat:, fix:, style:, etc.).
• The codebase uses ruff for formatting and linting. As well as ty for type checking.

Star History

[!NOTE] If you like this project, please consider starring it on GitHub. ❤️