Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

OpenShift Container Platform での .NET の使用開始

.NET 8.0

OpenShift Container Platform での .NET 8.0 のインストールと実行

Red Hat Customer Content Services

概要

このガイドでは、OpenShift Container Platform に .NET 8.0 をインストールして実行する方法を説明します。

多様性を受け入れるオープンソースの強化
リンクのコピー

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

Red Hat ドキュメントへのフィードバック (英語のみ)
リンクのコピー

Red Hat ドキュメントに関するご意見やご感想をお寄せください。また、改善点があればお知らせください。

Jira からのフィードバック送信 (アカウントが必要)

  1. Jira の Web サイトにログインします。
  2. 上部のナビゲーションバーで Create をクリックします。
  3. Summary フィールドにわかりやすいタイトルを入力します。
  4. Description フィールドに、ドキュメントの改善に関するご意見を記入してください。ドキュメントの該当部分へのリンクも追加してください。
  5. ダイアログの下部にある Create をクリックします。

第1章 概要
リンクのコピー

NET イメージは、s2i-dotnetcore からイメージストリーム定義をインポートすることで OpenShift に追加されます。

イメージストリーム定義には、サポートされる異なるバージョンの .NET の sdk イメージが含まれる dotnet イメージストリームが含まれます。.NET プログラムのライフサイクルおよびサポートポリシー では、サポートされているバージョンの最新の情報をまとめています。

Expand
バージョンタグエイリアス

.NET 6.0

dotnet:6.0-ubi8

dotnet:6.0

.NET 7.0

dotnet:7.0-ubi8

dotnet:7.0

.NET 8.0

dotnet:8.0-ubi8

dotnet:8.0

sdk イメージには、dotnet-runtime イメージストリームで定義される対応するランタイムイメージがあります。

コンテナーイメージは、Red Hat Enterprise Linux と OpenShift の異なるバージョン間で機能します。UBI-8 ベースのイメージ (suffix -ubi8) は registry.access.redhat.com でホストされ、認証は必要ありません。

第2章 .NET イメージストリームのインストール
リンクのコピー

.NET イメージストリームをインストールするには、s2i-dotnetcore のイメージストリーム定義と OpenShift Client (oc) バイナリーを使用してインストールされます。イメージストリームは、Linux、Mac、Windows からインストールできます。

.NET イメージストリームは、グローバルな openshift namespace で定義するか、プロジェクト namespace でローカルにストリームします。openshift namespace の定義を更新するには、十分な権限が必要です。

手順

  1. イメージストリームをインストール (または更新) します。 

    $ oc apply [-n namespace] -f
https://raw.githubusercontent.com/redhat-developer/s2i-dotnetcore/main/dotnet_imagestreams.json
    Copy to Clipboard Toggle word wrap

第3章 OpenShift Client を使用したアプリケーションのデプロイメント
リンクのコピー

アプリケーションのデプロイメントに OpenShift クライアント (oc) を使用できます。アプリケーションはソースまたはバイナリーアーティファクトからデプロイできます。

3.1. oc を使用したソースからのアプリケーションのデプロイメント
リンクのコピー

以下の例では、oc を使用した example-app アプリケーションのデプロイ方法を説明します。これは、redhat-developer/s2i-dotnetcore-ex GitHub リポジトリーの dotnet-8.0 ブランチの app ディレクトリーにあります。

手順

  1. 新しい OpenShift プロジェクトを作成します。 

    $ oc new-project sample-project
    Copy to Clipboard Toggle word wrap

  2. ASP .NET Core アプリケーションを追加します。 

    $ oc new-app --name=example-app 'dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnet-8.0' --build-env DOTNET_STARTUP_PROJECT=app
    Copy to Clipboard Toggle word wrap

  3. ビルドの進捗を追跡します。 

    $ oc logs -f bc/example-app
    Copy to Clipboard Toggle word wrap

  4. ビルドが完了したら、デプロイされたアプリケーションを表示します。 

    $ oc logs -f dc/example-app
    Copy to Clipboard Toggle word wrap

    これで、プロジェクト内でアプリケーションにアクセスできます。

  5. オプション: プロジェクトを外部からアクセス可能にします。 

    $ oc expose svc/example-app
    Copy to Clipboard Toggle word wrap

  6. 共有可能な URL を取得します。 

    $ oc get routes
    Copy to Clipboard Toggle word wrap

