业务生态计费后端Docker镜像

本仓库包含FIWARE业务API生态系统GE的业务生态计费后端组件的Docker镜像。

您可以基于此Dockerfile构建Docker镜像。该镜像将包含业务生态计费后端实例，暴露端口8006。这要求您的机器上已安装Docker。

如果您希望尽快运行业务生态计费后端实例，请跳至“最快方式”部分。如果您想了解容器的内部工作原理，可以阅读构建和运行部分。

最快方式

业务生态计费后端组件使用MongoDB容器作为数据库。软件可通过标准settings.py文件或支持的环境变量进行配置。有关不同配置选项的详细信息，请参阅业务API生态系统配置指南。

要运行业务生态计费后端，可使用docker compose。您可以使用源代码中提供的docker-compose.yml文件，或创建一个包含以下内容的新文件：

yaml
version: '3'
services:
    mongo:
        image: mongo:4.4
        ports:
            - 27017:27017
        volumes:
            - ./charging-data:/data/db

    charging:
        image: fiware/biz-ecosystem-charging-backend:master
        links:
            - mongo
        depends_on:
            - mongo
        ports:
            - 8006:8006
        volumes:
            - ./charging-bills:/business-ecosystem-charging-backend/src/media/bills
            - ./charging-assets:/business-ecosystem-charging-backend/src/media/assets
            - ./charging-plugins:/business-ecosystem-charging-backend/src/plugins
            - ./charging-inst-plugins:/business-ecosystem-charging-backend/src/wstore/asset_manager/resource_plugins/plugins
        environment:
          - BAE_CB_PAYMENT_METHOD=None  # 支付方式：***或None（测试模式，断开支付连接）
          # - BAE_CB_***_CLIENT_ID=client_id
          # - BAE_CB_***_CLIENT_SECRET=client_secret

          # ----- 数据库配置 -----
          - BAE_CB_MONGO_SERVER=mongo
          - BAE_CB_MONGO_PORT=27017
          - BAE_CB_MONGO_DB=charging_db
          # - BAE_CB_MONGO_USER=user
          # - BAE_CB_MONGO_PASS=passwd

          # ----- 角色配置 -----
          - BAE_LP_OAUTH2_ADMIN_ROLE=admin
          - BAE_LP_OAUTH2_SELLER_ROLE=seller
          - BAE_LP_OAUTH2_CUSTOMER_ROLE=customer

          # ----- 邮件配置 -----
          - BAE_CB_EMAIL=***
          # - BAE_CB_EMAIL_USER=user
          # - BAE_CB_EMAIL_PASS=pass
          # - BAE_CB_EMAIL_SMTP_SERVER=smtp.server.com
          # - BAE_CB_EMAIL_SMTP_PORT=587

          - BAE_CB_VERIFY_REQUESTS=True  # BAE是否验证对外部组件请求的SSL证书

          # ----- 站点配置 -----
          - BAE_SERVICE_HOST=[***]  # 用于访问BAE的外部URL
          - BAE_CB_LOCAL_SITE=[***]  # 计费后端的本地URL

          # ----- API连接配置 -----
          - BAE_CB_CATALOG=[***]
          - BAE_CB_INVENTORY=[***]
          - BAE_CB_ORDERING=[***]
          - BAE_CB_BILLING=[***]
          - BAE_CB_RSS=[***]
          - BAE_CB_USAGE=[***]
          - BAE_CB_AUTHORIZE_SERVICE=[***]

如您所见，biz-ecosystem-charging-backend镜像定义了4个卷。具体如下：

• /business-ecosystem-charging-backend/src/media/bills：存放业务生态计费后端生成的PDF发票
• /business-ecosystem-charging-backend/src/media/assets：存放卖家上传到业务生态计费后端的各类数字资产
• /business-ecosystem-charging-backend/src/plugins：用于提供资产插件（参见“安装资产插件”部分）
• /business-ecosystem-charging-backend/src/wstore/asset_manager/resource_plugins/plugins：包含已安装插件的代码

系统可通过软件定义的环境变量进行配置。在此情况下，无需提供settings文件，因为环境变量值会覆盖文件中的配置。

创建文件后，运行以下命令：

bash
docker compose up

之后，业务生态计费后端将在[***]上运行，其中YOUR_HOST替换为您机器的主机名，PORT替换为上一步中选择的端口。

不同容器运行后，可使用以下命令停止：

bash
docker compose stop

再次启动使用：

bash
docker compose start

此外，可通过以下命令终止所有容器：

bash
docker compose down

构建镜像

如果您已下载业务生态计费后端的源代码，可以构建自己的镜像。最终结果相同，但这种方式能让您更好地控制过程。

要创建镜像，导航至docker目录并运行：

bash
$ docker build -t biz-ecosystem-charging-backend -f docker/Dockerfile .

参数-t biz-ecosystem-charging-backend为镜像命名。此名称可以是任意值，甚至可以包含组织名，如-t fiware/biz-ecosystem-charging-backend。该名称随后用于基于镜像运行容器。

如需了解更多关于镜像和构建过程的信息，可参阅Docker文档。

安装资产插件

如您所知，业务API生态系统可通过在计费后端加载资产插件来销售不同类型的数字资产。在当前Docker镜像中安装资产插件的步骤如下：

1. 将插件文件复制到卷/business-ecosystem-charging-backend/src/plugins的主机目录中

2. 进入运行中的容器：

bash
docker exec -i -t your-container /bin/bash

3. 进入安装目录

bash
cd /business-ecosystem-charging-backend/src

4. 加载插件

bash
./manage.py loadplugin ./plugins/pluginfile.zip