Seminar ASP.NET Core APIs auf Linux – Entwicklung und Integration

Seminarbeschreibung

Linux-taugliche Web-APIs benötigen einen klaren Aufbau, verlässliche Fehlerantworten und prüfbare Schnittstellen. Im Seminar entsteht schrittweise eine fachlich zusammenhängende Anwendung mit ASP.NET Core. Die Architektur bleibt bewusst überschaubar, damit Entscheidungen zu Endpunkten, Abhängigkeiten und Tests nachvollziehbar bleiben.

Der Datenzugriff wird beispielhaft mit Entity Framework Core und PostgreSQL umgesetzt. Betriebseigenschaften wie strukturierte Protokolle, validierte Konfiguration und Health-Endpunkte fließen von Anfang an ein. Die Übungen führen vom ersten Request bis zu einer unter Linux getesteten Anwendung.

Lernziele

• Wartbare HTTP-APIs mit konsistenten Verträgen und Fehlerantworten entwickeln.
• Datenzugriffe und externe HTTP-Aufrufe kontrolliert integrieren.
• Linux-relevante Fehler vor der Bereitstellung durch automatisierte Tests erkennen.

Zielgruppe

C#-Entwickler, Backend-Entwickler und Softwarearchitekten mit praktischer Programmiererfahrung.

Voraussetzungen

Sicherer Umgang mit C#, asynchroner Programmierung, Git, HTTP und SQL; grundlegende Kenntnisse der .NET CLI. Eine C#-Einführung ist nicht enthalten.

Seminarinhalte im Überblick

1. Anwendungsaufbau und Request-Verarbeitung
2. Verträge, Validierung und Fehlerbehandlung
3. Persistenz und Fremdsysteme
4. Qualitätssicherung unter Linux
5. Bereitstellbare Anwendung

1. Anwendungsaufbau und Request-Verarbeitung

• Projektstruktur, Dependency Injection, Middleware und Konfigurationsquellen einsetzen.
• Minimal APIs und Controller anhand der Wartungs- und Erweiterungsanforderungen auswählen.
• Routing, Parameterbindung, Statuscodes und asynchrone Verarbeitung nachvollziehen.

2. Verträge, Validierung und Fehlerbehandlung

• Eingaben validieren und fachliche Fehler von technischen Störungen unterscheiden.
• Problem Details, zentrale Ausnahmebehandlung und aussagekräftige Protokolle einrichten.
• OpenAPI-Beschreibungen, Schnittstellenänderungen und überprüfbare API-Verträge bearbeiten.

3. Persistenz und Fremdsysteme

• Entity Framework Core mit einem passenden PostgreSQL-Provider integrieren.
• Migrationen, Transaktionen, Abfrageprojektionen und Verbindungsverwaltung untersuchen.
• HttpClient, Zeitlimits, Cancellation und begrenzte Wiederholungen für geeignete Operationen verwenden.

4. Qualitätssicherung unter Linux

• Unit- und Integrationstests mit Testhost und isolierter Testdatenbank aufbauen.
• Dateipfade, Groß-/Kleinschreibung, Kulturen und Umgebungsvariablen systematisch testen.
• Fehlerfälle, fehlende Konfiguration und nicht erreichbare Abhängigkeiten reproduzieren.

5. Bereitstellbare Anwendung

• Release-Publish, Laufzeitkonfiguration und geeignete Health-Endpunkte vorbereiten.
• Authentifizierungs- und Autorisierungsgrenzen in der API-Struktur vorsehen.
• Die Beispielanwendung unter Linux prüfen und einen automatisierten Abnahmetest ausführen.

Praktische Übungen

1. Eine CRUD-API mit Eingabeprüfung und PostgreSQL-Persistenz entwickeln.
2. Einen Fehler in einem externen HTTP-Aufruf eingrenzen und kontrolliert behandeln.
3. Integrationstests für Erfolg, Validierungsfehler und Datenbankausfall erstellen.
4. Ein Release-Artefakt unter Linux starten und mit einem Smoke-Test prüfen.

Schulungsumgebung

Arbeitsgrundlage ist .NET 10 LTS mit ASP.NET Core 10 auf einer unterstützten Linux-Version. Verwendet werden zueinander passende stabile Paket- und Werkzeugstände. Die Übungen nutzen ausschließlich abgegrenzte Testdaten und vorbereitete Beispielanwendungen. Vorgesehen sind ein Editor, Git, das .NET SDK, eine Linux-Testumgebung und eine isolierte PostgreSQL-Datenbank. Der Kunde stellt die vereinbarte Schulungsumgebung bereit; Konten, Berechtigungen, Softwarestände und der erfolgreiche Teststart werden vor Seminarbeginn abgestimmt.

Thematische Einordnung

Schwerpunkt ist die API-Entwicklung mit vorhandenen C#-Kenntnissen. Vertiefte Benutzeranmeldung, Linux-Administration und Kubernetes werden in den ergänzenden Seminaren behandelt.

Weitere Fachseminare und die empfohlene Besuchsreihenfolge enthält die Übersicht der Seminarreihe.