建構及配置 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 映像
您可以針對容器組態使用下列環境變數。這些環境變數可在 example/docker-compose.yml 檔案中使用,其包含在 DockerFile 下載或 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/從 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
要針對 ThingWorx 的 TLS 連線啟用主機名稱驗證的旗標。
這是否有幫助?