dotnet clean arch

Beispiel für sauberes Architektur in C#

Dieses Repository bietet eine Implementierung der sauberen Architektur in einer C# -Lösung, die in eine HTTP -API von Wetter integriert wird und essentielle moderne Tools wie Prometheus und Grafana zur Überwachung und Beobachtbarkeit integriert.

Projektstruktur

Dieses Projekt folgt der Struktur der sauberen Architektur:

• CleanArch.Api : Die Web -API -Ebene, die Controller, Konfiguration und Abhängigkeitsinjektionssetup enthält.
• CleanArch.Domain : Kerngeschäftslogik und Domäneneinheiten.
• CleanArch.Application : Anwendungsspezifische Logik- und Anwendungsfälle.
• CleanArch.Infrastructure : Infrastrukturcode wie externe Serviceintegration und Datenpersistenz.

Bibliotheken und Werkzeuge

Das Projekt verwendet die folgenden Bibliotheken und Tools:

• ASP.NET CORE : Zum Erstellen der Web -API.
• Serilog : Zum Protokollieren.
• Prometheus.net : Für die Enthüllung von Anwendungsmetriken.
• Docker Compose : Für die Orchestrierung von Diensten wie API, Prometheus und Grafana.

Überwachung und Beobachtbarkeit

Das Projekt enthält eine festgelegte Datei docker-compose.yml die eingerichtet ist:

• Prometheus : Metriken, die von der API entlarvt werden.
• Grafana : Zur Visualisierung von Metriken aus Prometheus.

Metrikenendpunkt

Die Anwendung enthält Metriken AT /metrics mithilfe der Prometheus.net -Bibliothek.

Setup -Anweisungen

Voraussetzungen

• Docker und Docker komponieren installiert.
• Weather -Stack -API -Schlüssel für die Wetter -API -Integration.

Schritte

1. Klonen Sie das Repository:

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

2. Fügen Sie Ihren Weatherstack -API -Schlüssel zu Ihren Systemumgebungsvariablen hinzu
3. Erstellen und führen Sie die Anwendung mit Docker Compose aus:

docker-compose up --build

4. Zugriff auf die Dienste:

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

Metriken visualisieren

1. Melden Sie sich in Grafana unter http: // localhost: 3000 (Standard Admin/Admin) an.
2. Fügen Sie Prometheus als Datenquelle hinzu. (Verwenden Sie Prometheus: 9090 als URL)
3. Importieren Sie vorkonfigurierte Dashboards oder erstellen Sie benutzerdefinierte, um die API-Leistung zu überwachen.

Beispiel -API -Endpunkte

• Get /weathers?location=Brasil Sao Paulo : Abrufen Wetterinformationen für einen bestimmten Ort mit WeatherStack -API.