物聯(lián)網(wǎng)后端數(shù)據(jù)可視化消息隊(duì)列【免費(fèi)下載鏈接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.項(xiàng)目地址https://gitcode.com/GitHub_Trending/th/thingsboard點(diǎn)擊查看免費(fèi)下載導(dǎo)讀本文以 ThingsBoard 倉(cāng)庫(kù)中msa/black-box-tests模塊為對(duì)象系統(tǒng)講解其黑盒Black Box測(cè)試套件的運(yùn)行機(jī)制與實(shí)操方法。該套件會(huì)拉取一個(gè)完整的 Docker Compose 微服務(wù)棧在真實(shí)運(yùn)行中的 ThingsBoard 集群上驗(yàn)證 MQTT / CoAP / HTTP / LwM2M / SNMP 傳輸層連通性、各類外部集成AWS IoT、Azure IoT Hub、OPC UA 等、Web UI 冒煙用例與 EDQS / 報(bào)表 / Trendz 等子服務(wù)是倉(cāng)庫(kù)提交合入前最重要的端到端回歸防線。讀完本文你將掌握如何構(gòu)建本地鏡像、如何用一條 Maven 命令在 Valkey 單機(jī) / 集群 / 哨兵 / TLS 與 PostgreSQL、Cassandra 混合模式等不同拓?fù)渖吓芡ㄈ亢诤袦y(cè)試?yán)斫?Compose 棧的自動(dòng)克隆與緩存機(jī)制、無(wú) License 的 Keyless 運(yùn)行方式以及如何在本地環(huán)境或 IDE 中單獨(dú)調(diào)試某一條測(cè)試用例。一、模塊定位它在測(cè)什么msa/black-box-tests是 ThingsBoard 頂層多模塊 Maven 工程中的一個(gè)測(cè)試模塊其pom.xml中聲明為org.thingsboard.msa:black-box-tests描述為 “Project for ThingsBoard black box testing with using Docker”模塊 pom。它的測(cè)試代碼全部位于src/test下主要覆蓋以下幾類場(chǎng)景測(cè)試類別源碼包路徑覆蓋內(nèi)容傳輸層連通性org.thingsboard.server.msa.connectivityMQTT / CoAP / HTTP / LwM2M 客戶端上報(bào)遙測(cè)、屬性訂閱、RPC 雙向通信、網(wǎng)關(guān)接入、LwM2M 安全NoSec / PSK與觀察訂閱Observe外部集成org.thingsboard.server.msa.integrationAWS IoT、Azure IoT Hub、Azure Event Hub、Azure Service Bus、OPC UA、MQTT、HTTP、TCP、UDP、CoAP、LoRaChirpStack / KPN / Loriot / ThingPark等集成節(jié)點(diǎn)數(shù)據(jù)服務(wù)org.thingsboard.server.msa.edqs、cf、reportEDQS 實(shí)體數(shù)據(jù)查詢、計(jì)算字段Calculated Field、報(bào)表服務(wù)規(guī)則與安全org.thingsboard.server.msa.rule.node、securityMQTT 規(guī)則節(jié)點(diǎn)、JS Executor 沙箱隔離UI 冒煙o(wú)rg.thingsboard.server.msa.ui.tests設(shè)備 / 客戶 / 規(guī)則鏈 / 設(shè)備配置檔 / 資產(chǎn)配置檔 / 告警指派 / 解決方案模板安裝等 Web UI 操作附加服務(wù)org.thingsboard.server.msa.trendzTrendz 報(bào)表分析與普通單元測(cè)試不同這套測(cè)試不 mock 任何服務(wù)端組件AbstractContainerTest的BeforeSuite會(huì)先通過(guò)ContainerTestSuite.start()把整套微服務(wù)用 Docker Compose 拉起再用真實(shí)的設(shè)備端客戶端如netty-mqtt、californium的 CoAP 客戶端、leshan的 LwM2M 客戶端、HiveMQ MQTT 客戶端和 REST / WebSocket 客戶端去訪問(wèn)真實(shí)運(yùn)行的集群參見(jiàn) AbstractContainerTest.java。二、前置條件構(gòu)建本地鏡像與拉取輔助鏡像黑盒測(cè)試運(yùn)行前必須先保證本機(jī) Docker 中具備 ThingsBoard 各微服務(wù)的本地鏡像。2.1 構(gòu)建本地 Docker 鏡像在倉(cāng)庫(kù)根目錄即 ThingsBoard 主pom.xml所在目錄執(zhí)行mvn clean install -Ddockerfile.skipfalse該命令會(huì)為msa下的各個(gè)子模塊構(gòu)建鏡像。構(gòu)建完成后用以下命令核對(duì)鏡像是否齊全docker image lsREPOSITORY列中應(yīng)當(dāng)出現(xiàn)以下 11 個(gè)鏡像與 README 列出的清單一致thingsboard/tb-coap-transport thingsboard/tb-lwm2m-transport thingsboard/tb-http-transport thingsboard/tb-mqtt-transport thingsboard/tb-snmp-transport thingsboard/tb-node thingsboard/tb-web-ui thingsboard/tb-js-executor thingsboard/tb-web-report thingsboard/tb-http-integration thingsboard/tb-mqtt-integration注意tb-node等鏡像在測(cè)試啟動(dòng)時(shí)會(huì)被DockerComposeContainer以.withPull(false)方式直接復(fù)用本地鏡像見(jiàn) ContainerTestSuite.java因此未構(gòu)建的鏡像不會(huì)自動(dòng)從遠(yuǎn)端拉取缺少任何一個(gè)都會(huì)導(dǎo)致套件啟動(dòng)失敗。2.2 拉取輔助測(cè)試鏡像部分集成測(cè)試還需要額外的第三方鏡像MQTT 集成測(cè)試需要 Eclipse Mosquitto 作為外部 MQTT Brokerdocker pull eclipse-mosquittoOPC UA 集成測(cè)試需要微軟官方的 OPC 模擬 PLCdocker pull mcr.microsoft.com/iotedge/opc-plc:2.8.5這些輔助服務(wù)在測(cè)試時(shí)通過(guò)src/test/resources下的額外 Compose 文件引入例如 docker-compose.mosquitto.yml 與 docker-compose.opc-ua.yml。三、Compose 棧的來(lái)源自動(dòng)克隆與本地緩存機(jī)制黑盒測(cè)試不是直接用倉(cāng)庫(kù)內(nèi)的 Compose 文件而是克隆一個(gè)獨(dú)立的 Compose 倉(cāng)庫(kù) —— ThingsBoard PE Docker Compose 倉(cāng)庫(kù)然后按固定的分支檢查出來(lái)運(yùn)行。整套克隆、緩存與校驗(yàn)邏輯封裝在 ComposeRepository.java 中。3.1 分支釘扎tb.compose.refCompose 棧要使用哪個(gè)分支由 Maven 屬性tb.compose.ref決定。該屬性定義在 msa/black-box-tests/pom.xmltb.compose.refrelease-4.3.1.4/tb.compose.refpom.xml中的注釋說(shuō)明該分支是發(fā)布時(shí)手工更新釘扎的當(dāng)前指向release-4.3.1.4ContainerTestSuite已對(duì) .env 中的 13 個(gè)鏡像名做了改寫(xiě)以適配 4.4 鏡像樹(shù)。Maven 通過(guò) surefire 的systemPropertyVariables把它傳給測(cè)試 JVM見(jiàn) pom 中black-box-testsprofile 配置。在 Maven 內(nèi)運(yùn)行無(wú)需關(guān)心tb.compose.ref自動(dòng)生效在 Maven 之外運(yùn)行如 IDE 直接跑 TestNG必須顯式傳入-Dtb.compose.refbranch否則ComposeRepository.pinnedRef()會(huì)拋出 “System property tb.compose.ref is not set” 的 IllegalStateException。3.2 倉(cāng)庫(kù)可替換tb.compose.repository默認(rèn)克隆的是官方 Compose 倉(cāng)庫(kù)如果你想用 fork 或本地鏡像倉(cāng)庫(kù)可傳入-Dtb.compose.repositoryurl3.3 緩存目錄與倉(cāng)庫(kù)指紋Compose 倉(cāng)庫(kù)被克隆到用戶級(jí)緩存目錄~/.cache/thingsboard/compose-branch-repository hash分支ref.replace(/, _)后的分支名倉(cāng)庫(kù)指紋對(duì)倉(cāng)庫(kù) URL 取 SHA-256 摘要的前 4 字節(jié)8 個(gè)十六進(jìn)制字符。指紋的存在使得不同來(lái)源的緩存互不復(fù)用ComposeRepository.refresh()會(huì)讀取緩存.git目錄中記錄倉(cāng)庫(kù)來(lái)源的 marker 文件tb-compose-repository如果 marker 與本次配置的倉(cāng)庫(kù)不一致緩存會(huì)被先丟棄、再重新克隆—— 這樣跑 fork 的測(cè)試絕不會(huì)靜默復(fù)用默認(rèn)倉(cāng)庫(kù)的 Compose 棧。緩存目錄也可以用-Dtb.compose.cacheDirpath顯式覆蓋。但即便覆蓋了路徑marker 校驗(yàn)依然生效一個(gè)來(lái)自其他倉(cāng)庫(kù)的緩存即使放在cacheDir指定的目錄下該目錄名本身不攜帶倉(cāng)庫(kù)信息也會(huì)被丟棄重克隆。3.4 克隆策略與失敗語(yǔ)義使用 JGit 做shallow 克隆depth 1只拉取釘扎分支的單個(gè) commit不拉 tagComposeRepository.java 中的cloneShallow傳輸超時(shí)設(shè)為 60 秒防止網(wǎng)絡(luò)黑洞導(dǎo)致套件無(wú)限掛起克隆前會(huì)先lsRemote校驗(yàn)釘扎分支確實(shí)存在于遠(yuǎn)端若遠(yuǎn)端明確拒絕倉(cāng)庫(kù)不存在 / 憑據(jù)被拒直接判失敗若僅是無(wú)法連通則允許回退使用已有緩存緩存會(huì)被先丟棄再克隆一旦克隆失敗不會(huì)回退到舊緩存而是整次運(yùn)行報(bào)錯(cuò)避免靜默使用錯(cuò)誤來(lái)源的 Compose 棧。3.5 并發(fā)保護(hù)與舊緩存清理checkout()通過(guò)目標(biāo)緩存目錄旁的*.lock文件獲取進(jìn)程級(jí)文件鎖FileLock保證并發(fā)運(yùn)行時(shí)不會(huì)出現(xiàn)“一個(gè)進(jìn)程在 reset 緩存、另一個(gè)進(jìn)程正在拷貝工作樹(shù)”的競(jìng)態(tài)。需要特別留意的是緩存目錄名帶上了倉(cāng)庫(kù)指紋新增行為。早期運(yùn)行留下的無(wú)后綴目錄~/.cache/thingsboard/compose-branch不會(huì)再被使用也不會(huì)被自動(dòng)清理。README 明確建議手動(dòng)刪除一次這些無(wú)后綴的舊目錄。四、Keyless 模式免 License 運(yùn)行整套微服務(wù)黑盒套件不需要任何 ThingsBoard 商業(yè)版 License。ContainerTestSuite.start()在啟動(dòng)前會(huì)改寫(xiě)tb-node.env將TB_LICENSE_SECRETYOUR_LICENSE_KEY_HERE替換為空值TB_LICENSE_SECRET采用“驗(yàn)證式替換”若替換不成功會(huì)直接 fail 而不會(huì)靜默放過(guò)見(jiàn) ContainerTestSuite.java 中帶verifyPhrase的replaceInFile追加NON_PRODUCTION_USEtrue。在這種 Keyless 模式下無(wú)需License Key、Cluster ID 或 License Server功能面基本完整唯一例外是白標(biāo)white-labeling與 Trendz 的高級(jí)能力不可用平臺(tái)會(huì)按“開(kāi)發(fā)部署”對(duì)待因此測(cè)試生成的每一份報(bào)表第一行都會(huì)帶有 non-production非生產(chǎn)提示。五、運(yùn)行黑盒測(cè)試各種拓?fù)涞?Maven 命令所有運(yùn)行命令都在msa/black-box-tests目錄下執(zhí)行核心開(kāi)關(guān)是-DblackBoxTests.skipfalse它激活pom.xml中的black-box-testsprofile默認(rèn)的do-nothingprofile 會(huì)讓 surefire 直接跳過(guò)測(cè)試同時(shí)通過(guò)skipTests${blackBoxTests.skip}/skipTests關(guān)掉跳過(guò)邏輯并按src/test/resources/${suite}.xml加載對(duì)應(yīng)的 TestNG 套件。5.1 Valkey 獨(dú)立單機(jī)默認(rèn)不帶 UI 測(cè)試mvn clean install -DblackBoxTests.skipfalse默認(rèn)suite屬性值為black-box加載 black-box.xml運(yùn)行connectivity、integration、edqs、cf、rule.node、report、security、trendz全部后端包但不跑 UI。5.2 Valkey 獨(dú)立單機(jī) TLSmvn clean install -DblackBoxTests.skipfalse -DblackBoxTests.redisSsltrue套件會(huì)啟用 docker-compose.valkey-ssl.yml 與docker-compose.valkey-ssl.volumes.yml并向cache-valkey.env注入TB_REDIS_SSL_ENABLEDtrue與TB_REDIS_SSL_PEM_CERT/valkey/certs/valkeyCA.crt。測(cè)試用的 CA 證書(shū)、服務(wù)端證書(shū)與私鑰預(yù)置于 valkey-certs 目錄。5.3 Valkey 集群mvn clean install -DblackBoxTests.skipfalse -DblackBoxTests.redisClustertrue啟用docker-compose.valkey-cluster.yml并創(chuàng)建 6 個(gè)節(jié)點(diǎn)valkey-node-0至valkey-node-5各自的數(shù)據(jù)卷VALKEY_CLUSTER_DATA_VOLUME_0..5。5.4 Valkey 哨兵mvn clean install -DblackBoxTests.skipfalse -DblackBoxTests.redisSentineltrue啟用docker-compose.valkey-sentinel.yml創(chuàng)建 primary / replica / sentinel 三組獨(dú)立數(shù)據(jù)卷。5.5 Hybrid 模式PostgreSQL Cassandramvn clean install -DblackBoxTests.skipfalse -DblackBoxTests.hybridModetrue啟用advanced/docker-compose.hybrid.yml與 docker-compose.hybrid-test-extras.yml并追加 Cassandra 數(shù)據(jù)卷。注意ContainerTestSuite.start()中有硬校驗(yàn)blackBoxTests.citus與blackBoxTests.hybridMode互斥同時(shí)開(kāi)啟會(huì)拋出IllegalStateExceptionCitus 是分布式 PostgreSQL 布局不能與 Cassandra 混合模式同跑。5.6 啟用集成測(cè)試mvn clean install -DblackBoxTests.skipfalse -DblackBoxTests.integrations.skipfalse默認(rèn)black-box套件本身已包含integration包該開(kāi)關(guān)用于顯式保證集成用例不被跳過(guò)。運(yùn)行時(shí)額外拉起 docker-compose.integration.yml。5.7 參數(shù)速查表系統(tǒng)屬性取值作用blackBoxTests.skipfalse激活 black-box-tests profile 并真正執(zhí)行測(cè)試blackBoxTests.redisSsltrueValkey TLS 模式blackBoxTests.redisClustertrueValkey 6 節(jié)點(diǎn)集群模式blackBoxTests.redisSentineltrueValkey 哨兵模式blackBoxTests.hybridModetruePostgreSQL Cassandra 混合模式blackBoxTests.citustrue分布式 PostgreSQLCitus模式與 hybridMode 互斥blackBoxTests.integrations.skipfalse確保集成測(cè)試執(zhí)行blackBoxTests.queuekafka默認(rèn)隊(duì)列實(shí)現(xiàn)非 kafka 時(shí)AbstractContainerTest會(huì)把超時(shí)系數(shù)放大 10 倍blackBoxTests.skipTailChildContainerstrue跳過(guò)對(duì)子容器日志的 tail加快清理suite見(jiàn)下表選擇要執(zhí)行的 TestNG 套件 XMLtb.compose.ref分支名釘扎 Compose 倉(cāng)庫(kù)分支tb.compose.repository倉(cāng)庫(kù) URL替換 Compose 倉(cāng)庫(kù)來(lái)源tb.compose.cacheDir目錄路徑覆蓋 Compose 緩存目錄runLocaltrue跳過(guò)容器啟動(dòng)改用本地已運(yùn)行的實(shí)例5.8 隊(duì)列與超時(shí)說(shuō)明從源碼看AbstractContainerTest.beforeSuite()會(huì)讀取blackBoxTests.queue默認(rèn)kafkaContainerTestSuite啟動(dòng)時(shí)也通過(guò)withEnv(TB_QUEUE_TYPE, kafka)強(qiáng)制 Kafka若檢測(cè)到隊(duì)列不是 Kafka例如使用內(nèi)存隊(duì)列所有等待超時(shí)都會(huì)乘以 10 倍系數(shù)AbstractContainerTest.java因?yàn)榉?Kafka 隊(duì)列下事件流轉(zhuǎn)顯著變慢。六、云端集成測(cè)試的 VM Options運(yùn)行 AWS / Azure 相關(guān)集成測(cè)試時(shí)需要提供真實(shí)云資源的憑據(jù)通過(guò) JVM 系統(tǒng)屬性傳入6.1 AWS IoT-DblackBoxTests.aws.endpointYOUR_AWS_CLIENT_ENDPOINT -DblackBoxTests.aws.rootCAPATH_TO_ROOT_CA_PEM -DblackBoxTests.aws.certPATH_TO_CERT -DblackBoxTests.aws.privateKeyPATH_TO_PRIVATE_KEY對(duì)應(yīng)的AwsIotIntegrationTest位于org.thingsboard.server.msa.integration包依賴aws-iot-device-sdk-java。6.2 Azure IoT Hub-DblackBoxTests.azureIotHubHostNameYOUR_HOST_NAME -DblackBoxTests.azureIotHubDeviceIdYOUR_DEVICE_ID -DblackBoxTests.azureIotHubSasKeyYOUR_SAS_KEY -DblackBoxTests.azureIotHubConnectionStringYOUR_CONNECTION_STRING6.3 Azure Event Hub-DblackBoxTests.azureEventHubConnectionStringYOUR_CONNECTION_STRING6.4 Azure Service Bus-DblackBoxTests.azureServiceBusConnectionStringYOUR_CONNECTION_STRING -DblackBoxTests.azureServiceBusTopicNameYOUR_TOPIC_NAME -DblackBoxTests.azureServiceBusSubNameYOUR_SUB_NAME -DblackBoxTests.azureServiceBusDownlinkConnectionStringYOUR_CONNECTION_STRING -DblackBoxTests.azureServiceBusDownlinkTopicNameYOUR_TOPIC_NAME -DblackBoxTests.azureServiceBusDownlinkSubNameYOUR_SUB_NAME帶Downlink的選項(xiàng)用于下行平臺(tái) → 云端方向的消息訂閱配置。以上參數(shù)在對(duì)應(yīng)測(cè)試類AwsIotIntegrationTest、AzureIotHubIntegrationTest、AzureEventHubIntegrationTest、AzureServiceBusIntegrationTest中通過(guò)System.getProperty讀取未配置時(shí)會(huì)直接報(bào)錯(cuò)因此這些測(cè)試默認(rèn)需要真實(shí)云環(huán)境才能通過(guò)。七、指定套件運(yùn)行TestNG Suite 選擇器通過(guò)-Dsuitename可以只跑某類測(cè)試對(duì)應(yīng)關(guān)系如下-Dsuite取值加載的 XML運(yùn)行內(nèi)容black-box默認(rèn)black-box.xml全部后端包c(diǎn)onnectivity / integration / edqs / cf / rule.node / report / security / trendzintegrationsintegration.xml僅集成測(cè)試connectivityconnectivity.xml僅傳輸層連通性測(cè)試uiTestsuiTests.xml全部 UI 冒煙組smokesRuleChainsmokesRuleChain.xml僅規(guī)則鏈 UI 冒煙smokesCustomersmokesCustomer.xml僅客戶 UI 冒煙smokesPrifilessmokesProfiles.xml設(shè)備配置檔 資產(chǎn)配置檔 UI 冒煙注意 README 原文中的拼寫(xiě)為smokesPrifiles實(shí)際對(duì)應(yīng)的 XML 文件為smokesProfiles.xmlallall.xml黑盒測(cè)試 全部 UI 冒煙組最全量例如只跑連通性測(cè)試mvn clean install -DblackBoxTests.skipfalse -Dsuiteconnectivity只跑全部 UI 測(cè)試mvn clean install -DblackBoxTests.skipfalse -DsuiteuiTests全量運(yùn)行黑盒 UImvn clean install -DblackBoxTests.skipfalse -Dsuiteall從 all.xml 可以看到全量模式會(huì)依次執(zhí)行黑盒后端包、規(guī)則鏈 / 客戶 / 設(shè)備配置檔 / 資產(chǎn)配置檔 / 設(shè)備 / 告警指派 / 解決方案模板安裝等 7 組 UI 冒煙。UI 套件還注冊(cè)了RetryTestListener失敗重試監(jiān)聽(tīng)器見(jiàn)ui.listeners包所有 UI 用例均排除broken分組。八、本地環(huán)境運(yùn)行跳過(guò)容器啟動(dòng)如果本機(jī)已經(jīng)有一套 ThingsBoard 在運(yùn)行例如本地開(kāi)發(fā)服務(wù)器 tb-web-ui可以用runLocal跳過(guò) Docker 容器啟動(dòng)mvn clean install -DblackBoxTests.skipfalse -DrunLocaltrue此時(shí)AbstractContainerTest.beforeSuite()不會(huì)調(diào)用containerTestSuite.start()測(cè)試改為訪問(wèn)本地實(shí)例各端點(diǎn)由TestProperties提供默認(rèn)值TestProperties.java端點(diǎn)容器模式本地模式默認(rèn)值可用屬性覆蓋REST 基址https://localhosttb.baseUrl→http://localhost:8080UI 基址https://haproxyCompose 網(wǎng)絡(luò)內(nèi)直連負(fù)載均衡器tb.baseUiUrl→http://localhost:8080WebSocketwss://localhosttb.wsUrl→ws://localhost:8080遠(yuǎn)端 HTTP 集成由 testcontainers 動(dòng)態(tài)映射remote.httpUrl→http://localhost:8082集成執(zhí)行器由 testcontainers 動(dòng)態(tài)映射integrationExecutor.httpUrl→http://localhost:8082MQTT Brokertcp://映射主機(jī):1883mqtt.broker→tcp://localhost:1883遠(yuǎn)端 CoAPlocalhost:15683remote.coap.host/port→localhost:15683注意本地模式下各 REST 客戶端仍會(huì)以sysadminthingsboard.org / sysadmin登錄并調(diào)用ensureSystemSetup完成系統(tǒng)初始化因此本地實(shí)例需要具備默認(rèn)系統(tǒng)管理員賬號(hào)。九、在 IDE 中單獨(dú)手動(dòng)運(yùn)行一條測(cè)試針對(duì)“只跑某一條用例”的調(diào)試場(chǎng)景README 給出了三條步驟將 black-box-tests 加入 Maven 工程在 msa/pom.xml 的modules中加入 black-box-tests 模塊或在 IDE 中把它作為獨(dú)立的 Maven 工程導(dǎo)入配置 TestNG 模板的 VM Options在 IDE 的 “Run” → “Edit Configuration” → “Edit Configuration Templates” → “TestNG” 中添加-DrunLocaltrue -Dtb.baseUiUrlhttp://localhost:4200/即要求測(cè)試訪問(wèn)本地正在開(kāi)發(fā)調(diào)試的 UIAngular dev server 默認(rèn)端口 4200運(yùn)行具體用例定位到 UI 測(cè)試包 下的某個(gè)測(cè)試類直接運(yùn)行或者到 src/test/resources 目錄右鍵運(yùn)行所需的測(cè)試套件 XML如smokesRuleChain.xml。若要在 IDE 中以“容器模式”單跑某條后端用例則無(wú)需runLocal但要補(bǔ)上-Dtb.compose.refbranch見(jiàn) 3.1 節(jié)因?yàn)槿萜髂Ｊ较?JGit 克隆 Compose 倉(cāng)庫(kù)必須知道釘扎分支。十、啟動(dòng)與清理背后的機(jī)制10.1 容器啟動(dòng)編排ContainerTestSuite.start()源碼的啟動(dòng)流程可以概括為從ComposeRepository.checkout()拿到緩存工作樹(shù)拷貝到臨時(shí)目錄ContainerTestSuite-UUID改寫(xiě).env把鏡像名從tb-pe-*批量替換為tb-*因?yàn)楫?dāng)前釘扎的 Compose 分支仍沿用tb-pe-*舊命名這是該分支與 4.4 分支的唯一差異升級(jí)到新分支后此步自動(dòng)變?yōu)榭詹僮饕瞥齛dvanced/docker-compose.yml中的container_name配置testcontainers 對(duì)含container_name的 Compose 文件不支持會(huì)拋IllegalStateException見(jiàn)源碼中引用的 testcontainers issue #2472 的 workaround把src/test/resources整體拷入目標(biāo)目錄作為覆蓋層注入 Kafka 隊(duì)列前綴TB_QUEUE_PREFIXtest、強(qiáng)制TB_QUEUE_TYPEkafka應(yīng)用 Keyless 配置見(jiàn)第四節(jié)按運(yùn)行模式拼接一份 Compose 文件清單最多十幾份見(jiàn)源碼中的composeFiles列表調(diào)用TestUtils.addComposeVersion統(tǒng)一補(bǔ)上version: 3.0用 testcontainers 的DockerComposeContainer啟動(dòng).withPull(false).withLocalCompose(true).withOptions(--compatibility)通過(guò)日志正則等待確認(rèn)每個(gè)服務(wù)就緒等待超時(shí)統(tǒng)一為 400 秒例如tb-core1/tb-core2等待.*Starting polling for events.*各傳輸層等待.*Going to recalculate partitions.*集成服務(wù)等待.*Sending a connect request to the TB!.*tb-js-executor等待.*template started.*tb-edqs1/2等待.*All partitions processed.*對(duì)外暴露關(guān)鍵服務(wù)haproxy:80HTTP 探活路徑/swagger-ui.html、tb-http-integration:8082、tb-integration-executor1:8082、tb-mqtt-integration:8082、broker:1883Mosquitto。10.2 數(shù)據(jù)庫(kù)初始化啟動(dòng)容器之前ThingsBoardDbInstaller.createVolumes()會(huì)先為 PostgreSQL / Cassandra / Valkey / 各服務(wù)日志卷批量創(chuàng)建命名卷卷名帶隨機(jī) project 前綴然后按順序執(zhí)行docker compose up -d postgres [valkey ...]只拉起數(shù)據(jù)庫(kù)docker compose run --no-deps --rm -e INSTALL_TBtrue tb-core1完成 ThingsBoard 數(shù)據(jù)庫(kù)初始化docker compose run --no-deps --rm trendz-db-init與-e INSTALL_TRENDZtrue trendz完成 Trendz 初始化。所有初始化命令在finally塊中都會(huì)down -v回收避免殘留。10.3 日志收集與卷清理每次運(yùn)行結(jié)束無(wú)論成敗ThingsBoardDbInstaller.saveLogsAndRemoveVolumes()會(huì)把各服務(wù)日志卷的內(nèi)容用臨時(shí) alpine 容器docker cp到模塊的./target/下例如./target/tb-logs/ tb-node / tb-core / tb-rule-engine 等主日志 ./target/tb-coap-transport-logs/ ./target/tb-lwm2m-transport-logs/ ./target/tb-http-transport-logs/ ./target/tb-mqtt-transport-logs/ ./target/tb-snmp-transport-logs/ ./target/tb-vc-executor-logs/ ./target/tb-http_integration-logs/ ./target/tb-mqtt_integration-logs/ ./target/tb-coap_integration-logs/ ./target/tb-tcp_integration-logs/ ./target/tb-udp_integration-logs/ ./target/tb-integration-executor-logs/ ./target/tb-edqs-logs/ ./target/tb-report-logs/ ./target/trendz-logs/隨后刪除本次運(yùn)行創(chuàng)建的全部數(shù)據(jù)卷。這套 teardown 由AfterSuite(alwaysRun true)保證即使BeforeSuite啟動(dòng)失敗也會(huì)執(zhí)行參見(jiàn) AbstractContainerTest.java 中的注釋與ContainerTestSuite中“先置 active 標(biāo)記再創(chuàng)建卷”的設(shè)計(jì)。10.4 測(cè)試報(bào)告模塊集成了 Allurepom.xml的black-box-testsprofile 中配置了allure-maven插件報(bào)告版本由allure-testng.version驅(qū)動(dòng)讀取 allure.properties。測(cè)試類通過(guò)Listeners注冊(cè)了TestListener與 UI 的RetryTestListener/RetryAnalyzer失敗重試與截圖等行為都經(jīng)由這些監(jiān)聽(tīng)器實(shí)現(xiàn)。十一、常見(jiàn)問(wèn)題與注意事項(xiàng)鏡像缺失導(dǎo)致啟動(dòng)失敗任何thingsboard/*鏡像未構(gòu)建Compose 啟動(dòng)即失敗。請(qǐng)先回到倉(cāng)庫(kù)根目錄執(zhí)行mvn clean install -Ddockerfile.skipfalse并docker image ls核對(duì) 11 個(gè)鏡像。緩存來(lái)源不匹配跑過(guò) fork 后再跑官方倉(cāng)庫(kù)或反之緩存會(huì)被丟棄并重新克隆這是預(yù)期行為網(wǎng)絡(luò)不通時(shí)這種“先刪后克隆”會(huì)直接報(bào)錯(cuò)而不會(huì)靜默回退。舊緩存殘留~(yú)/.cache/thingsboard/compose-branch無(wú)指紋后綴是歷史版本遺留建議手動(dòng)刪除一次。IDE 運(yùn)行報(bào)tb.compose.ref未設(shè)置容器模式下必須顯式傳入-Dtb.compose.refbranch本地模式可傳-DrunLocaltrue跳過(guò)。云端集成測(cè)試失敗AWS / Azure 類用例需要真實(shí)憑據(jù)未配置參數(shù)會(huì)直接報(bào)錯(cuò)本地?zé)o云資源時(shí)建議用-Dsuiteconnectivity只跑連通性用例。Citus 與 Hybrid 互斥blackBoxTests.citus與blackBoxTests.hybridMode同時(shí)開(kāi)啟會(huì)拋出異常二者只能選一。Keyless 模式特性限制無(wú) License 運(yùn)行時(shí)白標(biāo)與 Trendz 完整功能不可用所有報(bào)表會(huì)帶 non-production 首行提示。十二、源碼閱讀指引若希望深入理解本套件建議按以下路徑閱讀README本文所依據(jù)的官方執(zhí)行文檔模塊 pom.xmltb.compose.ref屬性、do-nothing/black-box-testsprofile、suite XML 裝配邏輯ContainerTestSuite.java容器編排、鏡像名改寫(xiě)、Keyless 注入、日志等待正則、各模式 Compose 文件選擇ComposeRepository.javaJGit 克隆、緩存指紋、marker 校驗(yàn)、文件鎖、傳輸超時(shí)與失敗語(yǔ)義ThingsBoardDbInstaller.java數(shù)據(jù)卷創(chuàng)建、數(shù)據(jù)庫(kù)初始化、日志導(dǎo)出與卷清理TestProperties.java容器模式 / 本地模式端點(diǎn)解析AbstractContainerTest.javaBeforeSuite/AfterSuite生命周期、REST / WebSocket 測(cè)試基座測(cè)試套件 XMLblack-box.xml、all.xml 等測(cè)試用例包c(diǎn)onnectivity 傳輸層、integration 集成、UI 冒煙。結(jié)語(yǔ)msa/black-box-tests是 ThingsBoard 工程里最接近真實(shí)生產(chǎn)形態(tài)的回歸測(cè)試層它通過(guò)自動(dòng)克隆 Compose 棧、Keyless 免 License 啟動(dòng)整套微服務(wù)、以真實(shí)設(shè)備協(xié)議客戶端端到端驗(yàn)證傳輸與集成鏈路并提供從“全量黑盒”到“單條 UI 用例”的多級(jí)運(yùn)行粒度。結(jié)合本文的 Maven 命令、參數(shù)速查表與源碼路徑你可以按需在本機(jī)復(fù)現(xiàn)這套驗(yàn)證體系或基于本地實(shí)例快速調(diào)試單條用例。贊分享物聯(lián)網(wǎng)后端數(shù)據(jù)可視化消息隊(duì)列【免費(fèi)下載鏈接】thingsboardAll-in-one IoT Platform - Device management, data collection, processing and visualization.項(xiàng)目地址https://gitcode.com/GitHub_Trending/th/thingsboard點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Presto 產(chǎn)品測(cè)試Product Tests完全指南基于 Docker 與 Tempto 的端到端正確性驗(yàn)證Presto 產(chǎn)品測(cè)試Product Tests完全指南基于 Docker 與 Tempto 的端到端正確性驗(yàn)證 本指南以 Presto 倉(cāng)庫(kù)中的 pre大數(shù)據(jù)數(shù)據(jù)庫(kù)后端gunicorn Docker 集成測(cè)試實(shí)戰(zhàn)指南tests/docker 端到端測(cè)試套件全解析gunicorn Docker 集成測(cè)試實(shí)戰(zhàn)指南tests/docker 端到端測(cè)試套件全解析 導(dǎo)讀 gunicorn 的核心價(jià)值在于進(jìn)程管理、多 worke后端RustFS 三站點(diǎn) Site Replication 本地驗(yàn)證指南基于 Docker Compose 的端到端測(cè)試全流程RustFS 三站點(diǎn) Site Replication 本地驗(yàn)證指南基于 Docker Compose 的端到端測(cè)試全流程 導(dǎo)讀 本指南圍繞 RustFS 倉(cāng)后端對(duì)象存儲(chǔ)分布式存儲(chǔ)上一篇【親測(cè)免費(fèi)】 BiliBili-UWP開(kāi)源項(xiàng)目常見(jiàn)問(wèn)題解決方案下一篇CodeXGLUE 項(xiàng)目常見(jiàn)問(wèn)題解決方案創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考