WSL UbuntuでASP.NET Core+SQLiteの開発環境のをつくる

オウルです。

今回は、ASP.NET Core 3.1 MVC アプリの開発環境を WSL Ubuntu に準備します。

※ Windows 版は、こちらを参考にしてください。

https://book2525stack.com/2020/01/15/windows-netcore-development-env

オウルです。今回は、ASP.NET Core 3.1 MVC アプリの開発環境を Windows に準備します。※ WSL Ubuntu 版は、こちらを参考にしてください。RDBMS は本業で SQLServer を１０年近く使用しているため、SQLServer でと考えていましたが、SQL Server on Linux を動作させるためのマシンのメモリが、最低２ＧＢ要求されるため、今回は SQLite を使用します。Windows 開発環境を構築ローカル環境OSWindows10IDEVisual Studio 2019 v16.4～SDKASP.NET Core 3.1RDBMSSQLite 3.30.1.NET Core 3.1 SDK インストールDownload .NET Core 3.1 から、S...

RDBMS は本業で SQLServer を１０年近く使用しているため、SQLServer でと考えていましたが、SQL Server on Linux を動作させるためのマシンのメモリが、最低２ＧＢ要求されるため、今回は SQLite を使用します。

WSL Ubuntu 開発環境を構築

ローカル環境

Client OS	Windows10
WSL	Ubuntu 18.04.2 LTS
Editor	Visual Studio Code
SDK	ASP.NET Core 3.1
RDBMS	SQLite 3.22.0

WSL Ubuntu 18.04.2 LTS インストール

WSL に Ubuntu 18.04.2 LTS インストールする方法は、次の記事を参考にしてください。

雲の上はいつも晴れ

WSL に Ubuntu をインストール

https://book2525stack.com/2019/07/27/wsl-ubuntu-install

オウルです。WSL2（Windows Subsystem for Linux 2）のプレビューが開始されていますね。ということで WSL2 の正式リリース前に WSL をインストールしてみます。Microsoft: WSL 2 についてMicrosoft de:code 2019 では少しですが WSL2 と WSL を比較するセッションがありました。アカウントをお持ちで興味のある方は、ご覧ください（アカウントがない方は作成すれば無料で見れます）Microsoft: de:code 2019ではインストールしてみます。OS は Windows 10 を前提とします。WSL インストールオプションの有効化# コマンドプロンプトから...

.NET Core 3.1 SDK インストール

コマンドプロンプトを起動して、次のコマンドを実行します。

:: WSL Ubuntu に接続
wsl
:: Microsoft キー・リポジトリを登録、必要な依存関係をインストール
:: .NET Core SDK をインストール
sudo wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install apt-transport-https
sudo apt update
sudo apt install dotnet-sdk-3.1

:: WSL Ubuntu に接続

wsl

:: Microsoft キー・リポジトリを登録、必要な依存関係をインストール

:: .NET Core SDK をインストール

sudo wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

sudo dpkg -i packages-microsoft-prod.deb

sudo apt update

sudo apt install apt-transport-https

sudo apt update

sudo apt install dotnet-sdk-3.1

Visual Studio Code インストール

Visual Studio Code インストール、Remote-WSL の設定は、こちらの記事を参考にしてください（Rust はインストールする必要ありません）

雲の上はいつも晴れ

【初心者向け】WSL+ VS Code + Rust の開発環境をつくる

https://book2525stack.com/2019/07/31/wsl-vscode-rust

オウルです。タイトルにある通り、今回は Windows Subsystem for Linux（以降 WSL）+ Visual Studio Code（以降 VS Code） + Rust の開発環境をつくります。RustRust（ラスト）は Mozilla が支援するオープンソースのシステムプログラミング言語です。Most LovedStack Overflow Developer Survey で「最も愛されているプログラミング言語」で一位を獲得しています。Stack Overflow: Most Loved, Dreaded, and Wanted僕が、Rust を知ったのはホント最近できっかけは ↓ の記事です。Stack Overflow: マイクロソフト、セキュアなコード実...

