CentOS に .NET SDK または .NET ランタイムをインストールする

.NET は CentOS でサポートされています。 この記事では、CentOS に .NET をインストールする方法について説明します。

.NET アプリを開発する場合は、SDK をインストールします (これにはランタイムが含まれます)。 または、アプリを実行する必要があるだけの場合は、ランタイムをインストールします。 ランタイムをインストールする場合は、ASP.NET Core ランタイム をインストールすることをお勧めします。これには .NET と ASP.NET の Core ランタイムの両方が含まれているためです。

既に SDK またはランタイムをインストールしている場合は、dotnet --list-sdksdotnet --list-runtimes コマンドを使用して、インストールされているバージョンを確認します。 詳細については、.NET が既にインストールされていることを確認する方法に関するページを参照してください。

重要

パッケージ マネージャーによるインストールは、x64 アーキテクチャでのみサポートされています。 ARM などの他のアーキテクチャについては、Snap、インストーラー スクリプト、手動のバイナリ インストールなど、他の方法で .NET をインストールする必要があります。

パッケージ マネージャーを使用せずに .NET をインストールする方法の詳細については、次の記事のいずれかを参照してください。

サポートされているディストリビューション

CentOS 7 と CentOS 8 の両方で現在サポートされている .NET のリリースの一覧は、次の表のとおりです。 これらのバージョンは、.NET のバージョンがサポート終了になるか、CentOS のバージョンがサポート終了になるまでサポートされます。

  • ✔️ は、CentOS または .NET のバージョンがまだサポートされていることを示します。
  • ❌ は、CentOS または .NET のバージョンがその CentOS のリリースではサポートされていないことを示しています。
  • CentOS のバージョンと .NET のバージョンの両方に ✔️ が付いている場合、その OS と .NET の組み合わせはサポートされています。
CentOS .NET Core 2.1 .NET Core 3.1 .NET 5.0
✔️ 8 ✔️ 2.1 ✔️ 3.1 ✔️ 5.0
✔️ 7 ✔️ 2.1 ✔️ 3.1 ✔️ 5.0

次のバージョンの .NET は、サポート対象外となりました。 これらのダウンロードは、まだ公開されています。

  • 3.0
  • 2.2
  • 2.0

重要

パッケージ マネージャーによるインストールは、x64 アーキテクチャでのみサポートされています。 ARM などの他のアーキテクチャについては、Snap、インストーラー スクリプト、手動のバイナリ インストールなど、他の方法で .NET をインストールする必要があります。

パッケージ マネージャーを使用せずに .NET をインストールする方法の詳細については、次の記事のいずれかを参照してください。

プレビュー バージョンの削除

パッケージ マネージャーを使用して .NET のインストールを管理しているとき、以前、プレビュー リリースをインストールしている場合、競合が発生することがあります。 パッケージ マネージャーは、プレビューではないリリースを .NET の以前のバージョンとして解釈することがあります。 プレビューではないリリースをインストールするには、最初にプレビュー バージョンをアンインストールします。 .NET をアンインストールする方法の詳細については、「.NET ランタイムと SDK を削除する方法」を参照してください。

CentOS 8 ✔️

.NET 5.0 は CentOS 8 の既定のパッケージ リポジトリで利用できます。

SDK のインストール

.NET SDK を使用すると、.NET を使用してアプリを開発できます。 .NET SDK をインストールする場合、対応するランタイムをインストールする必要はありません。 .NET SDK をインストールするには、次のコマンドを実行します。

sudo dnf install dotnet-sdk-5.0

ランタイムをインストールする

ASP.NET Core ランタイムを使用すると、ランタイムを提供しない .NET を使用して作成されたアプリを実行できます。 次のコマンドを実行すると、.NET の最も互換性の高いランタイムである ASP.NET Core ランタイムがインストールされます。 ご利用のターミナルで、次のコマンドを実行します。

sudo dnf install aspnetcore-runtime-5.0

ASP.NET Core ランタイムの代替手段として、ASP.NET Core サポートを含まない .NET ランタイムをインストールできます。それには、前のコマンドの aspnetcore-runtime-5.0dotnet-runtime-5.0 で置き換えます。

sudo dnf install dotnet-runtime-5.0

CentOS 7 ✔️

.NET をインストールする前に、次のコマンドを実行して、信頼されたキーの一覧に Microsoft パッケージ署名キーを追加し、Microsoft パッケージ リポジトリを追加します。 ターミナルを開き、次のコマンドを実行します。

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm

