fiware/monitoring-api

FIWARELab监控API Docker镜像使用指南

镜像概述

本镜像为FIWARELab监控API的Docker化部署版本，旨在简化监控API服务的搭建流程，支持快速启动并通过配置文件自定义服务参数，适用于FIWARE平台相关的监控场景。

核心功能

1. 支持绑定外部配置文件目录，灵活加载自定义配置
2. 提供端口映射功能，可根据需求设置服务内外端口
3. 兼容Docker引擎不同版本（17.06及以上支持--mount参数，低版本支持-v参数）
4. 支持通过命令行参数指定配置文件路径启动服务

使用场景

• FIWARE平台环境中的监控数据采集与API服务提供
• 开发或测试环境中快速部署监控API服务
• 生产环境中稳定运行监控API并灵活调整配置

配置说明

1. 构建镜像：使用指定Dockerfile构建镜像
2. 设置配置路径：通过环境变量指定配置文件所在目录
3. 端口设置：（可选）设置服务内外端口（若使用--net="host"可跳过）
4. 启动容器：根据Docker版本选择挂载方式启动容器

部署示例

1. 构建镜像

bash
sudo docker build -t fiware/monitoring-api:tag -f monitoringProxy/Dockerfile .

2. 设置配置路径环境变量

bash
export API_CONFIG_PATH=/etc/monitoringAPI

3. （可选）设置端口

bash
export API_INT_PORT=11027
export API_EXT_PORT=11027

4. 启动容器（Docker 17.06及以上版本）

bash
sudo docker run -d --name monitoringAPI \
--net="host" \
-p $API_EXT_PORT:$API_INT_PORT \
--mount type=bind,source=$API_CONFIG_PATH,target=monitoringAPI-conf \
fiware/monitoring-api:tag \
-c monitoringAPI-conf/monProxy-config.ini \
-m monitoringAPI-conf/main-config.ini

5. 启动容器（Docker 17.06以下版本）

bash
sudo docker run -d --name monitoringAPI \
--net="host" \
-p $API_EXT_PORT:$API_INT_PORT \
-v $API_CONFIG_PATH:/monitoringAPI-conf \
fiware/monitoring-api:tag \
-c monitoringAPI-conf/monProxy-config.ini \
-m monitoringAPI-conf/main-config.ini

提示：若使用docker-machine，请先挂载包含监控API配置文件的目录，详情参考https://docs.docker.com/machine/reference/mount/#example%E3%80%82