LayananPulse

LayananPulse

ServicePulse menyediakan pemantauan produksi waktu nyata untuk aplikasi terdistribusi. Ini memantau kesehatan titik akhir sistem, mendeteksi kesalahan pemrosesan, mengirim pesan yang gagal untuk diproses ulang, dan memastikan kebutuhan lingkungan tertentu terpenuhi, semuanya dalam satu dasbor yang terkonsolidasi.

ServicePulse adalah bagian dari Platform Layanan Khusus, yang mencakup NServiceBus dan alat untuk membangun, memantau, dan men-debug sistem terdistribusi.

Lihat dokumentasi ServicePulse untuk informasi lebih lanjut.

Menyiapkan proyek untuk pengembangan

Menyiapkan instans ServiceControl Main dan ServiceControl Monitoring

ServicePulse terutama menyajikan data yang disediakan oleh instance ServiceControl dan ServiceControl Monitoring.

URL untuk kedua layanan dapat diatur di src/Frontend/public/js/app.constants.js .

Menyiapkan manajer paket

ServicePulse menggunakan npm dan Bower sebagai manajer paket. Agar solusinya berfungsi, dependensi harus diunduh sebelum meluncurkan situs web ServicePulse.

Instal dependensi

Instal dependensi berikut jika Anda belum menginstalnya.

• Git untuk Windows
• Node.js
  • CATATAN: Merupakan praktik yang baik saat menginstal atau memperbarui node.js di lingkungan lokal Anda juga untuk memeriksa dan memastikan bahwa versi node.js untuk alur kerja ci.yml dan release.yml cocok dengan versi lingkungan lokal Anda. Cari name: Set up Node.js

Tetapkan lingkungan pengembangan

Langkah 0 - Menggunakan IDE yang sesuai untuk pengembangan frontend

Meskipun Visual Studio atau Rider tampaknya merupakan IDE yang memadai untuk pengembangan front-end, mereka cenderung tidak dapat diandalkan dengan kerangka kerja, linting, dan pemformatan front-end terbaru. Oleh karena itu, kami memiliki rekomendasi tambahan untuk membantu Anda lebih sukses dalam pengembangan front-end.

Langkah 1 - jalankan server pengembangan Vue.js

Navigasikan ke ServicePulsesrcFrontend dan:

• jalankan npm install untuk menginstal semua dependensi npm
• jalankan perintah berikut npm run dev (ini akan meng-host server dev pada port 5173 dan mulai mengamati perubahan di direktori /Frontend )

Jika npm run dev gagal dengan kesalahan terkait submodul git yang tidak dikonfigurasi dengan benar, jalankan kembali perintah npm install untuk memastikan semua dependensi yang diperlukan tersedia, lalu jalankan npm run dev .

Langkah 2 - buka browser

Setelah melakukan langkah-langkah di atas, navigasikan ke URL yang disajikan oleh eksekusi aplikasi Vue.js untuk melihat aplikasi ServicePulse.

Menjalankan tes otomatis

Tes otomatis frontend menggunakan Vitest sebagai kerangka pengujian dan perpustakaan pengujian untuk utilitas pengujian. Vitest menyediakan dua mode: watch mode di lingkungan pengembangan dan run mode di lingkungan CI secara default. Watch mode secara instan menjalankan kembali pengujian yang relevan setelah penyimpanan file, memberikan umpan balik langsung selama pengembangan.

Sebelum menjalankan pengujian, pastikan Anda telah menyiapkan server pengembangan. Navigasikan ke ServicePulsesrcFrontend dan jalankan npm install untuk menginstal semua dependensi npm.

Menjalankan tes komponen

Navigasikan ke ServicePulsesrcFrontend dan jalankan:

 npm run test:component

Perintah ini menjalankan semua file pengujian komponen *.spcs.ts di direktori ServicePulsesrcFrontendsrc dan subdirektorinya. Dengan mengaktifkan watch mode , ini memungkinkan pengembangan pengujian yang efisien, karena hanya pengujian relevan yang dijalankan kembali pada penyimpanan file.

Menjalankan tes aplikasi

Navigasikan ke ServicePulsesrcFrontend dan jalankan:

 npm run test:application

Mirip dengan pengujian komponen, perintah ini menjalankan semua file pengujian aplikasi *.spcs.ts di direktori ServicePulsesrcFrontendtest dan subdirektorinya.

Menjalankan cakupan tes

Navigasikan ke ServicePulsesrcFrontend dan jalankan:

 npm run test:coverage

Perintah ini menghasilkan laporan yang menunjukkan persentase pernyataan, cabang, fungsi, dan baris yang dicakup oleh pengujian. Selain itu, ini mengidentifikasi nomor baris yang tidak ditemukan.

Skrip npm disediakan

Vue.js

• dev - menjalankan vite yang memulai server pengembangan melakukan hot reload pada file sumber
• build - menjalankan skrip build yang menampilkan file ke folder ..app
• lint - memeriksa dengan eslint semua file vue, ts, dan js
• type-check - menjalankan TypeScript dalam mode tanpa emisi

Kunjungan

• test:application - menjalankan semua pengujian aplikasi yang terletak di folder Frontend/test .
• test:component - menjalankan pengujian semua pengujian komponen yang terletak di folder Frontend/src dan subdirektori mana pun.
• test:coverage - menjalankan laporan cakupan pengujian pada file yang ditentukan di vitest.config.ts

Berjalan dari ServicePulse.Host.exe

Dimungkinkan untuk menjalankan ServicePulse secara langsung melalui ServicePulse.Host.exe .

Langkah 1 - URL cadangan ACL

ServicePulse.Host.exe bergantung pada server web yang dihosting sendiri. Reservasi URL ACL harus disiapkan sebelum proyek dapat dijalankan. Jalankan Visual Studio dengan hak Administratif atau jalankan perintah berikut untuk menambahkan reservasi URL ACL yang diperlukan:

add urlacl url=URL

Dimana URL adalah URL yang dikonfigurasi pada mesin lokal.

Langkah 2 - membangun situs ServicePulse

Jalankan skrip build dari baris perintah:

 PowerShell -File .build.ps1

Catatan

Mungkin perlu mengubah kebijakan eksekusi PowerShell menggunakan Set-ExecutionPolicy Unrestricted -scope UserPolicy

Langkah 3 - jalankan ServicePulse.Host.exe

Bangun dan jalankan proyek ServicePulse.Host di IDE.

Versi peramban yang didukung

ServicePulse didukung pada versi browser desktop berikut:

• Chrome versi utama terbaru
• Tepi dengan EdgeHTML v17+
• Firefox ESR versi saat ini
• Safari versi utama terbaru

Pengembangan gambar kontainer

Dockerfile untuk ServicePulse berada di dalam folder src/ServicePulse . Semua image container dibuat sebagai bagian dari alur kerja rilis dan dipentaskan di Github Container Registry. Untuk cabang yang memiliki PR, gambarnya akan ditandai dengan nomor PR, misal pr-1234 .