SDK のインストール

.NET SDK を使用すると、.NET を使用してアプリを開発できます。 .NET SDK をインストールする場合、対応するランタイムをインストールする必要はありません。 .NET SDK をインストールするには、次のコマンドを実行します。

sudo yum install dotnet-sdk-5.0

ランタイムをインストールする

ASP.NET Core ランタイムを使用すると、ランタイムを提供しない .NET を使用して作成されたアプリを実行できます。 次のコマンドを実行すると、.NET の最も互換性の高いランタイムである ASP.NET Core ランタイムがインストールされます。 ご利用のターミナルで、次のコマンドを実行します。

sudo yum install aspnetcore-runtime-5.0

ASP.NET Core ランタイムの代替手段として、ASP.NET Core サポートを含まない .NET ランタイムをインストールできます。それには、前のコマンドの aspnetcore-runtime-5.0dotnet-runtime-5.0 で置き換えます。

sudo yum install dotnet-runtime-5.0

その他のバージョンをインストールする方法

パッケージ マネージャーのフィードに追加されるパッケージは、変更可能な {product}-{type}-{version} の形式で名前が付けられます。

  • product
    インストールする .NET 製品の種類。 有効なオプションは次のとおりです。

    • dotnet
    • aspnetcore
  • type
    SDK またはランタイムを選択します。 有効なオプションは次のとおりです。

    • SDK
    • ランタイム
  • version
    インストールする SDK またはランタイムのバージョン。 この記事では常に、サポートされている最新バージョンの手順について説明します。 有効なオプションは、次のようなリリース バージョンです。

    • 5.0
    • 3.1
    • 3.0
    • 2.1

    ダウンロードしようとしている SDK/ランタイムが Linux ディストリビューションで使用できない可能性があります。 サポートされているディストリビューションの一覧については、「.NET Core の依存関係と要件」を参照してください。

使用例

  • ASP.NET Core 5.0 ランタイムをインストールする: aspnetcore-runtime-5.0
  • .NET Core 2.1 ランタイムをインストールする: dotnet-runtime-2.1
  • .NET 5.0 SDK をインストールする: dotnet-sdk-5.0
  • .NET Core 3.1 SDK をインストールする: dotnet-sdk-3.1

パッケージがない

パッケージ バージョンの組み合わせが正しくない場合は、使用できません。 たとえば、ASP.NET Core SDK がない場合、SDK コンポーネントは .NET SDK に含まれています。 値 aspnetcore-sdk-2.2 は正しくありません。dotnet-sdk-2.2 にする必要があります .NET Core によってサポートされている Linux ディストリビューションの一覧については、.NET の依存関係と要件に関するページを参照してください。

パッケージ マネージャーのトラブルシューティング

このセクションでは、パッケージ マネージャーを使用して .NET をインストールするときに発生するおそれがある一般的なエラーについて説明します。

パッケージが見つからない

重要

パッケージ マネージャーによるインストールは、x64 アーキテクチャでのみサポートされています。 ARM などの他のアーキテクチャについては、Snap、インストーラー スクリプト、手動のバイナリ インストールなど、他の方法で .NET をインストールする必要があります。

パッケージ マネージャーを使用せずに .NET をインストールする方法の詳細については、次の記事のいずれかを参照してください。

フェッチできない

.NET パッケージのインストール中に、signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod' のようなエラーが表示されることがあります。 一般に、このエラーは、.NET のパッケージ フィードが新しいバージョンのパッケージでアップグレード中であり、後でもう一度試す必要があることを意味しています。 アップグレード中は、2 時間以上パッケージ フィードを利用できません。 2 時間以上このエラーが継続的に発生する場合は、https://github.com/dotnet/core/issues でイシューを報告してください。

依存関係

パッケージ マネージャーを使用してインストールする場合、次のライブラリが自動的にインストールされます。 ただし、手動で .NET Core をインストールする場合、または自己完結型アプリを公開する場合は、次のライブラリがインストールされていることを確認する必要があります。

  • krb5-libs
  • libicu
  • openssl-libs
  • zlib

ターゲット ランタイム環境の OpenSSL バージョンが 1.1 以降である場合は、compat-openssl10 をインストールする必要があります。

依存関係の詳細については、「Self-contained Linux applications」(自己完結型 Linux アプリケーション) をご覧ください。

System.Drawing.Common アセンブリを使用する .NET Core アプリの場合は、次の依存関係も必要です。

次のステップ