ASP.NET Core MVC プロジェクトの作成

WSL Ubuntu に接続して、次のコマンドを実行します。

// ホームディレクトリに移動
cd ~
// ディレクトリ作成
mkdir aspnetcore
// プロジェクト作成
dotnet new mvc -au Individual -o <AspNetCore_Project>
// プロジェクトファイルがあるディレクトリに移動
cd LinuxDeployWebApp
// ASP.NET Core MVC プロジェクト を Visual Studio Code で起動
code .

// ホームディレクトリに移動

cd ~

// ディレクトリ作成

mkdir aspnetcore

// プロジェクト作成

dotnet new mvc -au Individual -o <AspNetCore_Project>

// プロジェクトファイルがあるディレクトリに移動

cd LinuxDeployWebApp

// ASP.NET Core MVC プロジェクトを Visual Studio Code で起動

code .

拡張機能インストール

次の拡張機能をインストールします。

Debugger for Chrome
C#
EditorConfig for VS Code

NLog パッケージインストール

ASP.NET Core では、組み込みやサードパーティ製のさまざまなログプロバイダーと連携するログ API がサポートされています。公式ページにはログプロバイダーの一覧があります。その中で便利な NLog を使用します。

Visual Studio Code の Terminal から次のコマンドを実行します。

// NLog パッケージインストール
sudo dotnet add package NLog.Web.AspNetCore --version 4.9.0
sudo dotnet add package NLog --version 4.6.8

// NLog パッケージインストール

sudo dotnet add package NLog.Web.AspNetCore --version 4.9.0

sudo dotnet add package NLog --version 4.6.8

NLog の設定方法は、Getting started with ASP.NET Core 3 を参考にしてください。

ASP.NET Core 2.x の NLog は、次の記事にまとめています。

雲の上はいつも晴れ

【初心者向け】はじめての ASP.NET Core 作りながら学習（4）- NLog

https://book2525stack.com/2019/05/09/beginner-aspnetcore-nlog

オウルです。前回のIntelliCode編の続きです。今回はアプリケーション開発において重要なログです。ASP.NET Core では、組み込みやサードパーティ製のさまざまなログプロバイダーと連携するログ API がサポートされています。公式ページにはログプロバイダーの一覧がありますよ。「はじめての ASP.NET Core 作りながら学習」では、その中で便利な NLog を使用します。公式：サードパーティ製のログプロバイダーの一覧NLogNLogとはNLog is a flexible and free logging platform for various .NET platforms, including .NET standard...

Startup.cs

デフォルトで SQLite を使用するように構成されています。

デバッグ

デバッグ / 構成の追加をクリックして ”{} .NET: Launch a local .NET Core Web App” を選択します。次のように「launch.json」に構成が追加されます。

{
    // Use IntelliSense to find out which attributes exist for C# debugging
    // Use hover for the description of the existing attributes
    // For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (web)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            // If you have changed target frameworks, make sure to update the program path.
            "program": "${workspaceFolder}/bin/Debug/netcoreapp3.1/<AspNetCore_Project.dll>",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
            // Enable launching a web browser when ASP.NET Core starts. For more information: https://aka.ms/VSCode-CS-LaunchJson-WebBrowser
            "serverReadyAction": {
                "action": "openExternally",
                "pattern": "^\\s*Now listening on:\\s+(https?://\\S+)"
            },
            "env": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            },
            "sourceFileMap": {
                "/Views": "${workspaceFolder}/Views"
            }
        }
    ]
}

