构建和配置 ThingWorx CXServer Docker 镜像
构建 CXServer Docker 镜像
完成设置后,可以使用构建脚本来创建 ThingWorx Connection Server Docker 镜像。包括的 build.sh 脚本采用 build.env 文件中设置的变量,并与 staging 文件夹中的文件一起使用,以确保 Docker 构建命令具有相应的变量,且提供了可用的构建上下文。
要构建此映像,请运行以下命令:
./build.sh all
构建进程完成后,可使用以下 Docker 镜像:
thingwork/cxserver-twx:latest
配置 CXServer Docker 镜像
可将以下环境变量用于容器配置。这些变量可用于 DockerFile 下载中包含的 example/docker-compose.yml 文件,或 Thingworx DockerFile 下载中相应的 TWXdockerfile>/docker-compose-DB-clustered/.env 文件。
变量名称
Docker Compose 默认值
备注
CXSERVER_APP_KEY
未设置默认值
ThingWorx Connection Server 用于连接的应用程序密钥。
TWX_PLATFORM_SERVICE_NAME
未设置默认值
启用用于解析 ThingWorx Platform 端点的服务发现。
TWX_PLATFORM_TLS_ENABLED
false
指示是使用安全 WebSocket (wss) 还是非安全 WebSocket (ws) 连接到 ThingWorx Platform。
TWX_PLATFORM_TRANSPORT
WEBSOCKETS_ACTIVE_ACTIVE
用于向 ThingWorx Platform 发送消息/从中接收消息的传输。websockets websockets_active_active
LOG_LEVEL
信息
root 记录器的日志级别。
CXSERVER_THING_NAME
未设置默认值
Connection Server 将要绑定的事物名称。如果未指定,则 Connection Server 将使用 "AlwaysOn-cxserver-{UUID}" 格式与随机 UUID 进行绑定。
CXSERVER_SSL_ENABLED
false
用于为 Connection Server 启用 SSL 的标志。
SERVICE_DISCOVERY_ENDPOINT
未设置默认值
服务发现的 Zookeeper 地址。例如:zookeeper:2821
为 SSL 配置 CXServer Docker 镜像
可以将以下可选变量添加到此文件的 environment 部分,以为 SSL 配置 Connection Server。
变量名称
映像默认值
备注
CXSERVER_SSL_CLIENT_AUTH_MODE
客户端授权模式。
CXSERVER_SSL_KEYSTORE_LOCATION
/certs/connectionserver.p12
Connection Server KeyStore 的路径。
CXSERVER_SSL_KEYSTORE_PASSWORD
ptcptc
Connection Server KeyStore 的密码。
CXSERVER_SSL_TRUSTSTORE_LOCATION
未设置默认值
Connection Server TrustStore 的路径。例如:/certs/connectionserver-truststore.p12
如果未设置任何值,则默认的信任存储即 Java 分布中的 cacerts 文件。
CXSERVER_SSL_TRUSTSTORE_PASSWORD
未设置默认值
Connection Server KeyStore 的密码。
APP_XOPTS
未设置默认值
可为 Zookeeper SASL 身份验证传递的额外标志。
CXSERVER_HTTPS_ACTIVE
true
为连接服务器启用 HTTPS
CXSERVER_SASL_ENABLED
false
用于为 Connection Server 启用 SASL 的标志。
CXSERVER_SASL_KRB5_CONF_FILE
/tmp/krb5.conf
krb5 配置文件的路径。
CXSERVER_SASL_JAAS_FILE
/tmp/jaas.conf
jaas 配置文件的路径。
CXSERVER_VERIFY_HOST
true
用于启用通过 TLS 连接到 ThingWorx 时进行主机名验证的标志。
这对您有帮助吗?