Seminar ASP.NET Core auf Linux mit Nginx – Deployment und Betrieb

Seminarbeschreibung

Der zuverlässige Betrieb unter Linux umfasst mehr als das Starten einer DLL. Das Seminar zeigt die Rollenverteilung zwischen ASP.NET Core, Kestrel, Nginx und systemd und setzt diese an einer vorbereiteten Anwendung um. Bereitstellung, Rechte, Startverhalten und Protokollierung werden als zusammenhängende Betriebsaufgabe behandelt.

Ein besonderer Schwerpunkt liegt auf der TLS-Terminierung und dem Vertrauen in weitergeleitete Request-Informationen. Falsche Schemas, fehlerhafte Weiterleitungen, unerreichbare Upstreams und Berechtigungsprobleme werden gezielt erzeugt und eingegrenzt. Die Arbeiten erfolgen überwiegend über die Kommandozeile und werden durch Browserprüfungen ergänzt.

Lernziele

• Eine ASP.NET-Core-Anwendung unter einer eigenen Dienstidentität betreiben.
• Nginx als Reverse Proxy mit nachvollziehbarer TLS- und Header-Konfiguration einsetzen.
• Betriebsstörungen eingrenzen und ein fehlerhaftes Release kontrolliert zurücknehmen.

Zielgruppe

Linux- und Windows-Administratoren, DevOps-Verantwortliche sowie .NET-Entwickler mit Betriebsaufgaben.

Voraussetzungen

Grundlegende Linux-Kommandozeile, Dateirechte, TCP/IP, HTTP und Git; eine vorhandene ASP.NET-Core-Anwendung muss gestartet und konfiguriert werden können.

Seminarinhalte im Überblick

1. Linux und Veröffentlichung vorbereiten
2. Kestrel und systemd betreiben
3. Nginx und HTTPS integrieren
4. Betrieb prüfen und Störungen beheben
5. Releases und Wartung

1. Linux und Veröffentlichung vorbereiten

• Runtime und SDK unterscheiden sowie unterstützte Pakete und Abhängigkeiten auswählen.
• Frameworkabhängige und eigenständige Veröffentlichung samt Updatefolgen vergleichen.
• Benutzer, Dateirechte, Verzeichnisse und Konfigurationsquellen für den Dienst einrichten.

2. Kestrel und systemd betreiben

• Dienstdefinition, Arbeitsverzeichnis, Umgebung und Startberechtigungen konfigurieren.
• Neustartregeln, Beenden, Journal und einfache Ressourcenbegrenzungen untersuchen.
• Erreichbarkeit des Backends begrenzen und Fehler beim Dienststart diagnostizieren.

3. Nginx und HTTPS integrieren

• Serverblöcke, Upstream, Host-Prüfung, Zertifikate und TLS-Terminierung konfigurieren.
• Forwarded Headers nur von definierten Proxys verarbeiten und die Middleware-Reihenfolge prüfen.
• Uploads, Zeitlimits, statische Inhalte sowie WebSocket-Verbindungen an Beispielen behandeln.

4. Betrieb prüfen und Störungen beheben

• Dienstzustand, Netzwerkpfad, Antwortcodes und Anwendungsprotokolle systematisch vergleichen.
• Redirect-Schleifen, 502/504-Antworten, Dateirechte und falsche Umgebungswerte eingrenzen.
• Erreichbarkeit, TLS, Neustartverhalten und Health-Endpunkte mit einer Prüfroutine abnehmen.

5. Releases und Wartung

• Versionierte Releases bereitstellen und Daten sowie Geheimnisse vom Programmstand trennen.
• Konfiguration vor dem Nginx-Reload prüfen und Laufzeitupdates kontrolliert einführen.
• Einen fehlerhaften Programmstand zurücknehmen und die Anwendung erneut verifizieren.

Praktische Übungen

1. Eine Anwendung veröffentlichen und als systemd-Dienst unter eigenem Benutzer starten.
2. Nginx mit einem Laborzertifikat anbinden und die ursprüngliche Request-Scheme korrekt wiederherstellen.
3. Eine Proxy-Fehlkonfiguration anhand von Journal, Nginx-Log und Browserverhalten analysieren.
4. Ein Update einschließlich Dienstneustart und Rückfall auf den vorherigen Programmstand durchführen.

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. Benötigt werden eine Linux-VM mit sudo-Berechtigung, Nginx, ein Laborhostname und ein Laborzertifikat. Der Kunde stellt die vereinbarte Schulungsumgebung bereit; Konten, Berechtigungen, Softwarestände und der erfolgreiche Teststart werden vor Seminarbeginn abgestimmt.

Thematische Einordnung

Die vollständige Linux-Administration und die Entwicklung einer Anwendung von Grund auf sind nicht Bestandteil. Ein vorbereitetes ASP.NET-Core-Projekt und eine unterstützte Linux-Laborumgebung bilden die Grundlage.

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