Installieren des .NET SDK oder der .NET-Runtime unter Alpine

  • Artikel

Wichtig

.NET 8 wurde am 14. November 2023 veröffentlicht. Es kann Zeit dauern, bis die Pakete in den Paket-Manager-Feeds angezeigt werden.

.NET wird unter Alpine unterstützt. In diesem Artikel wird beschrieben, wie Sie .NET unter Alpine installieren. Wenn für eine Alpine-Version kein Support mehr geboten wird, wird .NET mit dieser Version nicht mehr unterstützt.

Wenn Sie Docker verwenden, sollten Sie offizielle .NET Docker-Images verwenden, anstatt .NET selbst zu installieren.

Installieren Sie das SDK (das die Runtime enthält), wenn Sie .NET Core-Apps entwickeln möchten. Wenn Sie Apps nur ausführen möchten, installieren Sie die Runtime. Wenn Sie die Runtime installieren, wird die Installation der ASP.NET Core-Runtime empfohlen, da diese sowohl .NET- als auch ASP.NET Core-Runtimes umfasst.

Überprüfen Sie mithilfe der Befehle dotnet --list-sdks und dotnet --list-runtimes, welche Versionen installiert sind. Weitere Informationen finden Sie unter Überprüfen, ob .NET Core bereits installiert ist.

Der Alpine-Paket-Manager unterstützt die Installation einiger Versionen von .NET. Wenn das .NET-Paket nicht verfügbar ist, müssen Sie .NET auf eine der folgenden alternativen Weisen installieren:

Installieren von .NET 8

.NET 8 ist noch nicht im Standardzweig des Alpine-Paket-Repositorys verfügbar. Verwenden Sie die edge Verzweigung, um .NET 8 zu installieren. Verwenden Sie alternativ eine der folgenden Vorgehensweisen zum Installieren von .NET 8:

Installieren von .NET 7

Installieren des SDKs

Das .NET SDK ermöglicht Ihnen die Entwicklung von Apps mit .NET. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Runtime nicht installieren. Führen Sie den folgenden Befehl aus, um das .NET SDK zu installieren:

sudo apk add dotnet7-sdk

Installieren der Runtime

Die ASP.NET Core-Runtime ermöglicht Ihnen die Ausführung von Apps, die mit .NET erstellt wurden und die Runtime nicht enthalten. Mit dem folgenden Befehl wird mit der ASP.NET Core-Runtime die kompatibelste Runtime für .NET installiert. Führen Sie in Ihrem Terminal den folgenden Befehl aus:

sudo apk add aspnetcore7-runtime

Als Alternative zur ASP.NET Core-Runtime können Sie die .NET-Runtime installieren, die keine ASP.NET Core-Unterstützung bietet: Ersetzen Sie dazu im vorangegangenen Befehl aspnetcore7-runtime durch dotnet7-runtime:

sudo apk add dotnet7-runtime

Installieren von .NET 6

Installieren des SDKs

Das .NET SDK ermöglicht Ihnen die Entwicklung von Apps mit .NET. Wenn Sie das .NET SDK installieren, müssen Sie die entsprechende Runtime nicht installieren. Führen Sie den folgenden Befehl aus, um das .NET SDK zu installieren:

sudo apk add dotnet6-sdk

Installieren der Runtime

Die ASP.NET Core-Runtime ermöglicht Ihnen die Ausführung von Apps, die mit .NET erstellt wurden und die Runtime nicht enthalten. Mit dem folgenden Befehl wird mit der ASP.NET Core-Runtime die kompatibelste Runtime für .NET installiert. Führen Sie in Ihrem Terminal den folgenden Befehl aus:

sudo apk add aspnetcore6-runtime

Als Alternative zur ASP.NET Core-Runtime können Sie die .NET-Runtime ohne ASP.NET Core-Unterstützung installieren. Ersetzen Sie dazu im vorherigen Befehl aspnetcore6-runtime durch dotnet6-runtime:

sudo apk add dotnet6-runtime

Unterstützte Distributionen

