サービスパルス

サービスパルス

ServicePulse は、分散アプリケーションのリアルタイムの運用監視を提供します。システムのエンドポイントの健全性を監視し、処理エラーを検出し、再処理のために失敗したメッセージを送信し、特定の環境のニーズが満たされていることをすべて 1 つの統合ダッシュボードで確認します。

ServicePulse は、分散システムを構築、監視、デバッグするための NServiceBus とツールを含む特定サービス プラットフォームの一部です。

詳細については、ServicePulse のドキュメントを参照してください。

開発用プロジェクトのセットアップ

ServiceControl Main インスタンスと ServiceControl Monitoring インスタンスのセットアップ

ServicePulse は主に、ServiceControl インスタンスと ServiceControl Monitoring インスタンスによって提供されるデータを表示します。

両方のサービスの URL はsrc/Frontend/public/js/app.constants.jsで設定できます。

パッケージマネージャーのセットアップ

ServicePulse は、npm と Bower をパッケージ マネージャーとして使用します。ソリューションが機能するには、ServicePulse Web サイトを起動する前に依存関係をダウンロードする必要があります。

依存関係をインストールする

次の依存関係をまだインストールしていない場合は、インストールします。

• Windows 用の Git
• Node.js
  • 注意:ローカル環境にnode.jsをインストールまたは更新するときは、 ci.ymlおよびrelease.ymlワークフローのnode.jsバージョンがローカル環境のバージョンと一致していることを確認することをお勧めします。ステップname: Set up Node.js

開発環境を設定する

ステップ 0 - フロントエンド開発に適切な IDE を使用する

Visual Studio または Rider はフロントエンド開発には適切な IDE であるように見えますが、最新のフロントエンド フレームワーク、lint、およびフォーマットでは信頼性が低くなる傾向があります。そのため、フロントエンド開発でさらに成功するために役立つ追加の推奨事項を用意しています。

ステップ 1 - Vue.js 開発サーバーを実行する

ServicePulsesrcFrontendに移動し、次の操作を行います。

• npm install実行して、npm の依存関係をすべてインストールします。
• 次のコマンドを実行しますnpm run dev (これにより、ポート 5173 で開発サーバーがホストされ、 /Frontendディレクトリ内の変更の監視が開始されます)

git サブモジュールが正しく構成されていないことに関連するエラーでnpm run dev失敗した場合は、 npm installコマンドを再度実行して、必要な依存関係がすべて利用可能であることを確認してから、 npm run dev実行します。

ステップ 2 - ブラウザを開きます

上記の手順を実行した後、Vue.js アプリケーションの実行によって表示される URL に移動して、ServicePulse アプリケーションを表示します。

自動テストの実行

フロントエンドの自動テストは、テスト フレームワークおよびテスト ユーティリティのテスト ライブラリとして Vitest を利用します。 Vitest は、デフォルトで開発環境のwatch modeと CI 環境のrun mode 2 つのモードを提供します。 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の最新メジャーバージョン
• EdgeHTML v17+ を使用したエッジ
• Firefox ESR の現在のバージョン
• Safariの最新メジャーバージョン

コンテナイメージの開発

ServicePulse の Dockerfile は、 src/ServicePulseフォルダー内にあります。コンテナー イメージはすべて、リリース ワークフローの一部として構築され、Github Container Registry にステージングされます。 PR を持つブランチの場合、イメージには PR 番号 (例: pr-1234がタグ付けされます。