3.2. oc を使用したバイナリーアーティファクトからアプリケーションのデプロイ
リンクのコピー

.NET Source-to-Image (S2I) ビルダーイメージを使用して、提供するバイナリーアーティファクトを使用してアプリケーションをビルドできます。

前提条件

  1. 公開済みアプリケーション。

    詳細は以下を参照してください。

手順

  1. 新しいバイナリービルドを作成します。 

    $ oc new-build --name=my-web-app dotnet:8.0-ubi8 --binary=true
    Copy to Clipboard Toggle word wrap

  2. ビルドを開始し、ローカルマシンのバイナリーアーティファクトへのパスを指定します。 

    $ oc start-build my-web-app --from-dir=bin/Release/net8.0/publish
    Copy to Clipboard Toggle word wrap

  3. 新規アプリケーションを作成します。 

    $ oc new-app my-web-app
    Copy to Clipboard Toggle word wrap

第4章 .NET 8.0 の環境変数
リンクのコピー

.NET イメージは、.NET アプリケーションのビルド動作を制御する複数の環境変数をサポートします。これらの変数はビルド設定の一部として設定したり、アプリケーションのソースコードリポジトリーの .s2i/environment ファイルに追加できます。

Expand
変数名説明デフォルト

DOTNET_STARTUP_PROJECT

実行するプロジェクトを選択します。これは、プロジェクトファイル (csproj、fsproj など) またはプロジェクトファイルを 1 つ含むディレクトリーである必要があります。

.

DOTNET_ASSEMBLY_NAME

実行するアセンブリーを選択します。これには .dll 拡張子を含めないでください。これを、csproj で指定した出力アセンブリー名 (PropertyGroup/AssemblyName) に設定します。

csproj ファイルの名前

DOTNET_PUBLISH_READYTORUN

true に設定すると、アプリケーションは事前にコンパイルされます。これにより、アプリケーションの読み込み時に JIT が必要な作業量が削減されるため、起動時間が短縮されます。

false

DOTNET_RESTORE_SOURCES

復元操作中に使用される NuGet パッケージソースのスペース区切りリストを指定します。これにより、NuGet.config ファイルで指定されたすべてのソースが上書きされます。この変数を DOTNET_RESTORE_CONFIGFILE と組み合わせることはできません。

 

DOTNET_RESTORE_CONFIGFILE

復元操作に使用される NuGet.Config ファイルを指定します。この変数を DOTNET_RESTORE_SOURCES と組み合わせることはできません。

 

DOTNET_TOOLS

アプリをビルドする前にインストールする .NET ツールのリストを指定します。@<version> でパッケージ名を保留することにより、特定のバージョンをインストールできます。

 

DOTNET_NPM_TOOLS

アプリケーションをビルドする前にインストールする NPM パッケージのリストを指定します。

 

DOTNET_TEST_PROJECTS

テストするテストプロジェクトのリストを指定します。これは、プロジェクトファイルまたは、単一のプロジェクトファイルを含むディレクトリーである必要があります。各項目に対して dotnet test が呼び出されます。

 

DOTNET_CONFIGURATION

Debug モードまたは Release モードでアプリケーションを実行します。この値は、Release または Debug でなければなりません。

Release

DOTNET_VERBOSITY

dotnet build コマンドの詳細度を指定します。設定すると、環境変数はビルドの開始時に出力されます。この変数は、msbuild の詳細度 (q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic]) のいずれかに設定できます。

 

HTTP_PROXY, HTTPS_PROXY

アプリケーションをビルドおよび実行するときにそれぞれ使用される HTTP または HTTPS プロキシーを設定します。

 

