业务生态系统逻辑代理Docker镜像

本文档介绍FIWARE Business API Ecosystem GE的Business Ecosystem Logic Proxy组件Docker镜像，包含镜像概述、快速启动方法、构建与运行说明等内容。该镜像用于部署业务生态系统逻辑代理服务，暴露8004端口，需Docker环境支持。

概述

本镜像包含Business Ecosystem Logic Proxy组件，可构建独立的逻辑代理实例。运行容器前，需先在所选身份管理系统（IDM）中注册实例并获取凭证，具体步骤参见业务API生态系统配置指南。

该组件依赖外部MongoDB容器（作为数据库）和ElasticSearch容器（用于索引处理），支持通过config.js文件或环境变量进行配置。

最快启动方式

推荐使用docker compose快速部署，需配置MongoDB和ElasticSearch服务。可使用软件源码中包含的docker-compose.yml文件，或创建如下自定义配置文件：

yaml
version: '3'
services:
    elasticsearch:
        image: docker.elastic.co/elasticsearch/elasticsearch:7.5.0
        environment:
            - 'node.name=BAE'
            - 'discovery.type=single-node'
            - 'ES_JAVA_OPTS=-Xms256m -Xmx256m'
        ports:
            - "127.0.0.1:9200:9200"

    mongo:
        image: mongo:4.4
        ports:
            - 27017:27017
        volumes:
            - ./proxy-data:/data/db

    proxy:
        image: fiware/biz-ecosystem-logic-proxy:master
        links:
            - mongo
        depends_on:
            - mongo
        ports:
            - 8000:8000
        volumes:
            - ./proxy-themes:/business-ecosystem-logic-proxy/themes
            - ./proxy-static:/business-ecosystem-logic-proxy/static
        environment:
            - NODE_ENV=development  # 部署环境：development或production
            - COLLECT=True  # 启动时是否执行静态文件收集命令
            
            - BAE_LP_PORT=8000  # 容器内服务端口
            - BAE_LP_HOST=proxy.docker  # 容器内服务主机
            # - BAE_SERVICE_HOST=[***]  # 代理访问的实际URL（如通过Apache代理时）
            # - BAE_LP_HTTPS_ENABLED=true  # 是否启用HTTPS（默认：false）
            # - BAE_LP_HTTPS_CERT=cert/cert.crt  # HTTPS证书路径
            # - BAE_LP_HTTPS_CA=cert/ca.crt  # CA证书路径
            # - BAE_LP_HTTPS_KEY=cert/key.key  # HTTPS密钥路径
            # - BAE_LP_HTTPS_PORT=443  # HTTPS端口
            
            # ------ OAUTH2配置 ------
            - BAE_LP_OAUTH2_SERVER=[***]  # FIWARE IDM服务URL
            - BAE_LP_OAUTH2_CLIENT_ID=id  # BAE应用的OAuth2客户端ID
            - BAE_LP_OAUTH2_CLIENT_SECRET=secret  # BAE应用的OAuth2客户端密钥
            - BAE_LP_OAUTH2_CALLBACK=[***]  # 访问令牌回调URL
            - BAE_LP_OAUTH2_ADMIN_ROLE=admin  # IDM中定义的BAE管理员角色
            - BAE_LP_OAUTH2_SELLER_ROLE=seller  # IDM中定义的BAE卖家角色
            - BAE_LP_OAUTH2_CUSTOMER_ROLE=customer  # IDM中定义的BAE客户角色
            - BAE_LP_OAUTH2_ORG_ADMIN_ROLE=orgAdmin  # IDM中定义的BAE组织管理员角色
            - BAE_LP_OAUTH2_IS_LEGACY=false  # 是否使用FIWARE IDM 6或更低版本
            
            # - BAE_LP_THEME=theme  # 自定义主题名称（需置于themes卷中）
            
            # ----- Mongo配置 ------
            # - BAE_LP_MONGO_USER=user  # MongoDB用户名
            # - BAE_LP_MONGO_PASS=pass  # MongoDB密码
            - BAE_LP_MONGO_SERVER=localhost  # MongoDB服务地址
            - BAE_LP_MONGO_PORT=27017  # MongoDB端口
            - BAE_LP_MONGO_DB=belp  # MongoDB数据库名
            
            - BAE_LP_REVENUE_MODEL=30  # 收入分享模型中市场所有者默认百分比
            
            # ----- API配置 -----
            # 配置逻辑代理管理的各API连接，默认配置apis.docker、charging.docker和rss.docker域
            # - BAE_LP_ENDPOINT_CATALOG_PATH=DSProductCatalog
            # - BAE_LP_ENDPOINT_CATALOG_PORT=8080
            # - BAE_LP_ENDPOINT_CATALOG_HOST=apis.docker
            # - BAE_LP_ENDPOINT_CATALOG_SECURED=false
            # ...

镜像卷说明

该镜像定义以下卷，用于数据持久化和自定义配置：

• /business-ecosystem-logic-proxy/themes：存放自定义主题文件，用于定制Web门户外观
• /business-ecosystem-logic-proxy/static：包含待渲染的静态文件（含所选主题和JS文件）

环境变量说明

镜像支持以下环境变量优化部署配置：

• NODE_ENV：部署环境类型，可选development（开发）或production（生产），默认development
• COLLECT：启动时是否执行静态文件收集命令（生成或使用现有静态文件），默认True

启动与停止命令

创建docker-compose.yml后，执行以下命令启动服务：

bash
docker compose up -d

服务将运行在[***]（替换YOUR_HOST为宿主机地址，PORT为配置的映射端口）。

停止服务：

bash
docker compose stop

重启服务：

bash
docker compose start

终止并删除容器：

bash
docker compose down

构建镜像

若已下载Business Ecosystem Logic Proxy源代码，可构建自定义镜像。在项目目录中执行以下命令：

bash
docker build -t biz-ecosystem-logic-proxy -f docker/Dockerfile .

• -t biz-ecosystem-logic-proxy：指定镜像名称，可自定义（如包含组织名：-t fiware/biz-ecosystem-logic-proxy）
• -f docker/Dockerfile：指定Dockerfile路径
• .：构建上下文为当前目录

构建完成后，可使用自定义镜像名称运行容器。