1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Blazor×Radzen】爆速でデータベースアプリの土台を作る環境構築と初期設定(連載第1回)

1
Last updated at Posted at 2026-11-10

はじめに

こんにちは。40年間「理想のDBアプリ開発ツール」を追い求め、ついに『Radzen × Blazor Server』という最強の組み合わせに辿り着いた男です。

前回の「第0回(予告編)」では、なぜこの構成が現代のサイバー攻撃(APIを狙った情報漏洩など)に対する究極のカウンターアーキテクチャになるのか、その構造的な強みをお話ししました。

いよいよ今回から本編のスタートです。
第1回となる今回は、実際にLinuxサーバーでの公開を見据えた 「システムの全体像(インフラ構成仕様)」 と、Windows環境で爆速でアプリの土台を組み上げ、Linux向けにパッケージングする 「開発・発行フェーズ」 のリアルな手順とノウハウをお届けします。


1. 究極の効率と安全を両立する「インフラ構成仕様」

私が構築した、高効率な業務画面構築と堅牢なバックエンド処理を両立する最新の環境構成がこちらです。NorthwindやAdventureworks、RadzenCRMといったWebアプリケーション群をこの上でスケールさせています。

これらは、私の 「爆速開発環境を求める」 目的で、趣味として開発しました。そのため、サンプルとしてマイクロソフトやRadzenより提供されているデータベースを活用しています。なお、この開発はまとまった時間が確保できる失業中の期間を使いました。黙って見守ってくれていた妻には、この場を借りて心から感謝しています。

項目 設定仕様・採用技術 狙いと備考
開発 OS Windows 11 デバッグおよび Visual Studio 実行環境
開発ツール (IDE) Visual Studio 2026 バージョンアップ後の最新統合開発環境
ターゲットフレームワーク .NET 10.0 .NET 6.0 / 9.0 から移行した最新トレンド
UI ライブラリ Radzen Blazor Components コンポーネント指向UI / ダイアログ / データグリッド
ORM / データアクセス Entity Framework Core 9.0 Pomelo.EntityFrameworkCore.MySql 併用
サーバー OS Linux (AlmaLinux 9.x / Ubuntu) 本番および検証用の低コスト・高安定サーバー
データベース MariaDB 10.x / 12.0 SQL Serverから移行。Linux特有の設定を適用
Web サーバー Nginx + Kestrel HTTPS終端および SignalR/WebSocket 転送用
プロセス管理 systemd 常駐サービス化・自動再起動・環境変数制御
SSL / TLS 証明書 独自SSL証明書 独自ドメインに対応した証明書・秘密鍵設定

【ここに注目!】あえて一世代前の「EF Core 9.0」を組み合わせる理由

環境仕様を見て、「おや? .NET 10.0 なのに Entity Framework Core(ORM)が 9.0 なのはなぜ?」と気づいた方は非常に鋭いです。

実は予告編でも少し触れましたが、最新の .NET 10.0(VS2026環境)へ移行する際、MySQL/MariaDB用のプロバイダである Pomelo.EntityFrameworkCore.MySql の「10.0対応版」がまだ検証中で、NuGetで取得できないという罠がありました。そのため、あえて他の依存関係とのバランスを取りながら 「EF Core 9.0」の構成で安定させる という現場のリアルな防衛策をとっています。このあたりの泥臭いトラブルの詳細は、第2回のDB編で詳しく解説します。


2. 私がRadzenに最高に感激した「数分間の奇跡」

ここで、私がRadzenを触って震えるほど感激した、このツールの圧倒的な破壊力について語らせてください。

通常、業務アプリケーションをゼロから作ろうとすると、ログイン画面を作り、各テーブルのCRUD(追加・読み込み・更新・削除)画面を作り、それらを繋ぐメニュー画面を構成するだけで、早くても1〜2ヶ月、下手をすれば半年以上の膨大な作業量と工数がかかります。

しかしRadzenは、「データベースさえ用意して接続すれば、数分待つだけ」 で、以下のすべてを完全に動作する状態で一発自動生成してしまうのです。

  • 完全に機能するセキュアなログイン画面
  • サイドメニューと選択したテーブルのデータ一覧画面
  • 選択したデータの編集ダイアログ

しかも、自動生成された一覧グリッド(DataGrid)のクオリティが凄まじい。高度なフィルタリング、キーワード検索、ソート機能はもちろん、CSVやExcelへのデータ出力機能まで最初からフル機能で実装されているのです。

【視覚的衝撃:これがRadzenが一発自動生成した画面】

  • 画面①:自動生成されたログイン画面
    radzen023.jpg

  • 画面②:全テーブル名が縦一列に並んだ初期サイドメニューと一覧グリッド
    radzen025.jpg

  • 画面③:自動生成された標準のデータ編集用ダイアログ
    radzen026.jpg

もちろん、この一発自動生成だけで実際の業務要件を100%満たすものは出来上がりません。ここから独自のカスタマイズを加えていく必要があります。しかし、プロトタイプ(たたき台)としてはこれ以上ないほど完璧です。

エクセルメインで業務を回している中小企業や小規模な現場であれば、この自動生成を見た瞬間に 「もうこれで十分だよ! Linuxへのデプロイもいらない、社内に余っているWindows PCをサーバーにして明日から動かそう。開発完了!」 となってしまうレベルの衝撃です。通常開発の数ヶ月分が、文字通り「数分」で終わる。これがRadzenの真骨頂です。


3. 開発・機能拡張フェーズ(Windows環境での仕込み)

ここからは、その自動生成された土台をベースに、後々「Linuxサーバーへデプロイして動かす」ことを見据えて、Windows環境での開発段階からあらかじめ仕込んでおくべき3つの重要ポイントを解説します。

【開発中のデザイナー画面】

radzen027.jpg

  • 説明文:Radzenの視覚的なデザイナーの画面です。左側で編集したい画面を選び、その後にコンポーネントをドラッグ&ドロップし、プロパティを設定することで、裏側で綺麗なC#(Blazor)コードがリアルタイム生成されます。
    なお、Pro版は、Visual Studio 2026 側でのGUI編集も可能となります。

① Linux環境を意識したデータベースマッピング

データベースのリレーションシップに基づき、EF Coreのエンティティクラス(例: Opportunity.cs)にナビゲーションプロパティや [ForeignKey] 属性を定義していきます。

ここで最大の注意点が 「テーブル名の大文字・小文字問題」 です。Windows環境では曖昧でも動いてしまいますが、Linux(MariaDB)環境に持っていくと完全に区別されるため、一発でエラーになります。
そのため、Program.cs側で UseSnakeCaseNamingConvention() を適用したり、モデルマッピングを明示化して、OS間のギャップを事前に埋めておきます。

また、伝票入力などの「Master-Detail(親明細・子明細)構成」に対応するため、明細テーブルへ表示順序管理カラム(SortOrder や SeqNo)を追加し、複合主キー設計の見直しもこの段階で実施しました。

② Radzen UIコンポーネントの正確なバインド

Radzenの強力なコンポーネントである RadzenDropDownDataGrid や RadzenDataGrid を配置していきます。
ここで重要なのは、Data, Value, ValueProperty, TextProperty のプロパティを正確にバインドすることです。ここがバチッとハマるだけで、データベースと連動した高度なグリッドやドロップダウンが、JavaScriptを1行も書くことなく画面上に組み上がります。

初期画面(Main.razor)には、売上集計グラフやKPIカードを配置し、業務の進捗が一目でわかる「コックピット型ダッシュボード」を構築しました。さらに、多言語ローライズ基盤も組み込み、AIを活用して一気にメッセージの日本語化を進めています。

③ リバースプロキシを見据えた「サブパス(URL階層)対応」

将来的に1台のLinuxサーバー(Nginx)の裏で、複数のアプリ(/Northwind や /RadzenCRM など)をサブパス運用で共存させるための仕込みです。

まず、appsettings.Production.json などの構成ファイルに、ベースとなるパスを定義します。

{
  "AppBasePath": "/Northwind"
}

そして、Program.cs 内でこの値を読み込み、ミドルウェアを適用します。

// サブパス運用時のルーティングおよび静的リソースパスの補正
var basePath = builder.Configuration["AppBasePath"];
if (!string.IsNullOrEmpty(basePath))
{
    app.UsePathBase(basePath);
}

この一行を開発初期から入れておくことで、リバースプロキシ(Nginx)を通した際のルーティングや画像・CSSなどの静的リソースのリンク切れを根本的に防ぐことができます。


4. アプリケーション発行(Publish)フェーズ

Windows環境での実装とデバッグが完了したら、いよいよLinux環境へ旅立つためのパッケージング(発行)を行います。使い慣れたVisual Studioから直接行えるため、特殊なコマンドは不要です。

  1. 発行プロファイルの作成
    Visual Studio 2026にてプロジェクトを右クリックし、「発行」を選択してフォルダプロファイルを作成します。
  2. ターゲットの設定
    • 構成:Release
    • ターゲットランタイム:linux-x64
    • ターゲットフレームワーク:.NET 10.0
  3. 発行方式の選択(ここが分かれ道)
    サーバー環境に応じて以下のどちらかを選択します。
    • フレームワーク依存(Framework-dependent):Linuxサーバー側にあらかじめ .NET 10.0 ランタイムをインストールしておく方式。
    • 自己完結型(Self-contained):成果物のフォルダ内に .NET 10.0 の実行環境(ランタイム)を丸ごと同梱してしまう方式。Linuxサーバー側の環境を汚さず、ランタイムのバージョン不整合に悩まされないため、個人的にはこちらの「自己完結型」がトラブルが少なくておすすめです。

「発行」ボタンをクリックすると、指定した出力フォルダへ、DLL、構成ファイル群、そしてフロントエンドの静的資産が詰まった wwwroot フォルダなど、Linux上でそのまま動く成果物一式が美しく書き出されます。


次回予告:いよいよMySQL(MariaDB)とのデータ連携へ!

これで、Linuxに持っていくための「セキュアで爆速なBlazor Serverアプリのパッケージ」が手元に完成しました。

しかし、これを本当にLinux環境で動かすためには、バックエンドのデータベースとの安全・確実な接続が不可欠です。次回の第2回は、【Radzen】MySQL(MariaDB)をデータソースとして安全・確実に連携させるノウハウ をテーマに、あの「EF Coreパッケージのバージョン不整合の罠」の具体的な突破法を含めてお送りします。

ぜひ、アカウントのフォローをしてお待ちください!

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?