{

// Use IntelliSense to find out which attributes exist for C# debugging

// Use hover for the description of the existing attributes

// For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md

"version": "0.2.0",

"configurations": [

{

"name": ".NET Core Launch (web)",

"type": "coreclr",

"request": "launch",

"preLaunchTask": "build",

// If you have changed target frameworks, make sure to update the program path.

"program": "${workspaceFolder}/bin/Debug/netcoreapp3.1/<AspNetCore_Project.dll>",

"args": [],

"cwd": "${workspaceFolder}",

"stopAtEntry": false,

// Enable launching a web browser when ASP.NET Core starts. For more information: https://aka.ms/VSCode-CS-LaunchJson-WebBrowser

"serverReadyAction": {

"action": "openExternally",

"pattern": "^\\s*Now listening on:\\s+(https?://\\S+)"

"env": {

"ASPNETCORE_ENVIRONMENT": "Development"

"sourceFileMap": {

"/Views": "${workspaceFolder}/Views"

}

]

}

WSL 証明書を信頼するように Windows 証明書ストアを構成します。

:: WSL によって生成された証明書をエクスポート
dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p <cryptic-password>

1 2	:: WSL によって生成された証明書をエクスポート dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p <cryptic-password>

「launch.json」に、次の環境変数を追加します。

"ASPNETCORE_Kestrel__Certificates__Default__Password": <cryptic-password>,
"ASPNETCORE_Kestrel__Certificates__Default__Path": "/mnt/c/Users/<user_name>/.aspnet/https/aspnetapp.pfx",

1 2	"ASPNETCORE_Kestrel__Certificates__Default__Password": <cryptic-password>, "ASPNETCORE_Kestrel__Certificates__Default__Path": "/mnt/c/Users/<user_name>/.aspnet/https/aspnetapp.pfx",

デバッグを実行します。トップページの Register リンクをクリックして、アカウントを登録します。

上記の図のようにログイン状態になると、アカウント登録は成功です。一応データベースの登録内容を確認します。

:: プロジェクトファイルのディレクトリに移動
cd *****
:: データベースに接続
sqlite3 app.db
SQLite version 3.22.0 2018-01-22 18:45:57
Enter ".help" for usage hints.
:: テーブル一覧を確認
sqlite>.table
AspNetRoleClaims       AspNetUserLogins       AspNetUsers
AspNetRoles            AspNetUserRoles        __EFMigrationsHistory
AspNetUserClaims       AspNetUserTokens
:: 登録したアカウントを確認
sqlite> select * from AspNetUsers where Email = 'hogehoge@test.com';
7e9cc5be-2015-4787-84a7-f83fcc1d1604|0|59d7d175-c9ce-4316-ace5-bb734cc2cd5f|hogehoge@test.com|0|1||HOGEHOGE@TEST.COM|HOGEHOGE@TEST.COM|AQAAAAEAACcQAAAAEDiHOOxMGyoMf0rRQK2fjvfo8sKkUkoJq+DO92QX5uOf7f8JvFIcsjdBjp984EESRA==||0|QTWXQRHRRE6YOTAZH7T2VCFS2HX7URW3|0|hogehoge@test.com

:: プロジェクトファイルのディレクトリに移動

cd *****

:: データベースに接続

sqlite3 app.db

SQLite version 3.22.0 2018-01-22 18:45:57

Enter ".help" for usage hints.

:: テーブル一覧を確認

sqlite>.table

AspNetRoleClaims AspNetUserLogins AspNetUsers

AspNetRoles AspNetUserRoles __EFMigrationsHistory

AspNetUserClaims AspNetUserTokens

:: 登録したアカウントを確認

sqlite> select * from AspNetUsers where Email = 'hogehoge@test.com';

7e9cc5be-2015-4787-84a7-f83fcc1d1604|0|59d7d175-c9ce-4316-ace5-bb734cc2cd5f|hogehoge@test.com|0|1||HOGEHOGE@TEST.COM|HOGEHOGE@TEST.COM|AQAAAAEAACcQAAAAEDiHOOxMGyoMf0rRQK2fjvfo8sKkUkoJq+DO92QX5uOf7f8JvFIcsjdBjp984EESRA==||0|QTWXQRHRRE6YOTAZH7T2VCFS2HX7URW3|0|hogehoge@test.com

今回作成した ASP.NET Core MVC アプリを WSL Ubuntu + Nginx でホストするのは、こちらをご覧ください。

雲の上はいつも晴れ