Die folgende Tabelle enthält die derzeit unterstützten .NET-Releases und die Alpine-Versionen, die diese unterstützen. Diese Versionen werden weiterhin unterstützt, bis entweder die Version von .NET das Ende des Supports oder die Version von Alpine das Ende ihrer Lebensdauer erreicht.

Alpine Unterstützte Version Verfügbar in Paket-Manager
3,19 .NET 8.0, .NET 7.0, .NET 6.0 .NET 7.0, .NET 6.0
3.18 .NET 8.0, .NET 7.0, .NET 6.0 .NET 7.0, .NET 6.0
3,17 .NET 8.0, .NET 7.0, .NET 6.0 .NET 7.0, .NET 6.0
3.16 .NET 7.0, .NET 6.0 .NET 6.0
3,15 .NET 7.0, .NET 6.0 None

Die folgenden Versionen von .NET ❌ werden nicht mehr unterstützt:

  • .NET 5
  • .NET Core 3.1
  • .NET Core 3.0
  • .NET Core 2.2
  • .NET Core 2.1
  • .NET Core 2.0

Unterstützte Architekturen

Die folgende Tabelle enthält die derzeit unterstützten .NET-Versionen und die Alpine-Architektur, in der diese unterstützt werden. Diese Versionen werden weiterhin unterstützt, bis entweder die Version von .NET das Ende des Supports oder die Architektur von Alpine unterstützt wird. Beachten Sie, dass nur x86_64, armv7 und aarch64 offiziell von Microsoft unterstützt werden. Andere Architekturen werden von den Distributionsmaintainern unterstützt und können mithilfe des Paket-Managers apk installiert werden.

Aufbau .NET 6 .NET 7 .NET 8
x86_64 3.16, 3.17, 3.18 3.17, 3.18 3.17, 3.18
x86 Keine Nein Keine
aarch64 3.16, 3.17, 3.18 3.17, 3.18 3.17, 3.18
armv7 3.16, 3.17, 3.18 3.17, 3.18 3.17, 3.18
armhf Keine Nein Keine
s390x 3,17 3,17 3,17
ppc64le Keine Nein Keine
riscv64 Keine Nein Keine

Installieren von Vorschauversionen

Vorschau- und Release Candidate-Versionen von .NET sind in Paketrepositorys nicht verfügbar. Sie können Vorschauversionen und Release Candidates von .NET auf eine der folgenden Arten installieren:

Entfernen von Vorschauversionen

Wenn Sie Ihre .NET-Installation mit einem Paket-Manager verwalten, tritt möglicherweise ein Konflikt auf, wenn Sie zuvor eine Vorschauversion installiert haben. Der Paket-Manager kann die Nichtvorschauversion als frühere Version von .NET interpretieren. Für die Installation der Nichtvorschauversion müssen Sie zunächst die Vorschauversionen deinstallieren. Weitere Informationen zur Deinstallation von .NET finden Sie unter Entfernen der .NET-Runtime und des SDK.

Abhängigkeiten

Wenn die Installation mit einem Paket-Manager erfolgt, werden diese Bibliotheken für Sie installiert. Wenn Sie jedoch .NET manuell installieren oder eine eigenständige Anwendung veröffentlichen, müssen Sie sicherstellen, dass diese Bibliotheken installiert sind:

3.18+

  • ca-certificates-bundle
  • libgcc
  • libssl3
  • libstdc++
  • zlib
  • libgdiplus (wenn die .NET-App die Assembly System.Drawing.Common erfordert)

3.15 - 3.17

  • icu-libs
  • krb5-libs
  • libgcc
  • libintl
  • libssl3
  • libstdc++
  • zlib
  • libgdiplus (wenn die .NET-App die Assembly System.Drawing.Common erfordert)

Verwenden Sie den apk add Befehl, um die Abhängigkeiten zu installieren.

Wenn die .NET-App die System.Drawing.Common-Assembly verwendet, muss libgdiplus ebenfalls installiert werden. Da System.Drawing.Common unter Linux nicht mehr unterstützt wird, funktioniert dies nur unter .NET 6 und erfordert das Festlegen der System.Drawing.EnableUnixSupport-Laufzeitkonfigurationsoption.

Führen Sie zum Installieren von libgdiplus Folgendes aus:

apk add libgdiplus

Nächste Schritte