C# unter Linux mit .NET Core

Keine Zeit? Hier die Kurzversion in 30 Sekunden.
- .NET Core 2.1 (Ende Mai 2018) ist das aktuelle LTS-Release; 2.2 ist noch Preview, für 3.0 sind WinForms und WPF nur unter Windows angekündigt.
- Der Alltag läuft über die
dotnet-CLI, Visual Studio Code mit C#-Erweiterung oder JetBrains Rider; Pakete gibt es über packages.microsoft.com, Docker-Images von Microsoft.- Self-contained Deployments mit Runtime Identifier (z. B.
linux-x64) liefern die Laufzeit gleich mit.- Die meisten Stolperfallen sind harmlos, aber real: Groß-/Kleinschreibung, Pfadtrenner, Zeilenenden, Zeitzonen-IDs, Encodings.
- Windows-spezifische Dinge wie Registry oder System.Drawing/GDI+ brauchen Ersatz oder eine Abstraktion.
Vor einigen Jahren war „C# unter Linux“ für mich eine Spielerei mit Mono. Heute ist es etwas anderes: Ich habe in den letzten Monaten einen kleinen Dienst und ein Kommandozeilenwerkzeug, die ich bisher unter Windows entwickelt hatte, mit .NET Core auf Linux gebracht und dort betrieben. Das ist kein Testbericht, sondern ein Erfahrungsbericht mit allem, was holprig war.
Der Stand
.NET Core 2.1 ist Ende Mai erschienen und aktuell das LTS-Release. Version 2.2 gibt es bisher nur als Preview, die würde ich nicht für etwas Ernsthaftes nehmen. Für .NET Core 3.0 wurde im Frühjahr auf der Build-Konferenz angekündigt, dass dann auch WinForms und WPF dabei sein sollen, allerdings nur unter Windows. Previews dazu habe ich noch nicht gesehen. Für Linux ist das also vor allem ein Hinweis, dass Desktop-Anwendungen weiter außen vor bleiben. Auf der Sprachseite ist C# 7.3 der aktuelle Stand, und der Compiler läuft überall gleich.
Gegenüber den Anfängen hat sich viel getan. Die Projektdateien sind wieder .csproj, kurz und lesbar, und die Werkzeugkette ist erwachsen geworden. Wer 2016 beim ersten Anlauf die wechselnden Formate gesehen hat, kann sich heute entspannter darauf einlassen.
Werkzeuge im Alltag
Das Zentrum ist die dotnet-Kommandozeile:
dotnet new console -o Werkzeug
cd Werkzeug
dotnet build
dotnet run
dotnet publish -c ReleaseMit dotnet new entsteht das Gerüst, build kompiliert, run startet, publish erzeugt das auslieferbare Ergebnis. Seit 2.1 kommen außerdem die Global Tools dazu: Kommandozeilenwerkzeuge, die man als NuGet-Paket installiert, etwa mit dotnet tool install -g <name>. Das ist ein bequemer Weg, kleine Helfer zu verteilen.
Installiert wird .NET Core unter Linux über Pakete von packages.microsoft.com. Es gibt sie für die gängigen Distributionen, man trägt die Paketquelle ein und installiert das SDK wie jedes andere Paket. Für Container stellt Microsoft Docker-Images bereit, getrennt für SDK (zum Bauen) und Laufzeit (zum Ausführen). Ich bin dazu übergegangen, in einem mehrstufigen Build mit dem SDK-Image zu kompilieren und nur das Ergebnis in ein Laufzeit-Image zu kopieren. Das hält die Images klein.
Bei den Editoren hatte ich die Wahl. Visual Studio Code mit der C#-Erweiterung (im Hintergrund OmniSharp) deckt das Nötige ab: Vervollständigung, Debugger, Refactoring in Grenzen. JetBrains Rider, seit 2017 auf dem Markt, fühlt sich für größere Lösungen runder an, ist aber kostenpflichtig. Wer von Visual Studio kommt, wird den Funktionsumfang vermissen, für Dienste und Konsolenprogramme reicht beides aus.
Ausliefern mit oder ohne Laufzeit
Zwei Möglichkeiten sind mir bei publish begegnet. Die eine setzt voraus, dass auf dem Zielrechner eine passende .NET-Core-Laufzeit installiert ist. Das Ergebnis ist klein, man startet es mit dotnet Werkzeug.dll. Die andere ist ein self-contained Deployment, bei dem die Laufzeit mitgeliefert wird:
dotnet publish -c Release -r linux-x64Der Runtime Identifier linux-x64 legt die Zielplattform fest. Das Verzeichnis ist größer, dafür läuft es auf einem Rechner ohne vorinstalliertes .NET. Ich nutze das für Werkzeuge, die auf fremden Maschinen laufen sollen, und die erste Variante für Container und eigene Server. Man muss dabei bedenken, dass Sicherheitsupdates der Laufzeit bei self-contained Anwendungen nicht automatisch ankommen. Man muss neu bauen und neu ausliefern.
Die Stolperfallen
Der Code selbst lief fast überall unverändert. Was kaputtging, waren Annahmen, die ich unter Windows nie bemerkt hatte.
Groß- und Kleinschreibung. Das Dateisystem unter Linux unterscheidet sie. Ein Config.json ist nicht config.json. Unter Windows fällt es nicht auf, dann läuft der Dienst auf dem Server nicht. Seitdem schreibe ich Dateinamen konsequent einheitlich.
Pfadtrenner. Wer Pfade mit "\\" zusammensetzt, fällt hier um. Richtig ist Path.Combine:
var pfad = Path.Combine("daten", "export", "bericht.csv");Zeilenenden. Dateien mit CRLF tauchen in Skripten oder Konfigurationen unter Linux als seltsame Fehler auf, zum Beispiel ein unsichtbares Zeichen am Zeilenende. Ich lege Zeilenenden im Repository fest, statt mich auf den Editor zu verlassen. Wer selbst Text schreibt, sollte Environment.NewLine statt eines fest eingebauten Zeichens benutzen.
Zeitzonen. Unter Windows heißen Zeitzonen etwa „W. Europe Standard Time“, unter Linux gelten die IANA-Namen wie „Europe/Berlin“. Code mit TimeZoneInfo.FindSystemTimeZoneById bricht daran, wenn die ID hart codiert ist. Ich habe die ID in die Konfiguration gelegt und zusätzlich geprüft, wo überhaupt lokale Zeit nötig ist. Meist reicht UTC intern, und umgerechnet wird nur an der Oberfläche.
System.Drawing und GDI+. Bildbearbeitung mit System.Drawing hängt unter Windows an GDI+. Mit .NET Core ist sie über ein Kompatibilitätspaket verfügbar, unter Linux braucht sie zusätzlich eine native Bibliothek (libgdiplus) und verhält sich nicht immer identisch. Für neue Vorhaben würde ich zu einer rein verwalteten Bibliothek greifen.
Windows-spezifische APIs. Die Registry gibt es unter Linux schlicht nicht. Wer dort Einstellungen ablegt, braucht eine Abstraktion mit einer Implementierung pro System, oder gleich eine Konfigurationsdatei. Das gilt ähnlich für Windows-Dienste, Ereignisprotokoll und alles, was COM nutzt.
Kultur und Encoding. Die Standardkultur kommt unter Linux aus der Umgebung. Fehlt die Locale, schreibt die Anwendung Zahlen im falschen Format. Ich setze Kulturen dort, wo es zählt, explizit (CultureInfo.InvariantCulture für Dateien und Protokolle). Bei Encodings war ich überrascht: Windows-1252 steht in .NET Core nicht von selbst bereit. Man registriert vorher den Provider aus dem Paket System.Text.Encoding.CodePages:
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
var latin = Encoding.GetEncoding(1252);Ein Fazit aus der Praxis
Für Webdienste und Werkzeuge ist .NET Core 2.1 auf Linux für mich inzwischen eine vernünftige Wahl. Das Tooling ist stabil, die Laufzeit schnell genug für das, was ich damit mache (Zahlen habe ich keine, nur den Eindruck), und der Betrieb in Containern ist unkompliziert. Weniger geeignet ist es für alles mit Oberfläche und für Anwendungen, die tief im Windows-Ökosystem stecken. Dort sollte man erst prüfen, was von der Klassenbibliothek überhaupt verfügbar ist, bevor man Aufwand investiert.
Mein Rat bei einer bestehenden Anwendung: Zuerst die Windows-Abhängigkeiten auflisten, dann Pfade, Zeiten und Encodings durchsehen, und den Dienst früh auf einer Linux-Maschine oder im Container starten. Fast alle Probleme zeigen sich dann in den ersten Stunden und sind klein.
Beitragsbild: .NET-Core-Logo von Jason Groce, gemeinfrei (via Wikimedia Commons; unverändert auf eigenem Hintergrund). .NET ist eine Marke der Microsoft Corporation / .NET Foundation.
Christian Ackermann
Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.