服務脈搏

服務脈搏

ServicePulse 為分散式應用程式提供即時生產監控。它監視系統端點的運作狀況，偵測處理錯誤，發送失敗訊息進行重新處理，並確保滿足特定環境的需求，所有這些都在一個整合的儀表板中完成。

ServicePulse 是特定服務平台的一部分，其中包括 NServiceBus 以及用於建置、監控和調試分散式系統的工具。

有關更多信息，請參閱 ServicePulse 文件。

設定開發項目

設定 ServiceControl Main 和 ServiceControl Monitoring 實例

ServicePulse主要呈現ServiceControl和ServiceControl監控實例提供的資料。

這兩個服務的 URL 都可以在src/Frontend/public/js/app.constants.js中設定。

設定套件管理器

ServicePulse 使用 npm 和 Bower 作為套件管理器。為了使解決方案發揮作用，必須在啟動 ServicePulse 網站之前下載依賴項。

安裝依賴項

如果尚未安裝以下依賴項，請安裝它們。

• 適用於 Windows 的 Git
• Node.js
  • 注意：在本機環境中安裝或更新 Node.js 時，最好檢查並確保ci.yml和release.yml工作流程的 Node.js 版本與本地環境的版本相符。尋找步驟name: Set up Node.js

設定開發環境

步驟 0 - 使用合適的 IDE 進行前端開發

儘管 Visual Studio 或 Rider 似乎是適合前端開發的 IDE，但它們對於最新的前端框架、linting 和格式往往不可靠。因此，我們提供了額外的建議來幫助您在前端開發方面取得更大的成功。

第 1 步 - 執行 Vue.js 開發伺服器

導航至ServicePulsesrcFrontend並：

• 執行npm install以安裝所有 npm 依賴項
• 執行以下命令npm run dev （這將在連接埠 5173 上託管一個開發伺服器並開始監視/Frontend目錄中的變更）

如果npm run dev失敗並出現與未正確配置 git 子模組相關的錯誤，請再次執行npm install命令以確保所有必需的依賴項均可用，然後執行npm run dev 。

第 2 步 - 開啟瀏覽器

完成上述步驟後，導覽至 Vue.js 應用程式執行時顯示的 URL 以查看 ServicePulse 應用程式。

運行自動化測試

前端自動化測試利用 Vitest 作為測試框架和測試實用程式的測試庫。 Vitest預設提供兩種模式：開發環境下的watch mode和CI環境下的run mode 。 Watch mode在文件保存後立即重新運行相關測試，在開發過程中提供即時回饋。

在執行測試之前，請確保您已設定開發伺服器。導航至ServicePulsesrcFrontend並執行npm install以安裝所有 npm 依賴項。

運行組件測試

導航至ServicePulsesrcFrontend並運行：

 npm run test:component

此命令運行目錄ServicePulsesrcFrontendsrc及其子目錄中的所有元件測試檔案*.spcs.ts 。啟用watch mode後，它可以實現高效的測試開發，因為只有相關測試才會在文件保存時重新運行。

運行應用程式測試

導航至ServicePulsesrcFrontend並運行：

 npm run test:application

與元件測試類似，此命令運行目錄ServicePulsesrcFrontendtest及其子目錄中的所有應用程式測試檔案*.spcs.ts 。

運行測試覆蓋率

導航至ServicePulsesrcFrontend並運行：

 npm run test:coverage

此命令產生一個報告，指示測試覆蓋的語句、分支、函數和行的百分比。此外，它還可以識別未覆蓋的行號。

提供npm腳本

Vue.js

• dev - 運行vite來啟動開發伺服器對來源檔案進行熱重載
• build - 執行建置腳本，將檔案輸出到..app資料夾
• lint - 使用 eslint 檢查所有 vue、ts 和 js 文件
• type-check - 在無發出模式下執行 TypeScript

維泰斯特

• test:application - 執行位於Frontend/test資料夾中的所有應用程式測試。
• test:component - 執行測試位於Frontend/src資料夾和任何子目錄中的所有元件測試。
• test:coverage - 對vitest.config.ts中定義的檔案執行測試覆蓋率報告

從 ServicePulse.Host.exe 執行

可以透過ServicePulse.Host.exe直接運行 ServicePulse。

步驟 1 - 保留 URL ACL

ServicePulse.Host.exe 依賴自架 Web 伺服器。在專案運行之前，必須設定 URL ACL 預留。使用管理權限執行 Visual Studio 或執行下列命令來新增所需的 URL ACL 預留：

add urlacl url=URL

其中URL是本機上配置的 URL。

步驟 2 - 建置 ServicePulse 站點

從命令列執行建置腳本：

 PowerShell -File .build.ps1

筆記

可能需要使用Set-ExecutionPolicy Unrestricted -scope UserPolicy更改 PowerShell 執行策略

步驟 3 - 執行ServicePulse.Host.exe

在 IDE 中建置並執行ServicePulse.Host專案。

支援的瀏覽器版本

以下桌面瀏覽器版本支援 ServicePulse：

• Chrome 最新主要版本
• Edge 與 EdgeHTML v17+
• Firefox ESR 目前版本
• Safari 最新主要版本

容器鏡像開發

ServicePulse 的 Dockerfile 位於src/ServicePulse資料夾中。容器鏡像都是作為發布工作流程的一部分建構的，並暫存在 Github 容器註冊表中。對於有 PR 的分支，圖像將標有 PR 編號，例如pr-1234 。