ExcelCreator12をWebアプリに組み込みAmazon ECS(AWS Fargate)にデプロイする

ExcelCreator12は動作保証を行っている環境の中にクラウドのAWS(Amazon Web Services)が含まれています。

この記事では、Webアプリケーションをコンテナイメージ化して、AWSが提供するコンテナサービスのAmazon ECS(Elastic Container Service)へデプロイする方法について解説していきます。

本記事で利用するAmazon ECSおよびAmazon ECR(Elastic Container Registry)は有料のサービスです。
Amazon ECR上へコンテナイメージを置き続けたり、Amazon ECS上で作成したサービスを実行し続けると、継続的に料金が加算されますのでご注意ください。

環境
- 実行環境
- 開発環境
環境構築
Webアプリケーションを作成する
Amazon ECSにデプロイする
出力結果の確認
さいごに

環境

実行環境

Amazon ECS

開発環境

Windows 11
.NET6
Visual Studio 2022
ExcelCreator12
Docker Desktop
AWS CLI

環境構築

コンテナイメージの作成、およびAWSへのデプロイに必要なソフトウェアをインストールします。

Docker Desktop
Windows用インストーラーをダウンロードし、ローカル環境にインストールします。
AWS CLI
Webブラウザで「AWS CLI」などで検索し、AWSサイトからAWS CLIのインストーラーをダウンロードしてローカル環境にインストールします。
AWS CLIを利用する為には、AWS CLIインストール後、認証の設定が必要となります。詳細な手順についてはAWSのWebサイト等でご確認ください。

Webアプリケーションを作成する

Excelファイルを生成しダウンロードする簡単なWebアプリを作成していきます。

新規プロジェクト(ASP.NET Core Web MVC)を作成する

Visual Studioを起動し、[新しいプロジェクト] > [ASP.NET Core Web アプリ(Model-View-Controller)]を選択後、任意のプロジェクト名を入力して[次へ]をクリックします。

追加情報を選択して[作成]をクリックします。

フレームワーク：.NET 6.0
コンテナーのサポートを有効にする
コンテナーOS：Linux
コンテナービルドの種類：Dockerfile

ExcelCreator12のインストール

プロジェクトにExcelCreator12をインストールします。
ソリューションエクスプローラーの[依存関係]を右クリックし、[NuGetパッケージの管理]を選択します。

パッケージソースにnuget.orgを指定し、検索ボックスで"AdvanceSoftware.ExcelCreator.Creator"と入力してパッケージファイルを検索します。
パッケージファイルがヒットしたら選択し、[インストール]ボタンをクリックしてインストールします。

プログラムの実装

[Controllers] > [HomeController.cs]にExcelファイル生成用のCreateExcelFileメソッドを追加します。

// Controllers/HomeController.cs
[HttpPost]
public IActionResult CreateExcelFile()
{
    System.IO.MemoryStream strmExcel = new System.IO.MemoryStream();
    // ExcelCretor で Excel ファイルを新規作成する処理 
    AdvanceSoftware.ExcelCreator.Creator creator1 = new AdvanceSoftware.ExcelCreator.Creator();
    // シート数:1、Excel バージョン:2021 で Excel ファイルを新規作成し、ストリームに出力します。
    creator1.CreateBook(strmExcel, 1, AdvanceSoftware.ExcelCreator.xlsxVersion.ver2021);
    creator1.Cell("A1").Value = "Amazon ECS 上で ExcelCreator を使用し Excel ファイルを作成";
    creator1.CloseBook(true);
    strmExcel.Close();
    return File(strmExcel.ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Book1.xlsx");
}

次に[Views] > [Home] > [Index.cshtml]にExcelファイルのダウンロード用ボタンを追加します。

<!-- Views/Home/Index.cshtml -->
@{
    ViewData["Title"] = "Home Page";
}

@using (Html.BeginForm("CreateExcelFile", "Home"))
{
    <p><input type="submit" formmethod="post" value="Excel ファイル作成" /></p>
}
<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

Dockerfileを編集する

Dockerfileの記述内容を下記のように編集します。

FROM ubuntu:22.04
WORKDIR /app

RUN apt-get update \
    && apt-get install -y aspnetcore-runtime-6.0 \
    && apt install -y libgdiplus

COPY ./publish/ /app/

EXPOSE 5000

ENTRYPOINT ["dotnet", "EC12WebAppSample.dll"]

Webアプリは以上で完成です。
なお、ここで作成したWebアプリのプロジェクトは以下のURLからダウンロードできます。

https://www.adv.co.jp/download/blog/deploy-excelcreator12-ecs/EC12WebAppSample.zip

Amazon ECSにデプロイする

作成したアプリケーションをAmazon ECSにデプロイする準備を行います。

フォルダーに発行

Visual Studio上で「発行」をクリックし、フォルダーにデプロイします。

今回は下記のようにプロファイルを編集してデプロイします。

構成：Release
ターゲットフレームワーク：net6.0
配置モード：フレームワーク依存
ターゲットランタイム：linux-x64

Amazon ECRにコンテナイメージを配置する

リポジトリを作成する

コンテナイメージを配置するための格納場所として、Amazon ECR上にリポジトリを作成します。今回はプライベートリポジトリを作成します。

Amazon ECRのトップ画面で「作成」をクリックします。

リポジトリ名を入力して[作成]をクリックします。(今回は「ec12webappsample」とします)

Dockerイメージをリポジトリにプッシュ(送信)する

リポジトリの作成が完了すると、リポジトリ一覧に表示されます。作成したリポジトリを選択(リポジトリ名の左側にある〇をチェック)し、「プッシュコマンドを表示」をクリックして、イメージをプッシュする為のコマンドを表示させます。

画面上の各コマンドをコピーし、コマンドプロンプト、またはPowerShell上でコマンド入力を行います。
この時、「macOS/Linux」「Windows」2つのタブが表示されますが、AWS CLIでイメージをプッシュする場合、「macOS/Linux」タブのコマンドを使用します。