ASP.NET Core デプロイガイド

ASP.NET Core アプリケーションを MySQL と Nginx を使用して Ubuntu 18.04 にデプロイする方法

ASP.NET Core アプリケーションを Ubuntu 18.04 にデプロイする際、MySQL データベースを使用し、Nginx をリバースプロキシとして設定することは一般的な構成です。このガイドでは、これらのステップを順を追って説明します。

1. 必要なツールとパッケージのインストール

まず、必要なソフトウェアと依存関係をインストールします。これには、ASP.NET Core ランタイム、MySQL、Nginx などが含まれます。

a. .NET Core ランタイムのインストール

1. Microsoft のリポジトリを追加します。

bash
CopyEdit
sudo apt-get update
sudo apt-get install -y apt-transport-https
sudo wget https://packages.microsoft.com/config/ubuntu/18.04/prod.list
sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list
sudo wget https://packages.microsoft.com/keys/microsoft.asc
sudo apt-key add microsoft.asc

2. 必要なパッケージをインストールします。

bash
CopyEdit
sudo apt-get update
sudo apt-get install -y dotnet-sdk-6.0

b. MySQL のインストール

1. MySQL の公式リポジトリを追加します。

bash
CopyEdit
sudo apt-get install -y software-properties-common
sudo add-apt-repository ppa:ondrej/mysql-5.7

2. MySQL をインストールします。

bash
CopyEdit
sudo apt-get update
sudo apt-get install -y mysql-server

3. MySQL をセットアップし、セキュリティ設定を行います。

bash
CopyEdit
sudo mysql_secure_installation

これで MySQL のインストールは完了です。次に、ASP.NET Core アプリケーション用のデータベースを作成します。

bash
CopyEdit
sudo mysql -u root -p
CREATE DATABASE your_database_name;
CREATE USER 'your_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

c. Nginx のインストール

1. Nginx をインストールします。

bash
CopyEdit
sudo apt-get install -y nginx

2. Nginx を起動し、システム起動時に自動的に開始するように設定します。

bash
CopyEdit
sudo systemctl start nginx
sudo systemctl enable nginx

2. ASP.NET Core アプリケーションのビルドと発行

次に、ASP.NET Core アプリケーションをビルドし、Ubuntu サーバーに発行します。

a. プロジェクトのビルド

1. プロジェクトディレクトリに移動します。

bash
CopyEdit
cd /path/to/your/project

2. アプリケーションを発行します。

bash
CopyEdit
dotnet publish --configuration Release --output /var/www/yourapp

b. 環境変数の設定

アプリケーションが MySQL に接続できるように、接続文字列を環境変数として設定します。例えば、appsettings.json に次のように接続文字列を追加します。

json
CopyEdit
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=your_database_name;User=your_user;Password=your_password;"
  }
}

3. ASP.NET Core アプリケーションをバックグラウンドで実行する

ASP.NET Core アプリケーションをバックグラウンドで実行するために、systemd サービスを使用します。

1. 新しい systemd サービスファイルを作成します。

bash
CopyEdit
sudo nano /etc/systemd/system/yourapp.service

2. サービスファイルの内容を以下のように設定します。

ini
CopyEdit
[Unit]
Description=ASP.NET Core Application
After=network.target

[Service]
WorkingDirectory=/var/www/yourapp
ExecStart=/usr/bin/dotnet /var/www/yourapp/yourapp.dll
Restart=always
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ConnectionStrings__DefaultConnection=Server=localhost;Database=your_database_name;User=your_user;Password=your_password;

[Install]
WantedBy=multi-user.target

3. サービスを有効にして起動します。

bash
CopyEdit
sudo systemctl enable yourapp.service
sudo systemctl start yourapp.service

4. Nginx の設定

Nginx をリバースプロキシとして設定し、外部からのリクエストを ASP.NET Core アプリケーションに転送します。

1. Nginx サイト設定を編集します。

bash
CopyEdit
sudo nano /etc/nginx/sites-available/yourapp

2. 以下のような設定を追加します。

nginx
CopyEdit
server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

3. サイト設定を有効にして、Nginx を再起動します。

bash
CopyEdit
sudo ln -s /etc/nginx/sites-available/yourapp /etc/nginx/sites-enabled/
sudo systemctl restart nginx

5. ファイアウォール設定

もし UFW を使用している場合、HTTP トラフィックを許可します。

bash
CopyEdit
sudo ufw allow 'Nginx Full'
sudo ufw enable

6. 動作確認

1. サーバーの IP アドレスまたはドメイン名をブラウザに入力し、アプリケーションが正常に動作していることを確認します。

2. エラーログやアクセスログを確認して、問題がないか確認します。

bash
CopyEdit
sudo journalctl -u yourapp.service

まとめ

このガイドでは、ASP.NET Core アプリケーションを Ubuntu 18.04 上で MySQL と Nginx を使ってデプロイする方法を紹介しました。MySQL の設定、Nginx のリバースプロキシ設定、そしてアプリケーションのバックグラウンド実行を含む一連のプロセスをカバーしました。この設定により、強力でスケーラブルな ASP.NET Core アプリケーションのデプロイメントが可能になります。