新增：IBM容器注册表

IBM® 现在在IBM容器注册表 icr.io 上托管产品镜像。您无需认证即可通过此IBM控制的源 icr.io/cpopen/odm-k8s 获取IBM Operational Decision Manager for Developers镜像。

console
docker pull icr.io/cpopen/odm-k8s/odm-metering-service:latest-amd64

快速参考

• 获取帮助的地方：

  ODM开发者社区

  ODM许可和计量文档

• 提交问题的地址：
  [***]

• 维护者：IBM ODM团队

• 支持的架构：
  amd64

• 本描述的来源：
  [***]

• 支持的Docker版本：
  最新版本（最高版本27，基于尽力而为原则）

• Kubernetes Helm图表：
  ODM计量Helm图表

概述

Operational Decision Manager (ODM) 使用计量服务镜像允许您生成符合IBM许可计量工具的许可文件。这些许可文件基于观察到的ODM软件使用情况生成。

有关使用此镜像的限制，请参见本页末尾的许可部分。

用法

该镜像包含计量服务，通过8888端口暴露HTTP，9999端口暴露HTTPS。

启动镜像前必须接受许可。许可详见本页末尾。

console
docker run -e LICENSE=accept -p 8888:8888 -p 9999:9999 icr.io/cpopen/odm-k8s/odm-metering-service:latest-amd64

服务器启动后，可通过URL http://localhost:8888 或 https://localhost:9999 访问欢迎页面。

计量服务接收来自Operational Decision Manager的使用信息并进行聚合。

服务可用时，可通过/backup REST API端点获取ILMT文件的zip归档。在浏览器中，通过http://localhost:8888/backup 或 https://localhost:9999/backup 访问zip归档，或使用以下curl命令：

console
curl http://localhost:8888/backup -o backup.zip
curl -k https://localhost:9999/backup -o backup.zip

存储

为避免删除Docker镜像容器时丢失数据，请将数据库存储在ODM计量Docker镜像容器外部，通过本地挂载主机卷（-v $PWD/DB:/config/storage/DB）。

您也可以通过创建卷（-v $PWD/ILMT:/config/storage/ILMT）来存储许可文件。

console
docker run -e LICENSE=accept -p 8888:8888 -p 9999:9999 -v $PWD/DB:/config/storage/DB -v $PWD/ILMT:/config/storage/ILMT -e com.ibm.decision.metering.ilmt.service.ILMToutputDirectory=/config/storage/ILMT -e com.ibm.decision.metering.ilmt.service.databaseFilePath=/config/storage/DB icr.io/cpopen/odm-k8s/odm-metering-service:latest-amd64

首次运行此命令时，会在本地文件夹中创建计量文件。重启计量服务时，将读取并更新这些文件。

配置

您可以通过提供自定义的mybootstrap.properties文件（-v $PWD/mybootstrap.properties:/config/bootstrap.properties）修改默认计量属性。

默认的bootstrap.properties文件包含以下属性：

console
# 应用程序使用的日志级别。可能的值包括ERROR、WARN、INFO、DEBUG和TRACE。
METERING_LOGGINGLEVEL=INFO
# 处理使用情况并写入许可文件的频率（毫秒）。
METERING_PROCESSINGRATE=60000
# 服务启动后首次处理前的延迟（毫秒）。
METERING_PROCESSING_INITIAL_DELAY=6000

要使用配置属性文件配置计量服务，可使用：

console
docker run -e LICENSE=accept -p 8888:8888 -p 9999:9999 -v $PWD/mybootstrap.properties:/config/bootstrap.properties icr.io/cpopen/odm-k8s/odm-metering-service:latest-amd64

安全

计量服务提供HTTPS安全协议。

默认证书与ODM Docker镜像兼容（[***]

如果要提供自定义证书，请设置两个卷，一个用于server.crt证书（-v $PWD/mycompany.crt:/config/resources/certificate/server.crt），一个用于server.key私钥（-v $PWD/mycompany.key:/config/resources/certificate/server.key）。

例如，使用以下命令生成证书：

console
openssl req -x509 -nodes -days 1000 -newkey rsa:2048 -keyout mycompany.key -out mycompany.crt -subj "/CN=*.mycompany.com/OU=it/O=mycompany/L=Paris/C=FR"

要使用自定义证书，运行以下docker命令：

console
docker run -e LICENSE=accept -p 8888:8888 -p 9999:9999 -v $PWD/mycompany.crt:/config/resources/certificate/server.crt -v $PWD/mycompany.key:/config/resources/certificate/server.key icr.io/cpopen/odm-k8s/odm-metering-service:latest-amd64

许可

Docker文件及相关脚本根据Apache License 2.0许可。