monasca-api Dockerfile

该镜像包含Monasca API的容器化版本。

Monasca API有两种实现：

• python（标签为-python或空）- Dockerfile
• java（标签为-java）- Dockerfile

目前推荐使用python镜像。有关Monasca项目的更多信息，请参见项目wiki。

源码仓库：monasca-api · monasca-docker

标签（Tags）

本仓库中的镜像遵循以下标签约定：

• latest：指向最新稳定Python版本，例如1.5.0-python
• latest-python、latest-java：同上，但明确指向最新稳定Python或Java版本，例如1.5.0
• 1.5.0、1.5、1：标准语义化版本标签，基于官方仓库中的git标签
• 1.5.0-python、1.5-python、1-python：同上，但明确指向Python实现的镜像
• mitaka、newton等：基于仓库中stable/RELEASE_NAME分支尖端构建的命名版本，遵循OpenStack版本命名
• mitaka-python、newton-python：同上，但明确指向Python实现的镜像
• master、master-DATESTAMP：来自master分支的不稳定构建，不建议一般使用

注意：除非另有说明，镜像默认为Python实现。所有Java实现的镜像均会明确标记，且可能不支持下文描述的配置选项。

使用方法（Usage）

运行API需要连接到Kafka、Influx和MySQL的可用实例。要处理指标，还应运行一个或多个monasca-persister实例。告警和告警管理功能还需要storm实例、monasca-thresh以及monasca-notification。

在类似官方Kubernetes环境中，该镜像无需额外配置参数，可按如下方式运行：

docker run -p 8070:8070 -it monasca/api:latest

注意：由于最近的配置文件变更，此Docker容器仅支持版本大于1.5.0的API。截至本文撰写时，此Dockerfile暂不支持正式的API版本发布。因此，在下次monasca-api版本发布前，latest和latest-python标签将指向最新的master镜像。

配置（Configuration）

可向容器传递多个环境变量：

若需覆盖其他配置值，可通过挂载替换以下配置文件或jinja2模板：

• /etc/monasca/api-config.conf.j2
• /etc/monasca/api-config.ini.j2
• /etc/monasca/api-logging.conf.j2

若不需要jinja2格式化，可设置环境变量CONFIG_TEMPLATE=false。注意，仍需覆盖jinja2模板文件（而非不带.j2后缀的目标文件），因为容器会在运行时复制模板文件。

配置文件源可在仓库中查看。若需查看运行时生成的配置文件，可执行：

docker exec -it some_container_id cat /etc/monasca/api-config.conf
docker exec -it some_container_id cat /etc/monasca/api-config.ini
docker exec -it some_container_id cat /etc/monasca/api-logging.conf

故障排除（Troubleshooting）

可通过以下命令检查容器状态（示例）：

docker ps --filter 'name=monasca' --format '{{.Names}}\t{{.Image}}\t{{.Status}}'

通过以下命令获取健康检查结果：

docker inspect --format '{{json .State.Health}}' monasca | python -m json.tool

健康检查ExitCode含义：

• 1: Keystone认证错误
• 2: Monasca API错误