Icinga DB 容器镜像文档

镜像概述

本镜像用于在容器化环境中集成Icinga DB，提供监控数据的存储与处理能力。Icinga DB是Icinga监控系统的核心组件，负责存储、处理和检索监控数据，支持与Redis（用于缓存）和关系型数据库（如MariaDB）协同工作。

核心功能与特性

• 容器化集成：可无缝融入容器化环境，支持与Redis、MariaDB等容器化服务联动。
• 环境变量配置：通过环境变量灵活配置数据库连接、Redis连接等参数，无需手动修改配置文件。
• 无卷依赖：容器运行无需挂载卷，简化部署流程。
• TLS支持：可通过环境变量配置TLS加密，保障与Redis及数据库的安全连接。

使用场景

适用于需要在容器化监控系统中部署Icinga DB的场景，尤其适合基于Docker的监控架构，用于存储和处理来自Icinga 2等监控引擎的监控数据。

使用方法与配置说明

前置准备

部署前需确保环境中已安装Docker，且具备创建Docker网络、运行容器的权限。

基本部署示例

1. 创建专用网络

bash
docker network create icinga

2. 启动Redis容器（用于缓存）

bash
docker run --rm -d \
    --network icinga \
    --name redis-icingadb \
    redis

3. 启动MariaDB容器（用于数据存储）

bash
docker run -d \
    --network icinga \
    --name mariadb-icingadb \
    -e MYSQL_RANDOM_ROOT_PASSWORD=1 \
    -e MYSQL_DATABASE=icingadb \
    -e MYSQL_USER=icingadb \
    -e MYSQL_PASSWORD=*** \
    mariadb

4. 启动Icinga DB容器

bash
docker run -d \
    --network icinga \
    --restart always \
    --name icingadb \
    -e ICINGADB_REDIS_HOST=redis-icingadb \
    -e ICINGADB_REDIS_PORT=6379 \
    -e ICINGADB_REDIS_PASSWORD=*** \
    -e ICINGADB_DATABASE_HOST=mariadb-icingadb \
    -e ICINGADB_DATABASE_PORT=3306 \
    -e ICINGADB_DATABASE_DATABASE=icingadb \
    -e ICINGADB_DATABASE_USER=icingadb \
    -e ICINGADB_DATABASE_PASSWORD=*** \
    icinga/icingadb

说明：Icinga DB容器无需挂载卷，所有配置通过环境变量传入。

环境变量配置

容器通过环境变量进行配置，主要包括Redis连接和数据库连接相关参数。

环境变量命名规则

• Redis相关配置以ICINGADB_REDIS_为前缀
• 数据库相关配置以ICINGADB_DATABASE_为前缀
• 配置项名称为大写，例如HOST、PORT等

常用环境变量示例

# Redis连接配置
ICINGADB_REDIS_HOST=redis-icingadb  # Redis主机地址
ICINGADB_REDIS_PORT=6379           # Redis端口
ICINGADB_REDIS_PASSWORD=***     # Redis密码（若有）

# 数据库连接配置
ICINGADB_DATABASE_HOST=mariadb-icingadb  # 数据库主机地址
ICINGADB_DATABASE_PORT=3306             # 数据库端口
ICINGADB_DATABASE_DATABASE=icingadb     # 数据库名称
ICINGADB_DATABASE_USER=icingadb         # 数据库用户名
ICINGADB_DATABASE_PASSWORD=***       # 数据库密码

更多选项，请参见Icinga DB配置文档。

TLS加密连接配置

若需通过TLS加密连接Redis或数据库，可添加以下环境变量：

bash
docker run -d \
    --network icinga \
    --restart always \
    --name icingadb \
    # Redis TLS配置
    -e ICINGADB_REDIS_TLS=true \
    -e ICINGADB_REDIS_CERT='[PEM格式证书内容或卷中文件路径]' \
    -e ICINGADB_REDIS_KEY='[PEM格式密钥内容或卷中文件路径]' \
    -e ICINGADB_REDIS_CA='[PEM格式CA证书内容或卷中文件路径]' \
    # 数据库TLS配置
    -e ICINGADB_DATABASE_TLS=true \
    -e ICINGADB_DATABASE_CERT='[PEM格式证书内容或卷中文件路径]' \
    -e ICINGADB_DATABASE_KEY='[PEM格式密钥内容或卷中文件路径]' \
    -e ICINGADB_DATABASE_CA='[PEM格式CA证书内容或卷中文件路径]' \
    # 其他基础配置（同上）
    -e ICINGADB_REDIS_HOST=redis-icingadb \
    -e ICINGADB_REDIS_PORT=6379 \
    -e ICINGADB_REDIS_PASSWORD=*** \
    -e ICINGADB_DATABASE_HOST=mariadb-icingadb \
    -e ICINGADB_DATABASE_PORT=3306 \
    -e ICINGADB_DATABASE_DATABASE=icingadb \
    -e ICINGADB_DATABASE_USER=icingadb \
    -e ICINGADB_DATABASE_PASSWORD=*** \
    icinga/icingadb

手动构建镜像

若需自定义构建镜像，可执行以下命令：

bash
# 克隆源码仓库
git clone [***]

# 构建镜像
docker build -t icingadb --file Containerfile .