Alpine に .NET SDK または .NET ランタイムをインストールする
重要
.NET 9 は 2024 年 11 月 12 日にリリースされました。 パッケージがパッケージ マネージャー フィードに表示されるか、特定の Linux ディストリビューションにパッケージが含まれるには時間がかかる場合があります。
.NET は Alpine でサポートされており、この記事では Alpine に .NET をインストールする方法について説明します。 Alpine のバージョンがサポート対象外である場合、.NET もそのバージョンでサポート対象外となります。
Docker を使用している場合は、.NET を自分でインストールするのではなく、公式の .NET Docker イメージを使用することを検討してください。
.NET アプリを開発する場合は、SDK をインストールします (これにはランタイムが含まれます)。 または、アプリを実行する必要があるだけの場合は、ランタイムをインストールします。 ランタイムをインストールする場合は、ASP.NET Core ランタイムをインストールすることをお勧めします。これには .NET と ASP.NET の Core ランタイムの両方が含まれているためです。
dotnet --list-sdks および dotnet --list-runtimes コマンドを使用して、インストールされているバージョンを確認します。 詳細については、.NET が既にインストールされていることを確認する方法に関するページを参照してください。
.NET のインストール
SDK のインストール
.NET SDK を使用すると、.NET を使用してアプリを開発できます。 .NET SDK をインストールする場合、対応するランタイムをインストールする必要はありません。 .NET SDK をインストールするには、次のコマンドを実行します。
sudo apk add dotnet8-sdk
.NET CLI の使用方法については、「.NET CLI の概要」を参照してください。
ランタイムをインストールする
ASP.NET Core ランタイムを使用すると、ランタイムを提供しない .NET を使用して作成されたアプリを実行できます。 次のコマンドを実行すると、.NET の最も互換性の高いランタイムである ASP.NET Core ランタイムがインストールされます。 ターミナルで、次のコマンドを実行します。
sudo apk add aspnetcore8-runtime
ASP.NET Core ランタイムの代替手段として、ASP.NET Core サポートを含まない .NET ランタイムをインストールできます。それには、前のコマンドの aspnetcore8-runtime を dotnet8-runtime で置き換えます。
sudo apk add dotnet8-runtime
.NET CLI の使用方法については、「.NET CLI の概要」を参照してください。
サポートされているディストリビューション
次の表に、現在サポートされている .NET リリースと、それらがサポートされている Alpine のバージョンの一覧を示します。 これらのバージョンは、.NET のバージョンがサポート終了するか、Alpine のバージョンの有効期限が切れるまでサポートされます。
| Alpine | サポートされているバージョン | パッケージ マネージャーで利用可能 |
|---|---|---|
| 3.20 | 8.0、6.0 | 8.0、6.0 |
| 3.19 | 8.0、6.0 | 7.0、6.0 |
| 3.18 | 8.0、6.0 | 7.0、6.0 |
| 3.17 | 8.0、6.0 | 7.0、6.0 |
重要
Alpine 3.17 は、2024 年 11 月 22 日に終了します。
次のバージョンの .NET は、❌ サポート対象外となりました。
- .NET 7
- .NET 6 (2024 年 11 月 12 日より)
- .NET 5
- .NET Core 3.1
- .NET Core 3.0
- .NET Core 2.2
- .NET Core 2.1
- .NET Core 2.0
サポートされているアーキテクチャ
次の表に、現在サポートされている .NET リリースと、それらがサポートされている Alpine のアーキテクチャの一覧を示します。 これらのバージョンは、.NET のバージョンがサポート終了するか、Alpine のアーキテクチャがサポートされるまでサポートされたままです。 x86_64、armv7、aarch64 のみが、Microsoft によって正式にサポートされていることに注意してください。 その他のアーキテクチャはディストリビューション メンテナによってサポートされており、apk パッケージ マネージャーを使用してインストールできます。
| アーキテクチャ | .NET 6 | .NET 8 |
|---|---|---|
| x86_64 | 3.17、3.18、3.19、3.20 | 3.17、3.18、3.19、3.20 |
| x86 | なし | なし |
| aarch64 | 3.17、3.18、3.19、3.20 | 3.17、3.18、3.19、3.20 |
| armv7 | 3.17、3.18、3.19、3.20 | 3.17、3.18、3.19、3.20 |
| armhf | なし | なし |
| s390x | 3.17 | 3.17 |
| ppc64le | なし | なし |
| riscv64 | なし | なし |
プレビュー バージョンをインストールする
.NET のプレビューおよびリリース候補バージョンは、パッケージ リポジトリでは入手できません。 .NET のプレビューとリリース候補は、次のいずれかの方法でインストールできます。
プレビュー バージョンの削除
パッケージ マネージャーを使用して .NET のインストールを管理しているとき、以前、プレビュー リリースをインストールしている場合、競合が発生することがあります。 パッケージ マネージャーは、プレビューではないリリースを .NET の以前のバージョンとして解釈することがあります。 プレビューではないリリースをインストールするには、最初にプレビュー バージョンをアンインストールします。 .NET をアンインストールする方法の詳細については、「.NET ランタイムと SDK を削除する方法」を参照してください。
依存関係
パッケージ マネージャーを使用してインストールする場合、次のライブラリが自動的にインストールされます。 ただし、手動で .NET をインストールする場合、または自己完結型アプリを公開する場合は、次のライブラリがインストールされていることを確認する必要があります。
3.18 以降
- ca-certificates-bundle
- libgcc
- libssl3
- libstdc++
- zlib
- libgdiplus (.NET アプリで System.Drawing.Common アセンブリが必要な場合)
3.15 - 3.17
- icu-libs
- krb5-libs
- libgcc
- libintl
- libssl3
- libstdc++
- zlib
- libgdiplus (.NET アプリで System.Drawing.Common アセンブリが必要な場合)
依存関係をインストールするには、apk add コマンドを使用します。
.NET アプリで System.Drawing.Common アセンブリを使用している場合、libgdiplus もインストールする必要があります。 System.Drawing.Common は Linux でサポートされなくなったため、これは .NET 6 のみで機能し、System.Drawing.EnableUnixSupport ランタイム構成スイッチを設定する必要があります。
libgdiplus をインストールするには、次を実行します。
apk add libgdiplus
次のステップ
.NET