DOTNET_RM_SRC

true に設定すると、ソースコードはイメージに含まれません。

 

DOTNET_SSL_DIRS

非推奨: 代わりに SSL_CERT_DIR を使用してください

 

SSL_CERT_DIR

信頼する追加の SSL 証明書を含むディレクトリーまたはファイルのリストを指定します。証明書は、ビルド中に実行する各プロセスと、ビルド後のイメージで実行するすべてのプロセス (ビルドされたアプリケーションを含む) により信頼されます。項目は、絶対パス (/ で始まる) またはソースリポジトリーのパス (証明書など) にすることができます。

 

NPM_MIRROR

ビルドプロセス中にカスタム NPM レジストリーミラーを使用してパッケージをダウンロードします。

 

ASPNETCORE_URLS

この変数は http://*:8080 に設定され、イメージにより公開されるポートを使用するように ASP.NET Core を設定します。これを変更することは推奨されません。

http://*:8080

DOTNET_RESTORE_DISABLE_PARALLEL

true に設定すると、複数のプロジェクトを並行して復元できなくなります。これにより、CPU 制限の値が低く設定された状態で、ビルドコンテナーが実行されている場合にも復元タイムアウトのエラーが減少します。

false

DOTNET_INCREMENTAL

true に設定すると、NuGet パッケージは保持され、インクリメンタルビルドに再利用できます。

false

DOTNET_PACK

true に設定すると、公開アプリケーションを含む tar.gz ファイルが /opt/app-root/app.tar.gz に作成されます。

 

第5章 .NET 8.0 を使用したサンプルアプリケーションの作成
リンクのコピー

5.1. MVC サンプルアプリケーションの作成
リンクのコピー

s2i-dotnetcore-ex は、.NET のデフォルトの Model、View、Controller (MVC) テンプレートアプリケーションです。

このアプリケーションは、.NET S2I イメージによってサンプルアプリケーションとして使用され、Try Example リンクを使用して OpenShift UI から直接作成できます。

アプリケーションは、OpenShift クライアントバイナリー (oc) を使用して作成することもできます。

手順

oc を使用してサンプルアプリケーションを作成するには、以下を行います。

  1. .NET アプリケーションを追加します。 

    $ oc new-app dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-ex#dotnet-8.0 --context-dir=app
    Copy to Clipboard Toggle word wrap

  2. アプリケーションによる外部アクセスを可能にします。 

    $ oc expose service s2i-dotnetcore-ex
    Copy to Clipboard Toggle word wrap

  3. 共有可能な URL を取得します。 

    $ oc get route s2i-dotnetcore-ex
    Copy to Clipboard Toggle word wrap

5.2. CRUD サンプルアプリケーションの作成
リンクのコピー

s2i-dotnetcore-persistent-ex は、PostgreSQL データベースにデータを格納する単純な Create、Read、Update、Delete (CRUD) の .NET Core Web アプリケーションです。

手順

oc を使用してサンプルアプリケーションを作成するには、以下を行います。

  1. データベースを追加します。 

    $ oc new-app postgresql-ephemeral
    Copy to Clipboard Toggle word wrap

  2. .NET アプリケーションを追加します。 

    $ oc new-app dotnet:8.0-ubi8~https://github.com/redhat-developer/s2i-dotnetcore-persistent-ex#dotnet-8.0 --context-dir app
    Copy to Clipboard Toggle word wrap

  3. postgresql シークレットおよびデータベースサービス名環境変数から環境変数を追加します。 

    $ oc set env dc/s2i-dotnetcore-persistent-ex --from=secret/postgresql -e database-service=postgresql
    Copy to Clipboard Toggle word wrap

  4. アプリケーションによる外部アクセスを可能にします。 

    $ oc expose service s2i-dotnetcore-persistent-ex
    Copy to Clipboard Toggle word wrap

  5. 共有可能な URL を取得します。 

    $ oc get route s2i-dotnetcore-persistent-ex
    Copy to Clipboard Toggle word wrap

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat