dotnet clean arch

Contoh Arsitektur Bersih di C#

Repositori ini menyediakan implementasi arsitektur bersih dalam solusi C# yang diintegrasikan dengan API HTTP cuaca, mengintegrasikan alat -alat modern penting seperti Prometheus dan Grafana untuk pemantauan dan observabilitas.

Struktur proyek

Proyek ini mengikuti struktur arsitektur yang bersih:

• CleanArch.Api : Lapisan API Web, yang berisi pengontrol, konfigurasi, dan pengaturan injeksi ketergantungan.
• CleanArch.Domain : Logika bisnis inti dan entitas domain.
• CleanArch.Application : Logika khusus aplikasi dan kasus penggunaan.
• CleanArch.Infrastructure : Kode infrastruktur seperti integrasi layanan eksternal dan kegigihan data.

Perpustakaan dan alat

Proyek ini menggunakan pustaka dan alat berikut:

• Asp.net Core : Untuk membangun API Web.
• Serilog : Untuk logging.
• Prometheus.net : Untuk mengekspos metrik aplikasi.
• Docker Compose : Untuk mengatur layanan seperti API, Prometheus, dan Grafana.

Pemantauan dan kemampuan observasi

Proyek ini mencakup file docker-compose.yml yang mengatur:

• Prometheus : Mengikis metrik yang diekspos oleh API.
• Grafana : Untuk memvisualisasikan metrik dari Prometheus.

Titik akhir metrik

Aplikasi ini memaparkan metrik pada /metrics menggunakan pustaka prometheus.net .

Petunjuk Pengaturan

Prasyarat

• Docker dan Docker menyusun terinstal.
• Kunci API Weatherstack untuk integrasi API cuaca.

Tangga

1. Klon Repositori:

git clone https://github.com/MatheusSw/dotnet-clean-arch.git
cd CleanArch

2. Tambahkan Kunci API Weatherstack Anda ke Variabel Lingkungan Sistem Anda
3. Bangun dan jalankan aplikasi menggunakan Docker Compose:

docker-compose up --build

4. Akses Layanan:

• API : http: // localhost: 8080
• Prometheus : http: // localhost: 9090
• Grafana : http: // localhost: 3000

Memvisualisasikan metrik

1. Masuk ke Grafana di http: // localhost: 3000 (admin default/admin).
2. Tambahkan Prometheus sebagai sumber data. (Gunakan Prometheus: 9090 sebagai URL)
3. Impor dasbor yang dikonfigurasi sebelumnya atau buat yang khusus untuk memantau kinerja API.

Contoh titik akhir API

• Get /weathers?location=Brasil Sao Paulo : Mengambil informasi cuaca untuk lokasi tertentu menggunakan Weatherstack API.